Icon.ExtractIcon Método

Definição

Espaço de Nomes:

System.Drawing

Assemblagem:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v11.0.0-preview.5.26302.115

Sobrecargas

Name	Descrição
ExtractIcon(String, Int32, Boolean)	Extrai um ícone especificado do dado filePath.
ExtractIcon(String, Int32, Int32)	Extrai um ícone especificado do dado filePath.

ExtractIcon(String, Int32, Boolean)

Origem:

Icon.cs

Extrai um ícone especificado do dado 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 ficheiro PE (.dll, .exe).

id

Int32

Números positivos referem-se a um índice de ícones no ficheiro indicado. Números negativos referem-se a um identificador nativo específico de recurso num ficheiro PE (.dll, .exe).

smallIcon

Boolean

true Para obter a Icon configuração de tamanho de ícones pequenos no sistema atual. false Para obter a Icon definição de tamanho grande de ícones no sistema atual. A predefinição é false.

Devoluções

Icon

Um Icon, ou null se um ícone não for encontrado com o especificado id.

ExtractIcon(String, Int32, Int32)

Origem:

Icon.cs

Extrai um ícone especificado do dado 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 ficheiro PE (.dll, .exe).

id

Int32

Números positivos referem-se a um índice de ícones no ficheiro indicado. Números negativos referem-se a um identificador nativo específico de recurso num ficheiro PE (.dll, .exe).

size

Int32

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

Devoluções

Icon

Um Icon, ou null se um ícone não for encontrado com o especificado id.

Exceções

ArgumentOutOfRangeException

size é negativo ou maior que MaxValue.

IOException

filePath não podia ser acedida.

ArgumentNullException

filePath é null.

Observações

Ao contrário do Icon, este método e os métodos ExtractAssociatedIcon(String) não retêm todos os dados de recursos nem modificam os dados originais (fora de redimensionamento, se necessário). Assim, só Icon usa a quantidade de memória necessária para o tamanho solicitado (maioritariamente memória nativa).

Sem os dados originais, é Icon necessário reamostrar o bitmap do ícone atual para alterar o tamanho. Para obter a melhor qualidade de imagem, se forem desejados tamanhos diferentes para uma Icon pessoa, deve criar instâncias separadas com este método e evitar os construtores de cópia.