Metodo ITextStoreACP2::GetACPFromPoint (textstor.h)

Articolo
03/02/2024

Converte un punto nelle coordinate dello schermo in una posizione del 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 del 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 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 di un rettangolo delimitatore di 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 un rettangolo di selezione dei caratteri, la posizione del carattere restituita è il bordo di delimitazione più vicino alle coordinate dello schermo del punto.
GXFPF_NEAREST	Se le coordinate dello schermo del punto non sono contenute in un rettangolo 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.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	textstor.h
DLL	Msctf.dll

Vedi anche

Costanti GXFPF_*

ITextStoreACP2

ITfContextOwner::GetACPFromPoint

ITfContextView::GetRangeFromPoint

Valori restituiti di Manager

TsViewCookie

Condividi tramite