ITextStoreAnchor：：GetAnchorFromPoint 方法 (textstor.h)

發行項
08/26/2023

ITextStoreAnchor：：GetAnchorFromPoint方法會將螢幕座標中的點轉換成位於對應位置的錨點。

語法

HRESULT GetAnchorFromPoint(
  [in]  TsViewCookie vcView,
  [in]  const POINT  *ptScreen,
  [in]  DWORD        dwFlags,
  [out] IAnchor      **ppaSite
);

參數

[in] vcView

指定內容檢視。

[in] ptScreen

具有點螢幕座標的 POINT 結構的指標。

[in] dwFlags

指定要根據相對於字元周框方塊之點的螢幕座標傳回的錨點位置。根據預設，傳回的錨點位置是包含點螢幕座標的字元周框方塊。如果點位於字元周框方塊之外，此方法會傳回 Null 或 TF_E_INVALIDPOINT。此參數的其他位旗標如下所示。

可以結合位旗標。

值	意義
GXFPF_ROUND_NEAREST	如果點的螢幕座標包含在字元周框方塊中，則會在最接近點螢幕座標的周框邊緣傳回錨點。
GXFPF_NEAREST	如果點的螢幕座標未包含在字元周框方塊中，則會傳回位於最接近字元位置的錨點。

[out] ppaSite

指向對應至螢幕座標 ptScreen之位置的錨點物件指標。

傳回值

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

值	描述
S_OK	此方法成功。
E_FAIL	方法失敗。
E_INVALIDARG	一或多個輸入參數無效。
E_OUTOFMEMORY	嘗試在指定的位置具現化錨點失敗。
TS_E_INVALIDPOINT	ptScreen參數不在任何字元的周框方塊內。
TS_E_NOLAYOUT	應用程式尚未計算文字版面配置。

備註

點 1 螢幕座標會導致錨點 ppaSite 的位移 (位移) 為 0，或者 dwFlags 參數設定為 GXFPF_NEAREST ，因為點 1 螢幕座標位於字元位置 0 的字元周框方塊內。如果 dwFlags 參數設定為點 1 的GXFPF_ROUND_NEAREST，則錨點位移為 1，因為點 1 螢幕座標最接近範圍位置 1。範圍位置 1 是字元位置 1 的起始範圍位置。

針對點 2 螢幕座標，此方法預設會傳回 TF_E_INVALIDPOINT， 或者 dwFlags 參數設定為 GXFPF_NEAREST ，因為點 2 螢幕座標位於字元周框方塊之外。如果 dwFlags 參數設定為 GXFPF_ROUND_NEAREST，則點 2 螢幕座標會導致錨點位移為 1，因為最接近點 2 螢幕座標的字元位置是字元位置 1。

第 1 點

Default-- 錨點位移 = 0 --螢幕座標點位於字元位置 0 的字元周框方塊內。
-- GXFPF_ROUND_NEAREST錨點位移 = 1 --點的螢幕座標最接近範圍位置 1，這是字元位置 1 的起始範圍位置。
GXFPF_NEAREST -- 錨點位移 = 0 --預設行為是因為點位於字元位置 0 的字元周框方塊內。

點 2

Default-- hr = TF_E_INVALIDPOINT --點的螢幕座標位於字元周框方塊之外。
GXFPF_ROUND_NEAREST-- hr = TF_E_INVALIDPOINT --預設行為是因為點的螢幕座標位於字元周框方塊之外。
GXFPF_NEAREST-- 錨點位移 = 1 --最接近點螢幕座標的字元位置是字元位置 1。

需求


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