ScriptCPtoX function (usp10.h)
Generates the x offset from the left end or leading edge of a run to either the leading or trailing edge of a logical character cluster.
HRESULT ScriptCPtoX( int iCP, BOOL fTrailing, int cChars, int cGlyphs, const WORD *pwLogClust, const SCRIPT_VISATTR *psva, const int *piAdvance, const SCRIPT_ANALYSIS *psa, int *piX );
Logical character position in the run. This parameter corresponds to the offset of any logical character in the cluster.
TRUE to use the trailing edge of the logical character cluster to compute the offset. This parameter is set to FALSE to use the leading edge of the logical character cluster.
Number of characters in the run.
Number of glyphs in the run.
Pointer to the logical clusters.
Pointer to a SCRIPT_VISATTR array of visual attributes.
Pointer to an advance widths value.
Pointer to a SCRIPT_ANALYSIS structure. The fLogicalOrder member specifies the end of the run from which to measure the offset. If the flag is set, the leading edge of the run is used. If the flag is not set, the left end of the run is used.
Pointer to the buffer in which the function retrieves the x position of the caret.
Returns 0 if successful. This function returns a nonzero HRESULT value if it does not succeed. The application can test the return value with the SUCCEEDED and FAILED macros.
The leading or trailing edge of the character and the leading edge of a run depend on the direction of text in the run.
For scripts in which the caret is conventionally placed in the middle of clusters (for example, Arabic and Hebrew), the retrieved x position of the carat can be an interpolated position for any code point in the line.
For scripts in which the caret is conventionally snapped to the boundaries of clusters (for example, Thai and Indian), the x position is snapped to the requested edge of the cluster containing the logical character position indicated by iCP.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Redistributable||Internet Explorer 5 or later on Windows Me/98/95|