View source for WM QUERYCONVERTPOS

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

==Syntax==
<pre>
param1
    PRECTL pCursorPos; /* Cursor position. */

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

==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)

[[Category:Messages]]