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)

Извлекает указанный значок из заданного filePath.

ExtractIcon(String, Int32, Int32)

Извлекает указанный значок из заданного filePath.

Finalize()

Позволяет объекту пытаться освободить ресурсы и выполнять другие операции очистки перед его восстановлением сборкой мусора.

FromHandle(IntPtr)

Создает GDI+ Icon из указанного дескриптора Windows на значок (HICON).

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetLifetimeService()
Устаревшие..

Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра.

(Унаследовано от MarshalByRefObject)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
InitializeLifetimeService()
Устаревшие..

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неглубокую копию текущего MarshalByRefObject объекта.

(Унаследовано от MarshalByRefObject)
Save(Stream)

Сохраняет его Icon в указанных выходных данных Stream.

ToBitmap()

Преобразует это Icon в GDI+ Bitmap.

ToString()

Возвращает удобочитаемую пользователем строку, описывающую Icon.

Явные реализации интерфейса

Имя Описание
ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет SerializationInfo данные, необходимые для сериализации целевого объекта.

Применяется к

См. также раздел