Metodo IUIAutomationTextRange::FindAttribute (uiautomationclient.h)

  • Articolo

Recupera un subset dell'intervallo di testo con il valore dell'attributo di testo specificato.

Sintassi

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID        attr,
  [in]          VARIANT                val,
  [in]          BOOL                   backward,
  [out, retval] IUIAutomationTextRange **found
);

Parametri

[in] attr

Tipo: TEXTATTRIBUTEID

Identificatore dell'attributo di testo per il subset dell'intervallo di testo recuperato. Per un elenco di ID attributo di testo, vedere Identificatori di attributo di testo.

[in] val

Tipo: VARIANT

Valore dell'attributo. Questo valore deve corrispondere al tipo specificato per l'attributo.

[in] backward

Tipo: BOOL

TRUE se l'ultimo intervallo di testo deve essere restituito anziché il primo; in caso contrario FALSE.

[out, retval] found

Tipo: IUIAutomationTextRange**

Riceve un puntatore all'intervallo di testo con un attributo e un valore di attributo corrispondenti; altrimenti NULL.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il metodo FindAttribute recupera il testo corrispondente indipendentemente dal fatto che il testo sia nascosto o visibile. Usare UIA_IsHiddenAttributeId per controllare la visibilità 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

IUIAutomationTextRange

Automazione interfaccia utente supporto per il contenuto testuale