Optionsseiten erstellen durch Automatisierung
Verwaltetes VSPackages Automatisierung kann verwendet werden, um die Visual Studio integrierte Entwicklungsumgebung (IDE) indem er Optionen Seiten auf den Extras Menü erweitert werden soll.
Eine Extras/Optionen Seite handelt es sich im Grunde um ein Benutzersteuerelement und wird auf die gleiche Weise wie jedes andere Steuerelement codiert. Normalerweise würden Sie einen des vom Designer Visual Studio IDE verwenden, um das Objekt zu erstellen und Benutzersteuerelemente hinzufügen.
Hinweis
Extras/Optionen Seiten, die als Dialogfeld unter Verwendung DialogProc implementiert werden, um Fenstermeldungen zu bearbeiten, müssen nicht modale Dialogfelder sein und dürfen die EndDialog-Funktion nicht aufrufen.
Sie sollten das Automatisierungsobjekt, das ein VSPackage Umgebungen zu unterstützen benutzersteuerelement Eigenschaften bereitstellt.
Automatisierungs-Unterstützung für die Optionsseiten im Menü Extras implementiert den Interop-Assemblys
Um das Automatisierungsmodell zu unterstützen, muss ein VSPackage ein Automatisierungsobjekt erstellen und registrieren. Weitere Informationen finden Sie unter Bereitstellen der Automatisierung für VSPackages.
Wenn Code, der das Automatisierungsmodells DTE.Properties für die Eigenschaftenauflistung einer angegebenen Extras/Optionen Seite aufruft, wird die IDE das Automatisierungsobjekt, das von der Implementierung von VSPackages GetAutomationObject bereitgestellt wird, um die Auflistung und zurückzugeben Property Zugriff auf die konstituierenden Objekte zu ermöglichen.
Hinweis das Automatisierungsobjekt, das von GetAutomationObject zurückgegeben wird, hängt vom angegebenen GUID ab (bei einem VSPackage mehr als ein Automatisierungsobjekt unterstützt). Weitere Informationen über das Implementieren von Automatisierungsobjekten finden Sie unter Automatisierungs-Unterstützung für Optionsseiten.
Eine Extras/Optionen Seite besteht aus zwei Bezeichnern angegeben. Der erste Bezeichner ist eine Zeichenfolge, die den Ordner angibt, der das Element im Optionen-Abschnitt des Extras Menüelemente enthält. Der zweite Bezeichner ist eine Zeichenfolge, die das jeweilige Element im Ordner angibt. Weitere Informationen finden Sie unter Verwenden der Optionsseiten.
Zwei Registrierungseinträge sind erforderlich, um ein Automatisierungsobjekt zu registrieren:
Klicken Sie unter HKEY_LOCAL_MACHINE \ SOFTWARE \ Microsoft \ VisualStudio \<Version \Packages\<PackageGUID>\ Automatisierung
Klicken Sie unter HKEY_LOCAL_MACHINE \ SOFTWARE \ Microsoft \ VisualStudio \ <Version> \ AutomationProperties
Dabei <Version> die Version von Visual Studio ist (z. B. 8.0), und die GUID ist <PackageGUID> VSPackages, das das Automatisierungsobjekt implementiert.
Abhängig von der Konfiguration AutomationProperties-Registrierungseintrag, unter dem der Zustand einer Extras/Optionen Seite wird automatisch durch den Visual Studio Mechanismus zur Einstellungen gespeichert und wiederhergestellt, wenn ein Benutzer den Einstellungen importieren und exportieren Befehl für das Extras Menü ausgewählt wird. Weitere Informationen zum Speichern von Extras/Optionen Seiteneinstellungen finden Sie unter Registrieren benutzerdefinierter Optionsseiten.
Eine Anwendung das Automatisierungsmodell nicht verwendet werden, um Unterstützung für Eigenschaften und Einstellungen einer Extras/Optionen Seite zu implementieren.
Dies kann aus mehreren Gründen geeignet:
Die Einstellungen, die von der Extras/Optionen Seite behandelt werden, sind in der Struktur als komplexer, was das relativ flachen Automatisierungseigenschaften Modell unterstützt.
Es gibt eine Anforderung an andere Anwendungen, die Extras/Optionen Seite programmgesteuert verwalten zu verhindern.
Besondere Zugreifen auf Steuerelemente oder Sicherheitsfunktionen sind erforderlich.
In diesen Fällen kann Extras/Optionen VSPackages Unterstützung vonseiten auf irgendeine Weise implementieren, die geeignet ist. Allerdings müssen sie:
Behandeln Sie die Einstellung von Extras/Optionen Seiteneigenschaften.
Verwalten von Dauerhaftigkeit von Extras/Optionen Seitenzustand von der Visual Studio Einstellungen.
Erstellen Sie eine API bereit, wenn Sie gewünscht sein, damit andere Anwendungen die Extras/Optionen Seite verwenden.
Die Eigenschaften des Schriftarten und Farben Dialogfelds ist ein Beispiel für eine Extras/Optionen Seite, die nicht vom Automatisierungsmodell geändert werden kann. Stattdessen wird ein separates API auf Grundlage der IVsFontAndColorDefaults-Schnittstelle bereitgestellt, um die programmgesteuerte Bearbeitung der Seite Schriftarten und FarbenExtras/Optionen zu ermöglichen. Weitere Informationen zum Steuern der Seite Schriftarten und FarbenExtras/Optionen finden Sie unter Schriftarten.
Automatisierungs-Unterstützung für Optionsseiten im Menü Extras im verwalteten Paketframeworks
Legen Sie die Eigenschaft SupportsAutomation registrierender ProvideOptionPageAttribute-Instanz einer Implementierung fest, um anzugeben, dass eine verwaltete Implementierung einer Extras/Optionen Seite Paket Framework-Basis Automatisierung unterstützt.
Extras/Optionen Seiten, die von DialogPage abgeleitet sind, werden mit einem Automatisierungsobjekt angegeben, das überschrieben werden kann.
Wenn eine Seite Extras/Optionen Implementierung der Automatisierung nicht unterstützt, muss die Implementierung über eine eigene API angeben, um den programmgesteuerten Zugriff auf die Extras/Optionen Seite zu ermöglichen.
Hinweis
Die Schriftarten und Farben Seite der IDE ist ein Beispiel für eine Extras/Optionen Seite, die keine Automatisierung unterstützt, doch bietet Zugriff auf die Extras/Optionen Seite durch seinen eigenen API.Weitere Informationen finden Sie unter Schriftarten.
Siehe auch
Aufgaben
Gewusst wie: Erstellen benutzerdefinierter Optionsseiten
Referenz
Erstellen von Registrierungsstellen-Skripten
Konzepte
Optionsseiten erstellen Sie mithilfe von Interop-Assemblys
Optionsseiten mithilfe der Klassen des verwalteten Paketframeworks erstellen
Automatisierungs-Unterstützung für Optionsseiten