Teilen über


Icon.ExtractAssociatedIcon(String) Methode

Definition

Gibt eine Symboldarstellung eines Bilds zurück, das in der angegebenen Datei enthalten ist.

public:
 static System::Drawing::Icon ^ ExtractAssociatedIcon(System::String ^ filePath);
public static System.Drawing.Icon ExtractAssociatedIcon (string filePath);
public static System.Drawing.Icon? ExtractAssociatedIcon (string filePath);
static member ExtractAssociatedIcon : string -> System.Drawing.Icon
Public Shared Function ExtractAssociatedIcon (filePath As String) As Icon

Parameter

filePath
String

Der Pfad zu der Datei, die ein Bild enthält.

Gibt zurück

Die Icon-Darstellung des in der angegebenen Datei enthaltenen Bilds.

Ausnahmen

Der filePath gibt keine gültige Datei an.

- oder -

Der filePath gibt einen UNC (Universal Naming Convention)-Pfad an.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die ExtractAssociatedIcon-Methode verwenden. Fügen Sie zum Ausführen dieses Beispiels den Code in ein Windows Form-Objekt ein, und rufen Sie ExtractAssociatedIconEx aus dem Konstruktor oder Load Ereignishandler des Formulars auf.

private void ExtractAssociatedIconEx()
{
    Icon ico =
        Icon.ExtractAssociatedIcon(@"C:\WINDOWS\system32\notepad.exe");
    this.Icon = ico;
}
Private Sub ExtractAssociatedIconEx()
    Dim ico As Icon = Icon.ExtractAssociatedIcon("C:\WINDOWS\system32\notepad.exe")
    Me.Icon = ico

End Sub

Hinweise

Ein relativer Pfad wird als relativ zum aktuellen Arbeitsverzeichnis angenommen.

Wenn ExtractAssociatedIcon mit Bitmaps verwendet wird, kann anstelle eines Symbols ein Miniaturbild zurückgegeben werden, wenn das System, auf dem die Anwendung ausgeführt wird, über eine Registrierungseinstellung verfügt, die dazu führt, dass Bitmapdateien als Miniaturansichten angezeigt werden.

Gilt für: