Método IVsPackage.ResetDefaults (UInt32)

Artigo
06/13/2016

Redefine os padrões da caixa de ferramentas.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

int ResetDefaults(
    uint grfFlags
)

int ResetDefaults(
    unsigned int grfFlags
)

abstract ResetDefaults : 
        grfFlags:uint32 -> int

Function ResetDefaults (
    grfFlags As UInteger
) As Integer

Parâmetros

grfFlags
[in] Sinalizadores cujos valores são obtidos a partir do __VSPKGRESETFLAGS enumeração.

Valor de retorno

Type: System.Int32

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

Comentários

COM assinatura

De vsshell.idl:

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

Implementar este método se você instalar ferramentas, ou itens na caixa de ferramentas.Na instalação, o ambiente carrega seu VSPackage e chama seu IVsPackage::ResetDefaults implementação.Depois que seu VSPackage configurar com êxito, o ResetDefaults método não será chamado durante as instalações subseqüentes, a menos que você mais tarde incrementa a chave de itens padrão no registro (encontrada no \Toolbox HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.1\Packages\ < GUID do pacote >]), ou redefine o usuário a caixa de ferramentas.Se você incrementar a chave de registro de itens padrão, o ResetDefaults método é chamado com grfFlags definido como PKGRF_TOOLBOXSETUP e se o caixa de ferramentas é redefinido, o ResetDefaults método é chamado com grfFlags definido como PKGRF_TOOLBOXITEMS.Para obter mais informações, consulte Registering Toolbox Item Providers.

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

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

Consulte também

Interface IVsPackage
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via