funzione TextRange_GetText (uiautomationcoreapi.h)

Nota Questa funzione è deprecata. Le applicazioni client devono usare invece le interfacce COM (Component Object Model) di Microsoft Automazione interfaccia utente.

 

Restituisce il testo in un intervallo di testo, fino a un numero specificato di caratteri.

Sintassi

HRESULT TextRange_GetText(
  [in]  HUIATEXTRANGE hobj,
  [in]  int           maxLength,
  [out] BSTR          *pRetVal
);

Parametri

[in] hobj

Tipo: HUIATEXTRANGE

Oggetto intervallo di testo.

[in] maxLength

Tipo: int

Numero di caratteri da restituire, a partire dal carattere all'endpoint iniziale dell'intervallo di testo.

[out] pRetVal

Tipo: BSTR*

Quando questa funzione viene restituita, questo parametro contiene un puntatore al testo restituito. Questo parametro viene passato non inizializzato.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.

Commenti

Se maxLength è -1, viene restituito tutto il testo all'interno dell'intervallo di testo. Se maxLength è maggiore della lunghezza dell'intervallo di testo, la stringa restituita contiene tutto il testo nell'intervallo di testo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcoreapi.h
Libreria	Uiautomationcore.lib
DLL	Uiautomationcore.dll