ITextStoreACP2：：GetTextExt 方法 (textstor.h)

取得位於指定字元位置之文字的周框方塊，以螢幕座標為單位。 呼叫端必須在檔上具有唯讀鎖定，才能呼叫這個方法。

語法

HRESULT GetTextExt(
  [in]  TsViewCookie vcView,
  [in]  LONG         acpStart,
  [in]  LONG         acpEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

參數

[in] vcView

指定內容檢視。

[in] acpStart

指定要在檔案中取得之文字的起始字元位置。

[in] acpEnd

指定要在檔案中取得之文字的結束字元位置。

[out] prc

在指定字元位置的文字螢幕座標中接收周框方塊。

[out] pfClipped

接收布爾值，指定周框方塊中的文字是否已裁剪。 如果此參數為 TRUE，周框方塊會包含裁剪的文字，而且不包含整個要求的文字範圍。 周框方塊會裁剪，因為要求的範圍看不到。

傳回值

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

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

備註

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

規格需求

需求	值
最低支援的用戶端	Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	textstor.h
Dll	Msctf.dll

另請參閱

ITextStoreACP2