Metodo IUIAutomationItemContainerPattern::FindItemByProperty (uiautomationclient.h)

  • Articolo

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

Sintassi

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

Parametri

[in] pStartAfter

Tipo: IUIAutomationElement*

Puntatore all'elemento dopo il quale inizia la ricerca o NULL per cercare 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, retval] pFound

Tipo: IUIAutomationElement**

Riceve un puntatore all'elemento corrispondente.

Valore restituito

Tipo: HRESULT

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

Commenti

Il provider può restituire un'interfaccia IUIAutomationElement effettiva o un segnaposto se l'elemento corrispondente è virtualizzato.

Questo metodo restituisce E_INVALIDARG se la proprietà richiesta non è quella supportata dalla ricerca nel contenitore. È previsto che la maggior parte dei contenitori supporti la proprietà Name e, se appropriata per il contenitore, AutomationId e IsSelected.

Questo metodo può essere lento, perché potrebbe essere necessario attraversare più oggetti per trovarne uno corrispondente. Se usato in un ciclo per restituire più elementi, non viene definito alcun ordine specifico, purché ogni elemento venga restituito una sola volta , ovvero il ciclo deve terminare. Questo metodo è anche incentrato sugli elementi, non incentrato su interfaccia utente, quindi gli elementi con più rappresentazioni dell'interfaccia utente devono essere raggiunti una sola volta.

Quando il parametro propertyId viene specificato come 0 (zero), il provider dovrebbe restituire l'elemento successivo dopo pStartAfter. Se pStartAfter viene specificato come NULL con un propertyId pari a 0, il provider deve restituire il primo elemento nel contenitore. Quando propertyId viene specificato come 0, il parametro value deve essere VT_EMPTY.

Requisiti

Requisito Valore
Client minimo supportato Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione uiautomationclient.h (include UIAutomation.h)

Vedi anche

IUIAutomationItemContainerPattern

Realizzare

Riferimento