<Return[D]><Top>

DeleteObject

Declare Function Api_DeleteObject& Lib "gdi32" Alias "DeleteObject" (ByVal hObject&)

Declare Function DeleteObject Lib "gdi32" Alias "DeleteObject" (ByVal hObject As Long) As Long

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

パラメータ
hObject
    ペン、ブラシ、フォント、ビットマップ、リージョン、パレットのいずれかの論理オブジェクトのハンドルを指定する。
 

戻り値
    関数が成功すると、0 以外の値が返る。
    指定したハンドルが有効でない場合、またはデバイスコンテキストでそのオブジェクトが選択されている場合は、0 が返る。
    Windows NT/2000:拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    デバイスコンテキストで選択されている描画オブジェクト(ペンまたはブラシ)は削除しないこと。
    パターンブラシを削除しても、そのブラシに関連付けられているビットマップは削除されない。

    ビットマップを削除するには、個別に削除を行う必要がある。