Método IUIAutomationTextRange::FindAttribute (uiautomationclient.h)

Recupera un subconjunto de intervalos de texto que tiene el valor de atributo de texto especificado.

Sintaxis

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

Parámetros

[in] attr

Tipo: TEXTATTRIBUTEID

Identificador del atributo de texto del subconjunto de intervalos de texto que se va a recuperar. Para obtener una lista de identificadores de atributo de texto, consulte Identificadores de atributo de texto.

[in] val

Tipo: VARIANT

El valor del atributo. Este valor debe coincidir con el tipo especificado para el atributo.

[in] backward

Tipo: BOOL

TRUE si se debe devolver el último intervalo de texto que se produce en lugar del primero; en caso contrario , FALSE.

[out, retval] found

Tipo: IUIAutomationTextRange**

Recibe un puntero al intervalo de texto que tiene un atributo y un valor de atributo coincidentes; en caso contrario , NULL.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

El método FindAttribute recupera texto coincidente independientemente de si el texto está oculto o visible. Use UIA_IsHiddenAttributeId para comprobar la visibilidad del texto.

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista, Windows XP con SP3 y Actualización de plataforma para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomationTextRange

Automatización de la interfaz de usuario compatibilidad con contenido textual