ScriptGetFontFeatureTags 関数 (usp10.h)

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

OpenType 処理用に定義された書き込みシステムの文字体裁機能の一覧を取得します。リストを構成する文字体裁機能タグは、指定されたデバイスコンテキストまたはキャッシュ内のフォントから取得されます。

構文

HRESULT ScriptGetFontFeatureTags(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           OPENTYPE_TAG    tagLangSys,
  [in]           int             cMaxTags,
  [out]          OPENTYPE_TAG    *pFeatureTags,
  [out]          int             *pcTags
);

パラメーター

[in, optional] hdc

デバイスコンテキストを処理します。詳細については、「キャッシュ」を参照してください。

[in, out] psc

スクリプトキャッシュを識別する SCRIPT_CACHE 構造体へのポインター。

[in, optional] psa

ScriptItemizeOpenType の以前の呼び出しから取得したSCRIPT_ANALYSIS構造体へのポインター。このパラメーターは、適切なフォントとスクリプトのフォント機能タグを取得できるように、シェイプエンジンを識別します。

または、アプリケーションでこのパラメーターを NULL に設定して、フィルター処理されていない結果を取得することもできます。

[in] tagScript

指定した機能タグに関連付けられているスクリプトタグを定義する OPENTYPE_TAG 構造体。

[in] tagLangSys

指定した機能タグに関連付けられている言語タグを定義する OPENTYPE_TAG 構造体。

[in] cMaxTags

pFeatureTags で指定された配列の長さ。

[out] pFeatureTags

この関数が、定義された書き込み システムのデバイス コンテキストまたはキャッシュ内のフォントでサポートされる文字体裁機能タグを定義するOPENTYPE_TAG構造体の配列を取得するバッファーへのポインター。

[out] pcTags

特徴タグ配列内の要素の数へのポインター。

戻り値

処理が正常に終了した場合は 0 を返します。関数は、成功しない場合は 0 以外の HRESULT 値を返します。アプリケーションでは、 SUCCEEDED マクロと FAILED マクロを使用して戻り値をテストできます。

一致するタグの数が cMaxTags の値を超えると、関数は E_OUTOFMEMORYで失敗します。アプリケーションは、より大きなバッファーを使用してもう一度呼び出しを試すことができます。

注釈

正式には ULONG 型として宣言されていますが、 OPENTYPE_TAG 構造体には、4 バイトの配列が含まれています。この配列には、スペース、A- Z、または a-z の 4 つの 8 ビット ASCII 値が含まれています。たとえば、合字機能の特徴タグは "liga" です。

この関数は、シェーピングエンジンによってこれらの機能が制御されるため、スクリプトが必要な機能または言語に必要な機能を非表示にします。アプリケーションでは、言語に必要な機能に対するシェーピングエンジンの処理を制御できません。たとえば、 ScriptGetFontFeatureTags では、初期フォーム、メディアフォーム、および最終フォームのアラビア語スクリプト機能が非表示になります。

大事なWindows 8以降: Windows 7 で実行する機能を維持するために、Uniscribe を使用するモジュールでは、ライブラリリストで gdi32.lib の前に Usp10.lib を指定する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	usp10.h
Library	Usp10.lib
[DLL]	Usp10.dll
再頒布可能パッケージ	Windows XP Usp10.dll バージョン 1.600 以降