Share via


CANDIDATEFORM

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains position information for the candidate window.

Syntax

typedef struct _tagCANDIDATEFORM {
  DWORD dwIndex;
  DWORD dwStyle;
  POINT ptCurrentPos;
  RECT rcArea;
} CANDIDATEFORM;

Members

  • dwIndex
    Candidate list identifier. dwIndex can be zero for the first list, 1 for the second, and so on. The maximum index is 31.
  • dwStyle
    Position style. The following table shows possible values for dwStyle.

    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 zero through 4 for the dwIndex member of the CANDIDATEFORM structure. In Windows CE 2.10 and later, an index range from zero through 3 is allowed.

Requirements

Header imm.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ImmSetCandidateWindow

Other Resources

POINT
RECT