Condividi tramite


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

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:

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));
}

Informazioni concettuali

Cenni preliminari sugli eventi di automazione interfaccia utente

Ottenere elementi di automazione interfaccia utente