Método ITextStoreACP2::GetACPFromPoint (textstor.h)

Artigo
03/05/2024

Converte um ponto nas coordenadas da tela em uma posição de caractere de aplicativo.

Sintaxe

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

Parâmetros

[in] vcView

Especifica a exibição de contexto.

[in] ptScreen

Ponteiro para a estrutura POINT com as coordenadas de tela do ponto.

[in] dwFlags

Especifica a posição do caractere a ser retornada com base nas coordenadas da tela do ponto em relação a uma caixa delimitadora de caracteres. Por padrão, a posição do caractere retornada é a caixa delimitadora de caracteres que contém as coordenadas da tela do ponto. Se o ponto estiver fora de uma caixa delimitadora de caracteres, o método retornará NULL ou TF_E_INVALIDPOINT. Outros sinalizadores de bits para esse parâmetro são os seguintes.

Os sinalizadores de bits podem ser combinados.

Valor	Significado
GXFPF_ROUND_NEAREST	Se as coordenadas de tela do ponto estiverem contidas em uma caixa delimitadora de caracteres, a posição do caractere retornada será a borda delimitada mais próxima das coordenadas da tela do ponto.
GXFPF_NEAREST	Se as coordenadas de tela do ponto não estiverem contidas em uma caixa delimitadora de caracteres, a posição do caractere mais próximo será retornada.

[out] pacp

Recebe a posição do caractere que corresponde às coordenadas da tela do ponto.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
TS_E_INVALIDPOINT	O parâmetro ptScreen não está dentro da caixa delimitadora de nenhum caractere.
TS_E_NOLAYOUT	O aplicativo não calculou um layout de texto.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	textstor.h
DLL	Msctf.dll

Confira também

constantes GXFPF_*

ITextStoreACP2

ITfContextOwner::GetACPFromPoint

ITfContextView::GetRangeFromPoint

Valores retornados do gerenciador

TsViewCookie

Compartilhar via