Icon.ExtractAssociatedIcon(String) Metoda

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

Icon.cs

Zwraca reprezentację ikony obrazu zawartego w określonym pliku.

public:
 static System::Drawing::Icon ^ ExtractAssociatedIcon(System::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

Parametry

filePath

String

Ścieżka do pliku zawierającego obraz.

Zwraca

Icon

Reprezentacja Icon obrazu, który znajduje się w określonym pliku.

Wyjątki

ArgumentException

Element filePath nie wskazuje prawidłowego pliku.

-lub-

Wskazuje filePath ścieżkę Universal Naming Convention (UNC).

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ExtractAssociatedIcon metody . Aby uruchomić ten przykład, wklej kod do formularza systemu Windows i wywołaj ExtractAssociatedIconEx metodę z konstruktora formularza lub Load procedury obsługi zdarzeń.

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

Uwagi

Przyjmuje się, że ścieżka względna jest względna względem bieżącego katalogu roboczego.

Gdy ExtractAssociatedIcon jest używany z mapami bitowymi, może zostać zwrócony obraz miniatury zamiast ikony, jeśli system, w którym jest uruchomiona aplikacja, ma ustawienie rejestru, które powoduje wyświetlanie plików mapy bitowej jako obrazów miniatur.