Graphics.GetHdc 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

來源:

Graphics.cs

取得與此 Graphics相關聯之裝置內容的句柄。

public IntPtr GetHdc();

傳回

IntPtr

處理與此 Graphics相關聯的裝置內容。

實作

GetHdc()

範例

下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。 此範例說明呼叫 Windows GDI 函式來執行與 GDI+ Graphics 方法相同的工作。 程式代碼會執行下列動作：

• 定義 Windows DLL 檔案的互操作性 DllImportAttribute 屬性 gdi32.dll。 此 DLL 包含所需的 GDI 函式。

• 將該 DLL 中的 Rectangle 函式定義為外部。

• 建立紅色畫筆。

• 使用畫筆時，使用 GDI+ DrawRectangle 方法將矩形繪製到畫面。

• 定義內部指標類型變數 hdc，並將其值設定為表單裝置內容的句柄。

• 使用 GDI Rectangle 函式將矩形繪製到畫面。

• 釋放以 hdc 參數表示的裝置內容。

public class GDI
{
    [System.Runtime.InteropServices.DllImport("gdi32.dll")]
    internal static extern bool Rectangle(
       IntPtr hdc,
       int ulCornerX, int ulCornerY,
       int lrCornerX, int lrCornerY);
}

private void GetHdcForGDI1(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.
    GDI.Rectangle(hdc, 10, 70, 110, 120);

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

備註

裝置內容是以 GDI 為基礎的 Windows 結構，可定義一組圖形物件及其相關聯的屬性，以及影響輸出的圖形模式。 這個方法會傳回該裝置內容，但字型除外。 因為未選取字型，因此使用從 GetHdc 方法傳回的句柄呼叫 FromHdc 方法將會失敗。

對 GetHdc 和 ReleaseHdc 方法的呼叫必須以配對顯示。 在 GetHdc 和 ReleaseHdc 方法組的範圍內，您通常只會呼叫 GDI 函式。 在該範圍內呼叫產生 hdc 參數之 Graphics 的 GDI+ 方法失敗，併發生 ObjectBusy 錯誤。 此外，GDI+ 會忽略後續作業中對 hdc 參數 Graphics 所做的任何狀態變更。