ProvideToolWindowAttribute Clase

Definición

Espacio de nombres:

Microsoft.VisualStudio.Shell

Ensamblado:

Microsoft.VisualStudio.Shell.15.0.dll

Paquete:

Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Notifica a Visual Studio que un VSPackage posee una ventana de herramientas.

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

Herencia

Attribute

RegistrationAttribute

ProvideToolWindowAttribute

Atributos

AttributeUsageAttribute

Comentarios

Cuándo llamar

Implemente la ProvideToolWindowAttribute clase cuando un VSPackage implementa una o varias ventanas de herramientas.

Uso básico

Este atributo declara que un VSPackage específico posee una ventana de herramientas. También ayuda a determinar el posicionamiento y la persistencia de la ventana de herramientas cuando se crea. Para usar ProvideToolWindowAttribute, colóquelo en una clase de paquete derivada de Package o implemente IVsPackage.

Este atributo solo se usa para proporcionar datos para herramientas de registro externas. No tiene ningún efecto en el comportamiento en tiempo de ejecución del VSPackage.

Entradas del Registro

• La ProvideToolWindowAttribute clase crea las siguientes entradas del Registro:

• <VSROOT>\ToolWindows\{ToolWindowGuid}

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

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

• Las siguientes entradas del Registro son opcionales:

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

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

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

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

Constructores

ProvideToolWindowAttribute(Type)

Inicializa una nueva instancia de la clase ProvideToolWindowAttribute.

Propiedades

AutoHidden	Establézcalo en true para ocultar la ventana de herramientas de forma predeterminada.
DockedHeight	Obtiene ore establece el alto predeterminado de ToolWindow cuando está acoplado.
DockedWidth	Obtiene ore establece el ancho predeterminado de ToolWindow cuando está acoplado.
DocumentLikeTool	Establezca esta propiedad en true si desea una ventana de herramientas similar a un documento en su comportamiento y duración. La ventana de herramientas solo será MDI o flotante y permanecerá visible en su posición en todos los cambios de diseño hasta que el usuario lo cierre manualmente en cuyo momento se destruirá. Esta marca implica DontForceCreate y la instancia múltiple destructiva.
Height	Obtiene o establece el alto predeterminado de la ventana de herramientas.
MultiInstances	Determina si varias instancias de la ventana de herramientas están permitidas.
Orientation	Obtiene o establece la orientación predeterminada para la ventana de herramientas en relación con la ventana especificada por la propiedad Window.
PositionX	Obtiene o establece el valor horizontal predeterminado de la esquina superior izquierda de la ventana de herramientas.
PositionY	Obtiene o establece el valor vertical de la esquina superior izquierda de la ventana de herramientas.
Style	Obtiene o establece el estilo predeterminado de acoplamiento para la ventana de herramientas.
ToolType	Obtiene o establece el tipo de la ventana de herramientas.
Transient	Obtiene o establece si la ventana de herramientas no se debe volver a abrir cuando se reinicia el IDE.
TypeId	Invalide la propiedad TypeID para permitir que las clases derivadas RegistrationAttribute funcionen con System.ComponentModel.TypeDescriptor.GetAttributes(...). Un atributo derivado de este tendrá que invalidar esta propiedad solo si necesita un mejor control en las instancias que se pueden aplicar a una clase. (Heredado de RegistrationAttribute)
Width	Obtiene o establece el ancho predeterminado de la ventana de herramientas.
Window	Obtiene o establece el GUID de la ventana predeterminada en la que la ventana de herramientas se debe acoplar.

Métodos

GetPackageRegKeyPath(Guid)	Obtiene la ruta del Registro (en relación con la raíz del Registro de la aplicación) del Paquete VSPackage. (Heredado de RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Registrar la ventana de herramientas.
Unregister(RegistrationAttribute+RegistrationContext)	Quita la clave del Registro para la ventana de herramientas.