Compartilhar via

Método ITfContextView::GetRangeFromPoint (msctf.h)

  • Artigo

O método ITfContextView::GetRangeFromPoint converte um ponto, em coordenadas de tela, em um intervalo vazio de texto posicionado em um local correspondente.

Sintaxe

HRESULT GetRangeFromPoint(
  [in]  TfEditCookie ec,
  [in]  const POINT  *ppt,
  [in]  DWORD        dwFlags,
  [out] ITfRange     **ppRange
);

Parâmetros

[in] ec

Especifica o cookie de edição com acesso somente leitura.

[in] ppt

Especifica o ponto nas coordenadas da tela.

[in] dwFlags

Especifica a posição do intervalo a ser retornada com base nas coordenadas da tela do ponto para uma caixa delimitadora de caracteres. Por padrão, a posição de intervalo retornada é a caixa delimitadora de caracteres que contém as coordenadas de 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 da tela do ponto estiverem contidas em uma caixa delimitadora de caracteres, a posição de intervalo retornada será a borda delimitada mais próxima das coordenadas da tela do ponto.
GXFPF_NEAREST
 Se as coordenadas da tela do ponto não estiverem contidas em uma caixa delimitadora de caracteres, a posição de intervalo mais próxima será retornada.

[out] ppRange

Recebe um ponteiro para a interface ITfRange.

Retornar valor

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método foi bem-sucedido.
TF_E_INVALIDPOINT
 O parâmetro pptScreen não abrange nenhum texto do documento.
TF_E_NOLAYOUT
 O aplicativo não calculou um layout de texto.
TF_E_NOLOCK
 O cookie de edição especificado é inválido.

Comentários

O ponto 1 está na caixa delimitadora de caracteres e o ponto 2 está fora da caixa delimitadora de caracteres. Por padrão, o método retornará um intervalo posicionado em 0 para o ponto 1 e TF_E_INVALIDPOINT para o ponto 2. Se o parâmetro dwFlags estiver definido como GXFPF_ROUND_NEAREST, o método retornará a posição de intervalo 1 para o ponto 1. Se o parâmetro dwFlags estiver definido como GXFPF_NEAREST, o método retornará a posição de intervalo 2 para o ponto 2.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msctf.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

GXFPF_NEAREST

GXFPF_ROUND_NEAREST

ITfContextView

TF_E_INVALIDPOINT