Creare un controllo casella degli strumenti WPF

Articolo
12/21/2023

Il modello di controllo della casella degli strumenti WPF (Windows Presentation Framework) consente di creare controlli WPF che vengono aggiunti automaticamente alla casella degli strumenti quando l'estensione è installata. Questa procedura dettagliata illustra come usare il modello per creare un controllo casella degli strumenti che è possibile distribuire ad altri utenti.

Creare il controllo casella degli strumenti

Creare un'estensione con un controllo casella degli strumenti WPF

Creare un progetto VSIX denominato MyToolboxControl. È possibile trovare il modello di progetto VSIX nella finestra di dialogo Nuovo progetto cercando "vsix".
Quando si apre il progetto, aggiungere un modello di elemento di controllo della casella degli strumenti WPF denominato MyToolboxControl. Nella Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo del progetto e scegliere Aggiungi>nuovo elemento. Nella finestra di dialogo Aggiungi nuovo elemento passare a Visual C#>Estendibilità e selezionare Controllo casella degli strumenti WPF. Nel campo Nome nella parte inferiore della finestra modificare il nome del file di comando in MyToolboxControl.cs.

La soluzione contiene ora un controllo utente, un oggetto ProvideToolboxControlAttributeRegistrationAttribute che aggiunge il controllo alla casella degli strumenti e una voce asset Microsoft.VisualStudio.ToolboxControl nel manifesto VSIX per la distribuzione.

Creare l'interfaccia utente del controllo

Aprire MyToolboxControl.xaml nella finestra di progettazione.

La finestra di progettazione mostra un controllo Grid che contiene un controllo Button.
Disporre il layout della griglia. Quando si seleziona il Grid controllo, le barre di controllo blu vengono visualizzate sui bordi superiore e sinistro della griglia. È possibile aggiungere righe e colonne alla griglia facendo clic sulle barre.
Aggiungere controlli figlio alla griglia. Puoi posizionare un controllo figlio trascinandolo dalla casella degli strumenti a una sezione della griglia oppure impostandone Grid.Row gli attributi e Grid.Column nel codice XAML. Nell'esempio seguente vengono aggiunte due etichette nella riga superiore della griglia e un pulsante nella seconda riga.
```
<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>
```

Ridenominazione del controllo

Per impostazione predefinita, il controllo verrà visualizzato nella casella degli strumenti come MyToolboxControl in un gruppo denominato MyToolboxControl.MyToolboxControl. È possibile modificare questi nomi nel file MyToolboxControl.xaml.cs .

Aprire MyToolboxControl.xaml.cs nella visualizzazione codice.
Trovare la MyToolboxControl classe e rinominarla in TestControl. Il modo più rapido per eseguire questa operazione consiste nel rinominare la classe, quindi selezionare Rinominare dal menu di scelta rapida e completare i passaggi. (Per altre informazioni su Comando Rinomina, vedere Rinominare il refactoring (C#).)
Passare all'attributo ProvideToolboxControl e modificare il valore del primo parametro in Test. Si tratta del nome del gruppo che conterrà il controllo nella casella degli strumenti.

Il codice risultante dovrebbe essere simile al seguente:
```
[ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}
```

Compilazione, test e distribuzione

Quando si esegue il debug del progetto, è necessario trovare il controllo installato nella casella degli strumenti dell'istanza sperimentale di Visual Studio.

Per compilare e testare il controllo

Ricompilare il progetto e avviare il debug.
Nella nuova istanza di Visual Studio creare un progetto di applicazione WPF. Assicurarsi che la finestra di progettazione XAML sia aperta.
Individuare il controllo nella casella degli strumenti e trascinarlo nell'area di progettazione.
Avviare il debug dell'applicazione WPF.
Verificare che venga visualizzato il controllo.

Per distribuire il controllo

Dopo aver compilato il progetto testato, è possibile trovare il file vsix nella cartella *\bin\debug* del progetto.
È possibile installarlo in un computer locale facendo doppio clic sul file vsix e seguendo la procedura di installazione. Per disinstallare il controllo, passare a Strumenti>Estensioni e Aggiornamenti e cercare l'estensione del controllo, quindi fare clic su Disinstalla.
Caricare il file vsix in una rete o in un sito Web.

Se si carica il file nel sito Web di Visual Studio Marketplace, altri utenti possono usare Le estensioni degli strumenti>e Aggiornamenti in Visual Studio per trovare il controllo online e installarlo.

Condividi tramite