Icon.ExtractIcon Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Surcharges

ExtractIcon(String, Int32, Boolean)	Extrait une icône spécifiée du donné filePath.
ExtractIcon(String, Int32, Int32)	Extrait une icône spécifiée du donné filePath.

ExtractIcon(String, Int32, Boolean)

Source:

Icon.cs

Extrait une icône spécifiée du donné filePath.

public static System.Drawing.Icon? ExtractIcon (string filePath, int id, bool smallIcon = false);

static member ExtractIcon : string * int * bool -> System.Drawing.Icon

Public Shared Function ExtractIcon (filePath As String, id As Integer, Optional smallIcon As Boolean = false) As Icon

Paramètres

filePath

String

Chemin d’accès à une icône ou à un fichier PE (.dll, .exe).

id

Int32

Les nombres positifs font référence à un index d’icône dans le fichier donné. Les nombres négatifs font référence à un identificateur de ressource natif spécifique dans un fichier PE (.dll, .exe).

smallIcon

Boolean

true pour obtenir le Icon au paramètre actuel de petite taille de l’icône système. false pour obtenir au Icon niveau du système actuel le paramètre de taille d’icône de grande taille. Par défaut, il s’agit de false.

Retours

Icon

ou Iconnull si une icône est introuvable avec le spécifiéid.

ExtractIcon(String, Int32, Int32)

Source:

Icon.cs

Extrait une icône spécifiée du donné filePath.

public:
 static System::Drawing::Icon ^ ExtractIcon(System::String ^ filePath, int id, int size);

public static System.Drawing.Icon? ExtractIcon (string filePath, int id, int size);

static member ExtractIcon : string * int * int -> System.Drawing.Icon

Public Shared Function ExtractIcon (filePath As String, id As Integer, size As Integer) As Icon

Paramètres

filePath

String

Chemin d’accès à une icône ou à un fichier PE (.dll, .exe).

id

Int32

Les nombres positifs font référence à un index d’icône dans le fichier donné. Les nombres négatifs font référence à un identificateur de ressource natif spécifique dans un fichier PE (.dll, .exe).

size

Int32

Taille désirée. Si la taille spécifiée n’existe pas, une taille existante est rééchantillonnée pour donner la taille demandée.

Retours

Icon

ou Iconnull si une icône est introuvable avec le spécifiéid.

Exceptions

ArgumentOutOfRangeException

size est négatif ou supérieur à MaxValue.

IOException

filePath impossible d’accéder.

ArgumentNullException

filePath a la valeur null.

Remarques

Contrairement à , Iconcette méthode et les ExtractAssociatedIcon(String) méthodes ne conservent pas toutes les données de ressource ou ne modifient pas les données d’origine (en dehors du redimensionnement si nécessaire). Par conséquent, le Icon utilise uniquement autant de mémoire que nécessaire pour la taille demandée (principalement de la mémoire native).

Sans les données sources d’origine, le Icon doit rééchantillonner la bitmap de l’icône actuelle pour changer de taille. Pour une qualité d’image optimale, si des tailles différentes pour un Icon sont souhaitées, vous devez créer des instances distinctes avec cette méthode et éviter les constructeurs de copie.