Icon.FromHandle メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Icon.FromHandle メソッド

アイコン (HICON) を識別する指定の Windows ハンドルから GDI+ Icon を作成します。

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Shared Function FromHandle
 ( _
    handle As IntPtr _
) As Icon

Visual Basic (使用法)

Dim handle As IntPtr
Dim returnValue As Icon

returnValue = Icon.FromHandle(handle)

public static Icon FromHandle (
    IntPtr handle
)

C++

public:
static Icon^ FromHandle (
    IntPtr handle
)

public static Icon FromHandle (
    IntPtr handle
)

JScript

public static function FromHandle
 (
    handle : IntPtr
) : Icon

パラメータ

handle: アイコンを識別する Windows ハンドル。

戻り値
このメソッドが作成する Icon。

解説

このメソッドを使用する場合は、Win32 API の DestroyIcon メソッドを使用して結果のアイコンを廃棄して、確実にリソースが解放されるようにする必要があります。

使用例

次の例は、Windows フォームでの使用を意図してデザインされており、Paint イベントハンドラのパラメータである PaintEventArgse が必要です。このコードは次のアクションを実行します。

Bitmap を作成します。
画面にそのオブジェクトを描画します。
Bitmap のアイコンハンドルを取得します。
フォームの Form.Icon 属性に、ハンドルから作成されたアイコンを設定します。
リソースを解放するには、Win32 API 関数の DestroyIcon を呼び出します。

Visual Basic

<System.Runtime.InteropServices.DllImportAttribute("user32.dll")>
 _
    Private Shared Function
 DestroyIcon(ByVal handle _ 
    As IntPtr) As Boolean
 
    End Function

   Private Sub GetHicon_Example(ByVal
 e As PaintEventArgs)

        ' Create a Bitmap object from an image file.
        Dim myBitmap As New
 Bitmap("c:\FakePhoto.jpg")

        ' Draw myBitmap to the screen.
        e.Graphics.DrawImage(myBitmap, 0, 0)

        ' Get an Hicon for myBitmap.
        Dim HIcon As IntPtr = myBitmap.GetHicon()
    
    ' Create a new icon from the handle.
    Dim newIcon as Icon = System.Drawing.Icon.FromHandle(HIcon)

        ' Set the form Icon attribute to the new icon.
        Me.Icon = newIcon

    ' Destroy the icon, since the form creates its 
    ' own copy of the icon.
    DestroyIcon(newIcon.Handle)
    
    End Sub

 [System.Runtime.InteropServices.DllImport("user32.dll", CharSet=CharSet.Auto)]
    extern static bool DestroyIcon(IntPtr handle);
   
private void GetHicon_Example(PaintEventArgs
 e)
    {
                 
        // Create a Bitmap object from an image file.
        Bitmap myBitmap = new Bitmap(@"c:\FakePhoto.jpg");
                 
        // Draw myBitmap to the screen.
        e.Graphics.DrawImage(myBitmap, 0, 0);
                 
        // Get an Hicon for myBitmap.
        IntPtr Hicon = myBitmap.GetHicon();
    
    // Create a new icon from the handle. 
    Icon newIcon = Icon.FromHandle(Hicon);
              
        // Set the form Icon attribute to the new icon.
        this.Icon = newIcon;
        
        // Destroy the Icon, since the form creates
    // its own copy of the icon.
        DestroyIcon(newIcon.Handle);
    
    }

C++

private:
   [System::Runtime::InteropServices::DllImportAttribute("user32.dll",CharSet=CharSet::Auto)]
   static bool DestroyIcon( IntPtr handle );

public:
   [SecurityPermission(SecurityAction::Demand, Flags=SecurityPermissionFlag::UnmanagedCode)]
   void GetHicon_Example( PaintEventArgs^ e )
   {
      
      // Create a Bitmap object from an image file.
      Bitmap^ myBitmap = gcnew Bitmap( "c:\\FakePhoto.jpg" );
      
      // Draw myBitmap to the screen.
      e->Graphics->DrawImage( myBitmap, 0, 0 );
      
      // Get an Hicon for myBitmap.
      IntPtr Hicon = myBitmap->GetHicon();
      
      // Create a new icon from the handle. 
      System::Drawing::Icon^ newIcon = ::Icon::FromHandle( Hicon );
      
      // Set the form Icon attribute to the new icon.
      this->Icon = newIcon;
      
      // Destroy the Icon, since the form creates
      // its own copy of the icon.
      DestroyIcon( newIcon->Handle );
   }