scriptStringOut 函式 (usp10.h)

顯示 先前呼叫 ScriptStringAnalyse 所產生的字串，並選擇性地新增醒目提示。

語法

HRESULT ScriptStringOut(
  [in]           SCRIPT_STRING_ANALYSIS ssa,
  [in]           int                    iX,
  [in]           int                    iY,
  [in]           UINT                   uOptions,
  [in, optional] const RECT             *prc,
  [in]           int                    iMinSel,
  [in]           int                    iMaxSel,
  [in]           BOOL                   fDisabled
);

參數

[in] ssa

字串 SCRIPT_STRING_ANALYSIS 結構。

[in] iX

用來放置字串之參考點的 X 座標。

[in] iY

用來放置字串之參考點的 Y 座標。

[in] uOptions

指定應用程式定義矩形使用的選項。 這個參數可以設定為 0 或下列任何值。 這些值可以與二進位 OR 合併。

值	意義
ETO_CLIPPED	將文字裁剪到矩形。
ETO_OPAQUE	使用目前的背景色彩填滿矩形。

[in, optional] prc

RECT 結構的指標，定義要使用的矩形。 如果 uOptions 設定為 ETO_OPAQUE，且為中國提供 NULL，則函式會成功並傳回S_OK。 不過，如果應用程式將 uOptions 設定為 ETO_CLIPPING，併為中國提供 NULL，則函式會傳回E_INVALIDARG。 應用程式可以將此參數設定為 NULL ，表示不需要任何選項。

[in] iMinSel

以零起始的索引，指定字串中的起始位置。 若未選取任何專案，應用程式應該設定 iMinSel>= iMaxSel。

[in] iMaxSel

以零起始的索引，指定字串中的結束位置。

[in] fDisabled

如果操作系統套用停用的文字醒目提示，請將背景色彩設定為COLOR_HIGHLIGHT所有選取字元後方，則為TRUE。 如果操作系統套用已啟用的文字醒目提示，則應用程式可以將此參數設定為 FALSE ，方法是將背景色彩設定為 COLOR_HIGHLIGHT，並將每個選取字元的文字色彩設定為COLOR_HIGHLIGHTTEXT。

傳回值

如果成功，則傳回S_OK。 如果函式不成功，函式會傳回非零 HRESULT 值。 應用程式無法使用 SUCCEEDED 和 FAILED 宏來測試傳回值。

備註

若要使用此函式，應用程式必須在對 ScriptStringAnalyse 的原始呼叫中指定SSA_GLYPHS。

當使用 ScriptStringOut 時，應用程式不應該搭配 TA_UPDATECP 使用 SetTextAlign，因為無法正確轉譯選取的文字。 如果應用程式必須使用這個旗標，它可以視需要取消設定和重設旗標，以避免發生問題。

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

 

規格需求

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

另請參閱

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

Uniscribe

Uniscribe 函式