iTextStoreACP：：GetTextExt 方法 (textstor.h)

  • 發行項

ITextStoreACP：：GetTextExt 方法會以螢幕座標傳回位於指定字元位置之文字的周框方塊。 呼叫端必須在檔上具有唯讀鎖定，才能呼叫這個方法。

語法

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 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 textstor.h
Dll Msctf.dll
可轉散發套件 Windows 2000 專業版上的 TSF 1.0

另請參閱

ITextStoreACP

ITfContextOwner：：GetTextExt

ITfContextView：：GetTextExt