IDWriteTextAnalyzer1::GetTextComplexity-Methode (dwrite_1.h)
Bestimmt die Komplexität von Text und ob IdWriteTextAnalyzer::GetGlyphs für die vollständige Skriptstrukturierung aufgerufen werden muss.
Syntax
HRESULT GetTextComplexity(
[in] WCHAR const *textString,
UINT32 textLength,
IDWriteFontFace *fontFace,
[out] BOOL *isTextSimple,
[out] UINT32 *textLengthRead,
[out, optional] UINT16 *glyphIndices
);
Parameter
[in] textString
Typ: const WCHAR*
Der Text, der auf Komplexität überprüft werden soll. Diese Zeichenfolge kann UTF-16 sein, aber alle zusätzlichen Zeichen werden als komplex betrachtet.
textLength
Typ: UINT32
Länge des zu überprüfenden Texts.
fontFace
Typ: IDWriteFontFace*
Die zu lesende Schriftart.
[out] isTextSimple
Typ: BOOL*
Wenn true, ist der Text einfach, und das glyphIndices-Array enthält bereits die nominalen Glyphen für Sie. Andernfalls müssen Sie IDWriteTextAnalyzer::GetGlyphs aufrufen, um komplexe Skripts und OpenType-Features ordnungsgemäß zu gestalten.
[out] textLengthRead
Typ: UINT32*
Die Länge des Texts wird mit der gleichen Komplexität, einfach oder komplex ausgeführt. Ab diesem Punkt können Sie erneut anrufen.
[out, optional] glyphIndices
Typ: UINT16*
Optionale Glyphenindizes für den Text. Wenn die Funktion zurückgegeben hat, dass der Text einfach war, verfügen Sie bereits über die benötigten Glyphen. Andernfalls sind die Glyphenindizes nicht sinnvoll, und Sie müssen idWriteTextAnalyzer::GetGlyphs zum Strukturieren aufrufen.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Text ist nicht einfach, wenn die Zeichen Teil eines Skripts sind, das komplexe Strukturierungsanforderungen aufweist, eine Bidi-Analyse erfordert, mit anderen Zeichen kombiniert, sich in den ergänzenden Ebenen befindet oder Glyphen aufweist, die an OpenType-Standardfeatures beteiligt sind. Die zurückgegebene Länge teilt keine kombinationsbasierten Markierungen von ihren Basiszeichen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwrite_1.h |
| Bibliothek | Dwrite.lib |
| DLL | Dwrite.dll |