Icon Classe

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

Icon.cs

Rappresenta un'icona di Windows, ossia una piccola immagine bitmap usata per rappresentare un oggetto. Le icone possono essere considerate come delle bitmap trasparenti, anche se le loro 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.Serializable]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable

[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable

Public NotInheritable Class Icon
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable

Ereditarietà

Object

MarshalByRefObject

Icon

Attributi

TypeConverterAttribute SerializableAttribute

Implementazioni

ICloneable IDisposable ISerializable

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo ToBitmap. Questo esempio è progettato per essere usato con Windows Forms. Create 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 di costruttori, vedere Icon. È anche possibile convertire un oggetto Icon in una bitmap usando il ToBitmap metodo .

Nota

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 di runtime. 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à di colore. 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

Icon(Icon, Int32, Int32)	Inizializza una nuova istanza della classe Icon e prova a individuare una versione dell'icona che corrisponda alle dimensioni richieste.
Icon(Icon, Size)	Inizializza una nuova istanza della classe Icon e prova a individuare una versione dell'icona che corrisponda alle dimensioni richieste.
Icon(Stream)	Inizializza una nuova istanza della classe Icon dal flusso dei dati specificato.
Icon(Stream, Int32, Int32)	Inizializza una nuova istanza della classe Icon dal flusso dei dati specificato e con la larghezza e l'altezza indicate.
Icon(Stream, Size)	Inizializza una nuova istanza della classe Icon delle dimensioni indicate dal flusso specificato.
Icon(String)	Inizializza una nuova istanza della classe Icon dal nome file specificato.
Icon(String, Int32, Int32)	Inizializza una nuova istanza della classe Icon con la larghezza e l'altezza specificate dal file.
Icon(String, Size)	Inizializza una nuova istanza della classe Icon delle dimensioni indicate dal file specificato.
Icon(Type, String)	Inizializza una nuova istanza della classe Icon da una risorsa nell'assembly specificato.

Proprietà

Handle	Ottiene l'handle di Windows per questo oggetto Icon. Non si tratta di una copia dell'handle, pertanto non deve essere liberata.
Height	Ottiene l'altezza di questo oggetto Icon.
Size	Ottiene le dimensioni di questo oggetto Icon.
Width	Ottiene la larghezza di questo oggetto Icon.

Metodi

Clone()	Clona l'oggetto Icon, creando un'immagine duplicata.
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da questa classe Icon.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
ExtractAssociatedIcon(String)	Restituisce una rappresentazione in forma di icona di un'immagine contenuta nel file specificato.
ExtractIcon(String, Int32, Boolean)	Estrae un'icona specificata dall'oggetto specificato filePath.
ExtractIcon(String, Int32, Int32)	Estrae un'icona specificata dall'oggetto specificato filePath.
Finalize()	Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection.
FromHandle(IntPtr)	Crea un oggetto Icon GDI+ dall'handle Windows specificato per un'icona (HICON).
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetType()	Ottiene l'oggetto 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 dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
Save(Stream)	Salva questo oggetto Icon nell'oggetto Stream di output specificato.
ToBitmap()	Converte questo oggetto Icon in una classe Bitmap GDI+.
ToString()	Ottiene una stringa leggibile in cui è descritto l'oggetto Icon.

Implementazioni dell'interfaccia esplicita

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popola un oggetto SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione.

Vedi anche

• Utilizzo di immagini, bitmap, icone e metafile