Metodo IItemContainerProvider::FindItemByProperty (uiautomationcore.h)

Recupera un elemento all'interno di un elemento contenitore, in base a un valore di proprietà specificato.

Sintassi

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

Parametri

[in] pStartAfter

Tipo: IRawElementProviderSimple*

Provider Automazione interfaccia utente dell'elemento dopo il quale inizia la ricerca o NULL per eseguire la ricerca in tutti gli elementi.

[in] propertyId

Tipo: PROPERTYID

Identificatore della proprietà. Per un elenco degli ID delle proprietà, vedere Identificatori di proprietà.

[in] value

Tipo: VARIANT

Valore della proprietà.

[out] pFound

Tipo: IRawElementProviderSimple**

Riceve un puntatore al provider Automazione interfaccia utente dell'elemento.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per gli elenchi virtuali, l'elemento restituito può essere un segnaposto. IVirtualizedItemProvider::Realize può quindi essere usato per rendere l'elemento completamente disponibile.

Il metodo restituisce E_INVALIDARG se la ricerca tramite la proprietà specificata non è supportata. La maggior parte dei contenitori deve supportare UIA_NamePropertyId e, se appropriato, UIA_AutomationIdPropertyId e UIA_SelectionItemIsSelectedPropertyId.

Se propertyId è 0, tutti gli elementi corrispondono. Questo valore può essere usato con pStartAfter uguale a NULL per ottenere il primo elemento e quindi per ottenere elementi successivi. In questo caso, il valore deve essere VT_EMPTY.

Requisiti

Vedi anche

Informazioni concettuali

IItemContainerProvider

Identificatori di proprietà

Riferimento