Compartir a través de

Método ITfContextOwner::GetACPFromPoint (msctf.h)

  • Artículo

El método ITfContextOwner::GetACPFromPoint convierte un punto en coordenadas de pantalla en una posición de carácter de aplicación.

Sintaxis

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

Parámetros

[in] ptScreen

Puntero a la estructura POINT con las coordenadas de pantalla del punto.

[in] dwFlags

Especifica la posición del carácter que se va a devolver en función de las coordenadas de pantalla del punto en relación con un cuadro de límite de caracteres. De forma predeterminada, la posición del carácter devuelta es el cuadro de límite de caracteres que contiene las coordenadas de pantalla del punto. Si el punto está fuera del cuadro de límite de un carácter, el método devuelve NULL o TF_E_INVALIDPOINT.

Si se especifica la marca GXFPF_ROUND_NEAREST para este parámetro y las coordenadas de pantalla del punto están contenidas en un cuadro de límite de caracteres, la posición del carácter devuelta es el borde delimitador más cercano a las coordenadas de pantalla del punto.

Si se especifica la marca GXFPF_NEAREST para este parámetro y las coordenadas de pantalla del punto no están contenidas en un cuadro de límite de caracteres, se devuelve la posición de carácter más cercana.

Las marcas de bits se pueden combinar.

[out] pacp

Recibe la posición del carácter que corresponde a las coordenadas de pantalla del punto.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
 Método realizado correctamente.
TS_E_INVALIDPOINT
 El parámetro ptScreen no está dentro del cuadro de límite de ningún carácter.
TS_E_NOLAYOUT
 La aplicación no ha calculado un diseño de texto.

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. Use la ilustración para determinar la posición del carácter devuelta en función de las marcas usadas en el parámetro dwFlags .

Punto 1

  • Default-- pacp = 0 --Las coordenadas de pantalla del punto están dentro del cuadro de límite de caracteres de Posición de carácter 0.
  • GXFPF_ROUND_NEAREST-- pacp = 1 --Las coordenadas de pantalla del punto son más cercanas a la posición del intervalo 1, que es la posición inicial del intervalo de carácter 1.
  • GXFPF_NEAREST-- pacp = 0 --El comportamiento predeterminado se produce porque el punto se encuentra dentro del cuadro de límite de caracteres de Posición de carácter 0.
Punto 2
  • Valor predeterminado: hr = TF_E_INVALIDPOINT - Las coordenadas de pantalla del punto están fuera de un cuadro de límite de caracteres.
  • GXFPF_ROUND_NEAREST-- hr = TF_E_INVALIDPOINT --El comportamiento predeterminado se produce porque las coordenadas de pantalla del punto están fuera de un cuadro de límite de caracteres.
  • GXFPF_NEAREST-- pacp = 1 --La posición de carácter más cercana a las coordenadas de pantalla del punto es Posición de carácter 1.

Requisitos

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

Consulte también

ITextStoreACP::GetACPFromPoint

ITfContextOwner

ITfContextView::GetRangeFromPoint

TsViewCookie