This structure contains position information for the candidate window.
At a Glance
| Header file: | Wceemul.h |
| Windows CE versions: | 2.1 and later (Japanese version 1.0 and later) |
Syntax
typedef _tagCANDIDATEFORM {
DWORD dwIndex;
DWORD dwStyle;
POINT ptCurrentPos;
RECT rcArea;
} CANDIDATEFORM;
Members
dwIndex
Specifies the candidate list identifier. Can be 0 for the first list, 1 for the second, and so on. The maximum index is 31.
dwStyle
Specifies the position style. It is one of the following values:
| Value | Description |
| CFS_CANDIDATEPOS | Displays the upper-left corner of the candidate list window at the position given by ptCurrentPos. The coordinates are relative to the upper-left corner of the window that contains the list window, and are subject to adjustment by the system. |
| CFS_EXCLUDE | Excludes the candidate window from the area specified by rcArea. The ptCurrentPos member specifies the coordinates of the current point of interest, typically the caret position. |
ptCurrentPos
Coordinates of the upper-left corner of the candidate window or the caret position, depending on the value of dwStyle.
rcArea
Coordinates of the upper-left and lower-right corners of the exclusion area.
Remarks
In Japanese versions 1.0 and later, the ImmSetCandidateWindow function allows an index range from 0 through 4 for the dwIndex member of the CANDIDATEFORM structure. In Windows CE versions 2.10 and later, an index range from 0 through 3 is allowed.
See Also