Metodo ITextProvider::GetVisibleRanges (uiautomationcore.h)

Articolo
03/08/2023

Recupera una matrice di intervalli di testo disgiunti da un controllo basato su testo in cui ogni intervallo di testo rappresenta un intervallo contiguo di testo visibile.

Sintassi

HRESULT GetVisibleRanges(
  [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 visibili o di una matrice vuota. Non viene mai restituito un riferimento NULL . 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

Se il testo visibile è costituito da un intervallo contiguo di testo, la matrice pRetVal deve contenere un singolo intervallo di testo che rappresenta tutto il testo visibile.

Se il testo visibile è costituito da più intervalli di testo, la matrice pRetVal deve contenere un intervallo di testo per ogni intervallo visibile, a partire dal primo intervallo visibile e terminando con l'ultimo intervallo visibile. La disgiunzione del testo visibile può verificarsi quando il contenuto di un controllo basato su testo viene parzialmente offuscato da una finestra sovrapposta o da un altro oggetto oppure quando un controllo basato su testo con più pagine o colonne ha contenuto parzialmente scorrevole fuori dalla visualizzazione.

ITextProvider::GetVisibleRanges deve restituire un intervallo di testo degenerato (vuoto) se non è visibile alcun testo, se tutto il testo viene scorrere fuori dalla visualizzazione o se il controllo basato sul testo non contiene testo.

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)