Metodo IUIAutomationTextPattern2::GetCaretRange (uiautomationclient.h)

Recupera un intervallo di testo a lunghezza zero nella posizione del caret che appartiene al controllo basato sul testo.

Sintassi

HRESULT GetCaretRange(
  [out, retval] BOOL                   *isActive,
  [out, retval] IUIAutomationTextRange **range
);

Parametri

[out, retval] 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] range

Tipo: IUIAutomationTextRange**

Riceve un intervallo di testo che rappresenta la posizione corrente del caret che appartiene al controllo basato sul 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 caret che appartiene al controllo basato sul testo potrebbe non essere nella stessa posizione del caret di sistema.

Questo metodo recupera un intervallo di testo che un client può usare per trovare il rettangolo di selezione del caret appartenente al controllo basato sul testo o per trovare il testo vicino al caret.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione uiautomationclient.h (includere UIAutomation.h)

Vedi anche

IUIAutomationTextPattern2

Automazione interfaccia utente supporto per il contenuto testuale

Uso dei controlli basati su testo