WM QUERYCONVERTPOS

This message is sent by an application to determine whether it is appropriate to begin conversion of DBCS characters.

Syntax

param1
    PRECTL pCursorPos; /* Cursor position. */

param2
    ULONG  ulReserved; /* Reserved value, should be 0. */

Parameters

pCursorPos (PRECTL) - input/output

Cursor position.

If usCode = QCP_CONVERT, pCursorPos should be updated to contain the position of the cursor in the window receiving this message. The position is specified as a rectangle in screen coordinates.

If usCode = QCP_NOCONVERT, pCursorPos should not be updated.

ulReserved (ULONG) - input

Reserved value, should be 0.

Returns

usCode (USHORT) - returns

Conversion code.

QCP_CONVERT: Conversion may be performed for the window with the input focus, pCursorPos has been updated to contain the position of the cursor.

QCP_NOCONVERT: Conversion should not be performed, the window with the input focus cannot receive DBCS characters, pCursorPos has not been updated.

Remarks

This message enables a DBCS application to determine whether the window with the input focus can handle DBCS characters. The pCursorPos parameter can be used as a guide for positioning any conversion window that the application requires.

in Button Controls

The button control window procedure returns QCP_NOCONVERT.

in Entry Fields

The entry field control window procedure updates pCursorPos to the position of the cursor and returns QCP_CONVERT.

in Frame Controls

The entry field control window procedure updates pCursorPos to the position of the cursor and returns QCP_CONVERT.

in List Boxes

The list box control window procedure returns QCP_NOCONVERT.

in Menu Controls

The menu control window procedure returns QCP_NOCONVERT.

in Scroll Bars

The scroll bar control window procedure returns QCP_NOCONVERT.

in Static Controls

The static control window procedure returns QCP_NOCONVERT.

in Title Bar Controls

The title bar control window procedure returns QCP_NOCONVERT.

Default Processing

The default window procedure returns QCP_CONVERT, and updates pCursorPos to the following values:

• xleft = -1
• ybottom = -1
• xright = 0
• ytop = 0

Related Messages

• WM_QUERYCONVERTPOS (in Button Controls)
• WM_QUERYCONVERTPOS (in Title Bar Controls)
• WM_QUERYCONVERTPOS (in Entry Fields)
• WM_QUERYCONVERTPOS (in Frame Controls)
• WM_QUERYCONVERTPOS (in List Boxes)
• WM_QUERYCONVERTPOS (in Menu Controls)
• WM_QUERYCONVERTPOS (in Scroll Bars)
• WM_QUERYCONVERTPOS (in Static Controls)