Icon.ExtractIcon Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Sobrecargas

ExtractIcon(String, Int32, Boolean)	Extrae un icono especificado de la clase especificada filePath.
ExtractIcon(String, Int32, Int32)	Extrae un icono especificado de la clase especificada filePath.

ExtractIcon(String, Int32, Boolean)

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

Icon

, Icono null si no se puede encontrar un icono con el especificado id.

ExtractIcon(String, Int32, Int32)

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

Icon

, Icono null si no se puede encontrar un icono con el especificado id.

Excepciones

ArgumentOutOfRangeException

size es negativo o mayor que MaxValue.

IOException

filePath no se pudo acceder a él.

ArgumentNullException

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.