Share via


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

傳回值

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

描述
S_OK
此方法成功。
E_FAIL
方法無法取得開始和/或結束錨點的有效介面指標。
TS_E_INVALIDARG
一或多個輸入參數無效。
TS_E_INVALIDPOS
paStartpaEnd 參數所指定的範圍會延伸超過檔的開頭或結尾。
TS_E_NOLAYOUT
應用程式尚未計算文字版面配置。 在應用程式呼叫 ITextStoreAnchorSink::OnLayoutChange 之前,任何進一步的呼叫都不會成功。
TS_E_NOLOCK
呼叫端沒有檔的唯讀鎖定。

備註

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

規格需求

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

另請參閱

ITextStoreAnchor

ITfContextOwner::GetTextExt

ITfContextView::GetTextExt