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

こちらもご覧ください

IDWriteTextAnalyzer1

IDWriteTextAnalyzer::GetGlyphs