Icon Constructor (Icon^, Int32, Int32)

 

Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

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

public:
Icon(
	Icon^ original,
	int width,
	int height
)

Parameters

original
Type: System.Drawing::Icon^

The icon to load the different size from.

width
Type: System::Int32

The width of the new icon.

height
Type: System::Int32

The height of the new icon.

Exception Condition
ArgumentException

The original parameter is null.

If a version cannot be found that exactly matches the size, the closest match is used. If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. Use the stretching capabilities of the DrawImage method to resize the icon.

The following code example demonstrates how to use the ToBitmap method. This example is designed to be used with Windows Forms. Create a form and paste the following code into it. 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) );
   }

.NET Framework
Available since 1.1
Return to top
Show: