Creación de un control de cuadro de herramientas de WPF

Artículo
07/12/2024

La plantilla de control del cuadro de herramientas de WPF (Windows Presentation Framework) permite crear controles de 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 del Cuadro de herramientas, que se puede distribuir a otros usuarios.

Creación del control de cuadro de herramientas

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

Cree un proyecto de VSIX denominado MyToolboxControl. Puede encontrar la plantilla de proyecto VSIX en el cuadro de diálogo Nuevo proyecto; para ello, busque "vsix".
Cuando se abra el proyecto, agregue una plantilla de elementos de 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, un RegistrationAttribute ProvideToolboxControlAttribute que 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

Abra MyToolboxControl.xaml en el diseñador.

El diseñador muestra un control Grid que contiene un control Button.
Organice el diseño de la cuadrícula. Al seleccionar el control Grid, 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.
Agregue controles secundarios a la cuadrícula. Puede colocar un control secundario arrastrándolo desde el Cuadro de herramientas a una sección de la cuadrícula, o estableciendo sus atributos Grid.Row 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 en 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>
```

Cambio del nombre del control

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

Abra MyToolboxControl.xaml.cs en la vista de código.
Busque la clase MyToolboxControl y cámbiele el nombre a TestControl. (La manera más rápida de hacerlo es cambiar el nombre de la clase y, a continuación, seleccionar Cambiar el nombre en el menú contextual y completar los pasos. (Para obtener más información sobre el comando Cambiar el nombre, consulte Cambio del nombre de la refactorización (C#)).
Vaya al atributo ProvideToolboxControl 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

Recompile el proyecto y comience la depuración.
En la nueva instancia de Visual Studio, cree un proyecto de aplicación WPF. Asegúrese de que el Diseñador XAML está abierto.
Busque el control en el Cuadro de herramientas y arrástrelo a la superficie de diseño.
Empiece a depurar la aplicación de WPF.
Compruebe que aparece el control.

Para implementar el control

Después de compilar el proyecto probado, encontrará el archivo .vsix en la carpeta *\bin\debug* del proyecto.
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 actualizaciones y busque la extensión de control y haga clic en Desinstalar.
Cargue el archivo .vsix en una red o en un sitio web.

Si va a cargar el archivo en el sitio web de Visual Studio Marketplace, otros usuarios pueden usar Herramientas>Extensiones y actualizaciones en Visual Studio para buscar el control en línea e instalarlo.

Compartir vía