Icon.ExtractAssociatedIcon(String) Metoda

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

Zdroj:

Icon.cs

Vrátí reprezentaci ikony obrázku, který je obsažen v zadaném souboru.

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

Cesta k souboru, který obsahuje obrázek.

Návraty

Icon

Reprezentace Icon obrázku obsaženého v zadaném souboru.

Výjimky

ArgumentException

Hodnota filePath neindikuje platný soubor.

-nebo-

Označuje filePath cestu UNC (Universal Naming Convention).

Příklady

Následující příklad kódu ukazuje, jak použít metodu ExtractAssociatedIcon . Chcete-li spustit tento příklad, vložte kód do formuláře Windows a zavolejte ExtractAssociatedIconEx ho z konstruktoru formuláře nebo Load obslužné rutiny události.

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

Poznámky

Relativní cesta se předpokládá jako relativní vzhledem k aktuálnímu pracovnímu adresáři.

Při ExtractAssociatedIcon použití s rastrovými obrázky může být namísto ikony vrácena miniatura, pokud systém, ve kterém aplikace běží, má nastavení registru, které způsobuje, že rastrové soubory se zobrazují jako miniatury.