Icon.ExtractIcon Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Overload

ExtractIcon(String, Int32, Boolean)	Estrae un'icona specificata dall'oggetto specificato filePath.
ExtractIcon(String, Int32, Int32)	Estrae un'icona specificata dall'oggetto specificato filePath.

ExtractIcon(String, Int32, Boolean)

Origine:

Icon.cs

Estrae un'icona specificata dall'oggetto specificato 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

Parametri

filePath

String

Percorso di un'icona o di un file PE (.dll, .exe).

id

Int32

I numeri positivi fanno riferimento a un indice icona nel file specificato. I numeri negativi fanno riferimento a un identificatore di risorsa nativo specifico in un file PE (.dll, .exe).

smallIcon

Boolean

true per ottenere l'impostazione Icon relativa alle dimensioni dell'icona di sistema di piccole dimensioni correnti. false per ottenere l'impostazione Icon di dimensioni dell'icona di grandi dimensioni del sistema corrente. Il valore predefinito è false.

Restituisce

Icon

Oggetto Icono null se non è possibile trovare un'icona con l'oggetto specificato id.

ExtractIcon(String, Int32, Int32)

Origine:

Icon.cs

Estrae un'icona specificata dall'oggetto specificato 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

Parametri

filePath

String

Percorso di un'icona o di un file PE (.dll, .exe).

id

Int32

I numeri positivi fanno riferimento a un indice icona nel file specificato. I numeri negativi fanno riferimento a un identificatore di risorsa nativo specifico in un file PE (.dll, .exe).

size

Int32

La dimensione desiderata. Se la dimensione specificata non esiste, verrà ricampionata una dimensione esistente per assegnare le dimensioni richieste.

Restituisce

Icon

Oggetto Icono null se non è possibile trovare un'icona con l'oggetto specificato id.

Eccezioni

ArgumentOutOfRangeException

size è negativo o maggiore di MaxValue.

IOException

filePath non è stato possibile accedere.

ArgumentNullException

filePath è null.

Commenti

A differenza di Icon, questo metodo e i ExtractAssociatedIcon(String) metodi non conservano tutti i dati della risorsa o modificano i dati originali (al di fuori del ridimensionamento, se necessario). Di conseguenza, usa Icon solo la quantità di memoria necessaria per le dimensioni richieste (per lo più la memoria nativa).

Senza i dati di origine originali, è Icon necessario ricampionare la bitmap dell'icona corrente per modificare le dimensioni. Per una migliore qualità dell'immagine, se si desiderano dimensioni diverse per un Icon oggetto, è consigliabile creare istanze separate con questo metodo ed evitare i costruttori di copia.