Icon Konstruktoren

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Initialisiert eine neue Instanz der Icon-Klasse.

Überlädt

Icon(Stream)	Initialisiert eine neue Instanz der Icon-Klasse aus dem angegebenen Stream.
Icon(String)	Initialisiert eine neue Instanz der Icon-Klasse aus dem angegebenen Dateinamen.
Icon(Icon, Size)	Initialisiert eine neue Instanz der Icon-Klasse und sucht eine Version des Symbols, die der angeforderten Größe entspricht.
Icon(Stream, Size)	Initialisiert eine neue Instanz der Icon-Klasse mit der angegebenen Größe aus dem angegebenen Stream.
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.
Icon(Icon, Int32, Int32)	Initialisiert eine neue Instanz der Icon-Klasse und sucht eine Version des Symbols, die der angeforderten Größe entspricht.
Icon(Stream, Int32, Int32)	Initialisiert eine neue Instanz der Icon-Klasse aus dem angegebenen Datenstream und mit der angegebenen Breite und Höhe.
Icon(String, Int32, Int32)	Initialisiert eine neue Instanz der Icon-Klasse mit der angegebenen Breite und Höhe aus der angegebenen Datei.

Icon(Stream)

Quelle:

Icon.cs

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

public:
 Icon(System::IO::Stream ^ stream);

public Icon (System.IO.Stream stream);

new System.Drawing.Icon : System.IO.Stream -> System.Drawing.Icon

Public Sub New (stream As Stream)

Parameter

stream

Stream

Der Datenstream, aus dem das Icon geladen werden soll.

Ausnahmen

ArgumentException

Der stream-Parameter ist null.

Hinweise

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. In der folgenden Liste sind 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

Dieser Konstruktor gibt das kleinste Bild zurück, das im angegebenen Stream enthalten ist.

Icon(String)

Quelle:

Icon.cs

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

public:
 Icon(System::String ^ fileName);

public Icon (string fileName);

new System.Drawing.Icon : string -> System.Drawing.Icon

Public Sub New (fileName As String)

Parameter

fileName

String

Die Datei, aus der das Icon geladen werden soll.

Hinweise

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. In der folgenden Liste sind 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

Dieser Konstruktor gibt das kleinste Bild zurück, das in der angegebenen Datei enthalten ist.

Icon(Icon, Size)

Quelle:

Icon.cs

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

public:
 Icon(System::Drawing::Icon ^ original, System::Drawing::Size size);

public Icon (System.Drawing.Icon original, System.Drawing.Size size);

new System.Drawing.Icon : System.Drawing.Icon * System.Drawing.Size -> System.Drawing.Icon

Public Sub New (original As Icon, size As Size)

Parameter

original

Icon

Das Icon, aus dem das Symbol mit geänderter Größe geladen werden soll.

size

Size

Eine Size-Struktur, die die Breite und Höhe des neuen Icon angibt.

Ausnahmen

ArgumentException

Der original-Parameter ist null.

Hinweise

Wenn keine Version gefunden werden kann, die genau der Größe entspricht, wird die nächstgelegene Übereinstimmung verwendet. Wenn der original Parameter ein Icon ist, der eine einzelne Größe hat, erstellt diese Methode nur ein doppeltes Symbol. Verwenden Sie die Dehnungsfunktionen der DrawImage -Methode, um die Größe des Symbols zu ändern.

Icon(Stream, Size)

Quelle:

Icon.cs

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

public:
 Icon(System::IO::Stream ^ stream, System::Drawing::Size size);

public Icon (System.IO.Stream stream, System.Drawing.Size size);

new System.Drawing.Icon : System.IO.Stream * System.Drawing.Size -> System.Drawing.Icon

Public Sub New (stream As Stream, size As Size)

Parameter

stream

Stream

Der Stream, der die Symboldaten enthält.

size

Size

Die gewünschte Größe des Symbols.

Ausnahmen

ArgumentException

Der stream ist null oder enthält keine Bilddaten.

Icon(String, Size)

Quelle:

Icon.cs

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

public:
 Icon(System::String ^ fileName, System::Drawing::Size size);

public Icon (string fileName, System.Drawing.Size size);

new System.Drawing.Icon : string * System.Drawing.Size -> System.Drawing.Icon

Public Sub New (fileName As String, size As Size)

Parameter

fileName

String

Der Name und der Pfad zur Datei, die die Symboldaten enthält.

size

Size

Die gewünschte Größe des Symbols.

Ausnahmen

ArgumentException

Der string ist null oder enthält keine Bilddaten.

Hinweise

Wenn die angegebene Datei kein Bild enthält, das der gewünschten Größe entspricht, wird das Symbol mit der nächsten Größe zurückgegeben.

Der fileName sollte den vollständigen Pfad enthalten, wenn er sich nicht im aktuellen Anwendungsverzeichnis befindet.

Icon(Type, String)

Quelle:

Icon.cs

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

public:
 Icon(Type ^ type, System::String ^ resource);

public Icon (Type type, string resource);

new System.Drawing.Icon : Type * string -> System.Drawing.Icon

Public Sub New (type As Type, resource As String)

Parameter

type

Type

Ein Type, der die Assembly angibt, in der die Ressource gesucht werden soll.

resource

String

Der zu ladende Ressourcenname.

Ausnahmen

ArgumentException

Ein von resource angegebenes Symbol kann nicht in der Assembly gefunden werden, die den angegebenen type enthält.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des Icon Konstruktors veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels den Code in ein Windows Form-Formular ein, und behandeln Sie das Ereignis des Formulars Paint . Rufen Sie die ConstructAnIconFromAType -Methode aus dem Paint Ereignishandler auf, und übergeben Sie e als EventArgs.

private void ConstructAnIconFromAType(PaintEventArgs e)
{

    Icon icon1 = new Icon(typeof(Control), "Error.ico");
    e.Graphics.DrawIcon(icon1, new Rectangle(10, 10, 50, 50));
}

Private Sub ConstructAnIconFromAType(ByVal e As PaintEventArgs)

    Dim icon1 As New Icon(GetType(Control), "Error.ico")
    e.Graphics.DrawIcon(icon1, New Rectangle(10, 10, 50, 50))

End Sub

Hinweise

Dieser Konstruktor erstellt eine Icon aus einer Ressource mit dem Namen, der durch den Parameter in der resource Assembly angegeben wird, die den vom type Parameter angegebenen Typ enthält.

Dieser Konstruktor kombiniert den Namespace des angegebenen Typs mit dem Zeichenfolgennamen der Ressource und sucht im Assemblymanifest nach einer Übereinstimmung. Sie können z. B. den Control Typ und Error.ico an diesen Konstruktor übergeben und nach einer Ressource mit dem Namen System.Windows.Forms.Error.icosuchen.

Icon(Icon, Int32, Int32)

Quelle:

Icon.cs

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

public:
 Icon(System::Drawing::Icon ^ original, int width, int height);

public Icon (System.Drawing.Icon original, int width, int height);

new System.Drawing.Icon : System.Drawing.Icon * int * int -> System.Drawing.Icon

Public Sub New (original As Icon, width As Integer, height As Integer)

Parameter

original

Icon

Das Symbol, aus dem die geänderte Größe geladen werden soll.

width

Int32

Die Breite des neuen Symbols.

height

Int32

Die Höhe des neuen Symbols.

Ausnahmen

ArgumentException

Der original-Parameter ist null.

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 aus, 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

Wenn keine Version gefunden werden kann, die genau der Größe entspricht, wird die nächstgelegene Übereinstimmung verwendet. Wenn der original Parameter ein Icon ist, der eine einzelne Größe hat, erstellt diese Methode nur ein doppeltes Symbol. Verwenden Sie die Dehnungsfunktionen der DrawImage -Methode, um die Größe des Symbols zu ändern.

Icon(Stream, Int32, Int32)

Quelle:

Icon.cs

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

public:
 Icon(System::IO::Stream ^ stream, int width, int height);

public Icon (System.IO.Stream stream, int width, int height);

new System.Drawing.Icon : System.IO.Stream * int * int -> System.Drawing.Icon

Public Sub New (stream As Stream, width As Integer, height As Integer)

Parameter

stream

Stream

Der Datenstream, aus dem das Symbol geladen werden soll.

width

Int32

Die Breite des Symbols in Pixel.

height

Int32

Die Höhe des Symbols in Pixel.

Ausnahmen

ArgumentException

Der stream-Parameter ist null.

Icon(String, Int32, Int32)

Quelle:

Icon.cs

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

public:
 Icon(System::String ^ fileName, int width, int height);

public Icon (string fileName, int width, int height);

new System.Drawing.Icon : string * int * int -> System.Drawing.Icon

Public Sub New (fileName As String, width As Integer, height As Integer)

Parameter

fileName

String

Der Name und der Pfad zu der Datei, die die Icon-Daten enthält.

width

Int32

Die gewünschte Breite des Icon.

height

Int32

Die gewünschte Höhe des Icon.

Ausnahmen

ArgumentException

Der string ist null oder enthält keine Bilddaten.

Hinweise

Wenn die angegebene Datei kein Bild enthält, das der gewünschten Höhe und Breite entspricht, wird das Symbol mit der nächsten Größe zurückgegeben.

Der fileName sollte den vollständigen Pfad enthalten, wenn er sich nicht im aktuellen Anwendungsverzeichnis befindet.