Icon.ExtractIcon Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
ExtractIcon(String, Int32, Boolean) |
Extrait une icône spécifiée du donné |
ExtractIcon(String, Int32, Int32) |
Extrait une icône spécifiée du donné |
ExtractIcon(String, Int32, Boolean)
- Source:
- Icon.cs
- 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
ou Iconnull
si une icône est introuvable avec le spécifiéid
.
S’applique à
ExtractIcon(String, Int32, Int32)
- Source:
- Icon.cs
- 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
ou Iconnull
si une icône est introuvable avec le spécifiéid
.
Exceptions
size
est négatif ou supérieur à MaxValue.
filePath
impossible d’accéder.
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.