SCRIPT_ANALYSIS構造体 (usp10.h)

[アーティクル]
03/13/2024

Unicode 文字列の一部、つまり "item" を含みます。

構文

typedef struct tag_SCRIPT_ANALYSIS {
  WORD         eScript : 10;
  WORD         fRTL : 1;
  WORD         fLayoutRTL : 1;
  WORD         fLinkBefore : 1;
  WORD         fLinkAfter : 1;
  WORD         fLogicalOrder : 1;
  WORD         fNoGlyphIndex : 1;
  SCRIPT_STATE s;
} SCRIPT_ANALYSIS;

メンバー

eScript

アイテムの ScriptShape、 ScriptPlace、および ScriptTextOut 関数を呼び出すときに Uniscribe が使用するエンジンを識別する不透明な値。このメンバーの値は未定義であり、アプリケーションは、あるリリースから次のリリースまでの値が同じであることに依存しないでください。アプリケーションは、ScriptGetProperties を呼び出すことによって eScript の属性を取得できます。

シェイプを無効にするには、アプリケーションでこのメンバーを SCRIPT_UNDEFINED に設定する必要があります。

fRTL

レンダリング方向を示す値。使用できる値は、次の表で定義されています。このメンバーは、左から右の実行で数値の 場合は TRUE に設定されます。数字は常に左から右に表示され、右から左への実行では 数値の場合は FALSE に設定されます。このメンバーの値は通常、Unicode 埋め込みレベルのパリティと同じですが、 GetCharacterPlacement レガシサポートによってオーバーライドされた場合は異なる場合があります。

値	意味
True	右から左へのレンダリング方向を使用します。
False	左から右へのレンダリング方向を使用します。

fLayoutRTL

数値のレイアウト方向を示す値。使用できる値は、次の表で定義されています。このメンバーは通常、右から左への実行で数値に対して fRTL に割り当てられた値と同じです。

値	意味
True	右から左へのシーケンスの一部として読み取られますので、右から左の実行で番号をレイアウトします。
False	左から右のシーケンスの一部として読み取られますので、左から右の実行で番号をレイアウトします。

fLinkBefore

シェイプエンジンがアイテムの最初の文字を前の文字と結合するかのように図形化するかどうかを示す値。使用できる値は、次の表で定義されています。このメンバーは ScriptItemize によって設定されます。アプリケーションは、 ScriptShape を呼び出す前に値をオーバーライドできます。

値	意味
True	前の文字とリンクして、最初の文字を整形します。
False	前の文字とリンクして最初の文字を整形しないでください。

fLinkAfter

シェイプエンジンがアイテムの最後の文字を、後続の文字と結合するかのように整形するかどうかを示す値。使用できる値は、次の表で定義されています。このメンバーは ScriptItemize によって設定されます。アプリケーションは、 ScriptItemize を呼び出す前に値をオーバーライドできます。

値	意味
True	後続の文字とリンクして、最後の文字を整形します。
False	後続の文字とリンクして、最後の文字を整形しないでください。

fLogicalOrder

シェイプエンジンがすべてのグリフ関連の配列を論理順序で生成するかどうかを示す値。使用できる値は、次の表で定義されています。このメンバーは ScriptItemize によって FALSE に設定されます。アプリケーションは、 ScriptShape を呼び出す前に値をオーバーライドできます。

値	意味
True	すべてのグリフ関連の配列を論理順序で生成します。
False	左端のグリフに対応する最初の配列エントリを使用して、すべてのグリフ関連の配列を視覚的な順序で生成します。これが既定値です。

fNoGlyphIndex

アイテムのグリフの使用を示す値。使用できる値は、次の表で定義されています。アプリケーションは、ScriptShape への入力時にこのメンバーを TRUE に設定して、アイテムのグリフの使用を無効にすることができます。さらに、 ScriptShape は 、シンボリック、認識されない、およびデバイスのフォントを含むハードウェアコンテキストに対して TRUE に 設定します。

グリフの使用を無効にすると、複雑なスクリプトシェイプも無効になります。このメンバーを TRUE に設定すると、 GetTextExtentExPoint と ExtTextOut の呼び出しによって、シェイプと配置が直接実装されます。

値	意味
True	アイテムのグリフの使用を無効にします。この値は、ビットマップ、ベクター、およびデバイスのフォントに使用されます。
False	アイテムのグリフの使用を有効にします。これが既定値です。

s

Unicode アルゴリズム状態のコピーを含む SCRIPT_STATE 構造体。

注釈

この構造体は ScriptItemize または ScriptItemizeOpenType によって塗りつぶされ、それぞれが Unicode 文字列を個別に整形可能な項目に分割します。どちらの関数も 、SCRIPT_ANALYSIS 構造体に直接アクセスします。各関数は、SCRIPT_ITEM 構造体の配列を処理します。各構造体には、 SCRIPT_ANALYSIS 構造体を定義するメンバーがあります。

ScriptItemize の代わりに ScriptItemizeOpenType を使用するアプリケーションでは、ScriptShape と ScriptPlace の代わりに ScriptShapeOpenType と ScriptPlaceOpenType も使用する必要があります。詳細については、「 Uniscribe でテキストを表示する」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	usp10.h
再頒布可能パッケージ	Windows Me/98/95 のインターネットエクスプローラー 5 以降