Bitmap.MakeTransparent Method ()

Makes the default transparent color transparent for this Bitmap.

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

public:
void MakeTransparent ()
public void MakeTransparent ()
public function MakeTransparent ()
Not applicable.

Return Value

This method does not return a value.

Exception typeCondition

InvalidOperationException

The image format of the Bitmap is an icon format.

Exception

The operation failed.

The system palette defines one color as the default transparent, or alpha, color. This method makes the default transparent color transparent for this Bitmap.

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 makes the system default transparent color transparent for myBitmap, and then draws the Bitmap to the screen.

private:
   void MakeTransparent_Example1( PaintEventArgs^ e )
   {
      // Create a Bitmap object from an image file.
      Bitmap^ myBitmap = gcnew Bitmap( "Grapes.gif" );

      // Draw myBitmap to the screen.
      e->Graphics->DrawImage( myBitmap, 0, 0, myBitmap->Width, myBitmap->Height );

      // Make the default transparent color transparent for myBitmap.
      myBitmap->MakeTransparent();

      // Draw the transparent bitmap to the screen.
      e->Graphics->DrawImage( myBitmap, myBitmap->Width, 0, myBitmap->Width, myBitmap->Height );
   }

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: