Dela via

Lägga till en kontroll (ATL-självstudie, del 2)

I det här steget lägger du till en kontroll i projektet, skapar den och testar den på en webbsida.

Förfaranden

Så här lägger du till ett objekt i ett ATL-projekt

  1. Högerklicka på projektet i Polygon.

  2. Peka på Lägg till på snabbmenyn och klicka på Nytt objekt i undermenyn.

    Dialogrutan Lägg till nytt objekt visas. De olika objektkategorierna visas i trädstrukturen till vänster.

  3. Klicka på ATL-mappen .

  4. I listan över mallar till höger väljer du ATL-kontroll. Klicka på Lägg till. ATL-kontrollguiden öppnas och du kan konfigurera kontrollen.

  5. Skriv PolyCtl som det korta namnet och observera att de andra fälten slutförs automatiskt. Klicka inte på Slutför ännu, eftersom du måste göra några fler ändringar.

Sidan Namn på ATL-kontrollguiden innehåller följande fält:

Fält Innehåll
Kort namn Det namn som du angav för kontrollen.
Klass C++-klassnamnet som skapades för att implementera kontrollen.
.h-fil Filen som skapats för att innehålla definitionen av klassen C++.
.cpp-filen Filen som skapats för att innehålla implementeringen av C++-klassen.
CoClass Namnet på komponentklassen för den här kontrollen.
Gränssnitt Namnet på gränssnittet där kontrollen implementerar sina anpassade metoder och egenskaper.
Typ En beskrivning av kontrollen.
ProgID Det läsbara namn som kan användas för att slå upp kontrollens CLSID.

Du hittar flera ytterligare inställningar som måste ändras i ATL-kontrollguiden .

Så här aktiverar du stöd för omfattande felinformation och anslutningspunkter

  1. Klicka på Alternativ för att öppna sidan Alternativ .

  2. Markera kryssrutan Anslutningspunkter . Det här alternativet skapar stöd för ett utgående gränssnitt i IDL-filen.

Du kan också lägga till gränssnitt för att utöka kontrollens funktioner.

Utöka kontrollens funktioner

  1. Klicka på Gränssnitt för att öppna sidan Gränssnitt .

  2. Välj IProvideClassInfo2 och klicka på uppåtpilen för att flytta den till listan Som stöds .

  3. Välj ISpecifyPropertyPages och klicka på uppåtpilen för att flytta den till listan Som stöds .

Du kan också göra kontrollen infogad, vilket innebär att den kan bäddas in i program som stöder inbäddade objekt, till exempel Excel eller Word.

För att göra kontrollen infogbar

  1. Klicka på Utseende för att öppna sidan Utseende .

  2. Markera kryssrutan Infogningsbar .

Polygonen som visas av objektet har en fast fyllningsfärg, så du måste lägga till en Fill Color lageregenskap.

Så här lägger du till en fyllningsfärgsegenskap och skapar kontrollen

  1. Klicka på Lageregenskaper för att öppna sidan Lageregenskaper .

  2. Under Stöds inte rullar du ned listan över möjliga lageregenskaper. Välj Fill Color och klicka på uppåtpilen för att flytta den till listan Som stöds .

  3. Välj Slutför.

När guiden skapar kontrollen sker flera kodändringar och filtillägg. Följande filer skapas:

Fil Beskrivning
PolyCtl.h Innehåller det mesta av implementeringen av C++-klassen CPolyCtl.
PolyCtl.cpp Innehåller de återstående delarna av CPolyCtl.
PolyCtl.rgs En textfil som innehåller registerskriptet som används för att registrera kontrollen.
PolyCtl.htm En webbsida som innehåller en referens till den nyligen skapade kontrollen.

Guiden gör också följande kodändringar:

  • Lägger till ett #include uttalande i de förkompilerade huvudfilerna för att inkludera de ATL-filer som behövs för att stödja kontroller.

  • Ändrar Polygon.idl så att den innehåller information om den nya kontrollen.

  • Lägger till den nya kontrollen på objektkartan i Polygon.cpp.

Nu kan du skapa kontrollen för att se den i praktiken.

Skapa och testa kontrollen

Skapa och testa kontrollen

  1. På menyn Skapa klickar du på Skapa polygon.

    När kontrollen har skapats högerklickar du på PolyCtl.htm i Solution Explorer och väljer Visa i webbläsare. HTML-webbsidan som innehåller kontrollen visas. Du bör se en sida med rubriken "ATL 8.0 testsida för objektet PolyCtl" och din kontroll, texten PolyCtl.

Anmärkning

Om kontrollen inte visas vet du att vissa webbläsare kräver inställningsjusteringar för att köra ActiveX-kontroller. Läs webbläsarens dokumentation om hur du aktiverar ActiveX-kontroller.

Anmärkning

När du slutför den här självstudien, om du får ett felmeddelande om att DLL-filen inte kan skapas, stänger du filen PolyCtl.htm och containern ActiveX Control Test och skapar lösningen igen. Om du fortfarande inte kan skapa DLL:en startar du om datorn eller loggar ut om du använder Terminal Services.

Därefter lägger du till en anpassad egenskap i kontrollen.

Tillbaka till steg 1 | Vidare till steg 3

Se även

Handledning