Graphics.DrawIcon 方法

定义

在指定坐标处绘制由指定的 Icon 表示的图像。Draws the image represented by the specified Icon at the specified coordinates.

重载

DrawIcon(Icon, Int32, Int32)

在指定坐标处绘制由指定的 Icon 表示的图像。Draws the image represented by the specified Icon at the specified coordinates.

DrawIcon(Icon, Rectangle)

Icon 结构指定的区域内绘制指定的 Rectangle 表示的图像。Draws the image represented by the specified Icon within the area specified by a Rectangle structure.

DrawIcon(Icon, Int32, Int32)

在指定坐标处绘制由指定的 Icon 表示的图像。Draws the image represented by the specified Icon at the specified coordinates.

public:
 void DrawIcon(System::Drawing::Icon ^ icon, int x, int y);
public void DrawIcon (System.Drawing.Icon icon, int x, int y);
member this.DrawIcon : System.Drawing.Icon * int * int -> unit
Public Sub DrawIcon (icon As Icon, x As Integer, y As Integer)

参数

icon
Icon

要绘制的 IconIcon to draw.

x
Int32

所绘制图像的左上角的 x 坐标。The x-coordinate of the upper-left corner of the drawn image.

y
Int32

所绘制图像的左上角的 y 坐标。The y-coordinate of the upper-left corner of the drawn image.

例外

iconnullicon is null.

示例

下面的代码示例旨在与 Windows 窗体一起使用,并且它需要作为 PaintEventArgs e Paint 事件处理程序的参数。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. 此代码执行以下操作:The code performs the following actions:

  • 从示例文件夹中的标准 Windows 图标文件 SampIcon 创建一个图标。Creates an icon from a standard Windows icon file SampIcon.ico in the example folder.

  • 创建要在其上绘制图标的左上角的坐标。Creates the coordinates of the upper-left corner at which to draw the icon.

  • 将图标绘制到屏幕上。Draws the icon to the screen.

绘制的图标是无比例的。The drawn icon is unscaled.

private:
   void DrawIconInt( PaintEventArgs^ e )
   {

      // Create icon.
      System::Drawing::Icon^ newIcon = gcnew System::Drawing::Icon( "SampIcon.ico" );

      // Create coordinates for upper-left corner of icon.
      int x = 100;
      int y = 100;

      // Draw icon to screen.
      e->Graphics->DrawIcon( newIcon, x, y );
   }
private void DrawIconInt(PaintEventArgs e)
{
    // Create icon.
    Icon newIcon = new Icon("SampIcon.ico");
             
    // Create coordinates for upper-left corner of icon.
    int x = 100;
    int y = 100;
             
    // Draw icon to screen.
    e.Graphics.DrawIcon(newIcon, x, y);
}
Private Sub DrawIconInt(ByVal e As PaintEventArgs)

    ' Create icon.
    Dim newIcon As New Icon("SampIcon.ico")

    ' Create coordinates for upper-left corner of icon.
    Dim x As Integer = 100
    Dim y As Integer = 100

    ' Draw icon to screen.
    e.Graphics.DrawIcon(newIcon, x, y)
End Sub

适用于

DrawIcon(Icon, Rectangle)

Icon 结构指定的区域内绘制指定的 Rectangle 表示的图像。Draws the image represented by the specified Icon within the area specified by a Rectangle structure.

public:
 void DrawIcon(System::Drawing::Icon ^ icon, System::Drawing::Rectangle targetRect);
public void DrawIcon (System.Drawing.Icon icon, System.Drawing.Rectangle targetRect);
member this.DrawIcon : System.Drawing.Icon * System.Drawing.Rectangle -> unit
Public Sub DrawIcon (icon As Icon, targetRect As Rectangle)

参数

icon
Icon

要绘制的 IconIcon to draw.

targetRect
Rectangle

Rectangle 结构,它指定显示面上结果图像的位置和大小。Rectangle structure that specifies the location and size of the resulting image on the display surface. icon 参数中包含的图像缩放为此矩形区域的尺寸。The image contained in the icon parameter is scaled to the dimensions of this rectangular area.

例外

iconnullicon is null.

示例

下面的代码示例旨在与 Windows 窗体一起使用,并且它需要作为 PaintEventArgs e Paint 事件处理程序的参数。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. 此代码执行以下操作:The code performs the following actions:

  • 从示例文件夹中的标准 Windows 图标文件 SampIcon 创建一个图标。Creates an icon from a standard Windows icon file SampIcon.ico in the example folder.

  • 创建一个要在其中绘制图标的矩形。Creates a rectangle in which to draw the icon.

  • 将图标绘制到屏幕上。Draws the icon to the screen.

矩形的位置查找屏幕上的图标,矩形的大小决定了所绘制的图标的缩放。The position of the rectangle locates the icon on the screen, and the size of the rectangle determines the scaling of the drawn icon.

private:
   void DrawIconRectangle( PaintEventArgs^ e )
   {
      // Create icon.
      System::Drawing::Icon^ newIcon = gcnew System::Drawing::Icon( "SampIcon.ico" );

      // Create rectangle for icon.
      Rectangle rect = Rectangle(100,100,200,200);

      // Draw icon to screen.
      e->Graphics->DrawIcon( newIcon, rect );
   }
private void DrawIconRectangle(PaintEventArgs e)
{        
    // Create icon.
    Icon newIcon = new Icon("SampIcon.ico");
             
    // Create rectangle for icon.
    Rectangle rect = new Rectangle(100, 100, 200, 200);
             
    // Draw icon to screen.
    e.Graphics.DrawIcon(newIcon, rect);
}
Private Sub DrawIconRectangle(ByVal e As PaintEventArgs)

    ' Create icon.
    Dim newIcon As New Icon("SampIcon.ico")

    ' Create rectangle for icon.
    Dim rect As New Rectangle(100, 100, 200, 200)

    ' Draw icon to screen.
    e.Graphics.DrawIcon(newIcon, rect)
End Sub

适用于