ScriptBreak 函式 (usp10.h)

發行項
03/03/2024

擷取判斷換行符的資訊。

語法

HRESULT ScriptBreak(
  [in]  const WCHAR           *pwcChars,
  [in]  int                   cChars,
  [in]  const SCRIPT_ANALYSIS *psa,
  [out] SCRIPT_LOGATTR        *psla
);

參數

[in] pwcChars

要處理的 Unicode 字元指標。

[in] cChars

要處理的 Unicode 字元數目。

[in] psa

從先前呼叫 ScriptItemize 取得之SCRIPT_ANALYSIS結構的指標。

[out] psla

緩衝區的指標，此函式會將字元屬性擷取為 SCRIPT_LOGATTR 結構。

傳回值

若成功，即傳回 0。如果函式不成功，函式會傳回非零 HRESULT 值。應用程式可以使用 SUCCEEDED 和 FAILED 宏來測試傳回值。

備註

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

此函式不需要裝置內容，也不會執行圖像成形。

此函式會擷取 SCRIPT_LOGATTR 結構數位中專案的游標移動和格式化中斷位置。若要正確支援單字內的混合格式設定， ScriptBreak 的呼叫應該依照 ScriptItemize 擷取的擷取方式傳遞整個專案，而不是執行更精細的格式設定。

SCRIPT_LOGATTR 結構會識別有效的插入號位置和換行符。 fCharStop 成員會指定旗標，此旗標會標示傳統限制在叢集內部移動之腳本的叢集界限。您也可以藉由檢查 ScriptShape 所擷取的邏輯叢集資訊來推斷相同的界限。不過， ScriptBreak 在實作中會大幅加快，而且不需要準備裝置內容。

fWordStop、fSoftBreak 和 fWhiteSpaceSCRIPT_LOGATTR 成員所指定的旗標只能透過 ScriptBreak 取得。

識別無效序列的大部分成形引擎都會在 ScriptBreak中設定由 SCRIPT_LOGATTR 的 fInvalid 成員所指示的旗標。 SCRIPT_PROPERTIES的 fInvalidLogAttr 成員會識別適用的腳本。

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	usp10.h
程式庫	Usp10.lib
Dll	Usp10.dll
可轉散發套件	Windows Me/98/95 上的 Internet Explorer 5 或更新版本