Metodo ITfContextOwner::GetACPFromPoint (msctf.h)

Articolo
08/24/2023

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

Sintassi

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

Parametri

[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 un rettangolo di selezione dei caratteri. Per impostazione predefinita, la posizione del carattere restituita è il rettangolo di selezione dei caratteri contenente le coordinate dello schermo del punto. Se il punto si trova all'esterno del rettangolo di delimitazione di un carattere, il metodo restituisce NULL o TF_E_INVALIDPOINT.

Se per questo parametro viene specificato il flag di GXFPF_ROUND_NEAREST e le coordinate dello schermo del punto sono contenute in un riquadro delimitatore di caratteri, la posizione del carattere restituita è il bordo di delimitazione più vicino alle coordinate dello schermo del punto.

Se per questo parametro viene specificato il flag di GXFPF_NEAREST e le coordinate dello schermo del punto non sono contenute in un riquadro delimitatore di caratteri, viene restituita la posizione del carattere più vicina.

I flag di bit possono essere combinati.

[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

Usare l'illustrazione per determinare la posizione del carattere restituita in base ai flag usati nel parametro dwFlags .

Punto 1

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

Punto 2

Default-- hr = TF_E_INVALIDPOINT --Le coordinate dello schermo del punto si trovano 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 un rettangolo di selezione dei caratteri.
GXFPF_NEAREST-- pacp = 1 - La posizione del carattere più vicina alle coordinate dello schermo del punto è Posizione carattere 1.

Requisiti

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

Vedi anche

ITextStoreACP::GetACPFromPoint

ITfContextOwner

ITfContextView::GetRangeFromPoint

TsViewCookie

Condividi tramite