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

  • Artículo

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

Sintaxis

HRESULT GetAttributeValue(
  [in]          TEXTATTRIBUTEID attributeId,
  [out, retval] VARIANT         *pRetVal
);

Parámetros

[in] attributeId

Tipo: TEXTATTRIBUTEID

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

[out, retval] pRetVal

Tipo: VARIANT*

Recibe uno de los siguientes.

  • Dirección de un objeto que representa el valor del atributo especificado. El tipo de datos del valor varía en función del atributo especificado. Por ejemplo, si attributeId es UIA_FontNameAttributeId, GetAttributeValue devuelve una cadena que representa el nombre de fuente del intervalo de texto, pero si attributeId es UIA_IsItalicAttributeId, GetAttributeValue devuelve un valor booleano.
  • Dirección del valor recuperado por la función UiaGetReservedMixedAttributeValue , si el valor del atributo especificado varía en el intervalo de texto.
  • Dirección del valor recuperado por la función UiaGetReservedNotSupportedValue , si el proveedor o el control no admiten el atributo especificado.
Este parámetro se pasa sin inicializar.

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 GetAttributeValue debe recuperar el valor del atributo independientemente de si el texto está oculto o visible.

Requisitos

   
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 (include UIAutomation.h)

Consulte también

Conceptual

ITextProvider

ITextRangeProvider

Referencia

Información general sobre proveedores de UI Automation