ProvideToolboxItemsAttribute Clase

Referencia

Definición

Espacio de nombres:: Microsoft.VisualStudio.Shell

Ensamblado:: Microsoft.VisualStudio.Shell.14.0.dll

Ensamblado:: Microsoft.VisualStudio.Shell.15.0.dll

Paquete:: Microsoft.VisualStudio.Shell.15.0 v17.11.40262

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Aplique este atributo a las clases que implementan VSPackages para declarar si ofrecen un conjunto de elementos en el Cuadro de herramientas de Visual Studio.

public ref class ProvideToolboxItemsAttribute : Microsoft::VisualStudio::Shell::RegistrationAttribute

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

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

Public Class ProvideToolboxItemsAttribute
Inherits RegistrationAttribute

Herencia: Attribute

RegistrationAttribute
ProvideToolboxItemsAttribute

Atributos: AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente, los atributos aplicados a la clase MyPackage indican que admite la versión 1 de los elementos del Cuadro de herramientas de con dos formatos de Portapapeles "CF_XMLCODE" y "InPlaceMenuEditorMenu".

[DefaultRegistryRoot("Software\\Microsoft\\VisualStudio\\8.0")]  
[ProvideToolboxItems(true, 1)]  
[ProvideToolboxFormat("CF_XMLCODE")]  
[ProvideToolboxFormat("InPlaceMenuEditorMenu")]  
[Guid("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]  
internal sealed class MyPackage : Package

Comentarios

Contexto de atributo


Se aplica a	Clases que proporcionan VSPackages mediante la implementación IVsPackagede , Package.
Reiterativo	No
Atributos necesarios	ProvideToolboxFormatAttribute
Atributos no válidos	None

Aplique este atributo a una Packageclase derivada de o a una clase que implemente que sea necesario para permitir que los usuarios arrastren objetos de datos de este formato, proporcionados IVsPackage por la clase, al Cuadro de herramientas. Esta clase de implementación debe controlar las notificaciones de eliminación.

Este atributo solo se usa con fines de registro y no afecta al comportamiento del código en tiempo de ejecución.

Dependiendo de los argumentos especificados en su constructor, este atributo puede indicar que un VSPackage no proporciona ningún elemento del cuadro de herramientas . Si el atributo ProvideToolboxFormatAttribute se agrega a una clase para indicar que proporciona elementos del Cuadro de herramientas , también se deben agregar una o varias instancias de ProvideToolboxFormatAttribute .

Este atributo usa ProvideToolboxFormatAttribute para registrar un VSPackage como proporcionar elementos del cuadro de herramientas de un formato determinado.

Si este atributo especifica que se proporcionan elementos del cuadro de herramientas , VSPackage debe controlar los ToolboxInitialized eventos y ToolboxUpgraded .

Cualquier VSPackage que use este atributo debe proporcionar un controlador para los ToolboxInitialized eventos y ToolboxUpgraded .

Constructores

ProvideToolboxItemsAttribute(Int32)	Crea una nueva instancia de que ProvideToolboxItemsAttribute indica si una clase que implementa un VSPackage proporciona elementos del cuadro de herramientas.
ProvideToolboxItemsAttribute(Int32, Boolean)	Inicializa una nueva instancia de ProvideToolboxItemsAttribute para la versión especificada.

Propiedades

NeedsCallBackAfterReset	Si se establece en true, se forzará un evento ToolboxInitialized después de restablecer cada cuadro de herramientas. Esto se puede usar al desarrollar el paquete para obligar al cuadro de herramientas a pedir la lista de elementos al paquete cada vez (en caso de que haya cambiado). En el caso de los productos enviados, es mejor dejarlo en false para que la memoria caché se pueda usar para mejorar el rendimiento. Es posible que algún escenario (como la lista de elementos que no se pueda conservar en la memoria caché) tenga que establecer esta marca en true.
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)
Version	Propiedad que devuelve la versión de los elementos del cuadro de herramientas que proporciona un VSPackage.

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)	Registra un VSPackage como proveedor de elementos del cuadro de herramientas para los formatos especificados cuando lo llama una herramienta de registro externo, como regpkg.exe. Para obtener más información, consulte Registro de VSPackages.
Unregister(RegistrationAttribute+RegistrationContext)	Revierte los cambios que el método Register(RegistrationAttribute+RegistrationContext) aplicó al Registro.

Se aplica a

Compartir a través de