Compartir a través de

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

  • Artículo

El método ITfContextView::GetRangeFromPoint convierte un punto, en coordenadas de pantalla, en un intervalo vacío de texto colocado en una ubicación correspondiente.

Sintaxis

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

Parámetros

[in] ec

Especifica la cookie de edición con acceso de solo lectura.

[in] ppt

Especifica el punto en coordenadas de pantalla.

[in] dwFlags

Especifica la posición del intervalo que se va a devolver en función de las coordenadas de pantalla del punto a un cuadro de límite de caracteres. De forma predeterminada, la posición del intervalo devuelta es el cuadro de límite de caracteres que contiene las coordenadas de pantalla del punto. Si el punto está fuera de un cuadro de límite de caracteres, el método devuelve NULL o TF_E_INVALIDPOINT. Otras marcas de bits para este parámetro son las siguientes.

Las marcas de bits se pueden combinar.

Valor Significado
GXFPF_ROUND_NEAREST
 Si las coordenadas de pantalla del punto están contenidas en un cuadro de límite de caracteres, la posición del intervalo devuelta es el borde delimitador más cercano a las coordenadas de pantalla del punto.
GXFPF_NEAREST
 Si las coordenadas de pantalla del punto no están contenidas en un cuadro de límite de caracteres, se devuelve la posición de intervalo más cercana.

[out] ppRange

Recibe un puntero a la interfaz ITfRange.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
 Método realizado correctamente.
TF_E_INVALIDPOINT
 El parámetro pptScreen no cubre ningún texto de documento.
TF_E_NOLAYOUT
 La aplicación no ha calculado un diseño de texto.
TF_E_NOLOCK
 La cookie de edición especificada no es válida.

Comentarios

El punto 1 está en el cuadro de límite de caracteres y el punto 2 está fuera del cuadro de límite de caracteres. De forma predeterminada, el método devolverá un intervalo situado en 0 para el punto 1 y TF_E_INVALIDPOINT para el punto 2. Si el parámetro dwFlags se establece en GXFPF_ROUND_NEAREST, el método devuelve la posición del intervalo 1 para el punto 1. Si el parámetro dwFlags se establece en GXFPF_NEAREST, el método devuelve la posición del intervalo 2 para el punto 2.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado msctf.h
Archivo DLL Msctf.dll
Redistribuible TSF 1.0 en Windows 2000 Professional

Consulte también

GXFPF_NEAREST

GXFPF_ROUND_NEAREST

ITfContextView

TF_E_INVALIDPOINT