Freigeben über


Icon Klasse

Definition

Stellt ein Windows-Symbol dar, bei dem es sich um ein Bitmap-Bild zur Darstellung eines Objekts handelt. Symbole lassen sich als transparente Bitmaps vorstellen, deren Größe jedoch durch das System bestimmt wird.

public ref class Icon sealed : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter("System.Drawing.IconConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
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.Serializable]
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter("System.Drawing.IconConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Vererbung
Attribute
Implementiert

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die ToBitmap-Methode verwenden. Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Create ein Formular, und fügen Sie den folgenden Code ein. Rufen Sie die IconToBitmap -Methode im Ereignishandler des Formulars Paint auf, und übergeben Sie e als 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

Hinweise

Sie können Objekte aus Dateien, Streams oder eingebetteten Ressourcen erstellen Icon . Eine Liste der Konstruktoren finden Sie unter Icon. Sie können auch eine Icon mit der ToBitmap -Methode in eine Bitmap konvertieren.

Hinweis

In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps führt zu Kompilierzeitwarnungen und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Eine Symbolressource kann mehrere Symbolbilder enthalten. Eine Symboldatei kann Bilder in mehreren Größen und Farbtiefen enthalten. Das Image, das in einer Anwendung verwendet wird, hängt vom Betriebssystem und den Einstellungen ab. Die folgende Liste enthält die typischen Größen für ein Symbol:

  • 16 Pixel x 16 Pixel

  • 32 Pixel x 32 Pixel

  • 48 Pixel x 48 Pixel

Konstruktoren

Icon(Icon, Int32, Int32)

Initialisiert eine neue Instanz der Icon-Klasse und sucht eine Version des Symbols, die der angeforderten Größe entspricht.

Icon(Icon, Size)

Initialisiert eine neue Instanz der Icon-Klasse und sucht eine Version des Symbols, die der angeforderten Größe entspricht.

Icon(Stream)

Initialisiert eine neue Instanz der Icon-Klasse aus dem angegebenen Stream.

Icon(Stream, Int32, Int32)

Initialisiert eine neue Instanz der Icon-Klasse aus dem angegebenen Datenstream und mit der angegebenen Breite und Höhe.

Icon(Stream, Size)

Initialisiert eine neue Instanz der Icon-Klasse mit der angegebenen Größe aus dem angegebenen Stream.

Icon(String)

Initialisiert eine neue Instanz der Icon-Klasse aus dem angegebenen Dateinamen.

Icon(String, Int32, Int32)

Initialisiert eine neue Instanz der Icon-Klasse mit der angegebenen Breite und Höhe aus der angegebenen Datei.

Icon(String, Size)

Initialisiert eine neue Instanz der Icon-Klasse mit der angegebenen Größe aus der angegebenen Datei.

Icon(Type, String)

Initialisiert eine neue Instanz der Icon-Klasse aus einer Ressource in der angegebenen Assembly.

Eigenschaften

Handle

Ruft das Windows-Handle für dieses Icon ab. Dies ist keine Kopie des Handles. Geben Sie es nicht frei.

Height

Ruft die Höhe dieses Icon ab.

Size

Ruft die Größe dieses Icon ab.

Width

Ruft die Breite dieses Icon ab.

Methoden

Clone()

Klont das Icon, wodurch ein Bildduplikat erstellt wird.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle von dieser Icon verwendeten Ressourcen frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
ExtractAssociatedIcon(String)

Gibt eine Symboldarstellung eines Bilds zurück, das in der angegebenen Datei enthalten ist.

ExtractIcon(String, Int32, Boolean)

Extrahiert ein angegebenes Symbol aus dem angegebenen filePath.

ExtractIcon(String, Int32, Int32)

Extrahiert ein angegebenes Symbol aus dem angegebenen filePath.

Finalize()

Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.

FromHandle(IntPtr)

Erstellt ein GDI+-Icon aus dem angegebenen Windows-Handle für ein Symbol (HICON).

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
Save(Stream)

Speichert dieses Icon im angegebenen Ausgabe-Stream.

ToBitmap()

Konvertiert dieses Icon in eine GDI+-Bitmap.

ToString()

Ruft eine Klartextzeichenfolge ab, die das Icon beschreibt.

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind.

Gilt für:

Weitere Informationen