Registrieren und Implementieren eines Eigenschaftenblatthandlers für eine Systemsteuerung-Anwendung

Viele Systemsteuerung Anwendungen zeigen ein Eigenschaftenfenster an, damit Benutzer verschiedene Geräte- und Systemeinstellungen anzeigen und ändern können. Zwei dieser Anwendungen – Maus und Anzeige – ermöglichen es Eigenschaftsblatthandlern, eine oder mehrere ihrer Seiten durch eine benutzerdefinierte Seite zu ersetzen. Der folgende Screenshot zeigt das Eigenschaftenblatt Mauseigenschaften .

Eigenschaftenblatthandler für Systemsteuerung Anwendungen ähneln denen für Dateitypen, mit zwei primären Ausnahmen:

• Sie werden von einer Systemsteuerung Anwendung aufgerufen, nicht von der Shell.
• Sie werden unterschiedlich registriert.

Wichtige Informationen

Technologien

• Shell

Voraussetzungen

• Verständnis der Systemsteuerung
• Verständnis von Kontextmenüs

Anweisungen

Schritt 1: Registrieren eines Eigenschaftenblatthandlers für eine Systemsteuerung-Anwendung

Ein Systemsteuerung Anwendungseigenschaftenblatthandler muss unter dem unterschlüsselten Systemsteuerung registriert sein. Dieser Schlüssel kann sich an einem von zwei Speicherorten befinden, je nachdem, ob der Handler benutzer- oder computerbezogen sein soll. Bei der Registrierung pro Benutzer ist der Systemsteuerung Unterschlüssel HKEY_CURRENT_USER\Systemsteuerung. Das Makro REGSTR_PATH_CONTROLPANEL, wie in Regstr.h definiert, kann im Code anstelle von "Systemsteuerung" verwendet werden. Für die Registrierung pro Computer lautet der Speicherort:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            Current Version
               Controls Folder

Dieser Pfad kann im Code als HKEY_LOCAL_MACHINE\REGSTR_PATH_CONTROLSFOLDER bezeichnet werden, wobei das in Regstr.h definierte REGSTR_PATH_CONTROLSFOLDER Makro verwendet wird.

Die Systemsteuerung Anwendungen, mit denen Eigenschaftenblatthandler Seiten ersetzen können, verfügen unter dem Unterschlüssel des Systemsteuerung über einen Unterschlüssel, der für die Anwendung benannt ist, z. B. Maus und Anzeige. Der Unterschlüssel der Anwendung muss über einen Shellex-Unterschlüssel mit einem PropertySheetHandlers-Unterschlüssel verfügen. Um einen Eigenschaftenblatthandler zu registrieren, fügen Sie dessen GUID dem PropertySheetHandlers-Unterschlüssel hinzu, der der Systemsteuerung-Anwendung zugeordnet ist. Erstellen Sie hierzu einen Unterschlüssel des Unterschlüssels PropertySheetHandlers , der für den Eigenschaftenblatthandler benannt ist, und legen Sie dessen Standardwert auf die Zeichenfolgenform der GUID des Handlers fest.

Im folgenden Beispiel wird ein Eigenschaftenblatthandler für die Maus-Systemsteuerung-Anwendung auf Computerbasis registriert. Um sie benutzerbezogen zu registrieren, ersetzen Sie HKEY_LOCAL_MACHINE\REGSTR_PATH_CONTROLSFOLDER durch HKEY_CURRENT_USER\REGSTR_PATH_CONTROLPANEL.

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

Schritt 2: Implementieren eines Eigenschaftenblatthandlers für eine Systemsteuerung-Anwendung

Das Verfahren zum Implementieren eines Systemsteuerung Eigenschaftenblatthandlers ähnelt dem verfahren, das unter Registrieren und Implementieren eines Eigenschaftenblatthandlers für einen Dateityp erläutert wird. Der Hauptunterschied besteht darin, dass IShellPropSheetExt::ReplacePage jetzt eine nontoken-Implementierung anstelle von IShellPropSheetExt::AddPages benötigt.

Wenn eine Systemsteuerung Anwendung ihr Eigenschaftenblatt anzeigt, ruft sie die IShellPropSheetExt::ReplacePage-Methode des Eigenschaftenblatthandlers einmal für jede Seite auf, die ersetzt werden kann. Der uPageID-Parameter ist auf die ID der Seite festgelegt. Die IDs für die verfügbaren Seiten werden in Cplext.h definiert. Die derzeit verfügbaren IDs sind in der folgenden Tabelle aufgeführt.

Seiten-ID	BESCHREIBUNG	Systemsteuerung Anwendung
CPLPAGE_MOUSE_BUTTONS	Seite Schaltflächen	Maus
CPLPAGE_MOUSE_PTRMOTION	Seite "Bewegung"	Maus
CPLPAGE_MOUSE_WHEEL	Seite "Rad"	Maus
CPLPAGE_KEYBOARD_SPEED	Seite "Geschwindigkeit"	Tastatur
CPLPAGE_DISPLAY_BACKGROUND	Seite "Hintergrund"	Anzeige

 

Bemerkungen

Das Verfahren zum Erstellen und Ersetzen einer Seite ist identisch mit dem zum Hinzufügen einer Seite. Weitere Informationen finden Sie unter Registrieren und Implementieren eines Eigenschaftenblatthandlers für einen Dateityp.