ReleaseDC

Aus DGL Wiki
Wechseln zu: Navigation, Suche

ReleaseDC

Name

ReleaseDC - Gibt einen Gerätekontext frei.


Delphi-Spezifikation

function ReleaseDC(hWnd: HWND; hDC: HDC): Integer;


Parameter

hWnd Handle des Fensters, dessen Gerätekontext freigegeben werden soll
hDC Handle des Gerätekontexts, der freigegeben werden soll


Beschreibung

Die Funktion ReleaseDC gibt einen Gerätekontext (DC) frei. Der Effekt von ReleaseDC hängt von der Art des DCs ab. Die Funktion gibt nur allgemeine DCs oder DCs von Fenstern frei. Auf DCs, die Teil einer Klasse oder privat sind, hat die Funktion keine Auswirkung. Der Rückgabewert der Funktion gibt an, ob ein Gerätekontext freigegeben wurde. Falls der Gerätekontext freigegeben wurde, wird 1 zurückgegeben. Falls der Gerätekontext nicht freigegeben wurde, wird 0 zurückgegeben.


Hinweise

Eine Anwendung muss ReleaseDC für jeden Aufruf von GetWindowDC und für jeden Aufruf von GetDC aufrufen.

ReleaseDC kann nicht benutzt werden, um einen Gerätekontext freizugeben, der durch einen Aufruf von CreateDC erschaffen wurde. Stattdessen muss DeleteDC genutzt werden.

ReleaseDC muss vom gleichen Thread aufgerufen werden, der auch GetDC aufgerufen hat.


Fehlermeldungen

Falls der Gerätekontext nicht freigegeben werden konnte, ist der Rückgabewert der Funktion gleich 0.


Siehe auch

CreateDC, DeleteDC, GetDC, GetWindowDC