Icon Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет значок Windows, который является небольшим растровым изображением, используемым для представления объекта. Значки можно рассматривать как прозрачные растровые изображения, хотя их размер определяется системой.
public ref class Icon sealed : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
[System.Serializable]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter("System.Drawing.IconConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")]
public sealed class Icon : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
type Icon = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposable
interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type Icon = class
inherit MarshalByRefObject
interface ISerializable
interface ICloneable
interface IDisposable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
[<System.Serializable>]
type Icon = class
inherit MarshalByRefObject
interface ISerializable
interface ICloneable
interface IDisposable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))>]
type Icon = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposable
interface ISerializable
[<System.ComponentModel.TypeConverter("System.Drawing.IconConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")>]
type Icon = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposable
interface ISerializable
Public NotInheritable Class Icon
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable
- Наследование
- Атрибуты
- Реализации
Примеры
В следующем примере кода показано, как использовать ToBitmap метод. Этот пример предназначен для использования с Windows Forms. Создайте форму и вставьте в него следующий код.
IconToBitmap Вызовите метод в обработчике событий формыPaint, передавая e как PaintEventArgs.
private:
void IconToBitmap( PaintEventArgs^ e )
{
// Construct an Icon.
System::Drawing::Icon^ icon1 = gcnew System::Drawing::Icon( SystemIcons::Exclamation,40,40 );
// Call ToBitmap to convert it.
Bitmap^ bmp = icon1->ToBitmap();
// Draw the bitmap.
e->Graphics->DrawImage( bmp, Point(30,30) );
}
private void IconToBitmap(PaintEventArgs e)
{
// Construct an Icon.
Icon icon1 = new Icon(SystemIcons.Exclamation, 40, 40);
// Call ToBitmap to convert it.
Bitmap bmp = icon1.ToBitmap();
// Draw the bitmap.
e.Graphics.DrawImage(bmp, new Point(30, 30));
}
Private Sub IconToBitmap(ByVal e As PaintEventArgs)
' Construct an Icon.
Dim icon1 As New Icon(SystemIcons.Exclamation, 40, 40)
' Call ToBitmap to convert it.
Dim bmp As Bitmap = icon1.ToBitmap()
' Draw the bitmap.
e.Graphics.DrawImage(bmp, New Point(30, 30))
End Sub
Комментарии
Объекты можно создавать Icon из файлов, потоков или внедренных ресурсов. Список конструкторов см. в разделе Icon. Можно также преобразовать в Icon растровое изображение с помощью ToBitmap метода.
Note
В .NET 6 и более поздних версиях пакет System.Drawing.Common, который включает этот тип, поддерживается только в операционных системах Windows. Использование этого типа в кроссплатформенных приложениях вызывает предупреждения во время компиляции и исключения во время выполнения. Дополнительные сведения см. в статье System.Drawing.Common, поддерживаемой только в Windows.
Ресурс значка может содержать несколько изображений значков. Один файл значка может содержать изображения в нескольких размерах и глубине цвета. Образ, используемый в приложении, зависит от операционной системы и параметров. В следующем списке приведены типичные размеры значка:
16 пикселей x 16 пикселей
32 пикселя x 32 пикселя
48 пикселей x 48 пикселей
Конструкторы
| Имя | Описание |
|---|---|
| Icon(Icon, Int32, Int32) |
Инициализирует новый экземпляр класса и пытается найти версию значка Icon , соответствующую запрашиваемому размеру. |
| Icon(Icon, Size) |
Инициализирует новый экземпляр класса и пытается найти версию значка Icon , соответствующую запрашиваемому размеру. |
| Icon(Stream, Int32, Int32) |
Инициализирует новый экземпляр класса из указанного Icon потока данных и с указанной шириной и высотой. |
| Icon(Stream, Size) |
Инициализирует новый экземпляр Icon класса указанного размера из указанного потока. |
| Icon(Stream) |
Инициализирует новый экземпляр класса из указанного Icon потока данных. |
| Icon(String, Int32, Int32) |
Инициализирует новый экземпляр Icon класса с указанной шириной и высотой из указанного файла. |
| Icon(String, Size) |
Инициализирует новый экземпляр Icon класса указанного размера из указанного файла. |
| Icon(String) |
Инициализирует новый экземпляр класса из указанного Icon имени файла. |
| Icon(Type, String) |
Инициализирует новый экземпляр Icon класса из ресурса в указанной сборке. |
Свойства
| Имя | Описание |
|---|---|
| Handle |
Возвращает дескриптор Windows для этого Icon. Это не копия дескриптора; не освобождайте его. |
| Height |
Возвращает высоту этого Iconпараметра. |
| Size |
Возвращает размер этого Iconобъекта. |
| Width |
Возвращает ширину этого Iconпараметра. |
Методы
| Имя | Описание |
|---|---|
| Clone() |
Клонирует Iconизображение, создающее повторяющееся изображение. |
| CreateObjRef(Type) |
Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
| Dispose() |
Освобождает все ресурсы, используемые этим Iconпараметром. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| ExtractAssociatedIcon(String) |
Возвращает представление значка изображения, содержащегося в указанном файле. |
| ExtractIcon(String, Int32, Boolean) |
Извлекает указанный значок из заданного |
| ExtractIcon(String, Int32, Int32) |
Извлекает указанный значок из заданного |
| Finalize() |
Позволяет объекту пытаться освободить ресурсы и выполнять другие операции очистки перед его восстановлением сборкой мусора. |
| FromHandle(IntPtr) |
Создает GDI+ Icon из указанного дескриптора Windows на значок ( |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetLifetimeService() |
Устаревшие..
Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| InitializeLifetimeService() |
Устаревшие..
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| MemberwiseClone(Boolean) |
Создает неглубокую копию текущего MarshalByRefObject объекта. (Унаследовано от MarshalByRefObject) |
| Save(Stream) | |
| ToBitmap() | |
| ToString() |
Возвращает удобочитаемую пользователем строку, описывающую Icon. |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Заполняет SerializationInfo данные, необходимые для сериализации целевого объекта. |