ScriptIsComplex 関数 (usp10.h)

Unicode 文字列に複雑なスクリプト処理が必要かどうかを判断します。

構文

HRESULT ScriptIsComplex(
  [in] const WCHAR *pwcInChars,
  [in] int         cInChars,
  [in] DWORD       dwFlags
);

[in] pwcInChars

テストする文字列へのポインター。

[in] cInChars

入力文字列の長さ (文字数)。

[in] dwFlags

テストの詳細を指定するフラグ。このパラメーターには、次のいずれかの値を指定できます。

値	意味
SIC_ASCIIDIGIT	数字 U+0030 から U+0039 を複合として扱います。このフラグは、文字列が数字の置換を有効にして表示される場合に設定されます。アプリケーションが ScriptRecordDigitSubstitution 関数を使用してユーザーの各国語サポート (NLS) 設定に従っている場合は、DigitSubstitute メンバーが SCRIPT_DIGITSUBSTITUTE_NONE に設定されたSCRIPT_DIGITSUBSTITUTE構造体を渡すことができます。
SIC_COMPLEX	複雑なスクリプト文字を複雑として扱います。通常、このフラグを設定する必要があります。
SIC_NEUTRAL	ニュートラルは複雑として扱います。アプリケーションは、右から左への読み取り順序で文字列を表示するようにこのフラグを設定します。

文字列に複雑なスクリプト処理が必要な場合は、S_OKを返します。標準の API 関数呼び出しで文字列を処理できる場合、つまり、並列および左から右にレイアウトされた文字のみが含まれている場合、関数はS_FALSEを返します。関数は、成功しない場合は 0 以外の HRESULT 値を返します。

この関数が通常呼び出されるコンテキストについては、「 Uniscribe でテキストを表示する」を参照してください。

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

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