ProvideToolWindowAttribute Classe

Definição

Namespace:

Microsoft.VisualStudio.Shell

Assembly:

Microsoft.VisualStudio.Shell.15.0.dll

Pacote:

Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Notifica o Visual Studio de que um VSPackage possui uma janela de ferramentas.

public ref class ProvideToolWindowAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

public ref class ProvideToolWindowAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)]
public sealed class ProvideToolWindowAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
type ProvideToolWindowAttribute = class
    inherit RegistrationAttribute

Public NotInheritable Class ProvideToolWindowAttribute
Inherits RegistrationAttribute

Herança

Attribute

RegistrationAttribute

ProvideToolWindowAttribute

Atributos

AttributeUsageAttribute

Comentários

Quando chamar

Implemente a ProvideToolWindowAttribute classe quando um VSPackage implementar uma ou mais janelas de ferramentas.

Uso básico

Esse atributo declara que um VSPackage específico possui uma janela de ferramentas. Ele também ajuda a determinar o posicionamento e a persistência da janela de ferramentas quando ela é criada. Para usar ProvideToolWindowAttribute, coloque-o em uma classe de pacote derivada de Package ou implementando IVsPackage.

Esse atributo só é usado para fornecer dados para ferramentas de registro externas. Ele não tem nenhum efeito sobre o comportamento de runtime do VSPackage.

Entradas do Registro

• A ProvideToolWindowAttribute classe cria as seguintes entradas do Registro:

• <VSROOT>\ToolWindows\{ToolWindowGuid}

• <VSROOT>\ToolWindows\{ToolWindowGuid}\@={ToolWindowTypeGuid}

• <VSROOT>\ToolWindows\{ToolWindowGuid}\Name=ToolWindowName

• As seguintes entradas do Registro são opcionais:

• <VSROOT>\ToolWindows\{ToolWindowGuid}\Float=FloatPosition

• <VSROOT>\ToolWindows\{ToolWindowGuid}\Style=ToolWindowStyle

• <VSROOT>\ToolWindows\{ToolWindowGuid}\Window=DockWith

• <VSROOT>\ToolWindows\{ToolWindowGuid}\Orientation=ToolWindowOrientation

Construtores

ProvideToolWindowAttribute(Type)

Inicializa uma nova instância de ProvideToolWindowAttribute.

Propriedades

AutoHidden	Defina como true para ocultar a janela de ferramentas por padrão.
DockedHeight	Obtém o minério define a altura padrão do ToolWindow quando encaixado.
DockedWidth	Obtém ore define a largura padrão do ToolWindow quando encaixado.
DocumentLikeTool	Defina essa propriedade como true se você quiser uma janela de ferramenta que seja como um documento em seu comportamento e tempo de vida. A janela de ferramentas será apenas MDI ou flutuante e permanecerá visível em sua posição em todas as alterações de layout até que seja fechada manualmente pelo usuário, momento em que ela será destruída. Esse sinalizador implica DontForceCreate e várias instâncias destrutivas.
Height	Obtém ou define a altura padrão da janela de ferramentas.
MultiInstances	Determina se várias instâncias da janela de ferramentas são permitidas.
Orientation	Obtém ou define a orientação padrão para a janela de ferramentas em relação à janela especificada pela propriedade Window.
PositionX	Obtém ou define o valor horizontal padrão do canto superior esquerdo da janela de ferramentas.
PositionY	Obtém ou define o valor vertical do canto superior esquerdo da janela de ferramentas.
Style	Obtém ou define o estilo de encaixe padrão para a janela de ferramentas.
ToolType	Obtém ou define o tipo da janela de ferramentas.
Transient	Obtém ou define se a janela de ferramentas não deve ser reaberta quando o IDE é reiniciado.
TypeId	Substitua a propriedade TypeID para permitir que as classes derivadas de RegistrationAttribute funcionem com System.ComponentModel.TypeDescriptor.GetAttributes(...). Um atributo derivado deste terá que substituir essa propriedade somente se precisar de um controle melhor nas instâncias que podem ser aplicadas a uma classe. (Herdado de RegistrationAttribute)
Width	Obtém ou define a largura padrão da janela de ferramentas.
Window	Obtém ou define o GUID da janela padrão na qual a janela de ferramentas deve ser encaixada.

Métodos

GetPackageRegKeyPath(Guid)	Obtém o caminho do Registro (em relação à raiz do Registro do aplicativo) do VSPackage. (Herdado de RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Registra a janela de ferramentas.
Unregister(RegistrationAttribute+RegistrationContext)	Remove a chave do Registro da janela de ferramentas.