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

Определение

Инициализация нового экземпляра класса Icon.Initializes a new instance of the Icon class.

Перегрузки

Icon(Stream)

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

Icon(String)

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

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, Size)

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

Icon(String, Size)

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

Icon(Type, String)

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

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(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(String, Int32, Int32)

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

Icon(Stream)

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

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

Параметры

stream
Stream

Поток данных, из которого загружается объект Icon.The data stream from which to load the Icon.

Исключения

Параметр stream содержит значение null.The stream parameter is null.

Комментарии

Ресурс значка может содержать несколько изображений значков.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 16 пикселей16 pixels x 16 pixels

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

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

Этот конструктор возвращает наименьшее изображение, содержащееся в указанном потоке.This constructor returns the smallest image that is contained in the specified stream.

Icon(String)

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

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.The file to load the Icon from.

Комментарии

Ресурс значка может содержать несколько изображений значков.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 16 пикселей16 pixels x 16 pixels

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

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

Этот конструктор возвращает наименьшее изображение, содержащееся в указанном файле.This constructor returns the smallest image that is contained in the specified file.

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.

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

Параметры

original
Icon

Объект Icon, из которого загружается значок с измененным размером.The Icon from which to load the newly sized icon.

size
Size

Структура Size, задающая высоту и ширину нового объекта Icon.A Size structure that specifies the height and width of the new Icon.

Исключения

Параметр original содержит значение null.The original parameter is null.

Комментарии

Если не удается найти версию, которая точно соответствует размеру, используется ближайшее соответствие.If a version cannot be found that exactly matches the size, the closest match is used. Если параметр original является Icon с одним размером, то этот метод создает только дубликат значка.If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. Чтобы изменить размер значка, используйте возможности растяжения метода DrawImage.Use the stretching capabilities of the DrawImage method to resize the icon.

Icon(Stream, Size)

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

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

Параметры

stream
Stream

Поток, содержащий данные значка.The stream that contains the icon data.

size
Size

Нужный размер значка.The desired size of the icon.

Исключения

Параметр stream равен null или не содержит данные изображения.The stream is null or does not contain image data.

Icon(String, Size)

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

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

Параметры

fileName
String

Имя и путь для файла, содержащего данные значка.The name and path to the file that contains the icon data.

size
Size

Нужный размер значка.The desired size of the icon.

Исключения

Параметр string равен null или не содержит данные изображения.The string is null or does not contain image data.

Комментарии

Если указанный файл не содержит изображение, соответствующее требуемому размеру, то возвращается значок с ближайшим размером.If the specified file does not contain an image that matches the desired size, the icon that has the closest size is returned.

fileName должен содержать полный путь, если он не находится в каталоге текущего приложения.The fileName should include the complete path if it is not in the current application directory.

Icon(Type, String)

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

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

Параметры

type
Type

Объект Type, задающий сборку, в которой выполняется поиск ресурса.A Type that specifies the assembly in which to look for the resource.

resource
String

Имя ресурса для загрузки.The resource name to load.

Исключения

В сборке, содержащей заданный параметр resource, не удалось найти значок, заданный параметром type.An icon specified by resource cannot be found in the assembly that contains the specified type.

Примеры

В следующем примере кода показано, как использовать конструктор Icon.The following code example demonstrates how to use the Icon constructor. Чтобы выполнить этот пример, вставьте код в форму Windows Forms и обработайте событие Paint формы.To run this example, paste the code into a Windows Form and handle the form's Paint event. Вызовите метод ConstructAnIconFromAType из обработчика событий Paint, передав e как EventArgs.Call the ConstructAnIconFromAType method from the Paint event handler, passing e as 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.This constructor creates an Icon from a resource with the name specified by the resource parameter in the assembly that contains the type specified by the type parameter.

Этот конструктор объединяет пространство имен данного типа вместе с строковым именем ресурса и ищет совпадение в манифесте сборки.This constructor combines the namespace of the given type together with the string name of the resource and looks for a match in the assembly manifest. Например, можно передать тип Control и Error.ico в этот конструктор, и он ищет ресурс с именем System.Windows.Forms.Error.ico.For example you can pass in the Control type and Error.ico to this constructor, and it looks for a resource that is named System.Windows.Forms.Error.ico.

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.

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

Значок для загрузки другого размера.The icon to load the different size from.

width
Int32

Ширина нового значка.The width of the new icon.

height
Int32

Высота нового значка.The height of the new icon.

Исключения

Параметр original содержит значение null.The original parameter is null.

Примеры

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

Комментарии

Если не удается найти версию, которая точно соответствует размеру, используется ближайшее соответствие.If a version cannot be found that exactly matches the size, the closest match is used. Если параметр original является Icon с одним размером, то этот метод создает только дубликат значка.If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. Чтобы изменить размер значка, используйте возможности растяжения метода DrawImage.Use the stretching capabilities of the DrawImage method to resize the icon.

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.

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

Параметры

stream
Stream

Поток данных, из которого загружается значок.The data stream from which to load the icon.

width
Int32

Ширина значка в пикселях.The width, in pixels, of the icon.

height
Int32

Высота значка в пикселях.The height, in pixels, of the icon.

Исключения

Параметр stream содержит значение null.The stream parameter is null.

Icon(String, Int32, Int32)

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

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.The name and path to the file that contains the Icon data.

width
Int32

Нужная ширина значка Icon.The desired width of the Icon.

height
Int32

Нужная высота значка Icon.The desired height of the Icon.

Исключения

Параметр string равен null или не содержит данные изображения.The string is null or does not contain image data.

Комментарии

Если указанный файл не содержит изображение, совпадающее с требуемой высотой и шириной, то возвращается значок с ближайшим размером.If the specified file does not contain an image that matches the desired height and width, the icon that has the closest size is returned.

fileName должен содержать полный путь, если он не находится в каталоге текущего приложения.The fileName should include the complete path if it is not in the current application directory.

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