Icone della casella degli strumenti

In Visual Studio e in Expression Blend è possibile includere icone della casella degli strumenti con controlli personalizzati WPF e Silverlight. In questo argomento viene descritto come assegnare un nome alle icone della casella degli strumenti e come includerle come risorse incorporate.

Tipi di file supportati

Nell'elenco seguente vengono elencati i tipi di file supportati per le icone della casella degli strumenti in WPF Designer per Visual Studio. 

  • BMP

  • GIF

  • JPG

  • JPEG

  • PNG

Nota

Expression Blend supporta solo file con estensione png.

Convenzione di denominazione

Per associare un'icona Casella degli strumenti a un controllo personalizzato occorre seguire una convenzione di denominazione. Gli strumenti di progettazione esaminano le risorse incorporate nell'assembly del controllo per trovare un file di immagine denominato in modo appropriato.

Nel caso più semplice, si aggiunge il file di immagine dell'icona Casella degli strumenti come risorsa incorporata al progetto del controllo. Denominare il file NomeControllo.Estensione e nella finestra Proprietà impostare Operazione di compilazione su Risorsa incorporata. WPF Designer cerca una risorsa con il nome file che corrisponde al nome del tipo del controllo. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di un'icona della casella degli strumenti personalizzata per un controllo.

Nota

Per garantire la compatibilità con le versioni precedenti, Visual Studio 2010 supporta la convenzione di denominazione utilizzata da Visual Studio 2008. Per ulteriori informazioni, vedere Icone della casella degli strumenti in Visual Studio 2008.

Visual Studio 2010 supporta la seguente convenzione di denominazione per le icone della casella degli strumenti. Le sottostringhe tra parentesi quadre ([]) sono facoltative.

[QualsiasiStringa]SpazioDeiNomi.NomeControllo[.Prodotto][.QualsiasiStringa].Estensione

Quando una finestra di progettazione cerca le icone della casella degli strumenti, confronta le sottostringhe SpazioDeiNomi, NomeControllo e Prodotto. Se SpazioDeiNomi e NomeControllo non corrispondono al controllo, l'icona non verrà visualizzata nella casella degli strumenti.

È possibile che la sottostringa Prodotto venga utilizzata da una finestra di progettazione per filtrare icone per altri prodotti. Ad esempio, Visual Studio preferisce icone che hanno impostato la sottostringa Prodotto su "VisualStudio".

Nell'elenco seguente vengono mostrate le convenzioni di denominazione dell'icona della casella degli strumenti di esempio che è possibile utilizzare per icone di Visual Studio e di Expression Blend.

  • SpazioDeiNomi.NomeControllo.VisualStudio.Estensione

  • SpazioDeiNomi.NomeControllo.VisualStudio.QualsiasiStringa.Estensione

  • SpazioDeiNomi.NomeControllo.Expression.png

  • SpazioDeiNomi.NomeControllo.Expression.QualsiasiStringa.png

Se nessuna icona trovata si adatta ai nomi precedenti, verranno cercati i nomi seguenti.

  • SpazioDeiNomi.NomeControllo.Estensione

  • SpazioDeiNomi.NomeControllo.QualsiasiStringa.Estensione

Nell'elenco seguente vengono illustrati i nomi di esempio dell'icona della casella degli strumenti per un controllo denominato TailspinToysControl nello spazio dei nomi TailspinToysControlLibrary. Informazioni facoltative aggiuntive sul formato di immagine vengono aggiunte, ma non vengono utilizzate dalle finestre di progettazione.

  • TailspinToysControlLibrary.TailspinToysControl.VisualStudio.24bit.48x48.bmp

  • TailspinToysControlLibrary.TailspinToysControl.Expression.4bit.16x16.png

Dopo che una finestra di progettazione ha trovato le icone della casella degli strumenti, l'icona che più si avvicina alla dimensione dell'icona di destinazione della finestra di progettazione viene caricata per la visualizzazione. Nell'elenco seguente viene mostrato l'ordine nel quale vengono applicati i criteri di confronto.

  1. Selezione delle icone con la finestra di progettazione specificata nel nome dell'icona anziché delle icone senza una finestra di progettazione specificata. Ad esempio, WPF Designer preferisce le icone nel cui nome è presente "VisualStudio" anziché quelle che contengono "Expression".

  2. Selezione dell'icona che più si avvicina alla dimensione di rendering. La casella degli strumenti Visual Studio carica l'icona che più si avvicina a 16x16 pixel, quindi esegue il mapping di quell'icona con l'intensità di colore a 24 bit.

  3. Selezione dell'icona trovata per prima.

Esecuzione dell'override delle icone della casella degli strumenti predefinite

È possibile utilizzare il framework di estensibilità di WPF Designer per eseguire l'override delle icone della casella degli strumenti incorporate in un assembly di runtime di un controllo. Per ulteriori informazioni, vedere Procedura dettagliata: aggiunta di metadati alle icone della casella degli strumenti.

Vedere anche

Concetti

Icone della casella degli strumenti in Visual Studio 2008

Altre risorse

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