Icon.ExtractIcon Methode

  • Referenz

Definition

Namespace:
System.Drawing
Assembly:
System.Drawing.Common.dll
Paket:
System.Drawing.Common v8.0.0
Paket:
System.Drawing.Common v9.0.0-preview.2.24128.3

Überlädt

ExtractIcon(String, Int32, Boolean)

Extrahiert ein angegebenes Symbol aus dem angegebenen filePath.
ExtractIcon(String, Int32, Int32)

Extrahiert ein angegebenes Symbol aus dem angegebenen filePath.

ExtractIcon(String, Int32, Boolean)

Quelle:
Icon.cs
Quelle:
Icon.cs

Extrahiert ein angegebenes Symbol aus dem angegebenen filePath.

public static System.Drawing.Icon? ExtractIcon (string filePath, int id, bool smallIcon = false);
static member ExtractIcon : string * int * bool -> System.Drawing.Icon
Public Shared Function ExtractIcon (filePath As String, id As Integer, Optional smallIcon As Boolean = false) As Icon

Parameter

filePath
String

Pfad zu einer Symbol- oder PE-Datei (.dll, .exe).

id
Int32

Positive Zahlen beziehen sich auf einen Symbolindex in der angegebenen Datei. Negative Zahlen beziehen sich auf einen bestimmten nativen Ressourcenbezeichner in einer PE-Datei (.dll, .exe).

smallIcon
Boolean

true , um beim Icon aktuellen System die Einstellung "Kleine Symbolgröße" abzurufen. false , um die Icon auf dem aktuellen System große Symbolgröße-Einstellung abzurufen. Der Standardwert lautet false.

Gibt zurück

Icon

null Oder Icon, wenn mit dem angegebenen idein Symbol nicht gefunden werden kann.

Gilt für:

ExtractIcon(String, Int32, Int32)

Quelle:
Icon.cs
Quelle:
Icon.cs

Extrahiert ein angegebenes Symbol aus dem angegebenen filePath.

public:
 static System::Drawing::Icon ^ ExtractIcon(System::String ^ filePath, int id, int size);
public static System.Drawing.Icon? ExtractIcon (string filePath, int id, int size);
static member ExtractIcon : string * int * int -> System.Drawing.Icon
Public Shared Function ExtractIcon (filePath As String, id As Integer, size As Integer) As Icon

Parameter

filePath
String

Pfad zu einer Symbol- oder PE-Datei (.dll, .exe).

id
Int32

Positive Zahlen beziehen sich auf einen Symbolindex in der angegebenen Datei. Negative Zahlen beziehen sich auf einen bestimmten nativen Ressourcenbezeichner in einer PE-Datei (.dll, .exe).

size
Int32

Die gewünschte Größe. Wenn die angegebene Größe nicht vorhanden ist, wird eine vorhandene Größe neu gestampt, um die angeforderte Größe zu erhalten.

Gibt zurück

Icon

null Oder Icon, wenn mit dem angegebenen idein Symbol nicht gefunden werden kann.

Ausnahmen

ArgumentOutOfRangeException

size ist negativ oder größer als MaxValue.

IOException

filePath konnte nicht darauf zugegriffen werden.

ArgumentNullException

filePath ist null

Hinweise

IconIm Gegensatz zu behalten diese Methode und die ExtractAssociatedIcon(String) Methoden nicht alle Ressourcendaten bei oder ändern die ursprünglichen Daten (außerhalb der Größenänderung, falls erforderlich). Daher verwendet nur so Icon viel Arbeitsspeicher, wie für die angeforderte Größe benötigt wird (meist nativer Arbeitsspeicher).

Ohne die ursprünglichen Quelldaten muss die Icon Bitmap des aktuellen Symbols neu sampleniert werden, um die Größe zu ändern. Um eine optimale Bildqualität zu erzielen, sollten Sie, wenn unterschiedliche Größen für eine Icon gewünscht sind, separate Instanzen mit dieser Methode erstellen und die Kopierkonstruktoren vermeiden.

Gilt für: