Método ITextRangeProvider::FindAttribute (uiautomationcore.h)

Artículo
08/26/2023

Devuelve un subconjunto de intervalo de texto que tiene el valor de atributo de texto especificado.

Sintaxis

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID    attributeId,
  [in]          VARIANT            val,
  [in]          BOOL               backward,
  [out, retval] ITextRangeProvider **pRetVal
);

Parámetros

[in] attributeId

Tipo: TEXTATTRIBUTEID

Identificador del atributo de texto. Para obtener una lista de identificadores de atributo de texto, vea Identificadores de atributos de texto.

[in] val

Tipo: VARIANT

Valor del atributo que se debe buscar. 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] pRetVal

Tipo: ITextRangeProvider**

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. Los clientes pueden usar UIA_IsHiddenAttributeId para comprobar la visibilidad del texto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	uiautomationcore.h (incluir UIAutomation.h)