hozugawa.net · A neutral informational page

DeleteObjectでGDIオブジェクトを解放する実践ガイド

Windows APIで描画処理を実装すると、ペン、ブラシ、フォント、ビットマップなどのGDIオブジェクトを作成する機会が増えます。これらは通常のC++オブジェクトとは異なり、Windows内部で管理されるハンドルを持つリソースです。使用後に適切なAPIで破棄しなければ、アプリケーションの動作中にGDIリソースが蓄積します。

GDIオブジェクトの解放に使われる代表的な関数がDeleteObjectです。CreatePen、CreateBrush、CreateFont、CreateBitmapなどで取得したハンドルを対象にできます。ただし、単に関数へ渡せばよいわけではなく、デバイスコンテキストから選択解除してから破棄するという順序が重要です。

特にウィンドウの再描画、印刷、画像変換、ドラッグ&ドロップ処理などでは、描画用リソースが複数の処理経路から作成されます。エラー発生時の後始末まで設計しないと、通常時には問題が見えなくても、長時間稼働した際に描画失敗やAPIエラーとして現れます。

DeleteObjectの役割と制約を理解し、所有権、選択状態、解放順序を明確にしておくことが、安定したWin32アプリケーションにつながります。ここでは代表的なGDIハンドルの扱いから、失敗しやすいコード、確認方法まで整理します。

DeleteObjectが解放するGDIリソース

DeleteObjectは、GDIオブジェクトを識別するハンドルを受け取り、該当するカーネル管理リソースを削除します。対象となるのは、HPEN、HBRUSH、HFONT、HBITMAP、HPALETTE、HRGNなどです。関数の宣言は次のようになります。

BOOL DeleteObject(HGDIOBJ ho);

戻り値が0以外なら処理は成功し、0なら失敗です。引数はHGDIOBJ型ですが、実際には各種GDIハンドルをキャストして渡します。C++では、ハンドルを作成した関数と破棄する関数を対応させ、どのコードが所有者なのかを明確にすると管理しやすくなります。

HPEN hPen = CreatePen(PS_SOLID, 1, RGB(0, 0, 255));
if (hPen != nullptr) {
    // 描画処理
    DeleteObject(hPen);
}

NULLまたはnullptrをDeleteObjectに渡しても、作成失敗を回復できるわけではありません。Create系APIの戻り値を確認し、取得できた場合だけ描画に利用します。また、DeleteObject後のハンドルは無効になるため、同じ値を再利用したり、二重解放したりしないようにします。

DCから選択解除してから破棄する

GDIオブジェクトをHDCへSelectObjectで選択した場合、そのオブジェクトが選択されたままの状態でDeleteObjectを呼び出してはいけません。選択中のペン、ブラシ、フォント、ビットマップは、まず元のオブジェクトへ戻す必要があります。特にメモリDCへ選択したビットマップでは、この順序を誤ると削除できません。

HBITMAP hBitmap = CreateCompatibleBitmap(hdc, 640, 480);
HBITMAP hOldBitmap = nullptr;

if (hBitmap != nullptr) {
    hOldBitmap = static_cast<HBITMAP>(
        SelectObject(hMemDC, hBitmap)
    );

    // hMemDCを使った描画

    SelectObject(hMemDC, hOldBitmap);
    DeleteObject(hBitmap);
}

SelectObjectが返す値は、以前選択されていたオブジェクトです。処理の開始時に保存し、終了時に必ず復元します。ペンやブラシでも同じ考え方を使えます。保存した古いハンドルがNULLやエラー値ではないかを確認し、復元処理が実行される構造にしておくことが大切です。

DCそのものはDeleteObjectでは解放しません。GetDCで取得したウィンドウDCはReleaseDC、CreateCompatibleDCで作成したメモリDCはDeleteDCを使用します。GDIオブジェクトとデバイスコンテキストは別種類のリソースなので、破棄APIを混同しないようにします。

オブジェクト別の解放方法を整理する

代表的なGDIオブジェクトと作成・破棄関数の対応を把握しておくと、解放漏れを発見しやすくなります。DeleteObjectで扱えるものでも、作成元が異なるため、利用目的に応じた所有権の設計が必要です。

GDIオブジェクト 代表的な作成関数 標準的な解放方法 注意点
ペン CreatePen、CreatePenIndirect DeleteObject DCから選択解除する
ブラシ CreateSolidBrush、CreatePatternBrush DeleteObject 塗りつぶし処理後に戻す
フォント CreateFont、CreateFontIndirect DeleteObject テキスト描画後に戻す
ビットマップ CreateBitmap、CreateCompatibleBitmap DeleteObject メモリDCから外してから削除
パレット CreatePalette DeleteObject 選択状態を解除する
リージョン CreateRectRgn、CreatePolygonRgn DeleteObject SelectClipRgnとの関係に注意
メモリDC CreateCompatibleDC DeleteDC DeleteObjectの対象ではない

GDIオブジェクトを使用する処理と、ファイル名や文字列を処理する処理は別問題ですが、実際のWindowsプログラムでは連続して登場します。たとえば画像ファイルを列挙する処理では、ディレクトリ列挙で得たファイルを読み込み、ビットマップを生成して表示する流れが考えられます。この場合、検索ハンドルのFindCloseと、画像用GDIハンドルのDeleteObjectをそれぞれ実行します。

ビットマップをファイルへ保存する場合や、ブラシパターンに画像を使う場合も、GDIオブジェクトの所有者を曖昧にしないことが重要です。OSや外部ライブラリが返したハンドルを、アプリケーション側で削除してよいかは、APIの契約を確認して判断します。

解放漏れを防ぐ実装パターン

最も安全な方法は、作成直後から解放責任を管理し、成功経路と失敗経路の両方で同じ後始末を実行することです。複数のGDIオブジェクトを作成する場合、後から作成したものを先に解放すると、依存関係を整理しやすくなります。

HBRUSH hBrush = CreateSolidBrush(RGB(240, 240, 240));
HPEN hPen = CreatePen(PS_SOLID, 1, RGB(0, 0, 0));

if (hBrush == nullptr || hPen == nullptr) {
    if (hPen != nullptr) {
        DeleteObject(hPen);
    }
    if (hBrush != nullptr) {
        DeleteObject(hBrush);
    }
    return FALSE;
}

HGDIOBJ oldBrush = SelectObject(hdc, hBrush);
HGDIOBJ oldPen = SelectObject(hdc, hPen);

// 描画処理

SelectObject(hdc, oldPen);
SelectObject(hdc, oldBrush);
DeleteObject(hPen);
DeleteObject(hBrush);
return TRUE;

C++では、デストラクターでDeleteObjectを呼ぶ独自ラッパーや、スマートハンドルを利用すると、例外や早期returnにも対応できます。ただし、デストラクターが呼ばれる時点で対象オブジェクトがDCに選択されたままだと問題になるため、選択解除を管理する仕組みも必要です。

ウィンドウへファイルがドロップされた場合は、WM_DROPFILESの処理でファイルパスを取得し、画像や文書を読み込むことがあります。ドロップファイル処理の後に作成したビットマップを表示するなら、再描画終了時や画像差し替え時に古いHBITMAPを解放します。新しい画像を先に選択し、古い画像を後で削除する設計では、現在の選択状態を必ず確認してください。

安易にWM_PAINTのたびにペンやブラシを作成する実装も、解放漏れを招きやすいパターンです。固定色のリソースはウィンドウ生成時に一度作り、破棄時にまとめて解放する方法が適しています。描画ごとに作る必要がある場合は、処理の末尾を一つに集約します。

エラー確認と診断の進め方

DeleteObjectが失敗した場合、対象が選択中である、無効なハンドルを渡している、すでに削除済みであるといった原因が考えられます。戻り値は必ず確認しますが、DeleteObjectの失敗時にGetLastErrorが常に具体的な原因を示すとは限りません。そのため、作成、選択、復元、削除の各段階を記録するほうが有効な場合があります。

Windowsのタスクマネージャーや診断ツールでGDIオブジェクト数を確認すると、リークの傾向を把握できます。画面を何度も再描画したり、画像を繰り返し切り替えたりして、GDIオブジェクト数が処理前の水準へ戻るかを調べます。数が単調に増えるなら、DeleteObjectの不足だけでなく、DeleteDC、ReleaseDC、FindCloseなど別種類の解放漏れも調査します。

安定した後始末を実装するための確認項目は次のとおりです。

文字列処理と描画資源を分離する

Windows APIでは、ファイル名を取得して表示したり、フォントを指定して文字列を描画したりする処理が頻繁に組み合わされます。マルチバイト文字列とUnicode文字列を変換する場合は、文字コード変換の整理のように、文字列バッファの寿命と変換結果を分けて管理すると安全です。

文字列変換用のメモリとGDIオブジェクトは異なるリソースですが、どちらも「作成した側が責任を持って解放する」という原則を適用できます。フォントを生成して文字列を描画した後は、元のフォントをDCへ戻してからHFONTを削除します。文字コード変換用バッファを解放する処理と混在させず、資源の種類ごとに後始末を整理すると、レビューもしやすくなります。

DeleteObjectはGDIリソースを解放する基本関数ですが、成功するコードは関数を呼ぶ位置だけでなく、ハンドルの所有権と選択状態まで設計されています。ペンやブラシの短い処理から画像表示のような長寿命処理まで、作成、利用、選択解除、破棄の4段階を追跡できる形にすることが重要です。まず既存コードで作成されるGDIハンドルを一覧化し、それぞれの解放箇所と選択解除箇所を対応付けて確認します。