ScriptRecordDigitSubstitution 函式 (usp10.h)

發行項
08/26/2023

讀取國家語言支援 (NLS) 原生數位和數位替代設定，並將其記錄在 SCRIPT_DIGITSUBSTITUTE 結構中。如需詳細資訊，請參閱數位圖形。

語法

HRESULT ScriptRecordDigitSubstitution(
  [in]  LCID                   Locale,
  [out] SCRIPT_DIGITSUBSTITUTE *psds
);

參數

[in] Locale

要查詢之地區設定的地區設定識別碼。一般而言，應用程式應該將此參數設定為 LOCALE_USER_DEFAULT。或者，設定可以指出與 LOCALE_NOUSEROVERRIDE 結合的特定地區設定，以取得預設設定。

[out] psds

SCRIPT_DIGITSUBSTITUTE結構的指標。這個結構稍後可以傳遞至 ScriptApplyDigitSubstitution。

傳回值

如果成功，則傳回S_OK。如果函式未成功，函式會傳回非零 HRESULT 值。

錯誤傳回包括：

E_INVALIDARG。 Locale參數指出無效或未安裝的地區設定。
E_POINTER。 psds參數會設定為Null。

備註

如需通常呼叫此函式的內容討論，請參閱使用 Uniscribe 顯示文字。

此函式僅支援阿拉伯文和俄文地區設定的內容數位替代。針對其他地區設定，內容數位替代對應至無替代。

下列範例顯示呼叫此函式的一般方式。

SCRIPT_DIGITSUBSTITUTE sds;
ScriptRecordDigitSubstitution(LOCALE_USER_DEFAULT, &sds);

在每個專案化時，應用程式都可以使用結果，如下一個範例所示。

SCRIPT_CONTROL sc = {0};
SCRIPT_STATE   ss = {0};
ScriptApplyDigitSubstitution(&sds, &sc, &ss);

基於效能考慮，您的應用程式不應該經常呼叫 ScriptRecordDigitSubstitution 。每次呼叫 ScriptItemize 或 ScriptStringAnalyse 時，函式都需要相當多的額外負荷來呼叫它。相反地，應用程式可以儲存 SCRIPT_DIGITSUBSTITUTE 結構，並只在收到 WM_SETTINGCHANGE 訊息時加以更新。或者，當專用線程中的RegNotifyChangeKeyValue呼叫指出 HKCU\主控台\International 之下登錄中的變更時，應用程式可以更新結構。

重要從 Windows 8 開始：若要維護在 Windows 7 上執行的能力，使用 Uniscribe 的模組必須在其程式庫清單中指定 Usp10.lib 之前，才能指定 Usp32.lib。

規格需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	usp10.h
程式庫	Usp10.lib
Dll	Usp10.dll