Implementera ett gränssnitt

För att implementera ett gränssnitt måste du ha skapat ett projekt som ett ATL COM-program eller som ett MFC-program som innehåller ATL-stöd. Du kan använda ATL-projektguiden för att skapa ett ATL-program eller lägga till ett ATL-objekt i MFC-programmet för att implementera ATL-stöd för ett MFC-program.

När du har skapat projektet måste du först lägga till ett ATL-objekt för att implementera ett gränssnitt. En lista över guider som lägger till objekt och kontroller i ditt ATL-projekt finns i Lägga till objekt och kontroller till ett ATL-projekt.

Anmärkning

Guiden stöder inte ATL-dialogrutor, XML-webbtjänster med ATL, prestandaobjekt eller prestandaräknare.

Om du lägger till en ATL-kontroll kan du ange om standardgränssnitt ska implementeras. Standardgränssnitten visas på sidan Gränssnitt i guiden och definieras i atlcom.h.

När du har lagt till objektet eller kontrollen kan du implementera andra gränssnitt som finns i alla tillgängliga typbibliotek med hjälp av guiden Implementera gränssnitt.

Om du lägger till ett nytt gränssnitt måste du lägga till det manuellt i projektets .idl-fil. Mer information finns i Lägga till ett nytt gränssnitt i ett ATL-projekt.

Så här implementerar du ett gränssnitt:

1. Högerklicka på klassnamnet för ATL-objektet i klassvyn.

2. Välj Lägg till på snabbmenyn och välj sedan Implementera gränssnitt för att visa guiden implementera gränssnitt.

3. Välj de gränssnitt som ska implementeras från lämpliga typbibliotek och välj Slutför.

4. I klassvyn expanderar du objektets nod Baser och gränssnitt för att se gränssnittet som du har implementerat. Expandera sedan gränssnittets nod för att se dess tillgängliga egenskaper, metoder och händelser.

   Anmärkning

   Du kan också använda objektwebbläsaren för att undersöka medlemmarna i gränssnittet.

I det här avsnittet

• Guiden Implementera gränssnitt

Implementera gränssnittsguide

Den här guiden implementerar ett gränssnitt för ett COM-objekt. Implementeringar av många gränssnitt ingår i COM-biblioteken som är tillgängliga med Visual Studio och Windows. En gränssnittsimplementering associeras med ett objekt när en instans av objektet skapas. Den tillhandahåller även de tjänster som objektet erbjuder.

En diskussion om gränssnitt och implementeringar finns i Gränssnitt och gränssnittsimplementeringar i Windows SDK.

• Implementera gränssnitt från

  Anger platsen för typbiblioteket som gränssnittet skapas från.

  Alternativ	Beskrivning
  Projekt	Typbiblioteket är en del av projektet.
  Register	Typbiblioteket är registrerat i systemet. Registrerade typbibliotek visas i Bibliotek av tillgänglig typ.
  Arkiv	Typbiblioteket är inte nödvändigtvis registrerat i systemet utan lagras i en fil. Ange filplatsen i Plats.

• Tillgängliga typbibliotek

  Visar de tillgängliga typbiblioteken med de gränssnittsdefinitioner som du kan implementera. Om du väljer Fil under Implementera gränssnitt från är den här rutan inte tillgänglig för ändring.

• Läge

  Visar platsen för det typbibliotek som för närvarande är markerat i listan Tillgängliga typbibliotek . Om du har valt Fil under Implementera gränssnitt från väljer du ellipsknappen för att hitta en fil som innehåller typbiblioteket som ska användas.

• Gränssnitt

  Visar de gränssnitt vars definitioner finns i det typbibliotek som för närvarande är markerat i rutan Tillgängliga typbibliotek .

  Anmärkning

  Gränssnitt som har samma namn som de som redan implementerats av det valda objektet visas inte i rutan Gränssnitt .

  Överför-knappen	Beskrivning
  >	Lägger till gränssnittsnamnet som för närvarande är valt i listan Gränssnitt till listan Implementera gränssnitt.
  >>	Lägger till i listan Implementera gränssnitt alla gränssnittsnamn som är tillgängliga i listan Gränssnitt .
  <	Tar bort det gränssnittsnamn som för närvarande har valts i listan Implementera gränssnitt .
  <<	Tar bort alla gränssnittsnamn som för närvarande visas i listan Implementera gränssnitt .

• Implementera gränssnitt

  Visar namnen på de gränssnitt som du har valt att implementera på objektet.

  Anmärkning

  Om du inkluderar fler än ett gränssnitt som härleds från IDispatch, eller om du försöker implementera ett gränssnitt som är härlett från ett annat gränssnitt som redan finns i din klass, måste du tydliggöra COM_MAP-posterna. Mer information finns i COM_INTERFACE_ENTRY2.