Metodo ITextStoreAnchor::GetAnchorFromPoint (textstor.h)

Il metodo ITextStoreAnchor::GetAnchorFromPoint converte un punto nelle coordinate dello schermo in una posizione ancorata in una posizione corrispondente.

Sintassi

HRESULT GetAnchorFromPoint(
  [in]  TsViewCookie vcView,
  [in]  const POINT  *ptScreen,
  [in]  DWORD        dwFlags,
  [out] IAnchor      **ppaSite
);

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 di ancoraggio da restituire in base alle coordinate dello schermo del punto rispetto a una casella di selezione dei caratteri. Per impostazione predefinita, la posizione di ancoraggio restituita è il riquadro 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, un ancoraggio viene restituito al bordo di limite 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 restituito un ancoraggio alla posizione di carattere più vicina.

[out] ppaSite

Puntatore a un oggetto ancoraggio in una posizione corrispondente alle coordinate dello schermo ptScreen.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Il metodo non è riuscito.
E_INVALIDARG	Uno o più parametri di input non sono validi.
E_OUTOFMEMORY	Tentativo di creare un'istanza di ancoraggio nella posizione specificata non riuscita.
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 ancora calcolato un layout di testo.

Commenti

Le coordinate dello schermo del punto 1 causano l'offset (posizione carattere) di ancoraggio ppaSite da 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 rettangolo di selezione caratteri della posizione 0. Se il parametro dwFlags è impostato su GXFPF_ROUND_NEAREST per il punto 1, l'offset di ancoraggio è 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 l'offset di ancoraggio 1, perché la posizione del carattere più vicina al punto 2 coordinate dello schermo è posizione carattere 1.

Punto 1

• Offset di ancoraggio predefinito = 0 --Il punto di coordinate dello schermo si trova all'interno della casella di selezione caratteri di Posizione carattere 0.
• -- GXFPF_ROUND_NEARESToffset di ancoraggio = 1 --Le coordinate dello schermo del punto sono più vicine alla posizione intervallo 1, ovvero la posizione iniziale dell'intervallo di caratteri 1.
• -- GXFPF_NEARESToffset di ancoraggio = 0 --Il comportamento predefinito si verifica perché il punto si trova all'interno della casella di selezione caratteri della posizione 0.

Punto 2

• Default-- hr = TF_E_INVALIDPOINT --Le coordinate dello schermo del punto sono esterne a 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 trova all'esterno di un rettangolo di selezione dei caratteri.
• GXFPF_NEAREST-- offset di ancoraggio = 1 --La posizione del carattere più vicina alle coordinate dello schermo del punto è Posizione carattere 1.

Requisiti

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

Vedi anche

costanti GXFPF_*

ITextStoreAnchor

ITfContextView::GetRangeFromPoint

Valori restituiti da Manager

TsViewCookie