Sdílet prostřednictvím

Průvodce ovládacím prvkem knihovny ATL

  • Článek

Vloží do projektu knihovny ATL (nebo projektu knihovny MFC s podporou ATL) ovládací prvek knihovny ATL. Pomocí tohoto průvodce lze vložit tři typy ovládacích prvků:

  • Standardní ovládací prvek

  • Složený ovládací prvek

  • Ovládací prvek DHTML

Navíc lze nastavit minimální ovládací prvek odebráním rozhraní ze seznamu Rozhraní, ve kterém jsou k dispozici výchozí rozhraní pro ovládací prvky pro otevření ve většině kontejnerů. Rozhraní podporována ovládacím prvkem lze nastavit na stránce průvodce Rozhraní.

Poznámky

Registračního skript vytvořený tímto průvodcem bude registrovat jeho komponenty COM pod HKEY_CURRENT_USER namísto HKEY_LOCAL_MACHINE. Chcete-li toto chování změnit, nastavte možnost Register component for all users v Průvodci knihovnou ATL.

Názvy

Zadejte názvy pro objekt, rozhraní a třídy které mají být přidány do projektu. S výjimkou pole Krátký název lze všechna ostatní pole měnit nezávisle. Pokud změníte text pole Krátký název, změny se projeví v názvech všech polí na této stránce. Pokud změníte název Coclass v oddíle modelu COM, změny se projeví v políčku Typ, nezmění se však název Rozhraní a ProgID. Toto chování je navrženo proto, aby bylo možné všechny názvy snadno identifikovat během vývoje ovládacího prvku.

Poznámka

Coclass je upravovatelná pouze v neatributových ovládacích prvcích. Je-li váš projekt označen atributy, nelze upravovat Coclass.

C++

Poskytuje informace třídě C++ implementující vytvořený objekt.

  • Krátký název
    Nastaví zkrácený název pro objekt. Pokud tyto položky nezměníte individuálně, určuje zadaný název názvy třídy a Coclass, názvy souborů (.CPP a .H), název rozhraní, a název Typů.

  • Třída
    Nastaví název třídy, která implementuje objekt. Tento název je založen na názvu, který zadáte v Krátký název, předcházený C, což je typický prefix pro název třídy.

  • h souboru
    Nastaví název souboru hlaviček pro novou třídu objektu. Ve výchozím nastavení je tento název založen na názvu, který zadáte v Krátký název. Kliknutím na tlačítko se třemi tečkami uložíte soubor do umístění dle vlastního výběru nebo připojíte deklaraci třídy do existujícího souboru. Vyberete-li existující soubor, průvodce jej neuloží do vybraného umístění, dokud nekliknete na tlačítko Dokončit.

    Průvodce soubor nepřepíše. Pokud jste zvolili název existujícího souboru, kliknete-li na Dokončit, průvodce vás vyzve k označení, zda by měl deklaraci třídy přiložit k obsahu souboru. Klikněte na tlačítko Ano pro připojení k souboru; klikněte na tlačítko Ne pro návrat do průvodce, a zadejte jiný název souboru.

  • soubor cpp
    Nastaví název implementačního souboru pro novou třídu objektu. Ve výchozím nastavení je tento název je založen na názvu, který zadáte v Krátký název. Klikněte na tlačítko se třemi tečkami pro uložení souboru do umístění dle vlastního výběru. Soubor není uložen do vybraného umístění, dokud nekliknete na tlačítko Dokončit v průvodci.

    Průvodce soubor nepřepíše. Pokud jste zvolili název existujícího souboru, kliknete-li na Dokončit, průvodce vás vyzve k označení, zda by měl implementaci třídy přiložit k obsahu souboru. Klikněte na tlačítko Ano pro připojení k souboru; klikněte na tlačítko Ne pro návrat do průvodce a zadejte jiný název souboru.

  • Atributový
    Označuje, zda objekt používá atributy. Přidáváte-li objekt do projektu knihovny ATL s atributy, tato možnost je zaškrtnuta a není ji možné změnit. To znamená, že můžete přidat pouze objekty s atributy do projektu vytvořeného s podporou atributu.

    Přidělený objekt můžete přidat pouze pro projekt knihovny ATL používající atributy. Pokud vyberete tuto možnost pro projekt knihovny ATL, který nemá podporu atributů, průvodce vyzve k upřesnění, zda chcete přidat podporu atributů do projektu.

    Ve výchozím nastavení, všechny objekty, které přidáte po nastavení této možnosti, jsou označeny jako atributové (zaškrtávací políčko je vybráno). Můžete zrušit zaškrtnutí tohoto políčka pro přidání objektu, který nepoužívá atributy.

    Pro další informace navštivte Nastavení aplikace, Průvodce projektu knihovny ATL nebo Základní mechanismy atributů.

COM

Poskytuje informace o funkcích modelu COM pro objekt.

  • Coclass
    Nastaví název třídy komponenty, která obsahuje seznam podporovaných rozhraní objektu.

    Poznámka

    Pokud jste vytvořili váš projekt pomocí atributů nebo pokud jste uvedli na stránce průvodce, že objekt používá atributy, nemůžete tuto možnost změnit, protože knihovna ATL nezahrnuje atribut coclass.

  • Rozhraní
    Nastaví název rozhraní pro objekt. Ve výchozím nastavení začíná název rozhraní „I".

  • Typ
    Nastaví popis objektu, který se zobrazí v registru.

  • ProgID
    Nastaví název, který mohou kontejnery použít pro objekt namísto identifikátoru CLSID. V aplikaci Microsoft Visual C++ 2010 není toto pole automaticky vyplněno. Pokud toto pole nevyplníte ručně, nemusí být ovládací prvek k dispozici pro jiné nástroje. Například ovládací prvky ActiveX, které jsou generovány bez ProgID, nejsou k dispozici v dialogovém okně Vložení ovládacího prvku ActiveX. Další informace o tomto dialogovém okně naleznete v tématu Insert ActiveX Control Dialog Box.

Viz také

Úkoly

Přidání ovládacího prvku knihovny ATL

Odkaz

Fundamentals of ATL COM Objects

Koncepty

Adding Functionality to the Composite Control