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

HE_CANCELCONVERT, HE_CHAROFFSET, HE_CHARPOSITION, HE_DEFAULTFONT, HE_ENABLEALTLIST, HE_FIXKKCONVERT, HE_GETBOXLAYOUT, HE_GETIMEDEFAULT, HE_GETINFLATE, HE_GETINKHANDLE, HE_GETKKCONVERT, HE_GETKKSTATUS, HE_GETUNDERLINE, HE_SETBOXLAYOUT, HE_SETIMEDEFAULT, HE_SETINFLATE, HE_SETINKMODE, HE_SETUNDERLINE, HE_SHOWALTLIST, HE_STOPINKMODE

Software for developers
Delphi Components
.Net Components
Software for Android Developers
More information resources
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
Databases for Amazon shops developers
Amazon Categories Database
Browse Nodes Database