Graphics.ReleaseHdc

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

Graphics.ReleaseHdc メソッド ()

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

この Graphics の GetHdc メソッドを前回呼び出したときに取得したデバイス コンテキスト ハンドルを解放します。

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

Visual Basic (宣言)

Public Sub ReleaseHdc

Visual Basic (使用法)

Dim instance As Graphics

instance.ReleaseHdc

C#

public void ReleaseHdc ()

C++

public:
virtual void ReleaseHdc () sealed

J#

public final void ReleaseHdc ()

JScript

public final function ReleaseHdc ()

解説

GetHdc と ReleaseHdc は、Windows デバイスのハンドルを取得および解放するためのメソッドです。Windows ハンドルを使い終えたら、GetHdc に続けて ReleaseHdc を必ず呼び出してください。

.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

参照

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

Graphics.ReleaseHdc メソッド (IntPtr)

この Graphics の GetHdc メソッドを前回呼び出したときに取得したデバイス コンテキスト ハンドルを解放します。

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

Visual Basic (宣言)

Public Sub ReleaseHdc ( _
    hdc As IntPtr _
)

Visual Basic (使用法)

Dim instance As Graphics
Dim hdc As IntPtr

instance.ReleaseHdc(hdc)

C#

public void ReleaseHdc (
    IntPtr hdc
)

C++

public:
void ReleaseHdc (
    IntPtr hdc
)

J#

public void ReleaseHdc (
    IntPtr hdc
)

JScript

public function ReleaseHdc (
    hdc : IntPtr
)

パラメータ

hdc

Graphics の GetHdc メソッドを前回呼び出したときに取得したデバイス コンテキストを識別するハンドル。

解説

デバイス コンテキストは、グラフィカル オブジェクトのセット、それらに関連付けられた属性、および出力に影響を与えるグラフィカル モードを定義する GDI ベースの Windows 構造体です。

GetHdc メソッドと ReleaseHdc メソッドの呼び出しは、ペアで表示する必要があります。GetHdc メソッドと ReleaseHdc メソッドのペアのスコープ内では、通常は GDI 関数だけを呼び出します。hdc パラメータを生成した Graphics の GDI+ メソッドをこのスコープ内で呼び出すと、その呼び出しは失敗し、ObjectBusy エラーが返されます。さらに GDI+ は、以降の操作で hdc パラメータの Graphics に加えられる状態の変更をすべて無視します。

使用例

次の例は、Windows フォームでの使用を意図してデザインされており、Paint イベント ハンドラのパラメータである PaintEventArgse が必要です。この例では、Windows GDI 関数を呼び出して、GDI+Graphics メソッドと同じタスクを実行します。このコードは次のアクションを実行します。

• Windows DLL ファイル gdi32.dll の相互運用性 DllImportAttribute 属性を定義します。この DLL は必要な GDI 関数を格納しており、その DLL の Rectangle 関数を外部関数として定義します。

• 赤いペンを作成します。

• GDI+ DrawRectangle メソッドを使用して、このペンで画面に四角形を描画します。

• 内部ポインタ型変数 hdc を定義し、フォームのデバイス コンテキストを識別するハンドルにこの変数の値を設定します。

• GDI Rectangle 関数を使用して、画面に四角形を描画します。

• hdc パラメータによって表されるデバイス コンテキストを解放します。

Visual Basic

<System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")>
 _
Private Shared Function
 Rectangle2(ByVal hdc As IntPtr, _
ByVal ulCornerX As Integer,
 ByVal ulCornerY As Integer,
 ByVal lrCornerX As Integer, _
ByVal lrCornerY As Integer)
 As Boolean
End Function

<System.Security.Permissions.SecurityPermission( _
System.Security.Permissions.SecurityAction.LinkDemand, Flags := _
System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
Public Sub GetHdcForGDI2(ByVal
 e As PaintEventArgs)

    ' Create pen.
    Dim redPen As New Pen(Color.Red,
 1)

    ' Draw rectangle with GDI+.
    e.Graphics.DrawRectangle(redPen, 10, 10, 100, 50)

    ' Get handle to device context.
    Dim hdc As IntPtr = e.Graphics.GetHdc()

    ' Draw rectangle with GDI using default pen.
    Rectangle2(hdc, 10, 70, 110, 120)

    ' Release handle to device context.
    e.Graphics.ReleaseHdc(hdc)
End Sub

C#

[System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")]
private static extern bool
 Rectangle2(
    IntPtr hdc,
    int ulCornerX, int ulCornerY,
    int lrCornerX, int lrCornerY);

[System.Security.Permissions.SecurityPermission(
System.Security.Permissions.SecurityAction.LinkDemand, Flags = 
System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)]            
public void GetHdcForGDI2(PaintEventArgs e)
{

    // Create pen.
    Pen redPen = new Pen(Color.Red, 1);

    // Draw rectangle with GDI+.
    e.Graphics.DrawRectangle(redPen, 10, 10, 100, 50);

    // Get handle to device context.
    IntPtr hdc = e.Graphics.GetHdc();

    // Draw rectangle with GDI using default pen.
    Rectangle2(hdc, 10, 70, 110, 120);

    // Release handle to device context.
    e.Graphics.ReleaseHdc(hdc);
}

.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
.NET Compact Framework
サポート対象 : 2.0

参照

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

Graphics.ReleaseHdc メソッド

この Graphics の GetHdc メソッドを前回呼び出したときに取得したデバイス コンテキスト ハンドルを解放します。
オーバーロードの一覧

名前	説明
Graphics.ReleaseHdc ()	この Graphics の GetHdc メソッドを前回呼び出したときに取得したデバイス コンテキスト ハンドルを解放します。
Graphics.ReleaseHdc (IntPtr)	この Graphics の GetHdc メソッドを前回呼び出したときに取得したデバイス コンテキスト ハンドルを解放します。 .NET Compact Framework によってサポートされています。

参照

関連項目

Graphics クラス
Graphics メンバ
System.Drawing 名前空間
IDeviceContext