Dodawanie kontrolki (ALT — Samouczek, część 2)
W tym kroku dodasz formant do projektu, skompilujesz go i przetestujesz go na stronie sieci Web.
Procedury
Aby dodać obiekt do Projektu ATL
W oknie Widoku klas kliknij prawym przyciskiem myszy projekt Wielokąt.
Wskaż polecenie Dodaj w menu skrótów, a następnie kliknij polecenie Klasa w podmenu.
Pojawi się okno dialogowe Dodaj klasę.Inne kategorie obiektów wymienione zostały w strukturze drzewa po lewej stronie.
Kliknij folder ATL.
Na liście szablonów po prawej stronie zaznacz pozycję Kontrolka ATL.Kliknij przycisk Dodaj.Zostanie otwarty Kreator formantu biblioteki ATL, sterowanie można skonfigurować.
Wpisz PolyCtl jako nazwę krótką i zauważ, że inne pola są automatycznie uzupełniane.Nie klikaj jeszcze przycisku Zakończ, ponieważ trzeba wprowadzić pewne zmiany.
Strona Kreatora formantu biblioteki ATL Nazwy zawiera następujące pola:
Pole |
Zawartość |
|---|---|
Krótka nazwa |
Nazwa wprowadzona dla formantu. |
Klasa |
Nazwa klasy języka C++ utworzona w celu wdrożenia kontroli. |
plik .h |
Plik utworzony, aby zawierać definicję klasy C++. |
plik .cpp |
Plik utworzony, aby zawierać wdrożenie klasy C++. |
CoClass |
Nazwa klasy składnika dla tego formantu. |
Interfejs |
Nazwa interfejsu, na którym formant będzie implementował swoje niestandardowe metody i właściwości. |
Typ |
Opis formantu. |
ProgID |
Czytelna nazwa, która może być używana do sprawdzania CLSID formantu. |
Musisz wprowadzić kilka dodatkowych ustawień w Kreatorze formantu ATL.
Aby włączyć obsługę szczegółowych informacji o błędach i punktach połączenia
Kliknij Opcje, aby otworzyć stronę Opcje.
Wybierz pole wyboru Punkty połączenia.Spowoduje to utworzenie obsługi interfejsu wychodzącego w pliku IDL.
Możesz również sprawić, że formant będzie wstawialny, co oznacza, że będzie on mógł być osadzany w aplikacjach, które obsługują obiekty osadzone, takich jak Excel lub Word.
Aby umożliwić wstawianie formantu
Kliknij Wygląd, aby otworzyć stronę Wygląd.
Wybierz pole wyboru Wstawialny.
Wielokąt wyświetlany przez obiekt będzie miał kolor wypełnienia kryjącego, więc trzeba dodać właściwość magazynu Fill Color.
Aby dodać właściwość Podstawowy kolor wypełnienia i utworzyć formant
Kliknij Właściwości podstawowe, aby otworzyć stronę Właściwości podstawowe.
W Nie obsługiwane, przewiń w dół listę możliwych właściwości stosu.Kliknij dwukrotnie Fill Color, aby je przesunąć do listy Obsługiwane.
Na tym kończą się opcje dla formantu.Kliknij Zakończ.
Gdy kreator utworzył już formant, pojawi się kilka zmian kodu i uzupełnień pliku.Utworzone zostały następujące pliki:
Plik |
Opis |
|---|---|
PolyCtl.h |
Zawiera większość Implementacji klasy języka C++ CPolyCtl. |
PolyCtl.cpp |
Zawiera pozostałe części CPolyCtl. |
PolyCtl.rgs |
Plik tekstowy zawierający skrypt rejestru używany do rejestrowania formantu. |
PolyCtl.htm |
Strona sieci Web zawierająca odwołanie do nowo utworzonego formantu. |
Kreator wykonał również następujące zmiany kodu:
Dodano instrukcję #include do plików stdafx.h i stdafx.cpp, aby uwzględnić pliki ATL niezbędne do obsługi formantów.
Zmieniono Polygon.idl, aby dołączyć szczegóły nowego formantu.
Dodany nowy formant do mapy obiektu w Polygon.cpp.
Teraz można skompilować formant, aby zobaczyć go w akcji.
Tworzenie i testowanie formantu
Aby skompilować przetestować formant
W menu Kompilacja kliknij Kompiluj wielokąt.
Po zakończeniu kompilowania formantu kliknij prawym przyciskiem myszy plik PolyCtl.htm w Eksploratorze rozwiązań i wybierz polecenie Pokaż w przeglądarce.Zostanie wyświetlona strona HTML sieci Web zawierająca formant.Powinieneś widzieć stronę o tytule "Strona testowa 8.0 ATL dla obiektu PolyCtl" i tekst PolyCtl.To jest Twój formant.
[!UWAGA]
Po ukończeniu tego samouczka, jeśli pojawi się komunikat o błędzie, gdy nie można utworzyć pliku DLL, zamknij plik PolyCtl.htm i kontener badania kontrolnego ActiveX i ponownie skompiluj rozwiązanie.Jeśli nadal nie można utworzyć biblioteki DLL, uruchom ponownie komputer lub wyloguj się (jeśli usługi terminalowe są używane).
Następnie dodasz właściwość niestandardową do formantu.