Icon.ExtractIcon Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
ExtractIcon(String, Int32, Boolean) |
Extrae un icono especificado de la clase especificada |
ExtractIcon(String, Int32, Int32) |
Extrae un icono especificado de la clase especificada |
ExtractIcon(String, Int32, Boolean)
- Source:
- Icon.cs
- Source:
- Icon.cs
Extrae un icono especificado de la clase especificada 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
Parámetros
- filePath
- String
Ruta de acceso a un archivo de icono o PE (.dll, .exe).
- id
- Int32
Los números positivos hacen referencia a un índice de icono en el archivo especificado. Los números negativos hacen referencia a un identificador de recursos nativo específico en un archivo PE (.dll, .exe).
- smallIcon
- Boolean
true
para obtener el Icon valor actual del tamaño del icono pequeño del sistema. false
para obtener en Icon la configuración actual de tamaño de icono grande del sistema. El valor predeterminado es false
.
Devoluciones
, Icono null
si no se puede encontrar un icono con el especificado id
.
Se aplica a
ExtractIcon(String, Int32, Int32)
- Source:
- Icon.cs
- Source:
- Icon.cs
Extrae un icono especificado de la clase especificada 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
Parámetros
- filePath
- String
Ruta de acceso a un archivo de icono o PE (.dll, .exe).
- id
- Int32
Los números positivos hacen referencia a un índice de icono en el archivo especificado. Los números negativos hacen referencia a un identificador de recursos nativo específico en un archivo PE (.dll, .exe).
- size
- Int32
El tamaño deseado. Si el tamaño especificado no existe, se volverá a muestrear un tamaño existente para proporcionar el tamaño solicitado.
Devoluciones
, Icono null
si no se puede encontrar un icono con el especificado id
.
Excepciones
size
es negativo o mayor que MaxValue.
filePath
no se pudo acceder a él.
filePath
es null
.
Comentarios
A diferencia de Icon, este método y los ExtractAssociatedIcon(String) métodos no conservan todos los datos de recursos ni modifican los datos originales (fuera del cambio de tamaño si es necesario). Por lo tanto, el Icon único usa tanta memoria como sea necesaria para el tamaño solicitado (principalmente memoria nativa).
Sin los datos de origen originales, debe Icon volver a implementar el mapa de bits del icono actual para cambiar los tamaños. Para obtener la mejor calidad de imagen, si se desean tamaños diferentes para un , Icon debe crear instancias independientes con este método y evitar los constructores de copia.