Icon Icon Icon Icon Class

Определение

Представляет значок Windows, который является точечным рисунком небольшого размера и используется для представления объекта.Represents a Windows icon, which is a small bitmap image that is used to represent an object. Значки можно считать прозрачными точечными рисунками, хотя их размер определяется системой.Icons can be thought of as transparent bitmaps, although their size is determined by the system.

public ref class Icon sealed : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.IconConverter))]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
[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
type Icon = class
    inherit MarshalByRefObject
    interface ISerializable
    interface ICloneable
    interface IDisposable
Public NotInheritable Class Icon
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable
Наследование
Атрибуты
Реализации

Примеры

В следующем примере кода показано, как использовать метод ToBitmap.The following code example demonstrates how to use the ToBitmap method. Этот пример предназначен для использования с Windows Forms.This example is designed to be used with Windows Forms. Создание формы и вставьте в него следующий код.Create a form and paste the following code into it. Вызовите IconToBitmap метод в форме Paint обработчик событий, передав e как PaintEventArgs.Call the IconToBitmap method in the form's Paint event handler, passing e as 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 объектов из файлов, потоки или внедренные ресурсы.You can construct Icon objects from files, streams, or embedded resources. Список конструкторов, см. в разделе Icon.For a list of constructors, see Icon. Вы также можете преобразовать Icon точечного рисунка с помощью ToBitmap метод.You can also convert an Icon to a bitmap by using the ToBitmap method.

Ресурс значка может содержать несколько изображений.An icon resource can contain multiple icon images. Один файл значка может содержать изображения нескольких размеров и цветов.One icon file may contain images in several sizes and color depths. Образ, который используется в приложении зависит от операционной системы и параметры.The image that is used in an application depends on the operating system and settings. В следующем списке приведены типичные размеры значка:The following list details the typical sizes for an icon:

  • 16 пикселей x 1616 pixels x 16 pixels

  • 32 пикселей x 3232 pixels x 32 pixels

  • 48 пикселей x 4848 pixels x 48 pixels

Конструкторы

Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32) Icon(Icon, Int32, Int32)

Инициализирует новый экземпляр класса Icon и предпринимает попытку поиска версии значка, соответствующей требуемому размеру.Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

Icon(Icon, Size) Icon(Icon, Size) Icon(Icon, Size) Icon(Icon, Size)

Инициализирует новый экземпляр класса Icon и предпринимает попытку поиска версии значка, соответствующей требуемому размеру.Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

Icon(Stream) Icon(Stream) Icon(Stream) Icon(Stream)

Инициализирует новый экземпляр класса Icon из указанного потока данных.Initializes a new instance of the Icon class from the specified data stream.

Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32) Icon(Stream, Int32, Int32)

Инициализирует новый экземпляр класса Icon из указанного потока данных с заданными шириной и высотой.Initializes a new instance of the Icon class from the specified data stream and with the specified width and height.

Icon(Stream, Size) Icon(Stream, Size) Icon(Stream, Size) Icon(Stream, Size)

Инициализирует новый экземпляр класса Icon заданного размера из указанного потока данных.Initializes a new instance of the Icon class of the specified size from the specified stream.

Icon(String) Icon(String) Icon(String) Icon(String)

Инициализация нового экземпляра класса Icon из указанного имени файла.Initializes a new instance of the Icon class from the specified file name.

Icon(String, Int32, Int32) Icon(String, Int32, Int32) Icon(String, Int32, Int32) Icon(String, Int32, Int32)

Инициализирует новый экземпляр класса Icon с заданными шириной и высотой из указанного файла.Initializes a new instance of the Icon class with the specified width and height from the specified file.

Icon(String, Size) Icon(String, Size) Icon(String, Size) Icon(String, Size)

Инициализирует новый экземпляр класса Icon заданного размера из указанного файла.Initializes a new instance of the Icon class of the specified size from the specified file.

Icon(Type, String) Icon(Type, String) Icon(Type, String) Icon(Type, String)

Инициализирует новый экземпляр класса Icon из ресурса в указанной сборке.Initializes a new instance of the Icon class from a resource in the specified assembly.

Свойства

Handle Handle Handle Handle

Получает дескриптор Windows для данного объекта Icon.Gets the Windows handle for this Icon. Данный дескриптор не является копией дескриптора, поэтому освобождать его не следует.This is not a copy of the handle; do not free it.

Height Height Height Height

Получает высоту объекта Icon.Gets the height of this Icon.

Size Size Size Size

Получает размер объекта Icon.Gets the size of this Icon.

Width Width Width Width

Получает ширину значка Icon.Gets the width of this Icon.

Методы

Clone() Clone() Clone() Clone()

Копирует объект Icon, создавая идентичное изображение.Clones the Icon, creating a duplicate image.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, используемые этим объектом Icon.Releases all resources used by this Icon.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractAssociatedIcon(String) ExtractAssociatedIcon(String) ExtractAssociatedIcon(String) ExtractAssociatedIcon(String)

Возвращает представление изображения, содержащегося в заданном файле, в виде значка.Returns an icon representation of an image that is contained in the specified file.

Finalize() Finalize() Finalize() Finalize()

Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как он будет уничтожен во время сборки мусора.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

FromHandle(IntPtr) FromHandle(IntPtr) FromHandle(IntPtr) FromHandle(IntPtr)

Создает объект GDI+ Icon из указанного дескриптора Windows для значка (HICON).Creates a GDI+ Icon from the specified Windows handle to an icon (HICON).

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Save(Stream) Save(Stream) Save(Stream) Save(Stream)

Сохраняет этот объект Icon в заданном потоке вывода Stream.Saves this Icon to the specified output Stream.

ToBitmap() ToBitmap() ToBitmap() ToBitmap()

Преобразует этот объект Icon в объект GDI+ Bitmap.Converts this Icon to a GDI+ Bitmap.

ToString() ToString() ToString() ToString()

Получает легко читаемую пользователем строку, описывающую объект Icon.Gets a human-readable string that describes the Icon.

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

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет объект SerializationInfo данными, необходимыми для сериализации целевого объекта.Populates a SerializationInfo with the data that is required to serialize the target object.

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

Дополнительно