Erstellen von Shellerweiterungshandlern
Die Funktionen der Shell können mit Registrierungseinträgen und .ini Dateien erweitert werden. Dieser Ansatz zum Erweitern der Shell ist zwar einfach und für viele Zwecke angemessen, ist aber begrenzt. Wenn Sie beispielsweise die Registrierung verwenden, um ein benutzerdefiniertes Symbol für einen Dateityp anzugeben, wird das gleiche Symbol für jede Datei dieses Typs angezeigt. Wenn Sie die Shell mit der Registrierung erweitern, können Sie das Symbol nicht für verschiedene Dateien desselben Typs ändern. Andere Aspekte der Shell, z. B. das Eigenschaftenblatt , das angezeigt werden kann, wenn eine Datei mit der rechten Maustaste geklickt wird, können überhaupt nicht mit der Registrierung geändert werden.
Ein leistungsfähigerer und flexiblerer Ansatz zum Erweitern der Shell ist die Implementierung von Shellerweiterungshandlern. Diese Handler können für eine Vielzahl von Aktionen implementiert werden, die die Shell ausführen kann. Bevor Sie die Aktion ausführen, fragt die Shell den Erweiterungshandler ab und gibt ihr die Möglichkeit, die Aktion zu ändern. Ein gängiges Beispiel ist ein Kontextmenüerweiterungshandler. Wenn eine für einen Dateityp implementiert ist, wird sie jedes Mal abgefragt, wenn mit der rechten Maustaste auf eine der Dateien geklickt wird. Der Handler kann dann zusätzliche Menüelemente auf Datei-für-Datei-Basis angeben, anstatt denselben Satz für den gesamten Dateityp festzulegen.
In diesem Dokument wird erläutert, wie Sie die Erweiterungshandler implementieren, mit denen Sie eine Vielzahl von Shellaktionen ändern können. Die folgenden Handler sind einem bestimmten Dateityp zugeordnet und ermöglichen es Ihnen, dateiweise anzugeben:
| Handler | BESCHREIBUNG |
|---|---|
| Kontextmenühandler | Wird aufgerufen, bevor das Kontextmenü einer Datei angezeigt wird. Damit können Sie dem Kontextmenü Datei für Datei Elemente hinzufügen. |
| Datenhandler | Wird aufgerufen, wenn ein Drag-and-Drop-Vorgang für dragShell-Objekte ausgeführt wird. Dadurch können Sie dem Ablageziel zusätzliche Zwischenablageformate bereitstellen. |
| Drop-Handler | Wird aufgerufen, wenn ein Datenobjekt über eine Datei gezogen oder gelöscht wird. Es ermöglicht Ihnen, eine Datei zu einem Ablageziel zu machen. |
| Symbolhandler | Wird aufgerufen, bevor das Symbol einer Datei angezeigt wird. Dadurch können Sie das Standardsymbol der Datei auf Dateibasis durch ein benutzerdefiniertes Symbol ersetzen. |
| Eigenschaftenblatthandler | Wird aufgerufen, bevor das Eigenschaftenblatt Eigenschaften eines Objekts angezeigt wird. Es ermöglicht Ihnen, Seiten hinzuzufügen oder zu ersetzen. |
| Miniaturbildhandler | Stellt ein Bild bereit, das das Element darstellt. |
| QuickInfo-Handler | Stellt Popuptext bereit, wenn der Benutzer mit dem Mauszeiger auf das Objekt zeigt. |
| Metadatenhandler | Bietet Lese- und Schreibzugriff auf Metadaten (Eigenschaften), die in einer Datei gespeichert sind. Dies kann verwendet werden, um die Detailsansicht, Infotips, die Eigenschaftenseite und die Gruppierungsfeatures zu erweitern. |
Andere Handler sind keinem bestimmten Dateityp zugeordnet, sondern werden vor einigen Shellvorgängen aufgerufen:
| Handler | BESCHREIBUNG |
|---|---|
| Spaltenhandler | Wird von Windows Explorer aufgerufen, bevor die Detailansicht eines Ordners angezeigt wird. Sie können der Detailansicht benutzerdefinierte Spalten hinzufügen. |
| Kopierhakenhandler | Wird aufgerufen, wenn ein Ordner- oder Druckerobjekt verschoben, kopiert, gelöscht oder umbenannt werden soll. Es ermöglicht Ihnen, den Vorgang zu genehmigen oder ein Veto einzufügen. |
| Drag & Drop-Handler | Wird aufgerufen, wenn eine Datei mit der rechten Maustaste gezogen wird. Dadurch können Sie das angezeigte Kontextmenü ändern. |
| Symbolüberlagerungshandler | Wird aufgerufen, bevor das Symbol einer Datei angezeigt wird. Sie können eine Überlagerung für das Symbol der Datei angeben. |
| Suchhandler | Aufgerufen, um eine Suchmaschine zu starten. Es ermöglicht Ihnen, eine benutzerdefinierte Suchmaschine zu implementieren, auf die über das Startmenü oder windows Explorer zugegriffen werden kann. |
Die Details zum Implementieren bestimmter Erweiterungshandler werden in den oben aufgeführten Abschnitten behandelt. Der Rest dieses Dokuments behandelt einige Implementierungsprobleme, die allen Shell-Erweiterungshandlern gemeinsam sind.
- Implementieren von Shellerweiterungshandlern
- Verbessern der Windows-Suche mit Shellerweiterungshandlern
- Registrieren von Shellerweiterungshandlern
- Zugehörige Themen
Implementieren von Shellerweiterungshandlern
Ein Großteil der Implementierung eines Shell-Erweiterungshandlerobjekts hängt vom Typ ab. Es gibt jedoch einige allgemeine Elemente. In diesem Abschnitt werden die Aspekte der Implementierung erläutert, die von allen Shell-Erweiterungshandlern gemeinsam genutzt werden.
Viele Shell-Erweiterungshandler sind prozessinterne COM-Objekte (Component Object Model). Sie müssen eine GUID zugewiesen und registriert werden, wie unter Registrieren von Shellerweiterungshandlern beschrieben. Sie werden als DLLs implementiert und müssen die folgenden Standardfunktionen exportieren:
- DllMain. Der Standardeinstiegspunkt zur DLL.
- DllGetClassObject. Macht die Klassenfactory des Objekts verfügbar.
- DllCanUnloadNow. COM ruft diese Funktion auf, um zu bestimmen, ob das Objekt Clients bedient. Andernfalls kann das System die DLL entladen und den zugeordneten Arbeitsspeicher freigeben.
Wie alle COM-Objekte müssen Shell-Erweiterungshandler eine IUnknown-Schnittstelle und eine Klassenfactory implementieren. Die meisten Erweiterungshandler müssen auch eine IPersistFile- oder IShellExtInit-Schnittstelle in Windows XP oder früher implementieren. Diese wurden in Windows Vista durch IInitializeWithStream, IInitializeWithItem und IInitializeWithFile ersetzt. Die Shell verwendet diese Schnittstellen, um den Handler zu initialisieren.
Die IPersistFile-Schnittstelle muss wie folgt implementiert werden:
- Datenhandler
- Löschen von Handlern
In der Vergangenheit waren auch Symbolhandler erforderlich, um IPersistFile zu implementieren, aber dies ist nicht mehr wahr. Für Symbolhandler ist IPersistFile jetzt optional, und andere Schnittstellen wie IInitializeWithItem werden bevorzugt.
Die IShellExtInit-Schnittstelle muss wie folgt implementiert werden:
- Kontextmenühandler
- Drag-and-Drop-Handler
- Eigenschaftenblatthandler
Implementieren von IPersistFile
Die IPersistFile-Schnittstelle soll das Laden oder Speichern eines Objekts aus einer Datenträgerdatei ermöglichen. Es verfügt über sechs Methoden neben IUnknown, fünf eigene und die GetClassID-Methode , die sie von IPersist erbt. Bei Shell-Erweiterungen wird IPersist nur verwendet, um ein Shell-Erweiterungshandlerobjekt zu initialisieren. Da in der Regel keine Lese- oder Schreibvorgänge auf dem Datenträger erforderlich sind, erfordern nur die Methoden GetClassID und Load eine Implementierung ohne Token.
Die Shell ruft zuerst GetClassID auf, und die Funktion gibt den Klassenbezeichner (CLSID) des Erweiterungshandlerobjekts zurück. Die Shell ruft dann Load auf und übergibt zwei Werte. Die erste, pszFileName, ist eine Unicode-Zeichenfolge mit dem Namen der Datei oder des Ordners, für die die Shell gerade arbeitet. Der zweite ist dwMode, der den Dateizugriffsmodus angibt. Da in der Regel kein Zugriff auf Dateien erforderlich ist, ist dwMode in der Regel null. Die -Methode speichert diese Werte nach Bedarf für einen späteren Verweis.
Das folgende Codefragment veranschaulicht, wie ein typischer Shell-Erweiterungshandler die Methoden GetClassID und Load implementiert. Es ist für die Verarbeitung von ANSI oder Unicode konzipiert. CLSID_SampleExtHandler ist die GUID des Erweiterungshandlerobjekts, und CSampleExtHandler ist der Name der Klasse, die zum Implementieren der Schnittstelle verwendet wird. Die variablen m_szFileName und m_dwMode sind private Variablen, die zum Speichern des Dateinamens und der Zugriffsflags verwendet werden.
wchar_t m_szFileName[MAX_PATH]; // The file name
DWORD m_dwMode; // The file access mode
CSampleExtHandler::GetClassID(CLSID *pCLSID)
{
*pCLSID = CLSID_SampleExtHandler;
}
CSampleExtHandler::Load(PCWSTR pszFile, DWORD dwMode)
{
m_dwMode = dwMode;
return StringCchCopy(_szFileName, ARRAYSIZE(m_szFileName), pszFile);
}
Implementieren von IShellExtInit
Die IShellExtInit-Schnittstelle verfügt zusätzlich zu IUnknown nur über eine Methode, IShellExtInit::Initialize. Die -Methode verfügt über drei Parameter, die die Shell verwenden kann, um verschiedene Arten von Informationen zu übergeben. Die übergebenen Werte hängen vom Typ des Handlers ab, und einige können auf NULL festgelegt werden.
- pIDFolder enthält den Zeiger eines Ordners auf eine Elementbezeichnerliste (PIDL). Bei Eigenschaftenblatterweiterungen ist dies NULL. Bei Kontextmenüerweiterungen ist es die PIDL des Ordners, der das Element enthält, dessen Kontextmenü angezeigt wird. Bei nicht standardmäßigen Drag-and-Drop-Handlern ist dies die PIDL des Zielordners.
- pDataObject enthält einen Zeiger auf die IDataObject-Schnittstelle eines Datenobjekts. Das Datenobjekt enthält einen oder mehrere Dateinamen in CF_HDROP Format.
- hRegKey enthält einen Registrierungsschlüssel für das Dateiobjekt oder den Ordnertyp.
Die IShellExtInit::Initialize-Methode speichert den Dateinamen, den IDataObject-Zeiger und den Registrierungsschlüssel bei Bedarf für die spätere Verwendung. Das folgende Codefragment veranschaulicht eine Implementierung von IShellExtInit::Initialize. Der Einfachheit halber wird in diesem Beispiel davon ausgegangen, dass das Datenobjekt nur eine einzelne Datei enthält. Im Allgemeinen kann es mehrere Dateien enthalten, die jeweils extrahiert werden müssen.
LPCITEMIDLIST m_pIDFolder; //The folder's PIDL
wchar_t m_szFile[MAX_PATH]; //The file name
IDataObject *m_pDataObj; //The IDataObject pointer
HKEY m_hRegKey; //The file or folder's registry key
STDMETHODIMP CShellExt::Initialize(LPCITEMIDLIST pIDFolder,
IDataObject *pDataObj,
HKEY hRegKey)
{
// If Initialize has already been called, release the old PIDL
ILFree(m_pIDFolder);
m_pIDFolder = nullptr;
// Store the new PIDL.
if (pIDFolder)
{
m_pIDFolder = ILClone(pIDFolder);
}
// If Initialize has already been called, release the old
// IDataObject pointer.
if (m_pDataObj)
{
m_pDataObj->Release();
}
// If a data object pointer was passed in, save it and
// extract the file name.
if (pDataObj)
{
m_pDataObj = pDataObj;
pDataObj->AddRef();
STGMEDIUM medium;
FORMATETC fe = {CF_HDROP, NULL, DVASPECT_CONTENT, -1, TYMED_HGLOBAL};
UINT uCount;
if (SUCCEEDED(m_pDataObj->GetData(&fe, &medium)))
{
// Get the count of files dropped.
uCount = DragQueryFile((HDROP)medium.hGlobal, (UINT)-1, NULL, 0);
// Get the first file name from the CF_HDROP.
if (uCount)
DragQueryFile((HDROP)medium.hGlobal, 0, m_szFile,
sizeof(m_szFile)/sizeof(TCHAR));
ReleaseStgMedium(&medium);
}
}
// Duplicate the registry handle.
if (hRegKey)
RegOpenKeyEx(hRegKey, nullptr, 0L, MAXIMUM_ALLOWED, &m_hRegKey);
return S_OK;
}
CSampleExtHandler ist der Name der Klasse, die zum Implementieren der Schnittstelle verwendet wird. Die Variablen m_pIDFolder, m_pDataObject, m_szFileName und m_hRegKey sind private Variablen, die zum Speichern der übergebenen Informationen verwendet werden. Der Einfachheit halber wird in diesem Beispiel davon ausgegangen, dass das Datenobjekt nur einen Dateinamen enthält. Nachdem die FORMATTC-Struktur aus dem Datenobjekt abgerufen wurde, wird DragQueryFile verwendet, um den Dateinamen aus dem Medium.hGlobal-Element der FORMATTC-Struktur zu extrahieren. Wenn ein Registrierungsschlüssel übergeben wird, verwendet die Methode RegOpenKeyEx , um den Schlüssel zu öffnen, und weist das Handle m_hRegKey zu.
Infotip-Anpassung
Es gibt zwei Möglichkeiten, Infotips anzupassen:
- Implementieren Sie ein Objekt, das IQueryInfo unterstützt, und registrieren Sie dieses Objekt dann unter dem richtigen Unterschlüssel in der Registrierung (siehe Registrieren von Shellerweiterungshandlern unten).
- Geben Sie eine feste Zeichenfolge oder eine Liste mit bestimmten Dateieigenschaften an, die angezeigt werden sollen.
Um eine feste Zeichenfolge für eine Namespaceerweiterung anzuzeigen, erstellen Sie einen Eintrag namens InfoTip im {CLSID}- Schlüssel Ihrer Namespaceerweiterung. Legen Sie den Wert dieses Eintrags auf die Literalzeichenfolge fest, die Sie anzeigen möchten, wie in diesem Beispiel gezeigt, oder auf eine indirekte Zeichenfolge, die eine Ressource und einen Index innerhalb dieser Ressource angibt (zu Lokalisierungszwecken).
HKEY_CLASSES_ROOT
CLSID
{CLSID}
InfoTip = InfoTip string for your namespace extension
Um eine feste Zeichenfolge für einen Dateityp anzuzeigen, erstellen Sie einen Eintrag namens InfoTip im ProgID-Schlüssel dieses Dateityps. Legen Sie den Wert dieses Eintrags auf die literale Zeichenfolge fest, die Sie anzeigen möchten, oder eine indirekte Zeichenfolge, die eine Ressource und einen Index innerhalb dieser Ressource (zu Lokalisierungszwecken) angibt, wie in diesem Beispiel gezeigt.
HKEY_CLASSES_ROOT
ProgID
InfoTip = Resource.dll, 3
Wenn die Shell bestimmte Dateieigenschaften im Infotip für einen bestimmten Dateityp anzeigen soll, erstellen Sie einen Eintrag InfoTip namens im ProgID-Schlüssel für diesen Dateityp. Legen Sie den Wert dieses Eintrags auf eine semikolontrennte Liste von kanonischen Eigenschaftennamen, FMTID-/Eigenschaftsbezeichner-Paaren (PID) oder beidem fest. Dieser Wert muss mit "prop:" beginnen, um ihn als Eigenschaftenlistenzeichenfolge zu identifizieren. Wenn Sie "prop:" weglassen, wird der Wert als Literalzeichenfolge betrachtet und als solche angezeigt.
Im folgenden Beispiel ist propname ein kanonischer Eigenschaftenname (z. B. System.Date) und {fmtid}, pid ist ein FMTID/PID-Paar .
HKEY_CLASSES_ROOT
ProgID
InfoTip = prop:propname;propname;{fmtid},pid;{fmtid},pid
Die folgenden Eigenschaftennamen können verwendet werden:
| Eigenschaftenname | BESCHREIBUNG | Abgerufen von |
|---|---|---|
| Autor | Autor des Dokuments | PIDSI_AUTHOR |
| Titel | Titel des Dokuments | PIDSI_TITLE |
| Subject | Zusammenfassung des Themas | PIDSI_SUBJECT |
| Kommentar | Dokumentkommentare | PIDSI_COMMENT - oder Ordner-/Treibereigenschaften |
| PageCount | Anzahl von Seiten | PIDSI_PAGECOUNT |
| Name | Angezeigter Name | Standardordneransicht |
| OriginalLocation | Speicherort der Ursprünglichen Datei | Aktenkofferordner und Papierkorbordner |
| DateDeleted | Datum des Löschens der Datei | Ordner "Papierkorb" |
| type | Dateityp | Standardansicht für Ordnerdetails |
| Size | Größe der Datei | Standardansicht für Ordnerdetails |
| SyncCopyIn | Identisch mit OriginalLocation | Identisch mit OriginalLocation |
| Geändert | Datum der letzten Änderung | Standardansicht für Ordnerdetails |
| Erstellt | Erstellungsdatum | Standardansicht für Ordnerdetails |
| Zugegriffen | Datum des letzten Zugriffs | Standardansicht für Ordnerdetails |
| InFolder | Verzeichnis mit der Datei | Dokumentsuchergebnisse |
| Rang | Qualität der Suchabfrage | Dokumentsuchergebnisse |
| FreeSpace | Verfügbarer Speicherplatz | Laufwerke |
| NumberOfVisits | Anzahl von Aufrufen | Ordner "Favoriten" |
| Attribute | Dateiattribute | Standardansicht für Ordnerdetails |
| Company | Unternehmensname | PIDDSI_COMPANY |
| Category | Dokumentkategorie | PIDDSI_CATEGORY |
| Copyright | Medienrecht | PIDMSI_COPYRIGHT |
| HTMLInfoTipFile | HTML InfoTip-Datei | Desktop.ini Datei für Ordner |
Verbessern der Windows-Suche mit Shellerweiterungshandlern
Shellerweiterungshandler können verwendet werden, um die Benutzerfreundlichkeit eines Windows Search-Protokollhandlers zu verbessern. Um solche Verbesserungen zu ermöglichen, muss der unterstützende Shell-Erweiterungshandler so konzipiert sein, dass er in den Suchprotokollhandler als Datenquelle integriert werden kann. Informationen zum Verbessern eines Windows Search-Protokollhandlers durch Integration in einen Shell-Erweiterungshandler finden Sie unter Hinzufügen von Symbolen, Vorschauen und Kontextmenüs. Weitere Informationen zu Windows Search-Protokollhandlern finden Sie unter Entwickeln von Protokollhandlern.
Registrieren von Shellerweiterungshandlern
Ein Shellerweiterungshandlerobjekt muss registriert werden, bevor es von der Shell verwendet werden kann. In diesem Abschnitt erfahren Sie, wie Sie einen Shellerweiterungshandler registrieren.
Jedes Mal, wenn Sie einen Shellerweiterungshandler erstellen oder ändern, ist es wichtig, das System darüber zu benachrichtigen, dass Sie eine Änderung mit SHChangeNotify vorgenommen haben, wobei das SHCNE_ASSOCCHANGED-Ereignis angegeben wird. Wenn Sie SHChangeNotify nicht aufrufen, wird die Änderung möglicherweise erst erkannt, wenn das System neu gestartet wird.
Wie bei allen COM-Objekten müssen Sie mithilfe eines Tools wie UUIDGEN.exe eine GUID für den Handler erstellen. Erstellen Sie einen Schlüssel unter HKEY_CLASSES_ROOT\CLSID , dessen Name die Zeichenfolgenform der GUID ist. Da Es sich bei Shell-Erweiterungshandlern um Prozessserver handelt, müssen Sie einen InProcServer32-Schlüssel unter dem GUID-Schlüssel erstellen, dessen Standardwert auf den Pfad der DLL des Handlers festgelegt ist. Verwenden Sie das Apartmentthreadingmodell.
Jedes Mal, wenn die Shell eine Aktion ausführt, die einen Shellerweiterungshandler umfassen kann, überprüft sie den entsprechenden Registrierungsschlüssel. Der Schlüssel, unter dem ein Erweiterungshandler registriert wird, steuert somit, wann er aufgerufen wird. Für instance ist es üblich, einen Kontextmenühandler namens zu verwenden, wenn die Shell ein Kontextmenü für ein Element eines Dateityps anzeigt. In diesem Fall muss der Handler unter dem ProgID-Schlüssel des Dateityps registriert werden.
Handlernamen
Um einen Shellerweiterungshandler zu aktivieren, erstellen Sie einen Unterschlüssel mit dem Handlerunterschlüsselnamen (siehe unten) unter dem ShellEx-Unterschlüssel der ProgID (für Dateitypen) oder des Shell-Objekttypnamens (für vordefinierte Shellobjekte).
Wenn Sie beispielsweise einen Kontextmenüerweiterungshandler für MyProgram.1 registrieren möchten, erstellen Sie zunächst den folgenden Unterschlüssel:
HKEY_CLASSES_ROOT
MyProgram.1
ShellEx
ContextMenuHandlers
Erstellen Sie für die folgenden Handler einen Unterschlüssel unter dem Schlüssel "Handler-Unterschlüsselname", dessen Name die Zeichenfolgenversion der CLSID der Shell-Erweiterung ist. Mehrere Erweiterungen können unter dem Schlüssel des Handlerunterschlüssels registriert werden, indem mehrere Unterschlüssel erstellt werden.
| Handler | Schnittstelle | Name des Handlerunterschlüssels |
|---|---|---|
| Kontextmenühandler | IContextMenu | ContextMenuHandlers |
| Copyhook-Handler | ICopyHook | CopyHookHandlers |
| Drag & Drop-Handler | IContextMenu | DragDropHandlers |
| Eigenschaftenblatthandler | IShellPropSheetExt | PropertySheetHandlers |
| Spaltenanbieterhandler (in Windows Vista veraltet) | IColumnProvider | ColumnHandlers |
Für die folgenden Handler ist der Standardwert des Schlüssels "Handler-Unterschlüsselname" die Zeichenfolgenversion der CLSID der Shell-Erweiterung. Für diese Handler kann nur eine Erweiterung registriert werden.
| Handler | Schnittstelle | Name des Handlerunterschlüssels |
|---|---|---|
| Datenhandler | Idataobject | Datahandler |
| Löschen des Handlers | Idroptarget | DropHandler |
| Symbolhandler | IExtractIconA/W | IconHandler |
| Imagehandler | IExtractImage | {BB2E617C-0920-11d1-9A0B-00C04FC2D6C1} |
| Miniaturbildhandler | IThumbnailProvider | {E357FCCD-A995-4576-B01F-234630154E96} |
| QuickInfo-Handler | IQueryInfo | {00021500-0000-0000-C000-000000000046} |
| Shelllink (ANSI ) | IShellLinkA | {000214EE-0000-0000-C000-000000000046} |
| Shelllink (UNICODE) | IShellLinkW | {000214F9-0000-0000-C000-000000000046} |
| Strukturierter Speicher | IStorage | {0000000B-0000-0000-C000-000000000046} |
| Metadaten | Ipropertystore | PropertyHandler |
| Metadaten | IPropertySetStorage (in Windows Vista veraltet) | PropertyHandler |
| An Startmenü anheften | IStartMenuPinnedList | {a2a9545d-a0c2-42b4-9708-a0b2badd77c8} |
| An Taskleiste anheften | {90AA3A4E-1CBA-4233-B8BB-535773D4849} |
Die angegebenen Unterschlüssel zum Hinzufügen von An das Startmenü anheften und an Taskleiste an das Kontextmenü eines Elements anheften sind nur für Dateitypen erforderlich, die den Eintrag IsShortCut enthalten.
Die Unterstützung für Spaltenanbieterhandler wurde in Windows Vista entfernt. Außerdem ist IPropertySetStorage seit Windows Vista zugunsten von IPropertyStore veraltet.
Während IExtractImage weiterhin unterstützt wird, wird IThumbnailProvider für Windows Vista und höher bevorzugt.
Vordefinierte Shellobjekte
Die Shell definiert zusätzliche Objekte unter HKEY_CLASSES_ROOT die auf die gleiche Weise wie Dateitypen erweitert werden können. Um beispielsweise einen Eigenschaftenblatthandler für alle Dateien hinzuzufügen, können Sie sich unter dem Schlüssel PropertySheetHandlers registrieren.
HKEY_CLASSES_ROOT
*
shellex
PropertySheetHandlers
Die folgende Tabelle enthält die verschiedenen Unterschlüssel von HKEY_CLASSES_ROOT , unter denen Erweiterungshandler registriert werden können. Beachten Sie, dass viele Erweiterungshandler nicht unter allen aufgeführten Unterschlüsseln registriert werden können. Weitere Informationen finden Sie in der Dokumentation des jeweiligen Handlers.
| Unterschlüssel | BESCHREIBUNG | Mögliche Handler | Version |
|---|---|---|---|
| * | Alle Dateien | Kontextmenü, Eigenschaftenblatt, Verben (siehe unten) | Alle |
| AllFileSystemObjects | Alle Dateien und Dateiordner | Kontextmenü, Eigenschaftenblatt, Verben | 4.71 |
| Ordner | Alle Ordner | Kontextmenü, Eigenschaftenblatt, Verben | Alle |
| Verzeichnis | Dateiordner | Kontextmenü, Eigenschaftenblatt, Verben | Alle |
| Verzeichnis\Hintergrund | Hintergrund des Dateiordners | Nur Kontextmenü | 4.71 |
| Laufwerk | Alle Laufwerke in MyComputer, z. B. "C:\" | Kontextmenü, Eigenschaftenblatt, Verben | Alle |
| Network | Gesamtes Netzwerk (unter Meine Netzwerkplätze) | Kontextmenü, Eigenschaftenblatt, Verben | Alle |
| Netzwerk\Typ\ # | Alle Objekte vom Typ # (siehe unten) | Kontextmenü, Eigenschaftenblatt, Verben | 4.71 |
| Netshare | Alle Netzwerkfreigaben | Kontextmenü, Eigenschaftenblatt, Verben | 4.71 |
| NetServer | Alle Netzwerkserver | Kontextmenü, Eigenschaftenblatt, Verben | 4.71 |
| network_provider_name | Alle vom Netzwerkanbieter "network_provider_name" bereitgestellten Objekte | Kontextmenü, Eigenschaftenblatt, Verben | Alle |
| Drucker | Alle Drucker | Kontextmenü, Eigenschaftenblatt | Alle |
| Audiocd | Audio-CD im CD-Laufwerk | Nur Verben | Alle |
| DVD | DVD-Laufwerk (Windows 2000) | Kontextmenü, Eigenschaftenblatt, Verben | 4.71 |
Hinweise:
- Auf das Kontextmenü im Hintergrund des Dateiordners wird zugegriffen, indem sie mit der rechten Maustaste in einem Dateiordner, aber nicht über den Inhalt des Ordners klicken.
- "Verben" sind spezielle Befehle, die unter HKEY_CLASSES_ROOT\Unterschlüssel-Shellverb\\ registriert sind.
- Für Netzwerktyp\\# ist "#" ein Netzwerkanbietertypcode in dezimal. Der Netzwerkanbietertypcode ist das hohe Wort eines Netzwerktyps. Die Liste der Netzwerktypen wird in der Winnetwk.h-Headerdatei (WNNC_NET_*-Werte) angegeben. Beispielsweise ist WNNC_NET_SHIVA 0x00330000, sodass der entsprechende Typschlüssel HKEY_CLASSES_ROOT\Netzwerktyp\\51 lautet.
- "network_provider_name" ist ein Netzwerkanbietername, der von WNetGetProviderName angegeben wird, wobei die Leerzeichen in Unterstriche konvertiert werden. Wenn beispielsweise der Microsoft-Netzwerkanbieter installiert ist, lautet sein Anbietername "Microsoft Windows-Netzwerk", und der entsprechende network_provider_name ist Microsoft_Windows_Network.
Beispiel für eine Erweiterungshandlerregistrierung
Um einen bestimmten Handler zu aktivieren, erstellen Sie einen Unterschlüssel unter dem Erweiterungshandlertypschlüssel mit dem Namen des Handlers. Die Shell verwendet nicht den Namen des Handlers, muss sich jedoch von allen anderen Namen unter diesem Typunterschlüssel unterscheiden. Legen Sie den Standardwert des Namensunterschlüssels auf die Zeichenfolgenform der GUID des Handlers fest.
Im folgenden Beispiel werden Registrierungseinträge veranschaulicht, die Kontextmenüs- und Eigenschaftenblatterweiterungshandler mit einem Beispiel für myp-Dateitypen aktivieren:
HKEY_CLASSES_ROOT
.myp
(Default) = MyProgram.1
CLSID
{00000000-1111-2222-3333-444444444444}
InProcServer32
(Default) = C:\MyDir\MyCommand.dll
ThreadingModel = Apartment
{11111111-2222-3333-4444-555555555555}
InProcServer32
(Default) = C:\MyDir\MyPropSheet.dll
ThreadingModel = Apartment
MyProgram.1
(Default) = MyProgram Application
Shellex
ContextMenuHandler
MyCommand
(Default) = {00000000-1111-2222-3333-444444444444}
PropertySheetHandlers
MyPropSheet
(Default) = {11111111-2222-3333-4444-555555555555}
Das in diesem Abschnitt erläuterte Registrierungsverfahren muss für alle Windows-Systeme befolgt werden.
Zugehörige Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für