Graphics::DrawIcon Method (Icon^, Int32, Int32)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public:
void DrawIcon(
	Icon^ icon,
	int x,
	int y
)

Parameters

icon
Type: System.Drawing::Icon^

Icon to draw.

x
Type: System::Int32

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

y
Type: System::Int32

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

Exception Condition
ArgumentNullException

icon is null.

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:

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

.NET Framework
Available since 1.1
Return to top
Show: