Icon Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta un'icona Windows, ovvero un'immagine bitmap di piccole dimensioni utilizzata per rappresentare un oggetto. Le icone possono essere considerate come bitmap trasparenti, anche se le dimensioni sono determinate dal sistema.
public ref class Icon sealed : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
[System.Serializable]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
type Icon = class
inherit MarshalByRefObject
interface ISerializable
interface ICloneable
interface IDisposable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
type Icon = class
inherit MarshalByRefObject
interface ISerializable
interface ICloneable
interface IDisposable
Public NotInheritable Class Icon
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable
- Ereditarietà
- Attributi
- Implementazioni
Esempio
Nell'esempio di codice seguente viene illustrato come usare il ToBitmap metodo . Questo esempio è progettato per essere usato con Windows Form. Creare un modulo e incollarvi il codice seguente. Chiamare il IconToBitmap metodo nel gestore eventi del Paint modulo, passando e come PaintEventArgs.
private:
void IconToBitmap( PaintEventArgs^ e )
{
// Construct an Icon.
System::Drawing::Icon^ icon1 = gcnew System::Drawing::Icon( SystemIcons::Exclamation,40,40 );
// Call ToBitmap to convert it.
Bitmap^ bmp = icon1->ToBitmap();
// Draw the bitmap.
e->Graphics->DrawImage( bmp, Point(30,30) );
}
private void IconToBitmap(PaintEventArgs e)
{
// Construct an Icon.
Icon icon1 = new Icon(SystemIcons.Exclamation, 40, 40);
// Call ToBitmap to convert it.
Bitmap bmp = icon1.ToBitmap();
// Draw the bitmap.
e.Graphics.DrawImage(bmp, new Point(30, 30));
}
Private Sub IconToBitmap(ByVal e As PaintEventArgs)
' Construct an Icon.
Dim icon1 As New Icon(SystemIcons.Exclamation, 40, 40)
' Call ToBitmap to convert it.
Dim bmp As Bitmap = icon1.ToBitmap()
' Draw the bitmap.
e.Graphics.DrawImage(bmp, New Point(30, 30))
End Sub
Commenti
È possibile costruire Icon oggetti da file, flussi o risorse incorporate. Per un elenco dei costruttori, vedere Icon. È anche possibile convertire un oggetto Icon in una bitmap usando il ToBitmap metodo .
Annotazioni
In .NET 6 e versioni successive il pacchetto System.Drawing.Common, che include questo tipo, è supportato solo nei sistemi operativi Windows. L'uso di questo tipo nelle app multipiattaforma causa avvisi in fase di compilazione ed eccezioni in fase di esecuzione. Per altre informazioni, vedere System.Drawing.Common supportato solo in Windows.
Una risorsa icona può contenere più immagini icona. Un file icona può contenere immagini in diverse dimensioni e profondità dei colori. L'immagine usata in un'applicazione dipende dal sistema operativo e dalle impostazioni. L'elenco seguente illustra in dettaglio le dimensioni tipiche per un'icona:
16 pixel x 16 pixel
32 pixel x 32 pixel
48 pixel x 48 pixel
Costruttori
| Nome | Descrizione |
|---|---|
| Icon(Icon, Int32, Int32) |
Inizializza una nuova istanza della Icon classe e tenta di trovare una versione dell'icona corrispondente alle dimensioni richieste. |
| Icon(Icon, Size) |
Inizializza una nuova istanza della Icon classe e tenta di trovare una versione dell'icona corrispondente alle dimensioni richieste. |
| Icon(Stream, Int32, Int32) |
Inizializza una nuova istanza della Icon classe dal flusso di dati specificato e con la larghezza e l'altezza specificate. |
| Icon(Stream, Size) |
Inizializza una nuova istanza della Icon classe delle dimensioni specificate dal flusso specificato. |
| Icon(Stream) |
Inizializza una nuova istanza della Icon classe dal flusso di dati specificato. |
| Icon(String, Int32, Int32) |
Inizializza una nuova istanza della Icon classe con la larghezza e l'altezza specificate dal file specificato. |
| Icon(String, Size) |
Inizializza una nuova istanza della Icon classe delle dimensioni specificate dal file specificato. |
| Icon(String) |
Inizializza una nuova istanza della Icon classe dal nome file specificato. |
| Icon(Type, String) |
Inizializza una nuova istanza della Icon classe da una risorsa nell'assembly specificato. |
Proprietà
| Nome | Descrizione |
|---|---|
| Handle |
Ottiene l'handle di Windows per questo Icon. Non si tratta di una copia dell'handle; non liberarlo. |
| Height |
Ottiene l'altezza di questo Iconoggetto . |
| Size |
Ottiene le dimensioni di questo Iconoggetto . |
| Width |
Ottiene la larghezza dell'oggetto Icon. |
Metodi
| Nome | Descrizione |
|---|---|
| Clone() |
Clona , Iconcreando un'immagine duplicata. |
| CreateObjRef(Type) |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject) |
| Dispose() |
Rilascia tutte le risorse usate da questo Iconoggetto . |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| ExtractAssociatedIcon(String) |
Restituisce una rappresentazione dell'icona di un'immagine contenuta nel file specificato. |
| Finalize() |
Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperata da Garbage Collection. |
| FromHandle(IntPtr) |
Crea un handle GDI+ Icon dall'handle di Windows specificato a un'icona ( |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| InitializeLifetimeService() |
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| Save(Stream) | |
| ToBitmap() | |
| ToString() |
Ottiene una stringa leggibile che descrive l'oggetto Icon. |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Popola un oggetto SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione. |