Udostępnij przez


Informacje o rejestrze kontrolek ActiveX

Istnieje wiele wpisów rejestru i flag, które są używane. Ponadto kontrolki mogą obsługiwać kategorie składników w celu klasyfikowania oferowanych przez nich funkcji.

Klucze rejestru związane z kontrolkami są oznaczone gwiazdką w następującym drzewie:

HKEY_CLASSES_ROOT
   CLSID
      {control_CLSID}
         ProgID = <identifier>
         InprocServer32 = <filename>.dll
         *DefaultIcon = <filename>.<ext>,resourceID
         *ToolboxBitmap32 = <filename>.<ext>,resourceID
         *Control
         verb
            *n = &Properties...
         *MiscStatus = 0
         TypeLib = {object_typelibID}
         *Version = version_number

Wpis DefaultIcon służy do identyfikowania ikony, która ma być wyświetlana po zminimalizowaniu kontrolki do ikony. Funkcja ExtractIcon służy do pobierania ikony z określonego pliku .DLL lub .EXE.

Wpis ToolboxBitmap32 identyfikuje nazwę modułu i identyfikator zasobu mapy bitowej 16*15 do użycia dla twarzy paska narzędzi lub przycisku przybornika. Standardowy rozmiar ikony systemu Windows jest zbyt duży, aby był używany w tym celu. Ten wpis obsługuje kontenery sterujące, które mają tryb projektowania, w którym wybiera się kontrolki i umieszcza je na formularzu, który jest projektowany. Na przykład w języku Visual Basic ikona kontrolki jest wyświetlana w przyborniku języka Visual Basic w trybie projektowania.

Wpis Control oznacza obiekt jako kontrolkę. Ten wpis jest często używany przez kontenery do wypełniania okien dialogowych. Kontener używa tego klucza podrzędnego, aby określić, czy należy uwzględnić obiekt w oknie dialogowym, w ramach którego są wyświetlane kontrolki.

Można również używać wstawiania klucza podrzędnego z kontrolkami, w zależności od tego, czy obiekt może działać tylko jako obiekt osadzony w miejscu bez specjalnych funkcji sterowania. Obiekty oznaczone wstawianych są wyświetlane w oknie dialogowym Wstawianie obiektu kontenera. Wpis z możliwością wstawiania zazwyczaj oznacza, że kontrolka została przetestowana przy użyciu kontenerów niekontrolujących.

Opcjonalne są zarówno , jak i klucze podrzędne Control. Kontrolka może pominąć wstawiania podklucz, jeśli nie jest przeznaczony do pracy ze starszymi kontenerami, które nie rozumieją kontrolek. Kontrolka może pominąć klucz Control, jeśli jest przeznaczony tylko do pracy z określonym kontenerem i w związku z tym nie chce być wstawiony do innych kontenerów.

Kontrolki powinny mieć OLEIVERB_PROPERTIES Propertiesverbwraz z innymi czasownikami, które obsługują. Parametr Propertiesverb, a także standardowy verb OLEIVERB_PRIMARY, instruuje kontrolkę, aby wyświetlała jego arkusz właściwości. Element Propertiesverb jest wyświetlany jako Properties element w menu kontenera, gdy kontrolka jest aktywna. Dzięki temu kontrolka może wyświetlać własną stronę właściwości umożliwiającą użytkownikowi końcowemu pewne przydatne funkcje, nawet jeśli kontener nie obsługuje kontrolek.

Kontrolka definiuje klucz MiscStatus opisujący się w potencjalnych kontenerach. Bity przyjmują wartości z OLEMISC, a kontrolki dodają kilka wartości do tego wyliczenia. Aby uzyskać więcej informacji, zobacz wartości wyliczania OLEMISC. Klient może uzyskać te informacje, wywołując IOleObject::GetMiscStatus bez konieczności wcześniejszego utworzenia wystąpienia kontrolki.

Na koniec version opisuje wersję kontrolki, która powinna być zgodna z wersją biblioteki typów skojarzonej z tą kontrolką.

Ponadto w informacjach o typie kontrolki atrybut oznacza wpis coclass jako opis kontrolki.