Jak zarejestrować i zaimplementować procedurę obsługi arkusza właściwości dla aplikacji Panelu sterowania

Wiele aplikacji Panelu sterowania wyświetla arkusz właściwości, aby umożliwić użytkownikom wyświetlanie i modyfikowanie różnych ustawień urządzenia i systemu. Dwie z tych aplikacji — mysz i ekran — umożliwiają programom obsługi arkuszy właściwości zastąpienie jednej lub kilku stron stroną niestandardową. Poniższy zrzut ekranu przedstawia kartę właściwości Właściwości myszy.

Programy obsługi arkuszy właściwości dla aplikacji Panelu sterowania są podobne do tych dla typów plików, z dwoma podstawowymi wyjątkami:

• Są one wywoływane przez aplikację Panel sterowania, a nie powłokę.
• Są one rejestrowane inaczej.

Co musisz wiedzieć

Technologie

• Shell

Warunki wstępne

• Znajomość panelu sterowania
• Znajomość menu skrótów

Instrukcje

Krok 1. Rejestrowanie programu obsługi arkusza właściwości dla aplikacji Panelu sterowania

Obsługiwacz arkusza właściwości aplikacji Panelu sterowania musi być zarejestrowany w podkluczu Panelu sterowania. Ten klucz może znajdować się w jednej z dwóch lokalizacji, w zależności od tego, czy program obsługi dotyczy użytkownika, czy komputera. W przypadku rejestracji poszczególnych użytkowników podklucz Panelu sterowania jest HKEY_CURRENT_USER\Panel sterowania. Makro REGSTR_PATH_CONTROLPANEL zdefiniowane w Regstr.h może być używane w kodzie zamiast "Panel sterowania". W przypadku rejestracji dla każdego komputera lokalizacja to:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            Current Version
               Controls Folder

Ta ścieżka może być określana w kodzie jako HKEY_LOCAL_MACHINE\REGSTR_PATH_CONTROLSFOLDER, przy użyciu makra REGSTR_PATH_CONTROLSFOLDER zdefiniowanego w regstr.h.

Aplikacje Panelu sterowania, które pozwalają na zastępowanie stron przez moduły obsługi arkuszy właściwości, mają podklucz w podkluczu Panelu sterowania, nazwany odpowiednio do aplikacji, takie jak Mysz i Wyświetlanie. Podklucz aplikacji musi mieć podklucz shellex z podkluczem PropertySheetHandlers. Aby zarejestrować procedurę obsługi arkusza właściwości, dodaj jego identyfikator GUID do podklucza PropertySheetHandlers, który jest skojarzony z aplikacją Panel Sterowania. W tym celu utwórz podklucz w podkluczu PropertySheetHandlers, nadając mu nazwę odpowiadającą procedurze obsługi arkusza właściwości, i ustaw jego wartość domyślną na formę ciągu GUID tego programu obsługi.

Poniższy przykład rejestruje procedurę obsługi arkusza właściwości dla aplikacji Panel sterowania myszą na poszczególnych komputerach. Aby zarejestrować go dla każdego użytkownika, zastąp HKEY_LOCAL_MACHINE\REGSTR_PATH_CONTROLSFOLDER przez HKEY_CURRENT_USER\REGSTR_PATH_CONTROLPANEL.

HKEY_LOCAL_MACHINE
   REGSTR_PATH_CONTROLSFOLDER
      Mouse
         shellex
            PropertySheetHandlers
               MyPropHandler
                  (Default) = {MyPropHandler CLSID GUID}

Krok 2. Implementowanie procedury obsługi arkusza właściwości dla aplikacji Panelu sterowania

Procedura implementowania procedury obsługi arkusza właściwości Panelu sterowania jest bardzo podobna do procedury opisanej w Jak zarejestrować i zaimplementować procedurę obsługi arkusza właściwości dla typu pliku. Podstawową różnicą jest to, że teraz IShellPropSheetExt::ReplacePage wymaga implementacji bez tokenu zamiast IShellPropSheetExt::AddPages.

Gdy aplikacja Panelu Sterowania ma wyświetlić arkusz właściwości, wywołuje metodę obsługującą arkusz właściwości IShellPropSheetExt::ReplacePage raz dla każdej strony, którą można zamienić. Parametr uPageID jest ustawiony na identyfikator strony. Identyfikatory dostępnych stron są zdefiniowane w pliku Cplext.h. Obecnie dostępne identyfikatory są wymienione w poniższej tabeli.

Uwagi

Procedura tworzenia i zastępowania strony jest identyczna z procedurą dodawania strony. Aby uzyskać więcej informacji, zobacz Jak zarejestrować i zaimplementować procedurę obsługi arkusza właściwości dla typu pliku.