SCRIPT_CHARPROP structure (usp10.h)

Article
02/22/2024

Contains information about a single character in a run (input string). The information indicates if the character glyph is affected by surrounding letters of the run.

Syntax

typedef struct script_charprop {
  WORD fCanGlyphAlone : 1;
  WORD reserved : 15;
} SCRIPT_CHARPROP;

Members

fCanGlyphAlone

Value indicating if the shaping of a letter depends on other characters around the letter being shaped. Possible values are defined in the following table.

Value	Meaning
TRUE	The shape of a letter is independent of surrounding characters.
FALSE	The shape of a letter depends on one or more adjacent characters.

reserved

Reserved.

Remarks

One or more characters in a run, immediately preceding and/or following the letter being shaped, can influence shaping. Information about these characters can help optimize higher-level layout code, such as that used to optimize paragraph layout.

Examples

Let's look at an example of the use of this structure.

A font has ligatures for letter combinations "fi" and "fl", and no others.
The input string is "I like flying fish".
An array of SCRIPT_CHARPROP structures contains one structure for each character of the input string.

For the provided input string, the array of structures has the following values in the fCanGlyphAlone members:

I like flying fish
111111100111110011

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	usp10.h
Redistributable	Usp10.dll version 1.600 or greater onWindows XP