Icon.ExtractAssociatedIcon(String) Méthode

Définition

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);
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

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

Exceptions

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 a un paramètre de Registre qui entraîne l’affichage des fichiers bitmap en tant qu’images miniatures.

S’applique à