Graphics.DrawIcon Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Draws the image represented by the specified Icon at the specified coordinates.

Overloads

DrawIcon(Icon, Rectangle)	Draws the image represented by the specified Icon within the area specified by a Rectangle structure.
DrawIcon(Icon, Int32, Int32)	Draws the image represented by the specified Icon at the specified coordinates.

DrawIcon(Icon, Rectangle)

Source:

Graphics.cs

Draws the image represented by the specified Icon within the area specified by a Rectangle structure.

C#

public void DrawIcon(System.Drawing.Icon icon, System.Drawing.Rectangle targetRect);

Parameters

icon

Icon

Icon to draw.

targetRect

Rectangle

Rectangle structure that specifies the location and size of the resulting image on the display surface. The image contained in the icon parameter is scaled to the dimensions of this rectangular area.

Exceptions

ArgumentNullException

icon is null.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

• 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.

C#

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);
}

DrawIcon(Icon, Int32, Int32)

Source:

Graphics.cs

Draws the image represented by the specified Icon at the specified coordinates.

C#

public void DrawIcon(System.Drawing.Icon icon, int x, int y);

Parameters

icon

Icon

Icon to draw.

x

Int32

The x-coordinate of the upper-left corner of the drawn image.

y

Int32

The y-coordinate of the upper-left corner of the drawn image.

Exceptions

ArgumentNullException

icon is null.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

• 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.

C#

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);
}