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.
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".
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.
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