Procedura dettagliata: creazione di un'icona della casella degli strumenti personalizzata per un controllo

In questa procedura dettagliata viene illustrato come creare un'icona Casella degli strumenti per un controllo personalizzato WPF (Windows Presentation Foundation). Quando si aggiunge il controllo personalizzato alla casella degli strumenti, l'icona è visualizzata accanto al nome del controllo.

Questa procedura dettagliata prevede l'esecuzione delle attività seguenti:

  • Creazione di un progetto di libreria di controlli personalizzati WPF.

  • Creazione di un file bitmap personalizzato per l'icona Casella degli strumenti del controllo.

  • Test dell'icona del controllo in fase di progettazione.

Al termine, si sarà in grado di creare un'icona Casella degli strumenti per un controllo personalizzato.

Nota

È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida a seconda delle impostazioni attive o dell'edizione del programma. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Gestione delle impostazioni.

Prerequisiti

Per completare la procedura dettagliata, è necessario disporre dei componenti seguenti:

  • Visual Studio 2010.

Creazione di un'icona Casella degli strumenti personalizzata

Per creare un'icona Casella degli strumenti personalizzata per un controllo, aggiungere un'immagine come risorsa incorporata al progetto del controllo.

Per creare un'icona della casella degli strumenti personalizzata

  1. In Visual Basic o Visual C# creare un nuovo progetto di libreria di controlli personalizzati WPF denominato CustomControlWithToolboxIcon.

    Il codice per CustomControl1 verrà aperto nell'editor di codice.

  2. Scegliere Aggiungi nuovo elemento dal menu Progetto.

    Viene aperta la finestra di dialogo Aggiungi nuovo elemento.

  3. Nella finestra di dialogo Aggiungi nuovo elemento selezionare la categoria Generale.

  4. Nell'elenco dei modelli selezionare File bitmap, denominare il file nuovo come CustomControl1.Icon.bmp e quindi fare clic su Aggiungi.

    Viene visualizzato l'editor di immagini.

  5. Nella finestra Proprietà impostare la proprietà Colori della bitmap su 24 bit.

  6. Utilizzare gli strumenti dell'editor di immagini per disegnare un'immagine nella bitmap. Per ulteriori informazioni, vedere Editor immagini.

  7. In Esplora soluzioni, selezionare CustomControl1.Icon.bmp.

  8. Nella finestra Proprietà, impostare la proprietà Operazione di compilazione su Risorsa incorporata.

  9. Compilare la soluzione

    Per ulteriori informazioni, vedere Icone della casella degli strumenti.

Test dell'icona Casella degli strumenti

Verificare l'icona Casella degli strumenti personalizzata aggiungendo CustomControl1 alla casella degli strumenti.

Per verificare l'icona Casella degli strumenti

  1. In Visual Basic o Visual C# aggiungere un nuovo progetto di applicazione WPF denominato TestApplication.

    MainWindow.xaml viene aperto in WPF Designer. Nella casella degli strumenti verrà visualizzato CustomControl1 nella scheda CustomControlWithToolboxIcon Controls.

    Casella degli strumenti con controllo personalizzato

  2. Nella casella degli strumenti fare clic con il pulsante destro del mouse su CustomControl1 e scegliere Elimina.

  3. Fare clic su OK nella finestra di messaggio visualizzata.

    CustomControl1 verrà rimosso dalla casella degli strumenti.

  4. Nella casella degli strumenti, fare clic con il pulsante destro del mouse sul gruppo del controllo in cui si desidera aggiungere il controllo e quindi selezionare Scegli elementi dal menu di scelta rapida.

    Verrà visualizzata la finestra di dialogo Scegli elementi della Casella degli strumenti.

  5. Nella finestra di dialogo Scegli elementi della Casella degli strumenti, fare clic sulla scheda Componenti WPF. Per ulteriori informazioni, vedere Scheda Componenti WPF, finestra di dialogo Scegli elementi della Casella degli strumenti.

  6. Fare clic su Sfoglia e passare alla cartella bin\Debug del progetto CustomControlWithToolboxIcon.

  7. Nella finestra di dialogo Apri selezionare CustomControlWithToolboxIcon.dll e fare clic su Apri.

    I dettagli dell'assembly CustomControlWithToolboxIcon vengono visualizzati nella finestra di dialogo Scegli elementi della Casella degli strumenti. L'icona personalizzata è visualizzata nella casella di gruppo CustomControl1.

  8. Scegliere OK.

    CustomControl1 verrà visualizzato nella casella degli strumenti con l'icona corrispondente.

    Icona della casella degli strumenti personalizzata

Vedere anche

Attività

Procedura: incorporare un'icona in un assembly

Riferimenti

Scheda Componenti WPF, finestra di dialogo Scegli elementi della Casella degli strumenti

Altre risorse

Icone della casella degli strumenti

Utilizzo delle risorse

Procedura dettagliata: aggiunta di metadati alle icone della casella degli strumenti