Icon.ExtractIcon Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
ExtractIcon(String, Int32, Boolean) |
Извлекает указанный значок из заданного |
ExtractIcon(String, Int32, Int32) |
Извлекает указанный значок из заданного |
ExtractIcon(String, Int32, Boolean)
- Исходный код:
- Icon.cs
- Исходный код:
- 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, или null
значение , если не удается найти значок с указанным id
.
Применяется к
ExtractIcon(String, Int32, Int32)
- Исходный код:
- Icon.cs
- Исходный код:
- 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, или null
значение , если не удается найти значок с указанным id
.
Исключения
size
имеет отрицательное значение или больше MaxValue.
filePath
не удалось получить доступ.
filePath
имеет значение null
.
Комментарии
IconВ отличие от , этот метод и ExtractAssociatedIcon(String) методы не сохраняют все данные ресурсов и не изменяют исходные данные (за пределами изменения размера при необходимости). Таким образом, только использует столько памяти, Icon сколько требуется для запрошенного размера (в основном это собственная память).
Без исходных исходных данных Icon необходимо повторно выбрать растровое изображение текущего значка, чтобы изменить размеры. Для оптимального качества изображения, если требуется использовать разные размеры, Icon следует создать отдельные экземпляры с помощью этого метода и избегать конструкторов копирования.