Icone della casella degli strumenti in Visual Studio 2008
È possibile includere icone della casella degli strumenti con i controlli personalizzati Windows Presentation Foundation (WPF) in Visual Studio. In questo argomento viene descritto come assegnare un nome alle icone della casella degli strumenti e come includerle come risorse incorporate.
Nota
Questo argomento è stato mantenuto per garantire la compatibilità con Visual Studio 2008. Per Visual Studio 2010, vedere Icone della casella degli strumenti.
Tipi di file supportati
Nella tabella seguente vengono elencati i tipi di file supportati per le icone della casella degli strumenti in WPF Designer per Visual Studio.
XAML
BMP
GIF
JPG
JPEG
PNG
Convenzione di denominazione
Per associare un'icona Casella degli strumenti a un controllo personalizzato occorre seguire una convenzione di denominazione. WPF Designer per Visual Studio esamina 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. Assegnare il nome nel formato NomeControllo.Estensione. 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
WPF Designer utilizza un algoritmo di corrispondenza per trovare la risorsa migliore per un'icona Casella degli strumenti. Se un file di risorse non è un file XAML o un file di immagine valido, viene utilizzata la corrispondenza successiva fino a trovare quella corretta. Le immagini XAML non possono contenere riferimenti ai tipi non di sistema.
Nome totalmente corrispondente
La convenzione di denominazione dell'icona Casella degli strumenti supporta i nomi di risorsa totalmente corrispondenti. Per i nomi totalmente corrispondenti, nel nome dell'icona Casella degli strumenti viene inserito lo spazio dei nomi secondo la convenzione Spaziodeinomi.NomeControllo.Icona.Estensione. Ad esempio, si consideri un controllo denominato ProseControl definito nello spazio dei nomi Proseware.Core.Controls. L'icona Casella degli strumenti PNG totalmente corrispondente per questo controllo verrebbe denominata Proseware.Core.Controls.ProseControl.Icon.png.
Per le risorse, Visual Studio converte automaticamente le cartelle negli spazi dei nomi. Pertanto è possibile creare una struttura di cartelle nel progetto uguale a quella dello spazio dei nomi. Tenere presente che le cartelle influiscono sullo spazio dei nomi in cui si trovano le risorse incorporate. Nell'esempio precedente, se il file di immagine si trova in una sottocartella denominata Icons, WPF Designer cercherà un'icona Casella degli strumenti denominata Proseware.Core.Controls.Icons.ProseControl.Icon.png.
Se non viene trovata alcuna immagine nello stesso spazio dei nomi del controllo, WPF Designer cerca una corrispondenza per approssimazione.
Nome approssimativamente corrispondente
Se WPF Designer non trova una risorsa totalmente corrispondente, cerca corrispondenze approssimative nelle risorse incorporate dell'assembly. Nell'esempio precedente, WPF Designer cerca prima un file con il nome totalmente corrispondente Proseware.Core.Controls.ProseControl.Icon.Estensione. Se questa ricerca non riesce, WPF Designer ignora lo spazio dei nomi e cerca un nome basandosi solo sul nome del tipo. In questo esempio, WPF Designer cerca nelle risorse un file denominato Proseware.ProseControl.Icon.Estensione. Se la ricerca ha esito negativo, WPF Designer inizia a cercare nello spazio dei nomi predefinito. In questo esempio, WPF Designer cerca i file denominati Proseware.ProseControl.Icon.Estensione.
Più dimensioni delle immagini
Il nome del file di immagine dell'icona Casella degli strumenti può includere un campo facoltativo "Icon". Questa sottostringa consente di specificare più dimensioni di immagini per l'icona.
Per il controllo ProseControl dell'esempio precedente, WPF Designer trova le immagini seguenti nelle risorse e seleziona la migliore corrispondenza per la dimensione.
Proseware.Core.Controls.ProseControl.Icon.Large.png
Proseware.Core.Controls.ProseControl.Icon.Medium.png
Proseware.Core.Controls.ProseControl.Icon.ReallyLarge.png
Si può anche omettere il punto che segue "Icon" per specificare i nomi file seguenti.
Proseware.Core.Controls.ProseControl.IconLarge.png
Proseware.Core.Controls.ProseControl.IconMedium.png
Proseware.Core.Controls.ProseControl.IconReallyLarge.png
WPF Designer seleziona l'icona Casella degli strumenti sulla base delle regole seguenti.
XAML di vettore.
Corrispondenza esatta del valore in entrambe le dimensioni.
Corrispondenza più vicina per dimensione e proporzione.
La dimensione dell'immagine consigliata per i formati di file bitmap è 64 pixel per 64 pixel.
WPF Designer e Expression Blend utilizzano dimensioni di immagine diverse per l'icona Casella degli strumenti. Expression Blend utilizza 24x24 per la dimensione grande dell'icona e 12x12 per la dimensione piccola. WPF Designer utilizza 16x16.
Se la dimensione richiesta dall'host è 64x64 pixel e Proseware.Core.Controls.ProseControl.Icon.Large.png è la migliore corrispondenza per dimensione e proporzione, viene utilizzato questo file. Tutte le immagini nell'assembly vengono esaminate. Se ci sono due immagini con la stessa dimensione e proporzione è l'host che decide quale immagine viene utilizzata.