Share via


ITextStoreACP2::GetACPFromPoint 方法 (textstor.h)

將螢幕座標的點轉換成應用程式字元位置。

語法

HRESULT GetACPFromPoint(
  [in]  TsViewCookie vcView,
  [in]  const POINT  *ptScreen,
  [in]  DWORD        dwFlags,
  [out] LONG         *pacp
);

參數

[in] vcView

指定內容檢視。

[in] ptScreen

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

[in] dwFlags

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

可以結合位旗標。

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

[out] pacp

接收對應至點螢幕座標的字元位置。

傳回值

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

描述
S_OK
此方法成功。
TS_E_INVALIDPOINT
ptScreen 參數不在任何字元的周框方塊內。
TS_E_NOLAYOUT
應用程式尚未計算文字配置。

規格需求

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

另請參閱

GXFPF_* 常數

ITextStoreACP2

ITfContextOwner::GetACPFromPoint

ITfContextView::GetRangeFromPoint

管理員傳回值

TsViewCookie