Metodo ITfContextView::GetRangeFromPoint (msctf.h)

  • Articolo

Il metodo ITfContextView::GetRangeFromPoint converte un punto, nelle coordinate dello schermo, in un intervallo vuoto di testo posizionato in una posizione corrispondente.

Sintassi

HRESULT GetRangeFromPoint(
  [in]  TfEditCookie ec,
  [in]  const POINT  *ppt,
  [in]  DWORD        dwFlags,
  [out] ITfRange     **ppRange
);

Parametri

[in] ec

Specifica il cookie di modifica con accesso di sola lettura.

[in] ppt

Specifica il punto nelle coordinate dello schermo.

[in] dwFlags

Specifica la posizione dell'intervallo da restituire in base alle coordinate dello schermo del punto a un rettangolo delimitatore di caratteri. Per impostazione predefinita, la posizione dell'intervallo 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 dell'intervallo 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 dell'intervallo più vicino.

[out] ppRange

Riceve un puntatore all'interfaccia ITfRange.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
 Il metodo è stato eseguito correttamente.
TF_E_INVALIDPOINT
 Il parametro pptScreen non copre alcun testo del documento.
TF_E_NOLAYOUT
 L'applicazione non ha calcolato un layout di testo.
TF_E_NOLOCK
 Il cookie di modifica specificato non è valido.

Commenti

Il punto 1 si trova nel rettangolo di delimitazione dei caratteri e il punto 2 non rientra nel rettangolo di selezione dei caratteri. Per impostazione predefinita, il metodo restituirà un intervallo posizionato su 0 per il punto 1 e TF_E_INVALIDPOINT per il punto 2. Se il parametro dwFlags è impostato su GXFPF_ROUND_NEAREST, il metodo restituisce la posizione dell'intervallo 1 per il punto 1. Se il parametro dwFlags è impostato su GXFPF_NEAREST, il metodo restituisce la posizione dell'intervallo 2 per il punto 2.

Requisiti

Requisito Valore
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 msctf.h
DLL Msctf.dll
Componente ridistribuibile TSF 1.0 in Windows 2000 Professional

Vedi anche

GXFPF_NEAREST

GXFPF_ROUND_NEAREST

ITfContextView

TF_E_INVALIDPOINT