Icon.ExtractIcon Método

  • Referência

Definição

Namespace:
System.Drawing
Assembly:
System.Drawing.Common.dll
Pacote:
System.Drawing.Common v8.0.0
Pacote:
System.Drawing.Common v9.0.0-preview.2.24128.3

Sobrecargas

ExtractIcon(String, Int32, Boolean)

Extrai um ícone especificado do determinado filePath.
ExtractIcon(String, Int32, Int32)

Extrai um ícone especificado do determinado filePath.

ExtractIcon(String, Int32, Boolean)

Origem:
Icon.cs
Origem:
Icon.cs

Extrai um ícone especificado do determinado 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

Caminho para um ícone ou arquivo PE (.dll, .exe).

id
Int32

Números positivos referem-se a um índice de ícone no arquivo fornecido. Números negativos referem-se a um identificador de recurso nativo específico em um arquivo PE (.dll .exe).

smallIcon
Boolean

true para obter o Icon na configuração de tamanho de ícone pequeno do sistema atual. false para obter o Icon na configuração de tamanho de ícone grande do sistema atual. O padrão é false.

Retornos

Icon

Um Iconou null se um ícone não puder ser encontrado com o especificado id.

Aplica-se a

ExtractIcon(String, Int32, Int32)

Origem:
Icon.cs
Origem:
Icon.cs

Extrai um ícone especificado do determinado 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

Caminho para um ícone ou arquivo PE (.dll, .exe).

id
Int32

Números positivos referem-se a um índice de ícone no arquivo fornecido. Números negativos referem-se a um identificador de recurso nativo específico em um arquivo PE (.dll .exe).

size
Int32

O tamanho desejado. Se o tamanho especificado não existir, um tamanho existente será resampledo para fornecer o tamanho solicitado.

Retornos

Icon

Um Iconou null se um ícone não puder ser encontrado com o especificado id.

Exceções

ArgumentOutOfRangeException

size é negativo ou maior que MaxValue.

IOException

filePath não foi possível acessar.

ArgumentNullException

filePath é null.

Comentários

Ao contrário do Icon, esse método e os ExtractAssociatedIcon(String) métodos não retêm todos os dados de recurso nem modificam os dados originais (fora do redimensionamento, se necessário). Dessa forma, o Icon usa apenas a quantidade de memória necessária para o tamanho solicitado (principalmente memória nativa).

Sem os dados de origem originais, o Icon precisa resampler o bitmap do ícone atual para alterar os tamanhos. Para obter a melhor qualidade de imagem, se forem desejados tamanhos diferentes para um Icon , você deverá criar instâncias separadas com esse método e evitar os construtores de cópia.

Aplica-se a