Icon Konstruktoren

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Paket:: System.Drawing.Common v11.0.0-preview.4.26230.115

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

Name	Beschreibung
Icon(Stream)	Initialisiert eine neue Instanz der Icon Klasse aus dem angegebenen Datenstrom.
Icon(String)	Initialisiert eine neue Instanz der Icon Klasse aus dem angegebenen Dateinamen.
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, Size)	Initialisiert eine neue Instanz der Icon Klasse der angegebenen Größe aus dem angegebenen Datenstrom.
Icon(String, Size)	Initialisiert eine neue Instanz der Icon Klasse 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 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(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

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Initialisiert eine neue Instanz der Icon Klasse aus dem angegebenen Datenstrom.

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 Datenstrom, aus dem der IconDatenstrom 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 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

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

Gilt für:

Icon(String)

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

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 die Icon Datei 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)

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Initialisiert eine neue Instanz der Icon Klasse und versucht, eine Version des Symbols zu finden, 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 Symbol, von dem aus das neu angepasste Symbol geladen werden soll.

size: Size

Eine Size Struktur, die die Höhe und Breite des neuen Iconangibt.

Ausnahmen

ArgumentException

Der original Parameter ist null.

Hinweise

Wenn eine Version nicht gefunden werden kann, die exakt 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 Dehnungsfunktionen der DrawImage Methode, um die Größe des Symbols zu ändern.

Gilt für:

Icon(Stream, Size)

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Initialisiert eine neue Instanz der Icon Klasse der angegebenen Größe aus dem angegebenen Datenstrom.

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 Datenstrom, der die Symboldaten enthält.

size: Size

Die gewünschte Größe des Symbols.

Ausnahmen

ArgumentException

Dies stream ist null oder enthält keine Bilddaten.

Gilt für:

Icon(String, Size)

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Initialisiert eine neue Instanz der Icon Klasse 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 zu der Datei, die die Symboldaten enthält.

size: Size

Die gewünschte Größe des Symbols.

Ausnahmen

ArgumentException

Dies fileName 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.

Der fileName vollständige Pfad sollte enthalten, wenn er nicht im aktuellen Anwendungsverzeichnis enthalten ist.

Gilt für:

Icon(Type, String)

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

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 Wert, der die Assembly angibt, in der nach der Ressource gesucht werden soll.

resource: String

Der zu ladende Ressourcenname.

Ausnahmen

ArgumentException

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

Beispiele

Im folgenden Codebeispiel wird die Verwendung des Icon Konstruktors veranschaulicht. Um dieses Beispiel auszuführen, fügen Sie den Code in ein Windows Formular ein, und behandeln Sie das Paint-Ereignis des Formulars. Rufen Sie die ConstructAnIconFromAType Methode aus dem Paint Ereignishandler auf, und übergeben Sie 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, der den durch den type Parameter angegebenen Typ enthält.

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

Gilt für:

Icon(Icon, Int32, Int32)

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Initialisiert eine neue Instanz der Icon Klasse und versucht, eine Version des Symbols zu finden, 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, von dem die andere 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

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

Gilt für:

Icon(Stream, Int32, Int32)

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Initialisiert eine neue Instanz der Icon Klasse aus dem angegebenen Datenstrom 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 Datenstrom, 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)

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

Quelle:: Icon.cs

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 der Icon.

height: Int32

Die gewünschte Höhe der Icon.

Ausnahmen

ArgumentException

Dies fileName 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.

Der fileName vollständige Pfad sollte enthalten, wenn er nicht im aktuellen Anwendungsverzeichnis enthalten ist.

Gilt für:

Feedback

War diese Seite hilfreich?