Bitmap.GetHicon メソッド

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

Bitmap.GetHicon メソッド

アイコンを識別するハンドルを返します。

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

Visual Basic (宣言)

Public Function GetHicon As
 IntPtr

Visual Basic (使用法)

Dim instance As Bitmap
Dim returnValue As IntPtr

returnValue = instance.GetHicon

C#

public IntPtr GetHicon ()

C++

public:
IntPtr GetHicon ()

J#

public IntPtr GetHicon ()

JScript

public function GetHicon () : IntPtr

戻り値
Bitmap と同じイメージを持つアイコンに対する Windows ハンドル。

例外

例外の種類	条件
Exception	操作に失敗しました。

解説

最初は、ハンドルから作成されたアイコンのサイズは元のビットマップと同じです。

使用例

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

• Bitmap を作成します。

• 画面にそのオブジェクトを描画します。

• Bitmap のアイコン ハンドルを取得します。

• フォームの Form.Icon 属性に、ハンドルから作成されたアイコンを設定します。

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

C#

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

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Bitmap クラス
Bitmap メンバ
System.Drawing 名前空間