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

Consulte también

IUIAutomationTextRange

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