Icon Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Windows-Symbol dar, bei dem es sich um ein kleines Bitmapbild handelt, das zum Darstellen eines Objekts verwendet wird. Symbole können als transparente Bitmaps betrachtet werden, obwohl ihre Größe vom System bestimmt wird.
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
- Vererbung
- Attribute
- Implementiert
Beispiele
Im folgenden Codebeispiel wird die Verwendung der ToBitmap Methode veranschaulicht. Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Erstellen Sie ein Formular, und fügen Sie den folgenden Code in das Formular ein. Rufen Sie die IconToBitmap Methode im Ereignishandler des Formulars Paint auf, und übergeben Sie als ePaintEventArgs.
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, Datenströmen oder eingebetteten Ressourcen erstellen Icon . Eine Liste der Konstruktoren finden Sie unter Icon. Sie können eine Icon Bitmap auch mithilfe der ToBitmap Methode in eine Bitmap konvertieren.
Note
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 Kompilierungszeitwarnungen und Laufzeit-Ausnahmen. 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 Farbtiefe enthalten. Das Bild, das in einer Anwendung verwendet wird, hängt vom Betriebssystem und den Einstellungen ab. In der folgenden Liste werden die typischen Größen für ein Symbol aufgeführt:
16 Pixel x 16 Pixel
32 Pixel x 32 Pixel
48 Pixel x 48 Pixel
Konstruktoren
| Name | Beschreibung |
|---|---|
| Icon(Icon, Int32, Int32) |
Initialisiert eine neue Instanz der Icon Klasse und versucht, eine Version des Symbols zu finden, die der angeforderten Größe entspricht. |
| Icon(Icon, Size) |
Initialisiert eine neue Instanz der Icon Klasse und versucht, eine Version des Symbols zu finden, die der angeforderten Größe entspricht. |
| Icon(Stream, Int32, Int32) |
Initialisiert eine neue Instanz der Icon Klasse aus dem angegebenen Datenstrom und mit der angegebenen Breite und Höhe. |
| Icon(Stream, Size) |
Initialisiert eine neue Instanz der Icon Klasse der angegebenen Größe aus dem angegebenen Datenstrom. |
| Icon(Stream) |
Initialisiert eine neue Instanz der Icon Klasse aus dem angegebenen Datenstrom. |
| 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 der angegebenen Größe aus der angegebenen Datei. |
| Icon(String) |
Initialisiert eine neue Instanz der Icon Klasse aus dem angegebenen Dateinamen. |
| Icon(Type, String) |
Initialisiert eine neue Instanz der Icon Klasse aus einer Ressource in der angegebenen Assembly. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Handle |
Ruft den Windows Handle für dieses Icon ab. Dies ist keine Kopie des Handles; sie nicht freigeben. |
| Height |
Ruft die Höhe dieses .Icon |
| Size |
Ruft die Größe dieses Icon. |
| Width |
Ruft die Breite dieses .Icon |
Methoden
| Name | Beschreibung |
|---|---|
| Clone() |
Klont das Icon, erstellt ein dupliziertes Bild. |
| CreateObjRef(Type) |
Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject) |
| Dispose() |
Gibt alle von diesem IconRessourcen 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. |
| Finalize() |
Ermöglicht es einem Objekt, Ressourcen freizugeben und andere Bereinigungsvorgänge auszuführen, bevor es von der Garbage Collection erneut beansprucht wird. |
| FromHandle(IntPtr) |
Erstellt ein GDI+ Icon aus dem angegebenen Windows Handle zu einem Symbol ( |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetLifetimeService() |
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| InitializeLifetimeService() |
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject) |
| Save(Stream) | |
| ToBitmap() | |
| ToString() |
Ruft eine lesbare Zeichenfolge ab, die die Icon. |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind. |