IVsPackage.ResetDefaults(UInt32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.