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 合併。
| 值 | 意義 |
|---|---|
|
將文字裁剪到矩形。 |
|
使用目前的背景色彩填滿矩形。 |
[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 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | usp10.h |
| 程式庫 | Usp10.lib |
| Dll | Usp10.dll |