Icon Konstruktoren

Definition

Initialisiert eine neue Instanz der Icon-Klasse.Initializes a new instance of the Icon class.

Überlädt

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(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(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, 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, 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)

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.

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(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(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(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.

public:
 Icon(System::IO::Stream ^ stream);
public Icon (System.IO.Stream stream);
new System.Drawing.Icon : System.IO.Stream -> System.Drawing.Icon

Parameter

stream
Stream

Der Datenstream, aus dem das Icon geladen werden soll.The data stream from which to load the Icon.

Ausnahmen

Der stream-Parameter ist null.The stream parameter is null.

Hinweise

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

Dieser Konstruktor gibt das kleinste Bild zurück, das im angegebenen Stream enthalten ist.This constructor returns the smallest image that is contained in the specified stream.

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.

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.The file to load the Icon from.

Hinweise

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

Dieser Konstruktor gibt das kleinste Bild zurück, das in der angegebenen Datei enthalten ist.This constructor returns the smallest image that is contained in the specified file.

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.

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

Parameter

original
Icon

Das Icon, aus dem das Symbol mit geänderter Größe geladen werden soll.The Icon from which to load the newly sized icon.

size
Size

Eine Size-Struktur, die die Breite und Höhe des neuen Icon angibt.A Size structure that specifies the height and width of the new Icon.

Ausnahmen

Der original-Parameter ist null.The original parameter is null.

Hinweise

Wenn keine Version gefunden werden kann, die exakt mit der Größe übereinstimmt, wird die nächstgelegene Übereinstimmung verwendet.If a version cannot be found that exactly matches the size, the closest match is used. Wenn es original sich bei dem Icon Parameter um eine mit einer einzelnen Größe handelt, wird von dieser Methode nur ein Duplikat erstellt.If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. Verwenden Sie die streckungs Funktionen DrawImage der-Methode, um die Größe des Symbols zu ändern.Use the stretching capabilities of the DrawImage method to resize the icon.

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.

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

Parameter

stream
Stream

Der Stream, der die Symboldaten enthält.The stream that contains the icon data.

size
Size

Die gewünschte Größe des Symbols.The desired size of the icon.

Ausnahmen

Der stream ist null oder enthält keine Bilddaten.The stream is null or does not contain image data.

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.

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

Parameter

fileName
String

Der Name und der Pfad zur Datei, die die Symboldaten enthält.The name and path to the file that contains the icon data.

size
Size

Die gewünschte Größe des Symbols.The desired size of the icon.

Ausnahmen

Der string ist null oder enthält keine Bilddaten.The string is null or does not contain image data.

Hinweise

Wenn die angegebene Datei kein Bild enthält, das mit der gewünschten Größe übereinstimmt, wird das Symbol mit der nächstgelegenen Größe zurückgegeben.If the specified file does not contain an image that matches the desired size, the icon that has the closest size is returned.

Der fileName sollte den kompletten Pfad enthalten, wenn er sich nicht im aktuellen Anwendungsverzeichnis befindet.The fileName should include the complete path if it is not in the current application directory.

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.

public:
 Icon(Type ^ type, System::String ^ resource);
public Icon (Type type, string resource);
new System.Drawing.Icon : Type * string -> System.Drawing.Icon

Parameter

type
Type

Ein Type, der die Assembly angibt, in der die Ressource gesucht werden soll.A Type that specifies the assembly in which to look for the resource.

resource
String

Der zu ladende Ressourcenname.The resource name to load.

Ausnahmen

Ein von resource angegebenes Symbol kann nicht in der Assembly gefunden werden, die den angegebenen type enthält.An icon specified by resource cannot be found in the assembly that contains the specified type.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des Icon -Konstruktors veranschaulicht.The following code example demonstrates how to use the Icon constructor. Fügen Sie zum Ausführen dieses Beispiels den Code in ein Windows Form ein, und behandeln Sie Paint das-Ereignis des Formulars.To run this example, paste the code into a Windows Form and handle the form's Paint event. Ruft die ConstructAnIconFromAType -Methode aus Paint dem-Ereignishandler e auf EventArgsund übergibt als.Call the ConstructAnIconFromAType method from the Paint event handler, passing e as 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 ein Icon aus einer Ressource mit dem resource vom-Parameter angegebenen Namen in der Assembly, die type den vom-Parameter angegebenen Typ enthält.This constructor creates an Icon from a resource with the name specified by the resource parameter in the assembly that contains the type specified by the type parameter.

Dieser Konstruktor kombiniert den Namespace des angegebenen Typs zusammen mit dem Zeichen folgen Namen der Ressource und sucht im Assemblymanifest nach einer Entsprechung.This constructor combines the namespace of the given type together with the string name of the resource and looks for a match in the assembly manifest. Beispielsweise können Sie den Control -Typ und Error.ico an diesen Konstruktor übergeben, und es wird nach einer Ressource mit dem Namen System.Windows.Forms.Error.icogesucht.For example you can pass in the Control type and Error.ico to this constructor, and it looks for a resource that is named System.Windows.Forms.Error.ico.

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.

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.The icon to load the different size from.

width
Int32

Die Breite des neuen Symbols.The width of the new icon.

height
Int32

Die Höhe des neuen Symbols.The height of the new icon.

Ausnahmen

Der original-Parameter ist null.The original parameter is null.

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

Wenn keine Version gefunden werden kann, die exakt mit der Größe übereinstimmt, wird die nächstgelegene Übereinstimmung verwendet.If a version cannot be found that exactly matches the size, the closest match is used. Wenn es original sich bei dem Icon Parameter um eine mit einer einzelnen Größe handelt, wird von dieser Methode nur ein Duplikat erstellt.If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. Verwenden Sie die streckungs Funktionen DrawImage der-Methode, um die Größe des Symbols zu ändern.Use the stretching capabilities of the DrawImage method to resize the icon.

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.

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

Parameter

stream
Stream

Der Datenstream, aus dem das Symbol geladen werden soll.The data stream from which to load the icon.

width
Int32

Die Breite des Symbols in Pixel.The width, in pixels, of the icon.

height
Int32

Die Höhe des Symbols in Pixel.The height, in pixels, of the icon.

Ausnahmen

Der stream-Parameter ist null.The stream parameter is null.

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.

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 zur Datei, die die Icon-Daten enthält.The name and path to the file that contains the Icon data.

width
Int32

Die gewünschte Breite des Icon.The desired width of the Icon.

height
Int32

Die gewünschte Höhe des Icon.The desired height of the Icon.

Ausnahmen

Der string ist null oder enthält keine Bilddaten.The string is null or does not contain image data.

Hinweise

Wenn die angegebene Datei kein Bild enthält, das mit der gewünschten Höhe und Breite übereinstimmt, wird das Symbol mit der nächstgelegenen Größe zurückgegeben.If the specified file does not contain an image that matches the desired height and width, the icon that has the closest size is returned.

Der fileName sollte den kompletten Pfad enthalten, wenn er sich nicht im aktuellen Anwendungsverzeichnis befindet.The fileName should include the complete path if it is not in the current application directory.

Gilt für: