Metodo IUIAutomationElement::GetCurrentPattern (uiautomationclient.h)

Articolo
08/26/2023

Recupera l'interfaccia IUnknown del pattern di controllo specificato in questo elemento Automazione interfaccia utente.

Sintassi

HRESULT GetCurrentPattern(
  [in]          PATTERNID patternId,
  [out, retval] IUnknown  **patternObject
);

Parametri

[in] patternId

Tipo: PATTERNID

Identificatore del pattern di controllo da recuperare. Per un elenco degli ID dei pattern di controllo, vedere Identificatori del pattern di controllo.

[out, retval] patternObject

Tipo: IUnknown**

Riceve un puntatore a un'interfaccia IUnknown .

Valore restituito

Tipo: HRESULT

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

Commenti

Questo metodo ottiene il pattern di controllo specificato in base alla disponibilità al momento della chiamata.

Per alcune forme di interfaccia utente, questo metodo comporta un sovraccarico delle prestazioni tra processi. Le applicazioni possono ridurre il sovraccarico memorizzando nella cache i pattern di controllo e recuperandoli usando IUIAutomationElement::GetCachedPattern.

Requisiti


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)