HDC hdc,

// handle to device context

    LPCTSTR lpString,

// pointer to string

    int nCount,

// number of characters in string

    int nMaxExtent,

// maximum extent for displayed string

    LPGCP_RESULTS *lpResults,

// pointer to buffer for placement result

    DWORD dwFlags

// placement flags

   );

Value

Meaning

GCP_CLASSIN

Specifies that the lpClass array contains preset classifications for characters. The classifications may be the same as on output. If the particular classification for a character is not known, the corresponding location in the array must be set to zero. for more information about the classifications, see GCP_RESULTS. This is useful only if GetFontLanguageInfo1_H0UDU returned the GCP_REORDER flag.

GCP_DIACRITIC

Determines how diacritics in the string are handled. If this value is not set, diacritics are treated as zero-width characters. For example, a Hebrew string may contain diacritics, but you may not want to display them.

Use GetFontLanguageInfo to determine whether a font supports diacritics. If it does, you can use or not use the GCP_DIACRITIC flag in the call to GetCharacterPlacement, depending on the needs of your application.

GCP_DISPLAYZWG

For languages that need reordering or different glyph shapes depending on the positions of the characters within a word, nondisplayable characters often appear in the codepage. For example, in the Hebrew codepage, there are Left-To-Right and Right-To-Left markers, to help determine the final positioning of characters within the output strings. Normally these are not displayed and are removed from the lpGlyphs and lpDx arrays. You can use the GCP_DISPLAYZWG flag to display these characters.

GCP_GLYPHSHAPE

Specifies that some or all characters in the string are to be displayed using shapes other than the standard shapes defined in the currently selected font for the current code page. Some languages, such as Arabic, cannot support glyph creation unless this value is given. As a general rule, if GetFontLanguageInfo1_H0UDU returns this value for a string, this value must be used with GetCharacterPlacement.

GCP_JUSTIFY

Adjusts the extents in the lpDx array so that the string length is the same as nMaxExtent. GCP_JUSTIFY may only be used in conjunction with GCP_MAXEXTENT.

GCP_JUSTIFYIN

Specifies that the lpDx array contains justification weights on input. Normally, a justification weight can be either 0 or 1, where 1 indicates that the width of the given character can be adjusted for justification. For languages in which GetFontLanguageInfo1_H0UDU returns the GCP_KASHIDA flag, the justification weight can be one of the GCP_ARAJUST_* values.

GCP_KASHIDA

Use Kashidas as well as, or instead of, adjusted extents to modify the length of the string so that it is equal to the value given by nMaxExtent. In the lpDx array, a Kashida is indicated by a negative justification index. GCP_KASHIDA may be used only in conjunction with GCP_JUSTIFY and only if the font (and language) support Kashidas. Use GetFontLanguageInfo to determine whether the current font supports Kashidas.

Using Kashidas to justifiy the string can result in the number of glyphs required being greater than the number of characters in the input string. Because of this, when Kashidas are used, the application cannot assume that setting the arrays to be the size of the input string will be sufficient. (The maximum possible will be approximately dxPageWidth/dxAveCharWidth, where dxPageWidth is the width of the document and dxAveCharWidth is the average character width as returned from a GetTextMetricsZD2PDO call).

Note that just because GetFontLanguageInfo1_H0UDU returns the GCP_KASHIDA flag does not mean that it has to be used in the call to GetCharacterPlacement, just that the option is available.

GCP_LIGATE

Use ligations wherever characters ligate. A ligation occurs where one glyph is used for two or more characters. For example, the letters  a  and  e  can ligate to   . For this to be used, however , both the language support and the font must support the required glyphs (the example given will NOT be processed by default in English).

Use GetFontLanguageInfo1_H0UDU to determine whether the current font supports ligation. If it does and a specific maximum is required for the number of characters that will ligate, set the number in the first element of the lpGlyphs array. If normal ligation is required, set this value to zero. If GCP_LIGATE is not given, no ligation will take place. See GCP_RESULTS for more information.

If the GCP_REORDER value is usually required for the character set but is not given, the output will be meaningless unless the string being passed in is already in visual ordering (that is, the result that gets put into lpGcpResults->lpOutString in one call to GetCharacterPlacement is the input string of a second call).

Note that just because GetFontLanguageInfo1_H0UDU returns the GCP_LIGATE flag does not mean that it has to be used in the call to GetCharacterPlacement, just that the option is available.

GCP_MAXEXTENT

Compute extents of the string only as long as the resulting extent, in logical units, does not exceed the values given by the nMaxExtent parameter.

GCP_NEUTRALOVERRIDE

Certain languages only. Override the normal handling of neutrals and treat them as strong characters that match the strings reading order. Useful only with the GCP_REORDER flag.

GCP_NUMERICOVERRIDE

Certain languages only. Override the normal handling of numerics and treat them as strong characters that match the strings reading order. Useful only with the GCP_REORDER flag.

GCP_NUMERICSLATIN

Arabic/Thai only. Use standard Latin glyphs for numbers and override the system default. To determine if this option is available in the language of the font, use GetStringTypeExZ7LV.F to see if the language supports more than one number format.

GCP_NUMERICSLOCAL

Arabic/Thai only. Use local glyphs for numeric characters and override the system default. To determine if this option is available in the language of the font, use GetStringTypeEx to see if the language supports more than one number format.

GCP_REORDER

Reorder the string. Use for languages that are not SBCS and left-to-right reading order. If this value is not given, the string is assumed to be in display order already.

If this flag is set for Semitic languages and the lpClass array is used, the first two elements of the array are used to specify the reading order beyond the bounds of the string. GCP_CLASS_PREBOUNDRTL and GCP_CLASS_PREBOUNDLTR can be used to set the order. If no preset order is required, set the values to zero. These values can be combined with other values if theGCPCLASSIN flag is set.

If the GCP_REORDER value is not given, the lpString parameter is taken to be visual ordered for languages where this is used, and the lpOutString and lpOrder fields are ignored.

Use GetFontLanguageInfo1_H0UDU to determine whether the current font supports reordering.

GCP_SYMSWAPOFF

Semitic languages only. Specifies that swappable characters are not reset. For example, in a right-to-left string, the  (  and  )  are not reversed.

GCP_USEKERNING

Use kerning pairs in the font (if any) when creating the widths arrays. Use GetFontLanguageInfo1_H0UDU to determine whether the current font supports kerning pairs.

Note that just because GetFontLanguageInfo returns the GCP_USEKERNING flag does not mean that it has to be used in the call to GetCharacterPlacement, just that the option is available. Most TrueType fonts have a kerning table, but you do not have to use it.