337 lines
9.2 KiB
C
337 lines
9.2 KiB
C
|
/*++
|
||
|
|
*
|
||
|
|
* WOW v1.0
|
||
|
|
*
|
||
|
|
* Copyright (c) 1991, Microsoft Corporation
|
||
|
|
*
|
||
|
|
* WUCARET.C
|
||
|
|
* WOW32 16-bit User API support
|
||
|
|
*
|
||
|
|
* History:
|
||
|
|
* Created 07-Mar-1991 by Jeff Parsons (jeffpar)
|
||
|
|
--*/
|
||
|
|
|
||
|
|
|
||
|
|
#include "precomp.h"
|
||
|
|
#pragma hdrstop
|
||
|
|
|
||
|
|
MODNAME(wucaret.c);
|
||
|
|
|
||
|
|
|
||
|
|
/*++
|
||
|
|
void CreateCaret(<hwnd>, <hBitmap>, <nWidth>, <nHeight>)
|
||
|
|
HWND <hwnd>;
|
||
|
|
BITMAP <hBitmap>;
|
||
|
|
int <nWidth>;
|
||
|
|
int <nHeight>;
|
||
|
|
|
||
|
|
The %CreateCaret% function creates a new shape for the system caret and
|
||
|
|
assigns ownership of the caret to the given window. The caret shape can be a
|
||
|
|
line, block, or bitmap as defined by the <hBitmap> parameter. If <hBitmap>
|
||
|
|
is a bitmap handle, the <nWidth> and <nHeight> parameters are ignored; the
|
||
|
|
bitmap defines its own width and height. (The bitmap handle must have been
|
||
|
|
previously created by using the %CreateBitmap%, %CreateDIBitmap%, or
|
||
|
|
%LoadBitmap% function.) If <hBitmap> is NULL or 1, <nWidth> and <nHeight>
|
||
|
|
give the caret's width and height (in logical units); the exact width and
|
||
|
|
height (in pixels) depend on the window's mapping mode.
|
||
|
|
|
||
|
|
If <nWidth> or <nHeight> is zero, the caret width or height is set to the
|
||
|
|
system's window-border width or height. Using the window-border width or
|
||
|
|
height guarantees that the caret will be visible on a high-resolution
|
||
|
|
display.
|
||
|
|
|
||
|
|
The %CreateCaret% function automatically destroys the previous caret shape,
|
||
|
|
if any, regardless of which window owns the caret. Once created, the caret
|
||
|
|
is initially hidden. To show the caret, the %ShowCaret% function must be
|
||
|
|
called.
|
||
|
|
|
||
|
|
<hwnd>
|
||
|
|
Identifies the window that owns the new caret.
|
||
|
|
|
||
|
|
<hBitmap>
|
||
|
|
Identifies the bitmap that defines the caret shape. If
|
||
|
|
<hBitmap> is NULL, the caret is solid; if <hBitmap> is 1, the caret is
|
||
|
|
gray.
|
||
|
|
|
||
|
|
<nWidth>
|
||
|
|
Specifies the width of the caret (in logical units).
|
||
|
|
|
||
|
|
<nHeight>
|
||
|
|
Specifies the height of the caret (in logical units).
|
||
|
|
|
||
|
|
This function does not return a value.
|
||
|
|
|
||
|
|
The system caret is a shared resource. A window should create a caret only
|
||
|
|
when it has the input focus or is active. It should destroy the caret before
|
||
|
|
losing the input focus or becoming inactive.
|
||
|
|
|
||
|
|
The system's window-border width or height can be retrieved by using the
|
||
|
|
%GetSystemMetrics% function with the SM_CXBORDER and SM_CYBORDER indexes.
|
||
|
|
--*/
|
||
|
|
|
||
|
|
ULONG FASTCALL WU32CreateCaret(PVDMFRAME pFrame)
|
||
|
|
{
|
||
|
|
register PCREATECARET16 parg16;
|
||
|
|
HANDLE h32;
|
||
|
|
|
||
|
|
GETARGPTR(pFrame, sizeof(CREATECARET16), parg16);
|
||
|
|
|
||
|
|
h32 = (HANDLE)parg16->f2;
|
||
|
|
|
||
|
|
// 0 -> caret is solid, 1 -> caret is gray, otherwise it's an hBitmap
|
||
|
|
if(((DWORD)h32) > 1) {
|
||
|
|
h32 = HBITMAP32(h32);
|
||
|
|
}
|
||
|
|
|
||
|
|
CreateCaret(HWND32(parg16->f1), h32, INT32(parg16->f3), INT32(parg16->f4));
|
||
|
|
|
||
|
|
FREEARGPTR(parg16);
|
||
|
|
RETURN(0);
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/*++
|
||
|
|
void DestroyCaret(VOID)
|
||
|
|
|
||
|
|
The %DestroyCaret% function destroys the current caret shape, frees the
|
||
|
|
caret from the window that currently owns it, and removes the caret from the
|
||
|
|
screen if it is visible. The %DestroyCaret% function checks the ownership of
|
||
|
|
the caret and destroys the caret only if a window in the current task owns
|
||
|
|
it.
|
||
|
|
|
||
|
|
If the caret shape was previously a bitmap, %DestroyCaret% does not free the
|
||
|
|
bitmap.
|
||
|
|
|
||
|
|
This function has no parameters.
|
||
|
|
|
||
|
|
This function does not return a value.
|
||
|
|
|
||
|
|
The caret is a shared resource. If a window has created a caret shape, it
|
||
|
|
destroys that shape before it loses the input focus or becomes inactive.
|
||
|
|
--*/
|
||
|
|
|
||
|
|
ULONG FASTCALL WU32DestroyCaret(PVDMFRAME pFrame)
|
||
|
|
{
|
||
|
|
UNREFERENCED_PARAMETER(pFrame);
|
||
|
|
|
||
|
|
DestroyCaret();
|
||
|
|
|
||
|
|
RETURN(0);
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/*++
|
||
|
|
WORD GetCaretBlinkTime(VOID)
|
||
|
|
|
||
|
|
The %GetCaretBlinkTime% function retrieves the caret blink rate. The blink
|
||
|
|
rate is the elapsed time in milliseconds between flashes of the caret.
|
||
|
|
|
||
|
|
This function has no parameters.
|
||
|
|
|
||
|
|
The return value specifies the blink rate (in milliseconds).
|
||
|
|
--*/
|
||
|
|
|
||
|
|
ULONG FASTCALL WU32GetCaretBlinkTime(PVDMFRAME pFrame)
|
||
|
|
{
|
||
|
|
ULONG ul;
|
||
|
|
|
||
|
|
UNREFERENCED_PARAMETER(pFrame);
|
||
|
|
|
||
|
|
ul = GETWORD16(GetCaretBlinkTime());
|
||
|
|
|
||
|
|
RETURN(ul);
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/*++
|
||
|
|
void GetCaretPos(<lpPoint>)
|
||
|
|
LPPOINT <lpPoint>;
|
||
|
|
|
||
|
|
The %GetCaretPos% function retrieves the caret's current position (in screen
|
||
|
|
coordinates), and copies them to the %POINT% structure pointed to by the
|
||
|
|
<lpPoint> parameter.
|
||
|
|
|
||
|
|
<lpPoint>
|
||
|
|
Points to the %POINT% structure that is to receive the screen coordinates
|
||
|
|
of the caret.
|
||
|
|
|
||
|
|
This function does not return a value.
|
||
|
|
|
||
|
|
The caret position is always given in the client coordinates of the window
|
||
|
|
that contains the caret.
|
||
|
|
--*/
|
||
|
|
|
||
|
|
ULONG FASTCALL WU32GetCaretPos(PVDMFRAME pFrame)
|
||
|
|
{
|
||
|
|
POINT t1;
|
||
|
|
register PGETCARETPOS16 parg16;
|
||
|
|
|
||
|
|
GETARGPTR(pFrame, sizeof(GETCARETPOS16), parg16);
|
||
|
|
|
||
|
|
GetCaretPos(
|
||
|
|
&t1
|
||
|
|
);
|
||
|
|
|
||
|
|
PUTPOINT16(parg16->f1, &t1);
|
||
|
|
FREEARGPTR(parg16);
|
||
|
|
RETURN(0);
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/*++
|
||
|
|
void HideCaret(<hwnd>)
|
||
|
|
HWND <hwnd>;
|
||
|
|
|
||
|
|
The %HideCaret% function hides the caret by removing it from the display
|
||
|
|
screen. Although the caret is no longer visible, it can be displayed again
|
||
|
|
by using the %ShowCaret% function. Hiding the caret does not destroy its
|
||
|
|
current shape.
|
||
|
|
|
||
|
|
The %HideCaret% function hides the caret only if the given window owns the
|
||
|
|
caret. If the <hwnd> parameter is NULL, the function hides the caret only if
|
||
|
|
a window in the current task owns the caret.
|
||
|
|
|
||
|
|
Hiding is cumulative. If %HideCaret% has been called five times in a row,
|
||
|
|
%ShowCaret% must be called five times before the caret will be shown.
|
||
|
|
|
||
|
|
<hwnd>
|
||
|
|
Identifies the window that owns the caret, or it is NULL to indirectly
|
||
|
|
specify the window in the current task that owns the caret.
|
||
|
|
|
||
|
|
This function does not return a value.
|
||
|
|
--*/
|
||
|
|
|
||
|
|
ULONG FASTCALL WU32HideCaret(PVDMFRAME pFrame)
|
||
|
|
{
|
||
|
|
register PHIDECARET16 parg16;
|
||
|
|
|
||
|
|
GETARGPTR(pFrame, sizeof(HIDECARET16), parg16);
|
||
|
|
|
||
|
|
HideCaret(
|
||
|
|
HWND32(parg16->f1)
|
||
|
|
);
|
||
|
|
|
||
|
|
FREEARGPTR(parg16);
|
||
|
|
RETURN(0);
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/*++
|
||
|
|
void SetCaretBlinkTime(<wMSeconds>)
|
||
|
|
WORD <wMSeconds>;
|
||
|
|
|
||
|
|
The %SetCaretBlinkTime% function sets the caret blink rate (elapsed time
|
||
|
|
between caret flashes) to the number of milliseconds specified by the
|
||
|
|
<wMSeconds> parameter. The caret flashes on or off each <wMSeconds>
|
||
|
|
milliseconds. This means one complete flash (on-off-on) takes 2 x
|
||
|
|
<wMSeconds> milliseconds.
|
||
|
|
|
||
|
|
<wMSeconds>
|
||
|
|
Specifies the new blink rate (in milliseconds).
|
||
|
|
|
||
|
|
This function does not return a value.
|
||
|
|
|
||
|
|
The caret is a shared resource. A window should set the caret blink rate
|
||
|
|
only if it owns the caret. It should restore the previous rate before it
|
||
|
|
loses the input focus or becomes inactive.
|
||
|
|
--*/
|
||
|
|
|
||
|
|
ULONG FASTCALL WU32SetCaretBlinkTime(PVDMFRAME pFrame)
|
||
|
|
{
|
||
|
|
register PSETCARETBLINKTIME16 parg16;
|
||
|
|
|
||
|
|
GETARGPTR(pFrame, sizeof(SETCARETBLINKTIME16), parg16);
|
||
|
|
|
||
|
|
SetCaretBlinkTime(
|
||
|
|
WORD32(parg16->f1)
|
||
|
|
);
|
||
|
|
|
||
|
|
FREEARGPTR(parg16);
|
||
|
|
RETURN(0);
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/*++
|
||
|
|
void SetCaretPos(<X>, <Y>)
|
||
|
|
int <X>;
|
||
|
|
int <Y>;
|
||
|
|
|
||
|
|
The %SetCaretPos% function moves the caret to the position given by logical
|
||
|
|
coordinates specified by the <X> and <Y> parameters. Logical coordinates are
|
||
|
|
relative to the client area of the window that owns them and are affected by
|
||
|
|
the window's mapping mode, so the exact position in pixels depends on this
|
||
|
|
mapping mode.
|
||
|
|
|
||
|
|
The %SetCaretPos% function moves the caret only if it is owned by a window
|
||
|
|
in the current task. %SetCaretPos% moves the caret whether or not the caret
|
||
|
|
is hidden.
|
||
|
|
|
||
|
|
<X>
|
||
|
|
Specifies the new x-coordinate (in logical coordinates) of the caret.
|
||
|
|
|
||
|
|
<Y>
|
||
|
|
Specifies the new <y>-coordinate (in logical coordinates) of the
|
||
|
|
caret.
|
||
|
|
|
||
|
|
This function does not return a value.
|
||
|
|
|
||
|
|
The caret is a shared resource. A window should not move the caret if it
|
||
|
|
does not own the caret.
|
||
|
|
--*/
|
||
|
|
|
||
|
|
ULONG FASTCALL WU32SetCaretPos(PVDMFRAME pFrame)
|
||
|
|
{
|
||
|
|
register PSETCARETPOS16 parg16;
|
||
|
|
|
||
|
|
GETARGPTR(pFrame, sizeof(SETCARETPOS16), parg16);
|
||
|
|
|
||
|
|
SetCaretPos(
|
||
|
|
INT32(parg16->f1),
|
||
|
|
INT32(parg16->f2)
|
||
|
|
);
|
||
|
|
|
||
|
|
FREEARGPTR(parg16);
|
||
|
|
RETURN(0);
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/*++
|
||
|
|
void ShowCaret(<hwnd>)
|
||
|
|
|
||
|
|
The %ShowCaret% function shows the caret on the display at the caret's
|
||
|
|
current position. Once shown, the caret begins flashing automatically.
|
||
|
|
|
||
|
|
The %ShowCaret% function shows the caret only if it has a current shape and
|
||
|
|
has not been hidden two or more times in a row. If the caret is not owned by
|
||
|
|
the given window, the caret is not shown. If the <hwnd> parameter is NULL,
|
||
|
|
the %ShowCaret% function shows the caret only if it is owned by a window in
|
||
|
|
the current task.
|
||
|
|
|
||
|
|
Hiding the caret is accumulative. If the %HideCaret% function has been
|
||
|
|
called five times in a row, %ShowCaret% must be called five times to show
|
||
|
|
the caret.
|
||
|
|
|
||
|
|
<hwnd>
|
||
|
|
Identifies the window that owns the caret, or is NULL to specify
|
||
|
|
indirectly the owner window in the current task.
|
||
|
|
|
||
|
|
This function does not return a value.
|
||
|
|
|
||
|
|
The caret is a shared resource. A window should show the caret only when it
|
||
|
|
has the input focus or is active.
|
||
|
|
--*/
|
||
|
|
|
||
|
|
ULONG FASTCALL WU32ShowCaret(PVDMFRAME pFrame)
|
||
|
|
{
|
||
|
|
register PSHOWCARET16 parg16;
|
||
|
|
|
||
|
|
GETARGPTR(pFrame, sizeof(SHOWCARET16), parg16);
|
||
|
|
|
||
|
|
ShowCaret(
|
||
|
|
HWND32(parg16->f1)
|
||
|
|
);
|
||
|
|
|
||
|
|
FREEARGPTR(parg16);
|
||
|
|
RETURN(0);
|
||
|
|
}
|