Icon.ExtractAssociatedIcon(String) Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

Icon.cs

Restituisce una rappresentazione in forma di icona di un'immagine contenuta nel file specificato.

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

Parametri

filePath

String

Percorso del file contenente un'immagine.

Restituisce

Icon

Rappresentazione Icon dell'immagine contenuta nel file specificato.

Eccezioni

ArgumentException

filePath non indica un file valido.

-oppure-

filePath indica un percorso UNC (Universal Naming Convention).

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo ExtractAssociatedIcon. Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare ExtractAssociatedIconEx dal costruttore o Load dal gestore eventi del modulo.

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

Commenti

Si presuppone che un percorso relativo sia relativo alla directory di lavoro corrente.

Quando ExtractAssociatedIcon viene usato con le bitmap, un'immagine di anteprima può essere restituita anziché un'icona se il sistema che esegue l'applicazione ha un'impostazione del Registro di sistema che causa la visualizzazione di file bitmap come immagini di anteprima.