Método IItemContainerProvider::FindItemByProperty (uiautomationcore.h)

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

Sintaxis

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

Parámetros

[in] pStartAfter

Tipo: IRawElementProviderSimple*

Proveedor Automatización de la interfaz de usuario del 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 la propiedad.

[out] pFound

Tipo: IRawElementProviderSimple**

Recibe un puntero al proveedor Automatización de la interfaz de usuario del elemento.

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

Para las listas virtuales, el elemento devuelto puede ser un marcador de posición. IVirtualizedItemProvider::Realize se puede usar para que el elemento esté totalmente disponible.

El método devuelve E_INVALIDARG si no se admite la búsqueda por la propiedad especificada. La mayoría de los contenedores deben admitir UIA_NamePropertyId y, si procede, UIA_AutomationIdPropertyId y UIA_SelectionItemIsSelectedPropertyId.

Si propertyId es 0, todos los elementos son una coincidencia. Este valor se puede usar con pStartAfter equalling NULL para obtener el primer elemento y, a continuación, para obtener elementos sucesivos. En este caso, el valor debe ser VT_EMPTY.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista, Windows XP con SP3 y Actualización de plataforma para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Platform Update para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	uiautomationcore.h (include UIAutomation.h)
Archivo DLL	Uiautomationcore.dll

Consulte también

Conceptual

IItemContainerProvider

Identificadores de propiedad

Referencia