Método IUIAutomationItemContainerPattern::FindItemByProperty (uiautomationclient.h)

Recupera un elemento dentro de un elemento contenedor, basado en un valor de propiedad especificado.

Sintaxis

HRESULT FindItemByProperty(
  [in]          IUIAutomationElement *pStartAfter,
  [in]          PROPERTYID           propertyId,
  [in]          VARIANT              value,
  [out, retval] IUIAutomationElement **pFound
);

Parámetros

[in] pStartAfter

Tipo: IUIAutomationElement*

Puntero al elemento después del cual comienza la búsqueda o NULL para buscar todos los elementos.

[in] propertyId

Tipo: PROPERTYID

Identificador de propiedad. Para obtener una lista de identificadores de propiedad, vea Identificadores de propiedad.

[in] value

Tipo: VARIANT

Valor de propiedad.

[out, retval] pFound

Tipo: IUIAutomationElement**

Recibe un puntero al elemento coincidente.

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 proveedor puede devolver una interfaz IUIAutomationElement real o un marcador de posición si el elemento coincidente está virtualizado.

Este método devuelve E_INVALIDARG si la propiedad solicitada no es la que el contenedor admite la búsqueda. Se espera que la mayoría de los contenedores admitan la propiedad Name y, si procede, para el contenedor, AutomationId e IsSelected.

Este método puede ser lento, ya que puede que tenga que atravesar varios objetos para encontrar uno coincidente. Cuando se usa en un bucle para devolver varios elementos, no se define ningún orden específico siempre que cada elemento se devuelva solo una vez (es decir, el bucle debe finalizar). Este método también está centrado en elementos, no centrado en la interfaz de usuario, por lo que los elementos con varias representaciones de interfaz de usuario solo deben alcanzarse una vez.

Cuando el parámetro propertyId se especifica como 0 (cero), se espera que el proveedor devuelva el siguiente elemento después de pStartAfter. Si pStartAfter se especifica como NULL con un propertyId de 0, el proveedor debe devolver el primer elemento del contenedor. Cuando se especifica propertyId como 0, el parámetro value debe ser VT_EMPTY.

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

IUIAutomationItemContainerPattern

Darse cuenta de

Referencia