Metodo IUIAutomationTextPattern::GetVisibleRanges (uiautomationclient.h)

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

Sintassi

HRESULT GetVisibleRanges(
  [out, retval] IUIAutomationTextRangeArray **ranges
);

Parametri

[out, retval] ranges

Tipo: IUIAutomationTextRangeArray**

Riceve un puntatore alla raccolta di intervalli di testo visibili all'interno del 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 testo visibile è costituito da un intervallo contiguo di testo, la matrice di intervalli conterrà un singolo intervallo di testo che rappresenta tutto il testo visibile.

Se il testo visibile è costituito da più intervalli di testo non contigui, la matrice di intervalli conterrà un intervallo di testo per ogni intervallo visibile, a partire dal primo intervallo visibile e terminando con l'ultimo intervallo visibile. Gli intervalli non contigui di testo visibile possono verificarsi quando il contenuto di un controllo basato su testo viene parzialmente nascosto da una finestra sovrapposta o da un altro oggetto oppure quando un controllo basato su testo con più pagine o colonne dispone di contenuto parzialmente scorrevole all'esterno della visualizzazione.

IUIAutomationTextPattern::GetVisibleRanges recupera un intervallo di testo degenerato (vuoto) se non è visibile alcun testo, se tutto il testo viene spostato all'esterno della visualizzazione o se il controllo basato su testo non contiene testo.

Requisiti

Vedi anche

IUIAutomationTextPattern

supporto di Automazione interfaccia utente per il contenuto testuale