Icon Konstruktoren

Referenz

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

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.

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)

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 Farbtiefe enthalten. Das Bild, das in einer Anwendung verwendet wird, hängt von dem Betriebssystem und den Einstellungen ab. In der folgenden Liste werden die typischen Größen für ein Symbol beschrieben:

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 Datenstrom enthalten ist.

Gilt für

Icon(String)

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

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.

Gilt für

Icon(Icon, Size)

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 eine Version nicht gefunden werden kann, die genau mit der Größe übereinstimmt, wird die nächstgelegene Übereinstimmung verwendet. Wenn der original Parameter eine Icon einzelne Größe aufweist, erstellt diese Methode nur ein dupliziertes Symbol. Verwenden Sie die Stretchfunktionen der DrawImage Methode, um die Größe des Symbols zu ändern.

Gilt für

Icon(Stream, Size)

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.

Gilt für

Icon(String, Size)

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ächstgelegenen Größe zurückgegeben.

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

Gilt für

Icon(Type, String)

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 veranschaulicht, wie der Icon Konstruktor verwendet wird. Um dieses Beispiel auszuführen, fügen Sie den Code in ein Windows Formular ein, und behandeln Sie das Ereignis des FormularsPaint. Rufen Sie die ConstructAnIconFromAType Methode aus dem Paint Ereignishandler auf, indem e Sie 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 Ressource mit dem Namen, der durch den resource Parameter in der Assembly angegeben wird, der den vom type Parameter angegebenen Typ enthält.

Dieser Konstruktor kombiniert den Namespace des angegebenen Typs zusammen mit dem Zeichenfolgennamen der Ressource und sucht nach einer Übereinstimmung im Assemblymanifest. Sie können beispielsweise den Control Typ und Error.ico diesen Konstruktor übergeben und nach einer Ressource suchen, die benannt System.Windows.Forms.Error.icoist.

Gilt für

Icon(Icon, Int32, Int32)

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 wurde für die Verwendung mit Windows Forms entwickelt. Erstellen Sie ein Formular, und fügen Sie den folgenden Code darin ein. Rufen Sie die IconToBitmap Methode im Ereignishandler des Formulars Paint auf, indem e Sie 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

Gilt für

Icon(Stream, Int32, Int32)

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.

Gilt für

Icon(String, Int32, Int32)

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ächstgelegenen Größe zurückgegeben.

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

Gilt für

Icon Konstruktoren

Definition

Überlädt

Icon(Stream)

Parameter

Ausnahmen

Hinweise

Gilt für

Icon(String)

Parameter

Hinweise

Gilt für

Icon(Icon, Size)

Parameter

Ausnahmen

Hinweise

Gilt für

Icon(Stream, Size)

Parameter

Ausnahmen

Gilt für

Icon(String, Size)

Parameter

Ausnahmen

Hinweise

Gilt für

Icon(Type, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für

Icon(Icon, Int32, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für

Icon(Stream, Int32, Int32)

Parameter

Ausnahmen

Gilt für

Icon(String, Int32, Int32)

Parameter

Ausnahmen

Hinweise

Gilt für

Zusätzliche Ressourcen