Script MismatchSingleGlyph 関数 (usp10.h)

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

OpenType 処理用に同じグリフの代替形式を 1 つ持つ 1 つのグリフの置換を有効にします。

構文

HRESULT ScriptSubstituteSingleGlyph(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           OPENTYPE_TAG    tagLangSys,
  [in]           OPENTYPE_TAG    tagFeature,
  [in]           LONG            lParameter,
  [in]           WORD            wGlyphId,
  [out]          WORD            *pwOutGlyphId
);

パラメーター

[in, optional] hdc

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

[in, out] psc

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

[in, optional] psa

ScriptItemizeOpenType の以前の呼び出しから取得したSCRIPT_ANALYSIS構造体へのポインター。このパラメーターは、正しい代替グリフが使用されるようにシェイプエンジンを識別します。

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

[in] tagScript

シェイプ用のスクリプトタグを定義する OPENTYPE_TAG 構造体。

[in] tagLangSys

シェイプ用の言語タグを定義する OPENTYPE_TAG 構造体。

[in] tagFeature

代替グリフの整形に使用する特徴タグを定義する OPENTYPE_TAG 構造体。

[in] lParameter

置き換える代替グリフへの参照。この参照は、 OPENTYPE_FEATURE_RECORDに示すように、機能で定義されているすべての代替グリフを含む配列へのインデックスです。代替グリフ配列は、 ScriptGetFontAlternateGlyphs によって取得される項目の 1 つです。

[in] wGlyphId

元のグリフの識別子。

[out] pwOutGlyphId

この関数が代替グリフの識別子を取得する場所へのポインター。

戻り値

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

注釈

この関数は、アプリケーションが 1 つのグリフを 1 つの代替形式で置き換えることができる 1 対 1 の置換を使用します。ほとんどの場合、アプリケーションはこの関数を使用して行の先頭または末尾に行頭文字または代替グリフを設定します。

大事な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 以降