Icon 构造函数

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

初始化 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)

Source:

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 的数据流。

例外

ArgumentException

stream 参数为 null。

注解

一个图标资源可以包含多个图标图像。 一个图标文件可能包含多种大小和颜色深度的图像。 应用程序中使用的映像取决于操作系统和设置。 以下列表详细介绍了图标的典型大小：

• 16 像素 x 16 像素

• 32 像素 x 32 像素

• 48 像素 x 48 像素

此构造函数返回指定流中包含的最小图像。

Icon(String)

Source:

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)

Source:

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

用于指定新 Icon 的高度和宽度的 Size 结构。

例外

ArgumentException

original 参数为 null。

注解

如果找不到与大小完全匹配的版本，则使用最接近的匹配项。 original如果 参数是一个Icon具有单个大小的 ，则此方法仅创建重复图标。 使用 方法的 DrawImage 拉伸功能调整图标的大小。

Icon(Stream, Size)

Source:

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

所需的图标大小。

例外

ArgumentException

stream 为 null 或不包含图像数据。

Icon(String, Size)

Source:

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

所需的图标大小。

例外

ArgumentException

string 为 null 或不包含图像数据。

注解

如果指定的文件不包含与所需大小匹配的图像，则返回大小最接近的图标。

fileName如果它不在当前应用程序目录中，则应包括完整路径。

Icon(Type, String)

Source:

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

要加载的资源的名称。

例外

ArgumentException

由 resource 指定的图标无法在包含指定 type 的程序集中找到。

示例

下面的代码示例演示如何使用 Icon 构造函数。 若要运行此示例，请将代码粘贴到 Windows 窗体中并处理窗体的事件 Paint 。 ConstructAnIconFromAType从Paint事件处理程序调用 方法，作为 eEventArgs传递。

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

注解

此构造函数从包含 参数指定的类型的type程序集中的 参数指定resource的名称的资源创建 Icon 。

此构造函数将给定类型的命名空间与资源的字符串名称组合在一起，并在程序集清单中查找匹配项。 例如， Control 可以将 类型和 Error.ico 传递给此构造函数，并查找名为 System.Windows.Forms.Error.ico的资源。

Icon(Icon, Int32, Int32)

Source:

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

新图标的高度。

例外

ArgumentException

original 参数为 null。

示例

下面的代码示例演示如何使用 ToBitmap 方法。 此示例旨在与 Windows 窗体 一起使用。 创建窗体并将以下代码粘贴到其中。 IconToBitmap在窗体的Paint事件处理程序中调用 方法，作为 ePaintEventArgs传递。

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)

Source:

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

图标的高度（以像素为单位）。

例外

ArgumentException

stream 参数为 null。

Icon(String, Int32, Int32)

Source:

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 高度。

例外

ArgumentException

string 为 null 或不包含图像数据。

注解

如果指定文件不包含与所需高度和宽度匹配的图像，则返回大小最接近的图标。

fileName如果它不在当前应用程序目录中，则应包括完整路径。