Přidání ovládacího prvku (ATL – tutoriál, část 2)
V tomto kroku přidáte do projektu ovládací prvek, sestavíte ho a otestujete na webové stránce.
Procedury
Přidání objektu do projektu ATL
V Průzkumník řešení klikněte pravým tlačítkem myši na
Polygonprojekt.Přejděte na příkaz Přidat v místní nabídce a v podnabídce klikněte na Nová položka .
Zobrazí se dialogové okno Přidat novou položku. Různé kategorie objektů jsou uvedeny ve stromové struktuře vlevo.
Klikněte na složku ATL .
V seznamu šablon napravo vyberte ovládací prvek ATL. Klikněte na tlačítko Přidat. Otevře se průvodce ovládacími prvky ATL a můžete ho nakonfigurovat.
Zadejte
PolyCtljako krátký název a všimněte si, že ostatní pole se automaticky dokončí. Ještě neklikejte na Dokončit , protože musíte udělat nějaké další změny.
Stránka Názvy ovládacího prvku ATL obsahuje následující pole:
| Pole | Obsah |
|---|---|
| Krátký název | Název, který jste zadali pro ovládací prvek. |
| Třída | Název třídy C++ vytvořený pro implementaci ovládacího prvku. |
| Soubor .h | Soubor vytvořený tak, aby obsahoval definici třídy C++. |
| .cpp soubor | Soubor vytvořený tak, aby obsahoval implementaci třídy C++. |
| Třída třídy CoClass | Název třídy komponenty pro tento ovládací prvek. |
| Rozhraní | Název rozhraní, na kterém bude ovládací prvek implementovat vlastní metody a vlastnosti. |
| Typ | Popis ovládacího prvku |
| ID progID | Čitelný název, který lze použít k vyhledání CLSID ovládacího prvku. |
V průvodci ovládacím prvek ATL je potřeba změnit několik dalších nastavení.
Povolení podpory bohatých informací o chybách a spojovacích bodů
Kliknutím na Možnosti otevřete stránku Možnosti .
Zaškrtněte políčko Spojovací body. Tato možnost vytvoří podporu pro odchozí rozhraní v souboru IDL.
Můžete také přidat rozhraní pro rozšíření funkčnosti ovládacího prvku.
Rozšíření funkčnosti ovládacího prvku
Kliknutím na Rozhraní otevřete stránku Rozhraní .
Vyberte
IProvideClassInfo2šipku nahoru a přesuňte ji do seznamu Podporované .Vyberte
ISpecifyPropertyPagesšipku nahoru a přesuňte ji do seznamu Podporované .
Ovládací prvek můžete vložit také, což znamená, že je vložený do aplikací, které podporují vložené objekty, jako je Excel nebo Word.
Postup vložení ovládacího prvku
Kliknutím na Vzhled otevřete stránku Vzhled .
Zaškrtněte políčko Vložitelné.
Mnohoúhelník zobrazený objektem bude mít plnou barvu výplně, takže musíte přidat akciovou Fill Color vlastnost.
Přidání vlastnosti Barva výplně a vytvoření ovládacího prvku
Kliknutím na Vlastnosti akcií otevřete stránku Vlastnosti akcie.
V části Nepodporováno se posuňte dolů seznam možných vlastností akcií. Vyberte
Fill Coloršipku nahoru a přesuňte ji do seznamu Podporované .Zvolte Dokončit.
Průvodce vytvoří ovládací prvek, dojde k několika změnám kódu a přidání souborů. Vytvoří se následující soubory:
| Soubor | Popis |
|---|---|
| PolyCtl.h | Obsahuje většinu implementace třídy CPolyCtlC++ . |
| PolyCtl.cpp | Obsahuje zbývající části .CPolyCtl |
| PolyCtl.rgs | Textový soubor, který obsahuje skript registru použitý k registraci ovládacího prvku. |
| PolyCtl.htm | Webová stránka obsahující odkaz na nově vytvořený ovládací prvek. |
Průvodce také provede následující změny kódu:
#includePřidá příkaz do předkompilovaných hlavičkových souborů, aby zahrnoval soubory ATL nezbytné pro podpůrné ovládací prvky.Změní Polygon.idl tak, aby obsahoval podrobnosti o novém ovládacím prvku.
Přidá nový ovládací prvek do mapy objektů v Polygon.cpp.
Teď můžete ovládací prvek sestavit, abyste ho viděli v akci.
Sestavení a testování ovládacího prvku
Sestavení a otestování ovládacího prvku
V nabídce Sestavení klepněte na příkaz Sestavit mnohoúhelník.
Po dokončení vytváření ovládacího prvku klikněte pravým tlačítkem na PolyCtl.htm v Průzkumník řešení a vyberte Zobrazit v prohlížeči. Zobrazí se webová stránka HTML obsahující ovládací prvek. Měla by se zobrazit stránka s názvem "ATL 8.0 test page for object PolyCtl" (Testovací stránka ATL 8.0 pro objekt PolyCtl) a text PolyCtl.
Poznámka:
Pokud ovládací prvek není viditelný, nezapomeňte, že některé prohlížeče vyžadují úpravy nastavení pro spuštění ovládacích prvků ActiveX. Informace o povolení ovládacích prvků ActiveX najdete v dokumentaci prohlížeče.
Poznámka:
Pokud se při dokončení tohoto kurzu zobrazí chybová zpráva, že soubor DLL nelze vytvořit, zavřete soubor PolyCtl.htm a kontejner ActiveX Control Test a znovu sestavte řešení. Pokud stále nemůžete vytvořit knihovnu DLL, restartujte počítač nebo se odhlaste, pokud používáte Terminálové služby.
Dále do ovládacího prvku přidáte vlastní vlastnost.