ITextStoreAnchor::GetTextExt 方法 (textstor.h)
ITextStoreAnchor::GetTextExt 方法會以螢幕座標傳回文字範圍的周框方塊。 呼叫端必須在檔上具有唯讀鎖定,才能呼叫這個方法。
語法
HRESULT GetTextExt(
[in] TsViewCookie vcView,
[in] IAnchor *paStart,
[in] IAnchor *paEnd,
[out] RECT *prc,
[out] BOOL *pfClipped
);
參數
[in] vcView
指定內容檢視。
[in] paStart
指定位於範圍開頭的錨點。
[in] paEnd
指定位於範圍結尾的錨點。
[out] prc
接收螢幕座標中文字範圍的周框方塊。
[out] pfClipped
接收布爾值,指定周框方塊中的文字是否已裁剪。 如果 為TRUE,周框方塊會包含裁剪的文字,而且不包含整個要求的文字範圍。 周框方塊會裁剪,因為要求的範圍不可見。
傳回值
這個方法可以傳回下列其中一個值。
值 | 描述 |
---|---|
|
此方法成功。 |
|
方法無法取得開始和/或結束錨點的有效介面指標。 |
|
一或多個輸入參數無效。 |
|
paStart 和 paEnd 參數所指定的範圍會延伸超過檔的開頭或結尾。 |
|
應用程式尚未計算文字版面配置。 在應用程式呼叫 ITextStoreAnchorSink::OnLayoutChange 之前,任何進一步的呼叫都不會成功。 |
|
呼叫端沒有檔的唯讀鎖定。 |
備註
如果文件視窗最小化,或目前看不到指定的文字,此方法會傳回S_OK ,並將中國 參數設定為 {0,0,0,0}。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | textstor.h |
Dll | Msctf.dll |
可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |