Metodo ITextRangeProvider::GetText (uiautomationcore.h)

Recupera il testo normale dell'intervallo.

Sintassi

HRESULT GetText(
  [in]          int  maxLength,
  [out, retval] BSTR *pRetVal
);

Parametri

[in] maxLength

Tipo: int

Lunghezza massima della stringa da restituire. Usare -1 se non è richiesto alcun limite.

[out, retval] pRetVal

Tipo: BSTR*

Riceve il testo normale dell'intervallo di testo, possibilmente troncato alla lunghezza massima specificata. 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

ITextRangeProvider::GetText recupera sia testo nascosto che visibile.

Se maxLength è maggiore della lunghezza dell'intervallo di testo del chiamante, la stringa restituita sarà il testo normale dell'intervallo di testo.

ITextRangeProvider::GetText non sarà interessato dall'ordine degli endpoint nel flusso di testo; restituirà sempre il testo tra gli endpoint iniziale e finale dell'intervallo di testo nell'ordine del flusso di testo logico.

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)

Vedi anche

Informazioni concettuali

ITextProvider

ITextRangeProvider

Riferimento

Cenni preliminari sui provider di automazione interfaccia utente