Crear un control de cuadro de herramientas de WPF

  • Artículo

La plantilla Control del cuadro de herramientas de WPF (Windows Presentation Framework) le permite crear controles WPF que se agregan automáticamente al Cuadro de herramientas cuando se instala la extensión. En este tutorial se muestra cómo usar la plantilla para crear un control cuadro de herramientas que puede distribuir a otros usuarios.

Crear el control cuadro de herramientas

Crear una extensión con un control del cuadro de herramientas de WPF

  1. Cree un proyecto VSIX denominado MyToolboxControl. Puede encontrar la plantilla de proyecto VSIX en el cuadro de diálogo Nuevo proyecto buscando "vsix".

  2. Cuando se abra el proyecto, agregue una plantilla de elemento control del cuadro de herramientas de WPF denominada MyToolboxControl. En el Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto y seleccione Agregar>Nuevo elemento. En el cuadro de diálogo Agregar nuevo elemento, vaya a Visual C#>Extensibilidad y seleccione Control de cuadro de herramientas de WPF. En el campo Nombre de la parte inferior de la ventana, cambie el nombre del archivo de comando a MyToolboxControl.cs.

    La solución ahora contiene un control de usuario, que ProvideToolboxControlAttributeRegistrationAttribute agrega el control al cuadro de herramientas y una entrada de recurso Microsoft.VisualStudio.ToolboxControl en el manifiesto VSIX para la implementación.

Para crear la interfaz de usuario del control

  1. Abra MyToolboxControl.xaml en el diseñador.

    El diseñador muestra un control Grid que contiene un control Button.

  2. Organice el diseño de la cuadrícula. Al seleccionar el Grid control, las barras de control azules aparecen en los bordes superior e izquierdo de la cuadrícula. Puede agregar filas y columnas a la cuadrícula haciendo clic en las barras.

  3. Agregue controles secundarios a la cuadrícula. Puedes colocar un control secundario arrastrándolo desde el Cuadro de herramientas a una sección de la cuadrícula, o estableciendo sus Grid.Row atributos y Grid.Column en el XAML. En el ejemplo siguiente se agregan dos etiquetas en la fila superior de la cuadrícula y un botón de la segunda fila.

    <Grid>
    <Label Grid.Row="0" Grid.Column="0" Name="label1" />
    <Label Grid.Row="0" Grid.Column="1" Name="label2" />
    <Button Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
</Grid>

Cambiar el nombre del control

De forma predeterminada, el control aparecerá en el Cuadro de herramientas como MyToolboxControl en un grupo denominado MyToolboxControl.MyToolboxControl. Puedes cambiar estos nombres en el archivo MyToolboxControl.xaml.cs .

  1. Abra MyToolboxControl.xaml.cs en la vista de código.

  2. Busque la clase y cámbiele el MyToolboxControl nombre a TestControl. (La manera más rápida de hacerlo es cambiar el nombre de la clase y, a continuación, seleccionar Cambie el nombre del menú contextual y complete los pasos. (Para obtener más información sobre Cambie el nombre del comando y vea Cambiar el nombre de la refactorización (C#)).

  3. Vaya al ProvideToolboxControl atributo y cambie el valor del primer parámetro a Test. Este es el nombre del grupo que contendrá el control en el Cuadro de herramientas.

    El código resultante debe tener este aspecto:

    [ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}

Compilación, prueba e implementación

Al depurar el proyecto, debe encontrar el control instalado en el Cuadro de herramientas de la instancia experimental de Visual Studio.

Para compilar y probar el control

  1. Recompile el proyecto e inicie la depuración.

  2. En la nueva instancia de Visual Studio, cree un proyecto de aplicación WPF. Asegúrese de que el Diseñador XAML está abierto.

  3. Busque el control en el Cuadro de herramientas y arrástrelo a la superficie de diseño.

  4. Inicie la depuración de la aplicación WPF.

  5. Compruebe que aparece el control.

Para implementar el control

  1. Después de compilar el proyecto probado, puede encontrar el archivo .vsix en la carpeta *\bin\debug* del proyecto.

  2. Para instalarlo en un equipo local, haga doble clic en el archivo .vsix y siga el procedimiento de instalación. Para desinstalar el control, vaya a Herramientas>Extensiones y Novedades y busque la extensión de control y haga clic en Desinstalar.

  3. Cargue el archivo .vsix en una red o en un sitio web.

    Si carga el archivo en el sitio web de Visual Studio Marketplace, otros usuarios pueden usar extensiones de herramientas>y Novedades en Visual Studio para buscar el control en línea e instalarlo.