Kreator kontrolki ATL

Wstawia do projektu ATL (lub projektu MFC z obsługą ATL) kontrolkę ATL. Za pomocą tego kreatora można wstawić jeden z trzech rodzajów kontrolek:

• Kontrolka Standardowa

• Kontrolka złożona

• Kontrolka DHTML

Ponadto można określić minimalną kontrolkę, usuwając interfejsy z listy Interfejsy , które są udostępniane jako wartości domyślne dla kontrolek do otwierania w większości kontenerów. Interfejsy, które mają być obsługiwane dla kontrolki, można ustawić na stronie Interfejsy kreatora.

Uwagi

Skrypt rejestracji utworzony przez tego kreatora zarejestruje składniki COM w HKEY_CURRENT_USER zamiast HKEY_LOCAL_MACHINE. Aby zmodyfikować to zachowanie, ustaw opcję Zarejestruj składnik dla wszystkich użytkowników Kreatora ATL.

Nazwy

Określ nazwy obiektu, interfejsu i klas, które mają zostać dodane do projektu. Z wyjątkiem krótkiej nazwy wszystkie inne pola można zmienić niezależnie. Jeśli zmienisz tekst krótkiej nazwy, zmiana zostanie odzwierciedlona w nazwach wszystkich innych pól na tej stronie. Jeśli zmienisz nazwę coclass w sekcji COM, zmiana zostanie odzwierciedlona w polu Typ , ale nazwa interfejsu i identyfikator progID nie zostaną zmienione. To zachowanie nazewnictwa zostało zaprojektowane tak, aby wszystkie nazwy można było łatwo rozpoznać podczas opracowywania kontroli.

Uwaga

Coclass można edytować tylko dla kontrolek nieprzydatnych. Jeśli projekt został przypisany, nie można edytować coclass.

C++

Zawiera informacje o klasie języka C++ utworzonej w celu zaimplementowania obiektu.

• Krótka nazwa

  Ustawia skróconą nazwę obiektu. Podana nazwa określa nazwy klasy i klasy Coclass , plik (. CPP i . H) nazwy, nazwy interfejsu i nazwy typów , chyba że zmienisz te pola indywidualnie.

• Klasa

  Ustawia nazwę klasy, która implementuje obiekt. Ta nazwa jest oparta na nazwie podanej w krótkiej nazwie poprzedzonej ciągiem "C" typowym prefiksem nazwy klasy.

• Plik .h

  Ustawia nazwę pliku nagłówka dla klasy nowego obiektu. Domyślnie ta nazwa jest oparta na nazwie podanej w polu Krótka nazwa. Kliknij przycisk wielokropka, aby zapisać nazwę pliku w wybranej lokalizacji lub dołączyć deklarację klasy do istniejącego pliku. Jeśli wybierzesz istniejący plik, kreator nie zapisze go w wybranej lokalizacji, dopóki nie klikniesz przycisku Zakończ.

  Kreator nie zastępuje pliku. Jeśli wybierzesz nazwę istniejącego pliku, po kliknięciu przycisku Zakończ kreator wyświetli monit o wskazanie, czy deklaracja klasy powinna zostać dołączona do zawartości pliku. Kliknij przycisk Tak , aby dołączyć plik; kliknij przycisk Nie , aby powrócić do kreatora i określić inną nazwę pliku.

• Plik cpp

  Ustawia nazwę pliku implementacji dla klasy nowego obiektu. Domyślnie ta nazwa jest oparta na nazwie podanej w polu Krótka nazwa. Kliknij przycisk wielokropka, aby zapisać nazwę pliku w wybranej lokalizacji. Plik nie jest zapisywany w wybranej lokalizacji, dopóki nie klikniesz przycisku Zakończ w kreatorze.

  Kreator nie zastępuje pliku. Jeśli wybierzesz nazwę istniejącego pliku, po kliknięciu przycisku Zakończ kreator wyświetli monit o wskazanie, czy implementacja klasy powinna zostać dołączona do zawartości pliku. Kliknij przycisk Tak , aby dołączyć plik; kliknij przycisk Nie , aby powrócić do kreatora i określić inną nazwę pliku.

• Przypisane

  Wskazuje, czy obiekt używa atrybutów. Jeśli dodasz obiekt do przypisanego projektu ATL, ta opcja jest zaznaczona i niedostępna do zmiany. Oznacza to, że można dodawać tylko obiekty przypisane do projektu utworzonego z obsługą atrybutów.

  Możesz dodać obiekt przypisany tylko do projektu ATL, który używa atrybutów. Jeśli wybierzesz tę opcję dla projektu ATL, który nie ma obsługi atrybutów, kreator wyświetli monit o określenie, czy chcesz dodać obsługę atrybutów do projektu.

  Domyślnie wszystkie dodawane obiekty po ustawieniu tej opcji są oznaczone jako przypisane (pole wyboru jest zaznaczone). Możesz wyczyścić to pole, aby dodać obiekt, który nie używa atrybutów.

  Aby uzyskać więcej informacji, zobacz Application Ustawienia, ATL Project Wizard (Kreator projektu ATL) i Podstawowa mechanika atrybutów.

Model COM

Zawiera informacje o funkcjonalności modelu COM dla obiektu.

• Coclass

  Ustawia nazwę klasy składnika, która zawiera listę interfejsów obsługiwanych przez obiekt.

  Uwaga

  Jeśli tworzysz projekt przy użyciu atrybutów lub jeśli na tej stronie kreatora wskazujesz, że kontrolka używa atrybutów, nie można zmienić tej opcji, ponieważ ATL nie zawiera atrybutu coclass .

• Interfejs

  Ustawia nazwę interfejsu dla obiektu. Domyślnie nazwa interfejsu jest poprzedzona ciągiem "I".

• Type

  Ustawia opis obiektu, który będzie wyświetlany w rejestrze

• Progid

  Ustawia nazwę, która kontenery mogą używać zamiast identyfikatora CLSID obiektu. To pole nie jest wypełniane automatycznie. Jeśli to pole nie zostanie wypełnione ręcznie, kontrolka może nie być dostępna dla innych narzędzi. Na przykład kontrolki ActiveX, które są generowane bez elementuProgID, nie są dostępne w oknie dialogowym Wstawianie kontrolki ActiveX. Aby uzyskać więcej informacji na temat okna dialogowego, zobacz Wstawianie kontrolek ActiveX.

Zobacz też

ATL, kontrolka
Dodawanie funkcji do kontrolek złożonych
Podstawowe informacje na temat obiektów COM ATL