IVsPackage.ResetDefaults(UInt32) Método

Definição

Redefine os padrões da caixa de ferramentas.

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

Parâmetros

grfFlags
UInt32

no Sinalizadores cujos valores são extraídos da __VSPKGRESETFLAGS enumeração.

Retornos

Int32

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

Assinatura COM

De VSShell. idl:

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

Implemente esse método se você instalar itens ou ferramentas, na caixa de ferramentas. Na instalação, o ambiente carrega seu VSPackage e chama sua IVsPackage::ResetDefaults implementação. Depois que o VSPackage tiver sido configurado com êxito, o ResetDefaults método não será chamado durante as configurações subsequentes, a menos que você aumente posteriormente a chave de itens padrão no registro (encontrado em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.1\Packages\<GUID do pacote > \toolbox]) ou o usuário redefina a caixa de ferramentas. Se você incrementar a chave de registro de itens padrão, o ResetDefaults método será chamado com grfFlags definido como PKGRF_TOOLBOXSETUP e se a caixa de ferramentas for redefinida, o ResetDefaults método será chamado com grfFlags definido como PKGRF_TOOLBOXITEMS . Para obter mais informações, consulte Registering Toolbox Item Providers.

O usuário pode redefinir a caixa de ferramentas selecionando caixa de ferramentas no menu Exibir clicando com o botão direito do mouse na seção componentes da caixa de ferramentas e selecionando Adicionar/remover itens. Isso mostra a caixa de diálogo Personalizar caixas de ferramentas , que inclui o botão Redefinir . Clicar no botão Redefinir redefine a caixa de ferramentas.

Se desejar que o IVsPackage.ResetDefaults método seja chamado somente durante a instalação, você não precisará implementar a IVsToolboxDataProvider interface ou especificar uma chave de registro de formatos (encontrada em [ <VS Reg Root> \Packages \<GUID do pacote > \toolbox]). Para obter mais informações, consulte How to: Include Toolbox Support e IVsToolboxDataProvider interface. Quando sua IVsPackage::ResetDefaults implementação for chamada com um valor de PKGRF_ADDSTDPREVIEWER no grfFlags parâmetro, chame AddStandardPreviewer nesse momento para preencher a caixa de diálogo procurar com um navegador específico. Por exemplo, você pode usar essa abordagem para fornecer um emulador especial para seu produto.

Aplica-se a