Metodo IUIAutomationTextPattern::GetSelection (uiautomationclient.h)
Recupera una raccolta di intervalli di testo che rappresenta il testo attualmente selezionato in un controllo basato su testo.
Sintassi
HRESULT GetSelection(
[out, retval] IUIAutomationTextRangeArray **ranges
);
Parametri
[out, retval] ranges
Tipo: IUIAutomationTextRangeArray**
Riceve un puntatore alla raccolta di intervalli di 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 controllo supporta la selezione di più intervalli di testo non contigui, la raccolta intervalli riceve un intervallo di testo per ogni intervallo selezionato.
Se il controllo contiene solo un singolo intervallo di testo selezionato, la raccolta intervalli riceve un singolo intervallo di testo.
Se il controllo contiene un punto di inserimento di testo ma non è selezionato alcun testo, l'insieme intervalli riceve un intervallo di testo degenerato (vuoto) nella posizione del punto di inserimento del testo.
Se il controllo non contiene un punto di inserimento di testo o non supporta la selezione del testo, gli intervalli sono impostati su NULL.
Usare la proprietà IUIAutomationTextPattern::SupportedTextSelection per verificare se un controllo supporta la selezione del testo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | uiautomationclient.h (includere UIAutomation.h) |
Vedi anche
Automazione interfaccia utente supporto per il contenuto testuale