Metodo ITfContextView::GetRangeFromPoint (msctf.h)

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

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