Graphics.ReleaseHdc Graphics.ReleaseHdc Graphics.ReleaseHdc Graphics.ReleaseHdc Method

定義

この GetHdc()Graphics メソッドを前回呼び出したときに取得したデバイス コンテキスト ハンドルを解放します。Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

オーバーロード

ReleaseHdc() ReleaseHdc() ReleaseHdc() ReleaseHdc()

この GetHdc()Graphics メソッドを前回呼び出したときに取得したデバイス コンテキスト ハンドルを解放します。Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

ReleaseHdc(IntPtr) ReleaseHdc(IntPtr) ReleaseHdc(IntPtr) ReleaseHdc(IntPtr)

この GetHdc()Graphics メソッドを前回呼び出したときに取得したデバイス コンテキスト ハンドルを解放します。Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

ReleaseHdc() ReleaseHdc() ReleaseHdc() ReleaseHdc()

この GetHdc()Graphics メソッドを前回呼び出したときに取得したデバイス コンテキスト ハンドルを解放します。Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

public:
 virtual void ReleaseHdc();
public void ReleaseHdc ();
abstract member ReleaseHdc : unit -> unit
override this.ReleaseHdc : unit -> unit
Public Sub ReleaseHdc ()

実装

注釈

GetHdcReleaseHdcは、Windows デバイスのハンドルを取得して解放できる2つのメソッドです。GetHdc and ReleaseHdc are two methods that allow you to get and release the handle for a Windows device. Windows ハンドルの使用が終了しGetHdcたら、を呼びReleaseHdc出すことで、への呼び出しを常に実行する必要があります。You should always follow a call to GetHdc with a call to ReleaseHdc when you are finished with the Windows handle.

セキュリティ

SecurityPermission
アンマネージコードへのアクセスに使用します。for access to unmanaged code. 関連する列挙UnmanagedCode型:。Related enumeration: UnmanagedCode.

こちらもご覧ください

ReleaseHdc(IntPtr) ReleaseHdc(IntPtr) ReleaseHdc(IntPtr) ReleaseHdc(IntPtr)

この GetHdc()Graphics メソッドを前回呼び出したときに取得したデバイス コンテキスト ハンドルを解放します。Releases a device context handle obtained by a previous call to the GetHdc() method of this Graphics.

public:
 void ReleaseHdc(IntPtr hdc);
public void ReleaseHdc (IntPtr hdc);
member this.ReleaseHdc : nativeint -> unit
Public Sub ReleaseHdc (hdc As IntPtr)

パラメーター

hdc
IntPtr IntPtr IntPtr IntPtr

GetHdc()Graphics メソッドを前回呼び出したときに取得したデバイス コンテキストを識別するハンドル。Handle to a device context obtained by a previous call to the GetHdc() method of this Graphics.

次のコード例は、Windows フォームで使用するように設計さPaintEventArgsれています。これはPaint 、イベントハンドラーのパラメーターであるを必要eとします。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. この例は、Windows GDIGDI関数を呼び出しGDI+GDI+ Graphicsて、メソッドと同じタスクを実行する方法を示しています。The example illustrates calling a Windows GDIGDI function to perform the same task as a GDI+GDI+ Graphics method. コードは、次のアクションを実行します。The code performs the following actions:

  • Windows dll ファイルDllImportAttribute gdi32 の相互運用性属性を定義します。Defines the interoperability DllImportAttribute attribute for the Windows DLL file gdi32.dll. この dll には目的GDIGDIの関数が含まれてRectangleおり、dll 内の関数は外部として定義されています。This DLL contains the desired GDIGDI function, and it defines the Rectangle function in that DLL as external.

  • 赤いペンを作成します。Creates a red pen.

  • ペンを使用して、 GDI+GDI+ DrawRectangleメソッドを使用して画面に四角形を描画します。With the pen, draws a rectangle to the screen using the GDI+GDI+ DrawRectangle method.

  • 内部ポインター型の変数hdcを定義し、その値をフォームのデバイスコンテキストを指すハンドルに設定します。Defines an internal pointer type variable hdc and sets its value to the handle to the device context of the form.

  • Rectangle関数を使用してGDIGDI 、画面に四角形を描画します。Draws a rectangle to the screen using the GDIGDI Rectangle function.

  • hdcパラメーターによって表されるデバイスコンテキストを解放します。Releases the device context represented by the hdc parameter.

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

public:
   void GetHdcForGDI2( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ redPen = gcnew Pen( Color::Red,1.0f );

      // 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 );
   }
[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)]            
private 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);
}
<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)> _
Private 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

注釈

デバイスコンテキストは、にGDIGDI基づく Windows 構造であり、グラフィカルオブジェクトとそれらに関連付けられている属性のセット、および出力に影響を与えるグラフィカルモードを定義します。The device context is a Windows structure based on GDIGDI that defines a set of graphical objects and their associated attributes, as well as the graphical modes that affect output.

メソッドとGetHdc ReleaseHdcメソッドの呼び出しは、ペアで記述する必要があります。Calls to the GetHdc and ReleaseHdc methods must appear in pairs. メソッドGetHdcとメソッドのペアのReleaseHdcスコープでは、通常、関数にGDIGDI対してのみ呼び出しを行います。During the scope of a GetHdc and ReleaseHdc method pair, you usually make calls only to GDIGDI functions. パラメーターを生成GDI+GDI+ Graphics ObjectBusyしたのメソッドに対して行われたそのスコープ内の呼び出しは、エラーが発生して失敗します。 hdcCalls in that scope made to GDI+GDI+ methods of the Graphics that produced the hdc parameter fail with an ObjectBusy error. また、 GDI+GDI+以降の操作では、 hdcパラメーター Graphicsのに対して行われたすべての状態の変更は無視されます。Also, GDI+GDI+ ignores any state changes made to the Graphics of the hdc parameter in subsequent operations.

セキュリティ

SecurityPermission
アンマネージコードへのアクセスに使用します。for access to unmanaged code. 関連する列挙UnmanagedCode型:。Related enumeration: UnmanagedCode.

適用対象