WM_PENCTL
Performs
several actions, including:
Converts a logical character
position to a byte offset.
Converts a byte offset to a
logical character position.
Switches the font in a bedit
control to the default font.
Parameters
wParam
Submessage
identifier as described in the following table. Each submessage is documented
separately.
|
Constant |
Description |
|
HE_CANCELCONVERT |
Cancels
Kana-to-Kanji conversion. (Japanese version only.) |
|
HE_CHAROFFSET |
Converts
logical character position of a character in the control to byte offset to
the character. For bedit controls only. |
|
HE_CHARPOSITION |
Converts
byte offset in the text buffer of the control to the logical character
position, which contains the byte specified by the byte offset. For bedit controls
only. |
|
HE_DEFAULTFONT |
Switches
the font of the bedit control to the default font that the bedit selects at
the time of creation. For bedit controls only. |
|
HE_ENABLEALTLIST |
Enables or
disables the alternate list in a bedit control. |
|
HE_FIXKKCONVERT |
Confirm
undetermined string and close Input Method Editor (IME). (Japanese version
only.) |
|
HE_GETBOXLAYOUT |
Points to
the BOXLAYOUT
structure, which is filled with the current box layout for the control. For
bedit controls only. |
|
HE_GETCONVERTRANGE |
Gets the
range of the marked conversion string. (Japanese version only.) |
|
HE_GETINFLATE |
LPRECTOFS filled with current value. |
|
HE_GETINKHANDLE |
Retrieves a
handle to the captured ink. |
|
HE_GETKKCONVERT |
Determines
if the Input Method Editor (IME) is in pen (or keyboard) conversion mode.
(Japanese version only.) |
|
HE_GETKKSTATUS |
Determines
the mode of the Kana-to-Kanji conversion. (Japanese version only.) |
|
HE_GETRC |
Fills an RC structure, whose address
is passed in the lParam, with current values. See the note that
follows. |
|
HE_GETUNDERLINE |
Queries
whether underline mode is set. For hedit controls only. |
|
HE_HIDEALTLIST |
Hides the
alternate list in a bedit control, assuming it is being displayed. |
|
HE_KKCONVERT |
Starts
Kana-to-Kanji conversion. (Japanese version only.) |
|
HE_PUTCONVERTCHAR |
Sends a
character, marked for conversion, to the IME. (Japanese version only.) |
|
HE_SETBOXLAYOUT |
Sets a BOXLAYOUT structure. For bedit
controls only. |
|
HE_SETCONVERTRANGE |
Sets the
range of the marked conversion string. (Japanese version only.) |
|
HE_SETINFLATE |
Specifies
adjustments to the control window to specify the size of the writing window. |
|
HE_SETINKMODE |
Starts the
collection of inking. |
|
HE_SETRC |
Sets the RC structure, whose address
is passed in the lParam. See the note that follows. |
|
HE_SETUNDERLINE |
Sets or
cancels underline mode. For hedit controls only. |
|
HE_SHOWALTLIST |
Displays
the alternate list menu in a bedit control, assuming that alternate lists are
enable. |
|
HE_STOPINKMODE |
Stops the
collection of ink. |
The HE_GETRC and
HE_SETRC submessages are provided only for compatibility with version 1.0 of the
Pen API and will not be supported in future versions.
lParam
Depends on wParam.
See the individual HE_ submessage descriptions for more information.
Comments
Any control
message (a message with the EM_ prefix) that can be sent to an edit control can
also be sent to an hedit window. Most of these control messages are also
supported by bedit controls.
The HE_
submessages are also common to both hedit and bedit controls except as noted in
the preceding table. In a bedit control, each cell contains one logical
character. Carriage return (CR) and line-feed (LF) bytes together form one logical
character.
Before using
the HE_SETBOXLAYOUT or HE_SETINFLATE submessages, it is often useful to
retrieve the current structure associated with the control using the
HE_GETBOXLAYOUT or HE_GETINFLATE submessages. You should then change the
appropriate members in the retrieved structure. This procedure reduces the risk
of inadvertent changes to the structure.
In older
applications compatible with version 1.0 of the Pen API, placing the value
RRM_SYMBOL in wResultMode of the RC structure disables all default diction-ary
processing in a bedit control. The 1.0 application can perform dictionary
pro-cessing on its own by retrieving the recognition results during the
processing of the HN_RESULT notification and calling the DictionarySearch function.
See Also