Metodo ITextProvider2::GetCaretRange (uiautomationcore.h)

Articolo
03/03/2024

Fornisce un intervallo di testo di lunghezza zero nella posizione del cursore appartenente al controllo basato su testo.

Sintassi

HRESULT GetCaretRange(
  [out]         BOOL               *isActive,
  [out, retval] ITextRangeProvider **pRetVal
);

Parametri

[out] isActive

Tipo: BOOL*

TRUE se il controllo basato su testo contenente il cursore ha lo stato attivo della tastiera; in caso contrario, FALSE.

[out, retval] pRetVal

Tipo: ITextRangeProvider**

Intervallo di testo che rappresenta la posizione corrente del cursore appartenente al controllo basato su testo.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se il parametro isActive è FALSE, il cursore appartenente al controllo basato su testo potrebbe non trovarsi nella stessa posizione del cursore di sistema.

Questo metodo recupera un intervallo di testo che un client può usare per trovare il rettangolo di delimitazione del cursore appartenente al controllo basato su testo o per trovare il testo vicino al punto di inserimento.

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	uiautomationcore.h (include UIAutomation.h)

Vedi anche

ITextProvider2

Condividi tramite