Dela via

Skapa CUIAutomation-objektet

I det här avsnittet beskrivs hur du kommer igång med att skriva ett Microsoft UI Automation-klientprogram genom att instansiera ett objekt som implementerar IUIAutomation.

Det här avsnittet innehåller följande avsnitt.

CUIAutomation-objektet

Det första steget i att använda UI Automation är att skapa ett objekt i klassen CUIAutomation. Det här objektet exponerar IUIAutomation--gränssnittet, som är gatewayen till alla andra objekt och gränssnitt som används av klientprogram. Bland annat används IUIAutomation för följande uppgifter:

  • Prenumerera på händelser.
  • Skapa förutsättningar. Villkor är objekt som används för att begränsa sökomfånget för UI Automation-element.
  • Hämta UI Automation-element direkt från skrivbordet (rotelementet) eller från skärmkoordinater eller fönsterhandtag.
  • Skapa Tree Walker-objekt som kan användas för att navigera i hierarkin av UI Automation-elementen.
  • Konvertering av datatyper.

Skapa objektet

Kom igång med UI Automation i ditt program genom att utföra följande steg:

  • Inkludera UIAutomation.h i projektrubrikerna. UIAutomation.h innehåller de andra rubrikerna som definierar API:et.
  • Deklarera en pekare till IUIAutomation.
  • Initiera komponentobjektmodellen (COM).
  • Skapa en instans av CUIAutomation och hämta gränssnittet IUIAutomation i pekaren.

Följande exempelfunktion initierar COM och skapar sedan objektet CUIAutomation och hämtar gränssnittet IUIAutomation i ppAutomation pekaren.

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

konceptuell

översikt över UI Automation-händelser

Att Hämta UI-automatiseringselement