Creazione dell'oggetto CUIAutomation

Questa sezione descrive come iniziare a scrivere un'applicazione client di Microsoft Automazione interfaccia utente creando un'istanza di un oggetto che implementa IUIAutomation.

In questo argomento sono contenute le sezioni seguenti.

• Oggetto CUIAutomation
• Creazione dell'oggetto
• Argomenti correlati

Oggetto CUIAutomation

Il primo passaggio dell'uso di Automazione interfaccia utente consiste nel creare un oggetto della classe CUIAutomation. Questo oggetto espone l'interfaccia IUIAutomation , ovvero il gateway a tutti gli altri oggetti e interfacce usati dalle applicazioni client. Tra le altre cose, IUIAutomation viene usato per le attività seguenti:

• Sottoscrizione di eventi.
• Creazione di condizioni. Le condizioni sono oggetti usati per restringere l'ambito delle ricerche per gli elementi Automazione interfaccia utente.
• Ottenere Automazione interfaccia utente elementi direttamente dal desktop (elemento radice) o dalle coordinate dello schermo o dagli handle delle finestre.
• Creazione di oggetti tree walker che possono essere usati per spostarsi nella gerarchia degli elementi Automazione interfaccia utente.
• Conversione dei tipi di dati.

Creazione dell'oggetto

Per iniziare a usare Automazione interfaccia utente nell'applicazione, seguire questa procedura:

• Includere UIAutomation.h nelle intestazioni del progetto. UIAutomation.h inserisce le altre intestazioni che definiscono l'API.
• Dichiarare un puntatore a IUIAutomation.
• Inizializzare il modello a oggetti componente (COM).
• Creare un'istanza di CUIAutomation e recuperare l'interfaccia IUIAutomation nel puntatore .

La funzione di esempio seguente inizializza COM e quindi crea l'oggetto CUIAutomation , recuperando l'interfaccia IUIAutomation nel puntatore ppAutomation .

#include <uiautomation.h>

// CoInitialize must be called before calling this function, and the  
// caller must release the returned pointer when finished with it.
// 
HRESULT InitializeUIAutomation(IUIAutomation **ppAutomation)
{
    return CoCreateInstance(CLSID_CUIAutomation, NULL,
        CLSCTX_INPROC_SERVER, IID_IUIAutomation, 
        reinterpret_cast<void**>(ppAutomation));
}

Argomenti correlati

Informazioni concettuali

Cenni preliminari sugli eventi di automazione interfaccia utente

Ottenere elementi di automazione interfaccia utente