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

Recupera un subconjunto de intervalo 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 intervalo de texto que se va a recuperar. Para obtener una lista de identificadores de atributo de texto, vea Identificadores de atributos 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 produjo 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 de 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

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista, Windows XP con SP3 y Platform Update 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

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