Icon Icon Icon Icon Class

Definition

Stellt ein Windows-Symbol dar, bei dem es sich um ein Bitmap-Bild zur Darstellung eines Objekts handelt.Represents a Windows icon, which is a small bitmap image that is used to represent an object. Symbole lassen sich als transparente Bitmaps vorstellen, deren Größe jedoch durch das System bestimmt wird.Icons can be thought of as transparent bitmaps, although their size is determined by the system.

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]
[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
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.The following code example demonstrates how to use the ToBitmap method. Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert.This example is designed to be used with Windows Forms. Erstellen Sie ein Formular, und fügen Sie den folgenden Code in die Datei ein.Create a form and paste the following code into it. Wenden Sie IconToBitmap die-Methode im- Paint Ereignishandler des Formulars e an PaintEventArgs, und übergeben Sie als.Call the IconToBitmap method in the form's Paint event handler, passing e as 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 Icon aus Dateien, Streams oder eingebetteten Ressourcen erstellen.You can construct Icon objects from files, streams, or embedded resources. Eine Liste der Konstruktoren finden IconSie unter.For a list of constructors, see Icon. Mithilfe der Icon ToBitmap -Methode können Sie auch ein in eine Bitmap konvertieren.You can also convert an Icon to a bitmap by using the ToBitmap method.

Eine Symbol Ressource kann mehrere Symbolbilder enthalten.An icon resource can contain multiple icon images. Eine Symbol Datei kann Bilder in verschiedenen Größen und Farbtiefe enthalten.One icon file may contain images in several sizes and color depths. Das Image, das in einer Anwendung verwendet wird, hängt vom Betriebssystem und den Einstellungen ab.The image that is used in an application depends on the operating system and settings. In der folgenden Liste sind die typischen Größen für ein Symbol aufgeführt:The following list details the typical sizes for an icon:

  • 16 Pixel x 16 Pixel16 pixels x 16 pixels

  • 32 Pixel x 32 Pixel32 pixels x 32 pixels

  • 48 Pixel x 48 Pixel48 pixels x 48 pixels

Konstruktoren

Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32)

Initialisiert eine neue Instanz der Icon-Klasse und sucht eine Version des Symbols, die der angeforderten Größe entspricht.Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

Icon(Icon, Size) Icon(Icon, Size) Icon(Icon, Size) Icon(Icon, Size)

Initialisiert eine neue Instanz der Icon-Klasse und sucht eine Version des Symbols, die der angeforderten Größe entspricht.Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

Icon(Stream) Icon(Stream) Icon(Stream) Icon(Stream)

Initialisiert eine neue Instanz der Icon-Klasse aus dem angegebenen Stream.Initializes a new instance of the Icon class from the specified data stream.

Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32)

Initialisiert eine neue Instanz der Icon-Klasse aus dem angegebenen Datenstream und mit der angegebenen Breite und Höhe.Initializes a new instance of the Icon class from the specified data stream and with the specified width and height.

Icon(Stream, Size) Icon(Stream, Size) Icon(Stream, Size) Icon(Stream, Size)

Initialisiert eine neue Instanz der Icon-Klasse mit der angegebenen Größe aus dem angegebenen Stream.Initializes a new instance of the Icon class of the specified size from the specified stream.

Icon(String) Icon(String) Icon(String) Icon(String)

Initialisiert eine neue Instanz der Icon-Klasse aus dem angegebenen Dateinamen.Initializes a new instance of the Icon class from the specified file name.

Icon(String, Int32, Int32) Icon(String, Int32, Int32) Icon(String, Int32, Int32) Icon(String, Int32, Int32)

Initialisiert eine neue Instanz der Icon-Klasse mit der angegebenen Breite und Höhe aus der angegebenen Datei.Initializes a new instance of the Icon class with the specified width and height from the specified file.

Icon(String, Size) Icon(String, Size) Icon(String, Size) Icon(String, Size)

Initialisiert eine neue Instanz der Icon-Klasse mit der angegebenen Größe aus der angegebenen Datei.Initializes a new instance of the Icon class of the specified size from the specified file.

Icon(Type, String) Icon(Type, String) Icon(Type, String) Icon(Type, String)

Initialisiert eine neue Instanz der Icon-Klasse aus einer Ressource in der angegebenen Assembly.Initializes a new instance of the Icon class from a resource in the specified assembly.

Eigenschaften

Handle Handle Handle Handle

Ruft das Windows-Handle für dieses Icon ab.Gets the Windows handle for this Icon. Dies ist keine Kopie des Handles. Geben Sie es nicht frei.This is not a copy of the handle; do not free it.

Height Height Height Height

Ruft die Höhe dieses Icon ab.Gets the height of this Icon.

Size Size Size Size

Ruft die Größe dieses Icon ab.Gets the size of this Icon.

Width Width Width Width

Ruft die Breite dieses Icon ab.Gets the width of this Icon.

Methoden

Clone() Clone() Clone() Clone()

Klont das Icon, wodurch ein Bildduplikat erstellt wird.Clones the Icon, creating a duplicate image.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Gibt alle von dieser Icon verwendeten Ressourcen frei.Releases all resources used by this Icon.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractAssociatedIcon(String) ExtractAssociatedIcon(String) ExtractAssociatedIcon(String) ExtractAssociatedIcon(String)

Gibt eine Symboldarstellung eines Bildes zurück, das in der angegebenen Datei enthalten ist.Returns an icon representation of an image that is contained in the specified file.

Finalize() Finalize() Finalize() Finalize()

Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

FromHandle(IntPtr) FromHandle(IntPtr) FromHandle(IntPtr) FromHandle(IntPtr)

Erstellt ein GDI+-Icon aus dem angegebenen Windows-Handle für ein Symbol (HICON).Creates a GDI+ Icon from the specified Windows handle to an icon (HICON).

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Save(Stream) Save(Stream) Save(Stream) Save(Stream)

Speichert dieses Icon im angegebenen Ausgabe-Stream.Saves this Icon to the specified output Stream.

ToBitmap() ToBitmap() ToBitmap() ToBitmap()

Konvertiert dieses Icon in eine GDI+-Bitmap.Converts this Icon to a GDI+ Bitmap.

ToString() ToString() ToString() ToString()

Ruft eine Klartextzeichenfolge ab, die das Icon beschreibt.Gets a human-readable string that describes the Icon.

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind.Populates a SerializationInfo with the data that is required to serialize the target object.

Gilt für:

Siehe auch