Metodo ITextProvider::GetSelection (uiautomationcore.h)

Articolo
03/08/2023

Recupera una raccolta di intervalli di testo che rappresenta il testo attualmente selezionato in un controllo basato su testo.

Sintassi

HRESULT GetSelection(
  [out, retval] SAFEARRAY **pRetVal
);

Parametri

[out, retval] pRetVal

Tipo: SAFEARRAY**

Riceve l'indirizzo di una matrice di puntatori alle interfacce ITextRangeProvider degli intervalli di testo, uno per ogni intervallo di testo selezionato. Questo parametro viene passato non inizializzato.

Valore restituito

Tipo: HRESULT

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

Commenti

Per Automazione interfaccia utente provider che supportano la selezione del testo, il provider deve implementare questo metodo e restituire anche un valore ITextProvider::SupportedTextSelection.

Se il controllo contiene solo un singolo intervallo di testo selezionato, la matrice pRetVal deve contenere un singolo intervallo di testo.

Se il controllo contiene un punto di inserimento di testo ma non è selezionato alcun testo, la matrice pRetVal deve contenere un intervallo di testo degenerato (vuoto) nella posizione del punto di inserimento del testo.

Se il controllo non contiene testo selezionato o se il controllo non contiene un punto di inserimento di testo, impostare pRetVal su NULL.

Requisiti


Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcore.h (includere UIAutomation.h)