Udostępnij za pośrednictwem


Kreator prostych obiektów ATL

Ten kreator wstawia do projektu minimalny obiekt COM. Użyj tej strony kreatora, aby określić nazwy identyfikujące klasę i pliki języka C++ dla obiektu i jego funkcji COM.

Użyj strony Opcje tego kreatora, aby określić model wątkowania obiektu, jego obsługę agregacji i to, czy obsługuje podwójne interfejsy i automatyzację. Można również wskazać obsługę interfejsu informacji o błędach, punktów połączenia, obsługi programu Internet Explorer i marshalingu bez wątków.

Uwagi

Począwszy od programu Visual Studio 2008, skrypt rejestracji utworzony przez tego kreatora zarejestruje jego 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 edytować niezależnie od innych. 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 polach Typ i ProgID, ale nazwa interfejsu nie ulegnie zmianie. 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 w projektach nieprzydatnych. Jeśli projekt został przypisany, nie można edytować coclass.

C++

Zawiera informacje o klasie języka C++ utworzonej dla obiektu.

  • Krótka nazwa

    Ustawia skróconą nazwę obiektu. Podana nazwa określa Class nazwy i Coclass , plik .cpp i nazwy plików h, nazwę interfejsu , nazwy typów i identyfikator progID, chyba że zmienisz te pola indywidualnie.

  • 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 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 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.

  • Klasa

    Ustawia nazwę klasy do utworzenia. Ta nazwa jest oparta na nazwie podanej w krótkiej nazwie poprzedzonej ciągiem "C" typowym prefiksem nazwy klasy.

  • 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 Ustawienia aplikacji, 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 wskazujesz na tej stronie kreatora, że obiekt używa atrybutów, nie można zmienić tej opcji, ponieważ ATL nie zawiera atrybutu coclass .

  • Type

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

  • Interfejs

    Ustawia interfejs tworzony dla obiektu. Ten interfejs zawiera metody niestandardowe.

  • Identyfikator progu

    Ustawia nazwę, która kontenery mogą używać zamiast identyfikatora CLSID obiektu.

Zobacz też

Obiekt prosty ATL