(textstor.h) ITextStoreAnchor：：GetSelection 方法

發行項
03/05/2024

ITextStoreAnchor：：GetSelection 方法會傳回文字數據流中文字選取範圍的位移。這個方法支援多個文字選取範圍。呼叫端必須在檔上具有唯讀鎖定，才能呼叫這個方法。

語法

HRESULT GetSelection(
  [in]  ULONG               ulIndex,
  [in]  ULONG               ulCount,
  [out] TS_SELECTION_ANCHOR *pSelection,
  [out] ULONG               *pcFetched
);

參數

[in] ulIndex

指定啟動進程的文字選取範圍。如果為此參數指定 TF_DEFAULT_SELECTION 常數，則輸入選取專案會啟動進程，而且只會傳回單一選取範圍 (適合輸入作業) 。

[in] ulCount

指定要傳回的選取範圍數目上限。

[out] pSelection

接收選取文字的樣式、開始和結束字元位置。這些值會放入 TS_SELECTION_ANCHOR 結構中。

[out] pcFetched

接收傳回 的 pSelection 結構數目。

傳回值

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

值	描述
S_OK	此方法成功。
E_FAIL	方法無法將開始或結束錨點載入 TS_SELECTION_ANCHOR 結構。
E_OUTOFMEMORY	方法無法為選取範圍配置記憶體。
TS_E_NOLOCK	呼叫端沒有檔的唯讀鎖定。
TS_E_NOSELECTION	檔沒有選取範圍。

規格需求

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