共用方式為


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,周框方塊會包含裁剪的文字,而且不包含整個要求的文字範圍。 周框方塊會因為要求的範圍不可見而裁剪。

傳回值

這個方法可以傳回下列其中一個值。

描述
S_OK
此方法成功。
TS_E_INVALIDARG
指定的開始和結束字元位置相等。
TS_E_INVALIDPOS
acpStartacpEnd 參數所指定的範圍會延伸超過文件結尾或文件的頂端。
TS_E_NOLAYOUT
應用程式尚未計算文字版面配置。
TS_E_NOLOCK
呼叫端沒有檔的唯讀鎖定。

備註

如果文件視窗最小化,或目前看不到指定的文字,此方法會傳回S_OK ,並將中國 參數設定為 {0,0,0,0}。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 msctf.h
Dll Msimtf.dll
可轉散發套件 Windows 2000 專業版上的 TSF 1.0

另請參閱

ITextStoreACP::GetTextExt

ITfContextOwner

ITfContextView::GetTextExt