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

Определение

Инициализирует новый экземпляр класса Icon.

Перегрузки

Icon(Stream)

Инициализирует новый экземпляр класса Icon из указанного потока данных.

Icon(String)

Инициализирует новый экземпляр класса Icon из указанного имени файла.

Icon(Icon, Size)

Инициализирует новый экземпляр класса Icon и предпринимает попытку поиска версии значка, соответствующей требуемому размеру.

Icon(Stream, Size)

Инициализирует новый экземпляр класса Icon заданного размера из указанного потока данных.

Icon(String, Size)

Инициализирует новый экземпляр класса Icon заданного размера из указанного файла.

Icon(Type, String)

Инициализирует новый экземпляр класса Icon из ресурса в указанной сборке.

Icon(Icon, Int32, Int32)

Инициализирует новый экземпляр класса Icon и предпринимает попытку поиска версии значка, соответствующей требуемому размеру.

Icon(Stream, Int32, Int32)

Инициализирует новый экземпляр класса Icon из указанного потока данных с заданной шириной и высотой.

Icon(String, Int32, Int32)

Инициализирует новый экземпляр класса Icon с заданными шириной и высотой из указанного файла.

Icon(Stream)

Исходный код:
Icon.cs
Исходный код:
Icon.cs
Исходный код:
Icon.cs

Инициализирует новый экземпляр класса Icon из указанного потока данных.

public:
 Icon(System::IO::Stream ^ stream);
public Icon (System.IO.Stream stream);
new System.Drawing.Icon : System.IO.Stream -> System.Drawing.Icon
Public Sub New (stream As Stream)

Параметры

stream
Stream

Поток данных, из которого загружается объект Icon.

Исключения

Параметр stream имеет значение null.

Комментарии

Ресурс значка может содержать несколько изображений значков. Один файл значка может содержать изображения нескольких размеров и глубины цвета. Образ, используемый в приложении, зависит от операционной системы и параметров. В следующем списке описаны типичные размеры значка:

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

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

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

Этот конструктор возвращает наименьшее изображение, содержащееся в указанном потоке.

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

Icon(String)

Исходный код:
Icon.cs
Исходный код:
Icon.cs
Исходный код:
Icon.cs

Инициализирует новый экземпляр класса Icon из указанного имени файла.

public:
 Icon(System::String ^ fileName);
public Icon (string fileName);
new System.Drawing.Icon : string -> System.Drawing.Icon
Public Sub New (fileName As String)

Параметры

fileName
String

Файл, из которого загружается значок Icon.

Комментарии

Ресурс значка может содержать несколько изображений значков. Один файл значка может содержать изображения нескольких размеров и глубины цвета. Образ, используемый в приложении, зависит от операционной системы и параметров. В следующем списке описаны типичные размеры значка:

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

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

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

Этот конструктор возвращает наименьшее изображение, содержащееся в указанном файле.

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

Icon(Icon, Size)

Исходный код:
Icon.cs
Исходный код:
Icon.cs
Исходный код:
Icon.cs

Инициализирует новый экземпляр класса Icon и предпринимает попытку поиска версии значка, соответствующей требуемому размеру.

public:
 Icon(System::Drawing::Icon ^ original, System::Drawing::Size size);
public Icon (System.Drawing.Icon original, System.Drawing.Size size);
new System.Drawing.Icon : System.Drawing.Icon * System.Drawing.Size -> System.Drawing.Icon
Public Sub New (original As Icon, size As Size)

Параметры

original
Icon

Объект Icon, из которого загружается значок с измененным размером.

size
Size

Структура Size, задающая высоту и ширину нового объекта Icon.

Исключения

Параметр original имеет значение null.

Комментарии

Если не удается найти версию, которая точно соответствует размеру, используется ближайшее соответствие. original Если параметр имеет Icon один размер, этот метод создает только значок дубликата. Используйте возможности растяжения метода для DrawImage изменения размера значка.

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

Icon(Stream, Size)

Исходный код:
Icon.cs
Исходный код:
Icon.cs
Исходный код:
Icon.cs

Инициализирует новый экземпляр класса Icon заданного размера из указанного потока данных.

public:
 Icon(System::IO::Stream ^ stream, System::Drawing::Size size);
public Icon (System.IO.Stream stream, System.Drawing.Size size);
new System.Drawing.Icon : System.IO.Stream * System.Drawing.Size -> System.Drawing.Icon
Public Sub New (stream As Stream, size As Size)

Параметры

stream
Stream

Поток, содержащий данные значка.

size
Size

Нужный размер значка.

Исключения

Параметр stream равен null или не содержит данные изображения.

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

Icon(String, Size)

Исходный код:
Icon.cs
Исходный код:
Icon.cs
Исходный код:
Icon.cs

Инициализирует новый экземпляр класса Icon заданного размера из указанного файла.

public:
 Icon(System::String ^ fileName, System::Drawing::Size size);
public Icon (string fileName, System.Drawing.Size size);
new System.Drawing.Icon : string * System.Drawing.Size -> System.Drawing.Icon
Public Sub New (fileName As String, size As Size)

Параметры

fileName
String

Имя и путь для файла, содержащего данные значка.

size
Size

Нужный размер значка.

Исключения

Параметр string равен null или не содержит данные изображения.

Комментарии

Если указанный файл не содержит изображения, соответствующего требуемому размеру, возвращается значок ближайшего размера.

Должен fileName содержать полный путь, если он не находится в текущем каталоге приложения.

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

Icon(Type, String)

Исходный код:
Icon.cs
Исходный код:
Icon.cs
Исходный код:
Icon.cs

Инициализирует новый экземпляр класса Icon из ресурса в указанной сборке.

public:
 Icon(Type ^ type, System::String ^ resource);
public Icon (Type type, string resource);
new System.Drawing.Icon : Type * string -> System.Drawing.Icon
Public Sub New (type As Type, resource As String)

Параметры

type
Type

Объект Type, задающий сборку, в которой выполняется поиск ресурса.

resource
String

Имя ресурса для загрузки.

Исключения

В сборке, содержащей заданный параметр resource, не удалось найти значок, заданный параметром type.

Примеры

В следующем примере кода показано, как использовать Icon конструктор . Чтобы выполнить этот пример, вставьте код в Форму Windows Form и обработайте событие формы Paint . ConstructAnIconFromAType Вызовите метод из обработчика Paint событий, передавая e как EventArgs.

private void ConstructAnIconFromAType(PaintEventArgs e)
{

    Icon icon1 = new Icon(typeof(Control), "Error.ico");
    e.Graphics.DrawIcon(icon1, new Rectangle(10, 10, 50, 50));
}
Private Sub ConstructAnIconFromAType(ByVal e As PaintEventArgs)

    Dim icon1 As New Icon(GetType(Control), "Error.ico")
    e.Graphics.DrawIcon(icon1, New Rectangle(10, 10, 50, 50))

End Sub

Комментарии

Этот конструктор создает Icon из ресурса с именем, указанным параметром resource в сборке, которая содержит тип, указанный параметром type .

Этот конструктор объединяет пространство имен заданного типа со строковым именем ресурса и ищет совпадение в манифесте сборки. Например, можно передать тип и Error.ico в Control этот конструктор, и он ищет ресурс с именем System.Windows.Forms.Error.ico.

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

Icon(Icon, Int32, Int32)

Исходный код:
Icon.cs
Исходный код:
Icon.cs
Исходный код:
Icon.cs

Инициализирует новый экземпляр класса Icon и предпринимает попытку поиска версии значка, соответствующей требуемому размеру.

public:
 Icon(System::Drawing::Icon ^ original, int width, int height);
public Icon (System.Drawing.Icon original, int width, int height);
new System.Drawing.Icon : System.Drawing.Icon * int * int -> System.Drawing.Icon
Public Sub New (original As Icon, width As Integer, height As Integer)

Параметры

original
Icon

Значок для загрузки другого размера.

width
Int32

Ширина нового значка.

height
Int32

Высота нового значка.

Исключения

Параметр original имеет значение null.

Примеры

В следующем примере кода показано, как использовать метод 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

Комментарии

Если не удается найти версию, которая точно соответствует размеру, используется ближайшее соответствие. original Если параметр имеет Icon один размер, этот метод создает только значок дубликата. Используйте возможности растяжения метода для DrawImage изменения размера значка.

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

Icon(Stream, Int32, Int32)

Исходный код:
Icon.cs
Исходный код:
Icon.cs
Исходный код:
Icon.cs

Инициализирует новый экземпляр класса Icon из указанного потока данных с заданной шириной и высотой.

public:
 Icon(System::IO::Stream ^ stream, int width, int height);
public Icon (System.IO.Stream stream, int width, int height);
new System.Drawing.Icon : System.IO.Stream * int * int -> System.Drawing.Icon
Public Sub New (stream As Stream, width As Integer, height As Integer)

Параметры

stream
Stream

Поток данных, из которого загружается значок.

width
Int32

Ширина значка в пикселях.

height
Int32

Высота значка в пикселях.

Исключения

Параметр stream имеет значение null.

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

Icon(String, Int32, Int32)

Исходный код:
Icon.cs
Исходный код:
Icon.cs
Исходный код:
Icon.cs

Инициализирует новый экземпляр класса Icon с заданными шириной и высотой из указанного файла.

public:
 Icon(System::String ^ fileName, int width, int height);
public Icon (string fileName, int width, int height);
new System.Drawing.Icon : string * int * int -> System.Drawing.Icon
Public Sub New (fileName As String, width As Integer, height As Integer)

Параметры

fileName
String

Имя и путь для файла, содержащего данные значка Icon.

width
Int32

Нужная ширина значка Icon.

height
Int32

Нужная высота значка Icon.

Исключения

Параметр string равен null или не содержит данные изображения.

Комментарии

Если указанный файл не содержит изображения, соответствующего требуемой высоте и ширине, возвращается значок ближайшего размера.

Должен fileName содержать полный путь, если он не находится в текущем каталоге приложения.

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