IVsPackage.ResetDefaults(UInt32) 方法

  • 参考

定义

命名空间:
Microsoft.VisualStudio.Shell.Interop
程序集:
Microsoft.VisualStudio.Shell.Interop.dll
程序集:

重置工具箱默认值。

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

参数

grfFlags
UInt32

中值取自枚举的标志 __VSPKGRESETFLAGS 。

返回

Int32

如果该方法成功，则它会返回 S_OK。 如果该方法失败，则会返回错误代码。

注解

COM 签名

从 vsshell：

HRESULT IVsPackage::ResetDefaults(  
   [in] VSPKGRESETFLAGS grfFlags  
);

如果在 " 工具箱" 中安装项或工具，则实现此方法。 在安装时，环境将加载 VSPackage，并调用其 IVsPackage::ResetDefaults 实现。 成功配置 VSPackage 后，在 ResetDefaults 后续的设置过程中将不会调用该方法，除非你稍后递增 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.1\Packages<包 GUID \Toolbox] ) 中的注册表 (的默认项键 \ > ，否则用户将重置 工具箱。 如果递增默认项的注册表项，则在 ResetDefaults 设置为的情况下调用方法， grfFlags PKGRF_TOOLBOXSETUP 如果重置 工具箱 ，则 ResetDefaults 调用方法，并 grfFlags 将设置为 PKGRF_TOOLBOXITEMS 。 有关详细信息，请参阅 Registering Toolbox Item Providers。

用户可以通过在 "工具箱" 的 "组件" 部分中单击 "工具箱"，然后选择 "添加/删除项"，从 "视图" 菜单中选择 "工具箱" 来重置 工具箱。 这将显示 " 自定义工具箱 " 对话框，其中包括 " 重置 " 按钮。 单击 " 重置 " 按钮重置 工具箱。

如果希望仅在 IVsPackage.ResetDefaults 安装过程中调用方法，则无需实现 IVsToolboxDataProvider 接口或指定 (在 [ <VS Reg Root> \PACKAGES \<包 GUID \Toolbox] ) 中找到的格式注册表项 > 。 有关详细信息，请参阅 How to: Include Toolbox Support 和 IVsToolboxDataProvider 接口。 当 IVsPackage::ResetDefaults 使用参数中的值调用实现时 PKGRF_ADDSTDPREVIEWER grfFlags ， AddStandardPreviewer 在该时间调用以使用特定浏览器填充 " 浏览方式 " 对话框。 例如，您可以使用此方法为您的产品提供一个特殊的模拟器。

适用于