IDWriteTextAnalyzer1::GetTextComplexity メソッド (dwrite_1.h)
テキストの複雑さ、および完全なスクリプト シェイプのために IDWriteTextAnalyzer::GetGlyphs を呼び出す必要があるかどうかを判断します。
構文
HRESULT GetTextComplexity(
[in] WCHAR const *textString,
UINT32 textLength,
IDWriteFontFace *fontFace,
[out] BOOL *isTextSimple,
[out] UINT32 *textLengthRead,
[out, optional] UINT16 *glyphIndices
);
パラメーター
[in] textString
型: const WCHAR*
複雑さをチェックするテキスト。 この文字列は UTF-16 でもかまいませんが、補助文字はすべて複雑と見なされます。
textLength
種類: UINT32
チェックするテキストの長さ。
fontFace
種類: IDWriteFontFace*
読み取るフォント面。
[out] isTextSimple
種類: BOOL*
true の場合、テキストは単純であり、 glyphIndices 配列には名目グリフが既に含まれています。 それ以外の場合は、 IDWriteTextAnalyzer::GetGlyphs を呼び出して、複雑なスクリプトと OpenType 機能を適切に整形する必要があります。
[out] textLengthRead
型: UINT32*
テキストの長さの読み取りは、単純または複雑な同じ複雑さで実行されます。 その時点からもう一度を呼び出す場合があります。
[out, optional] glyphIndices
種類: UINT16*
テキストのオプションのグリフ インデックス。 関数がテキストが単純であることを返した場合は、必要なグリフが既にあります。 それ以外の場合、グリフ インデックスは意味を持たず、代わりにシェイプのために IDWriteTextAnalyzer::GetGlyphs を呼び出す必要があります。
戻り値
種類: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
文字が複雑な整形要件を持つスクリプトの一部である場合、bidi 分析が必要な場合、他の文字と組み合わせる場合、補助プレーン内に存在する場合、または標準の OpenType 機能に参加するグリフがある場合、テキストは単純ではありません。 返される長さは、結合マークをベース文字から分割しません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dwrite_1.h |
| Library | Dwrite.lib |
| [DLL] | Dwrite.dll |