Icon Classe

Definizione

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 (HICON).

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)

Salva l'oggetto Icon nell'output Streamspecificato.

ToBitmap()

Converte l'oggetto Icon in un GDI+ Bitmap.

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.

Si applica a

Vedi anche