IconToBitmap メソッド

指定した System.Drawing.Icon を System.Drawing.Bitmap に変換して透過を保持します。

シンタックス

Visual Basic

'宣言
 
Public Shared Function IconToBitmap( _
   ByVal icon As Icon _
) As Bitmap

C#

public static Bitmap IconToBitmap( 
   Icon icon
)

パラメータ

icon

変換するための System.Drawing.Icon。

戻り値の型

指定した System.Drawing.Icon と同じ画像の System.Drawing.Bitmap。

解説

System.Drawing.Icon.ToBitmap メソッド (.NET framework v1.x のみ) に制限があり、アイコンを構成するピクセルの不透明度は、返されるビットマップに正しく表されません。IconToBitmap メソッドは、アイコンのピクセル データに直接アクセスすることでこの制約を解決します。

IconToBitmap メソッドは、管理されていないコードを実行する権限を持つコンピュータに限って正しく動作し、これは System.Security.Permissions.SecurityPermission クラスを使用して決定されます。

IconToBitmap メソッドは、アイコンのピクセル データにアクセスするプロセスでスローされる除外をキャッチします。例外がスローされると、System.Drawing.Icon.ToBitmap メソッドがフォールバックとして使用されます。System.Drawing.Icon.ToBitmap メソッド自体が例外をスローする場合、IconToBitmap メソッドは例外をサーフェスします。

IconToBitmap メソッドによって返される System.Drawing.Bitmap は、限られたシステム リソースで、使用できなくなると破棄される必要があります。

System.Drawing.Icon.ToBitmap メソッドの制限は、.NET framework の v2.x には存在しません。従って、このプラットフォームでは、このメソッドは、System.Drawing.Icon.ToBitmap メソッドに直接呼び出します。