Graphics.FromHdc メソッド

定義

名前空間:

System.Drawing

アセンブリ:

System.Drawing.Common.dll

パッケージ:

System.Drawing.Common v9.0.0-rc.1.24451.1

指定したハンドルからデバイス コンテキストへの新しい Graphics を作成します。

オーバーロード

FromHdc(IntPtr, IntPtr)	指定したハンドルからデバイス コンテキストへの新しい Graphics を作成し、デバイスへのハンドルを作成します。
FromHdc(IntPtr)	指定したハンドルからデバイス コンテキストへの新しい Graphics を作成します。

FromHdc(IntPtr, IntPtr)

ソース:

Graphics.cs

指定したハンドルからデバイス コンテキストへの新しい Graphics を作成し、デバイスへのハンドルを作成します。

public:
 static System::Drawing::Graphics ^ FromHdc(IntPtr hdc, IntPtr hdevice);

public static System.Drawing.Graphics FromHdc (IntPtr hdc, IntPtr hdevice);

static member FromHdc : nativeint * nativeint -> System.Drawing.Graphics

Public Shared Function FromHdc (hdc As IntPtr, hdevice As IntPtr) As Graphics

パラメーター

hdc

IntPtr

nativeint

デバイス コンテキストへのハンドル。

hdevice

IntPtr

nativeint

デバイスへのハンドル。

戻り値

Graphics

このメソッドは、指定したデバイス コンテキストとデバイスの新しい Graphics を返します。

注釈

FromHdc メソッドによって作成された Graphics と関連リソースを解放するには、常に Dispose メソッドを呼び出す必要があります。

ディスプレイ デバイスに ICM カラー プロファイルが関連付けられている場合でも、GDI+ は既定でそのプロファイルを使用しません。 Graphicsに対して ICM を有効にするには、HDC (およびICM_ON) を SetICMMode 関数に渡した後、HDC から Graphics を構築します。 その後、Graphics によって行われる描画は、ディスプレイ デバイスに関連付けられている ICM プロファイルに従って調整されます。 ICM を有効にすると、パフォーマンスが低下します。

FromHdc 呼び出し時のデバイス コンテキスト (マッピング モード、論理ユニットなど) の状態は、Graphicsによって実行されるレンダリングに影響する可能性があります。

デバイス ハンドルは、通常、特定のプリンター機能のクエリに使用されます。

FromHdc(IntPtr)

ソース:

Graphics.cs

指定したハンドルからデバイス コンテキストへの新しい Graphics を作成します。

public:
 static System::Drawing::Graphics ^ FromHdc(IntPtr hdc);

public static System.Drawing.Graphics FromHdc (IntPtr hdc);

static member FromHdc : nativeint -> System.Drawing.Graphics

Public Shared Function FromHdc (hdc As IntPtr) As Graphics

パラメーター

hdc

IntPtr

nativeint

デバイス コンテキストへのハンドル。

戻り値

Graphics

このメソッドは、指定したデバイス コンテキストの新しい Graphics を返します。

例

次のコード例は Windows フォームで使用できるように設計されており、Paint イベント ハンドラーのパラメーターである PaintEventArgseが必要です。 このコードでは、次のアクションが実行されます。

• hdc 内部ポインター型変数を作成し、フォームのグラフィックス オブジェクトのデバイス コンテキストへのハンドルに設定します。

• hdcを使用して新しいグラフィックス オブジェクトを作成します。

• 新しいグラフィックス オブジェクト (画面上) を使用して四角形を描画します。

• hdcを使用して新しいグラフィックス オブジェクトを解放します。

public:
   void FromHdcHdc( PaintEventArgs^ e )
   {
      // Get handle to device context.
      IntPtr hdc = e->Graphics->GetHdc();

      // Create new graphics object using handle to device context.
      Graphics^ newGraphics = Graphics::FromHdc( hdc );

      // Draw rectangle to screen.
      newGraphics->DrawRectangle( gcnew Pen( Color::Red,3.0f ), 0, 0, 200, 100 );

      // Release handle to device context and dispose of the      // Graphics object
      e->Graphics->ReleaseHdc( hdc );
      delete newGraphics;
   }

private void FromHdcHdc(PaintEventArgs e)
{
    // Get handle to device context.
    IntPtr hdc = e.Graphics.GetHdc();

    // Create new graphics object using handle to device context.
    Graphics newGraphics = Graphics.FromHdc(hdc);

    // Draw rectangle to screen.
    newGraphics.DrawRectangle(new Pen(Color.Red, 3), 0, 0, 200, 100);

    // Release handle to device context and dispose of the      // Graphics object
    e.Graphics.ReleaseHdc(hdc);
    newGraphics.Dispose();
}

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

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

    ' Create new graphics object using handle to device context.
    Dim newGraphics As Graphics = Graphics.FromHdc(hdc)

    ' Draw rectangle to screen.
    newGraphics.DrawRectangle(New Pen(Color.Red, 3), 0, 0, 200, 100)

    ' Release handle to device context and dispose of the Graphics 	' object
    e.Graphics.ReleaseHdc(hdc)
    newGraphics.Dispose()
End Sub

注釈

FromHdc メソッドによって作成された Graphics と関連リソースを解放するには、常に Dispose メソッドを呼び出す必要があります。

ディスプレイ デバイスに ICM カラー プロファイルが関連付けられている場合でも、GDI+ は既定でそのプロファイルを使用しません。 Graphicsに対して ICM を有効にするには、HDC (およびICM_ON) を SetICMMode 関数に渡した後、HDC から Graphics を構築します。 その後、Graphics によって行われる描画は、ディスプレイ デバイスに関連付けられている ICM プロファイルに従って調整されます。 ICM を有効にすると、パフォーマンスが低下します。

FromHdc 呼び出し時のデバイス コンテキスト (マッピング モード、論理ユニットなど) の状態は、Graphicsによって実行されるレンダリングに影響する可能性があります。