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

Artículo
03/02/2024

Convierte un punto en coordenadas de pantalla en una posición de carácter de aplicación.

Sintaxis

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

Parámetros

[in] vcView

Especifica la vista de contexto.

[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 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 carácter 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 carácter más cercana.

[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.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	textstor.h
Archivo DLL	Msctf.dll