Icon.ExtractAssociatedIcon(String) Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

Icon.cs

Retourne la représentation sous forme d'icône d'une image contenue dans le fichier spécifié.

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

Paramètres

filePath

String

Chemin d’accès au fichier qui contient une image.

Retours

Icon

Représentation Icon de l'image contenue dans le fichier spécifié.

Exceptions

ArgumentException

filePath n'indique pas un fichier valide.

- ou -

filePath indique un chemin d'accès de convention d'affectation des noms (UNC, Universal Naming Convention).

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode ExtractAssociatedIcon. Pour exécuter cet exemple, collez le code dans un Windows Form et appelez ExtractAssociatedIconEx à partir du constructeur ou Load du gestionnaire d’événements du formulaire.

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

Remarques

Un chemin d’accès relatif est supposé être relatif au répertoire de travail actuel.

Quand ExtractAssociatedIcon est utilisé avec des bitmaps, une image miniature peut être retournée au lieu d’une icône si le système qui exécute l’application dispose d’un paramètre de Registre qui entraîne l’affichage des fichiers bitmap en tant qu’images miniatures.