Icon Класс

Определение

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

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

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

Icon.cs

Представляет значок 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>]
type Icon = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable

Public NotInheritable Class Icon
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable

Наследование

Object

MarshalByRefObject

Icon

Атрибуты

TypeConverterAttribute SerializableAttribute

Реализации

ICloneable IDisposable ISerializable

Примеры

В следующем примере кода показано, как использовать метод ToBitmap. Этот пример предназначен для использования с Windows Forms. Create форму и вставьте в нее следующий код. 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 метода .

Примечание

В .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)	Инициализирует новый экземпляр класса Icon из указанного потока данных.
Icon(Stream, Int32, Int32)	Инициализирует новый экземпляр класса Icon из указанного потока данных с заданной шириной и высотой.
Icon(Stream, Size)	Инициализирует новый экземпляр класса Icon заданного размера из указанного потока данных.
Icon(String)	Инициализирует новый экземпляр класса Icon из указанного имени файла.
Icon(String, Int32, Int32)	Инициализирует новый экземпляр класса Icon с заданными шириной и высотой из указанного файла.
Icon(String, Size)	Инициализирует новый экземпляр класса 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 данными, необходимыми для сериализации целевого объекта.

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

• Работа с растровыми и векторными изображениями