Metodo ITextStoreACP::GetACPFromPoint (textstor.h)

Articolo
08/26/2023

Il metodo ITextStoreACP::GetACPFromPoint converte un punto nelle coordinate dello schermo in una posizione di carattere dell'applicazione.

Sintassi

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

Parametri

[in] vcView

Specifica la visualizzazione contesto.

[in] ptScreen

Puntatore alla struttura POINT con le coordinate dello schermo del punto.

[in] dwFlags

Specifica la posizione del carattere da restituire in base alle coordinate dello schermo del punto rispetto a una casella di selezione dei caratteri. Per impostazione predefinita, la posizione del carattere restituita è la casella di selezione dei caratteri contenente le coordinate dello schermo del punto. Se il punto è esterno a una casella di selezione dei caratteri, il metodo restituisce NULL o TF_E_INVALIDPOINT. Di seguito sono riportati altri flag di bit per questo parametro.

I flag di bit possono essere combinati.

Valore	Significato
GXFPF_ROUND_NEAREST	Se le coordinate dello schermo del punto sono contenute in una casella di selezione dei caratteri, la posizione del carattere restituita è il bordo di delimitamento più vicino alle coordinate dello schermo del punto.
GXFPF_NEAREST	Se le coordinate dello schermo del punto non sono contenute in una casella di selezione dei caratteri, viene restituita la posizione del carattere più vicina.

[out] pacp

Riceve la posizione del carattere corrispondente alle coordinate dello schermo del punto.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
TS_E_INVALIDPOINT	Il parametro ptScreen non si trova all'interno del rettangolo di selezione di alcun carattere.
TS_E_NOLAYOUT	L'applicazione non ha calcolato un layout di testo.

Commenti

Il punto 1 è nel rettangolo di selezione dei caratteri e il punto 2 non è compreso nel rettangolo di selezione dei caratteri.

Le coordinate dello schermo del punto 1 causano che il parametro pacp sia 0 per impostazione predefinita o se il parametro dwFlags è impostato su GXFPF_NEAREST perché le coordinate dello schermo del punto 1 si trovano all'interno del riquadro di selezione caratteri della posizione del carattere 0. Se il parametro dwFlags è impostato su GXFPF_ROUND_NEAREST per il punto 1, il parametro pacp è 1 perché le coordinate dello schermo del punto 1 sono più vicine alla posizione dell'intervallo 1. La posizione dell'intervallo 1 è la posizione iniziale della posizione del carattere 1.

Per le coordinate dello schermo del punto 2, il metodo restituisce TF_E_INVALIDPOINT per impostazione predefinita o se il parametro dwFlags è impostato su GXFPF_NEAREST perché le coordinate dello schermo del punto 2 si trovano all'esterno di una casella di selezione dei caratteri. Se il parametro dwFlags è impostato su GXFPF_ROUND_NEAREST, le coordinate dello schermo del punto 2 causano che il parametro pacp sia 1, perché la posizione del carattere più vicina al punto 2 coordinate dello schermo è posizione carattere 1.

Punto 1

Default-- pacp = 0 --Il punto di coordinate dello schermo si trova all'interno della casella di selezione dei caratteri di Posizione 0.
-- GXFPF_ROUND_NEARESTpacp = 1 --Le coordinate dello schermo del punto sono più vicine alla posizione intervallo 1, ovvero la posizione iniziale dell'intervallo di caratteri 1.
-- GXFPF_NEARESTpacp = 0 --Il comportamento predefinito si verifica perché il punto si trova all'interno della casella di selezione dei caratteri della posizione 0.

Punto 2

Default-- hr = TF_E_INVALIDPOINT --Le coordinate dello schermo del punto si trova all'esterno di un rettangolo di selezione dei caratteri.
GXFPF_ROUND_NEAREST-- hr = TF_E_INVALIDPOINT --Il comportamento predefinito si verifica perché le coordinate dello schermo del punto si trovano all'esterno di una casella di selezione dei caratteri.
GXFPF_NEAREST-- pacp = 1 --La posizione del carattere più vicina alle coordinate dello schermo del punto è Posizione carattere 1.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	textstor.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional