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:
- 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