iTfContextOwner::GetTextExt 方法 (msctf.h)
ITfContextOwner::GetTextExt 方法會以螢幕座標傳回位於指定字元位置的文字周框方塊。 呼叫端必須在檔上具有唯讀鎖定,才能呼叫這個方法。
語法
HRESULT GetTextExt(
[in] LONG acpStart,
[in] LONG acpEnd,
[out] RECT *prc,
[out] BOOL *pfClipped
);
參數
[in] acpStart
指定要在檔案中取得之文字的起始字元位置。
[in] acpEnd
指定要在檔案中取得之文字的結束符位置。
[out] prc
在指定的字元位置接收文字的周框方塊,以螢幕座標表示。
[out] pfClipped
接收布爾值,指定周框方塊中的文字是否已裁剪。 如果此參數為 TRUE,周框方塊會包含裁剪的文字,而且不包含整個要求的文字範圍。 周框方塊會因為要求的範圍不可見而裁剪。
傳回值
這個方法可以傳回下列其中一個值。
值 | 描述 |
---|---|
|
此方法成功。 |
|
指定的開始和結束字元位置相等。 |
|
acpStart 和 acpEnd 參數所指定的範圍會延伸超過文件結尾或文件的頂端。 |
|
應用程式尚未計算文字版面配置。 |
|
呼叫端沒有檔的唯讀鎖定。 |
備註
如果文件視窗最小化,或目前看不到指定的文字,此方法會傳回S_OK ,並將中國 參數設定為 {0,0,0,0}。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | msctf.h |
Dll | Msimtf.dll |
可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |