Icon.ExtractIcon Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Перегрузки

ExtractIcon(String, Int32, Boolean)	Извлекает указанный значок из заданного filePathобъекта .
ExtractIcon(String, Int32, Int32)	Извлекает указанный значок из заданного filePathобъекта .

ExtractIcon(String, Int32, Boolean)

Исходный код:

Icon.cs

Извлекает указанный значок из заданного 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

Параметры

filePath

String

Путь к файлу значка или pe (.dll, .exe).

id

Int32

Положительные числа ссылаются на индекс значка в заданном файле. Отрицательные числа относятся к определенному идентификатору собственного ресурса в файле PE (.dll, .exe).

smallIcon

Boolean

true , чтобы получить Icon в текущей системе небольшой размер значка. false , чтобы получить Icon в текущей системе большой размер значка. Значение по умолчанию — false.

Возвращаемое значение

Icon

Значение Icon, или null значение , если не удается найти значок с указанным id.

ExtractIcon(String, Int32, Int32)

Исходный код:

Icon.cs

Извлекает указанный значок из заданного 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

Параметры

filePath

String

Путь к файлу значка или pe (.dll, .exe).

id

Int32

Положительные числа ссылаются на индекс значка в заданном файле. Отрицательные числа относятся к определенному идентификатору собственного ресурса в файле PE (.dll, .exe).

size

Int32

Нужный размер. Если указанный размер не существует, существующий размер будет повторно выбран для получения запрошенного размера.

Возвращаемое значение

Icon

Значение Icon, или null значение , если не удается найти значок с указанным id.

Исключения

ArgumentOutOfRangeException

size имеет отрицательное значение или больше MaxValue.

IOException

filePath не удалось получить доступ.

ArgumentNullException

filePath имеет значение null.

Комментарии

IconВ отличие от , этот метод и ExtractAssociatedIcon(String) методы не сохраняют все данные ресурсов и не изменяют исходные данные (за пределами изменения размера при необходимости). Таким образом, только использует столько памяти, Icon сколько требуется для запрошенного размера (в основном это собственная память).

Без исходных исходных данных Icon необходимо повторно выбрать растровое изображение текущего значка, чтобы изменить размеры. Для оптимального качества изображения, если требуется использовать разные размеры, Icon следует создать отдельные экземпляры с помощью этого метода и избегать конструкторов копирования.