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
Referencia