Compartir a través de

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

  • Artículo

Recupera el valor del atributo de texto especificado en todo el intervalo de texto.

Sintaxis

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attr,
  [out, retval] VARIANT         *value
);

Parámetros

[in] attr

Tipo: TEXTATTRIBUTEID

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

[out, retval] value

Tipo: VARIANT*

Recibe el valor del atributo especificado.

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 tipo de valor recuperado por este método depende del parámetro attr . Por ejemplo, al llamar a GetAttributeValue con el parámetro attr establecido en UIA_FontNameAttributeId devuelve una cadena que representa el nombre de fuente del intervalo de texto, mientras que llamar a GetAttributeValue con attr establecido enUIA_IsItalicAttributeId devolvería un valor booleano.

Si no se admite el atributo especificado por attr , el parámetro value recibe un valor equivalente a la propiedad IUIAutomation::ReservedNotSupportedValue .

Un intervalo de texto puede incluir más de un valor para un atributo determinado. Por ejemplo, si un intervalo de texto incluye más de una fuente, el atributo FontName tendrá varios valores. Un atributo con más de un valor se denomina atributo mixto. Puede determinar si un atributo determinado es un atributo mixto comparando el valor recuperado de GetAttributeValue con la propiedad UIAutomation::ReservedMixedAttributeValue .

El método GetAttributeValue recupera el valor del atributo 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 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