DeleteObject 関数 (wingdi.h)

DeleteObject 関数は、論理ペン、ブラシ、フォント、ビットマップ、領域、またはパレットを削除し、オブジェクトに関連付けられているすべてのシステムリソースを解放します。オブジェクトが削除されると、指定されたハンドルは無効になります。

構文

BOOL DeleteObject(
  [in] HGDIOBJ ho
);

[in] ho

論理ペン、ブラシ、フォント、ビットマップ、領域、またはパレットへのハンドル。

関数が成功すると、戻り値は 0 以外になります。

指定したハンドルが無効であるか、現在 DC に選択されている場合、戻り値は 0 です。

描画オブジェクト (ペンまたはブラシ) は、DC にまだ選択されている間は削除しないでください。

パターンブラシを削除しても、ブラシに関連付けられているビットマップは削除されません。ビットマップは個別に削除する必要があります。

例については、「色付きペンとブラシの作成」を参照してください。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll