IVsPackage.ResetDefaults(UInt32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Setzt Toolbox-Standardwerte zurück.
public:
int ResetDefaults(System::UInt32 grfFlags);
public:
int ResetDefaults(unsigned int grfFlags);
int ResetDefaults(unsigned int grfFlags);
public int ResetDefaults (uint grfFlags);
abstract member ResetDefaults : uint32 -> int
Public Function ResetDefaults (grfFlags As UInteger) As Integer
Parameter
- grfFlags
- UInt32
[in] Flags, deren Werte aus der __VSPKGRESETFLAGS-Enumeration übernommen werden.
Gibt zurück
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.
Hinweise
COM-Signatur
Aus vsshell. idl:
HRESULT IVsPackage::ResetDefaults(
[in] VSPKGRESETFLAGS grfFlags
);
Implementieren Sie diese Methode, wenn Sie Elemente oder Tools in der Toolbox installieren. Beim Setup lädt die Umgebung das VSPackage und ruft seine Implementierung auf IVsPackage::ResetDefaults . Nachdem das VSPackage erfolgreich konfiguriert wurde, wird die ResetDefaults Methode nicht mehr in nachfolgenden Setups aufgerufen, es sei denn, Sie erhöhen später den Standardelement Schlüssel in der Registrierung (befindet sich in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.1\Packages\<Package GUID > \toolbox]), oder der Benutzer setzt die Toolbox zurück. Wenn Sie den Standard Registrierungsschlüssel für Elemente erhöhen, ResetDefaults wird die-Methode aufgerufen, wobei grfFlags auf festgelegt ist PKGRF_TOOLBOXSETUP . wenn die Toolbox zurückgesetzt wird, wird die- ResetDefaults Methode aufgerufen, wobei grfFlags auf festgelegt ist PKGRF_TOOLBOXITEMS . Weitere Informationen finden Sie unter Registering Toolbox Item Providers.
Der Benutzer kann die Toolbox zurücksetzen, indem Sie im Menü Ansicht die Option Toolbox auswählen, indem Sie mit der rechten Maustaste in den Abschnitt Komponenten der Toolbox klicken und Elemente hinzufügen/entfernen auswählen. Dadurch wird das Dialogfeld Toolbox anpassen angezeigt, in dem die Schaltfläche Zurücksetzen enthalten ist. Durch Klicken auf die Schaltfläche Zurücksetzen wird die Toolbox zurückgesetzt.
Wenn die- IVsPackage.ResetDefaults Methode nur während des Setups aufgerufen werden soll, müssen Sie keine- IVsToolboxDataProvider Schnittstelle implementieren oder einen Registrierungsschlüssel für Formate angeben (finden Sie unter [ <VS Reg Root> \packages \<Package GUID > \toolbox]). Weitere Informationen finden Sie unter How to: Include Toolbox Support und- IVsToolboxDataProvider Schnittstelle. Wenn die- IVsPackage::ResetDefaults Implementierung mit dem Wert im- PKGRF_ADDSTDPREVIEWER Parameter aufgerufen wird, rufen Sie zu grfFlags AddStandardPreviewer diesem Zeitpunkt auf, um das Dialogfeld Durchsuchen mit einem bestimmten Browser aufzufüllen. Beispielsweise können Sie diesen Ansatz verwenden, um einen speziellen Emulator für Ihr Produkt bereitzustellen.