DeleteFont macro (windowsx.h)

The DeleteFont macro deletes a font object, freeing all system resources associated with the font object.

Syntax

BOOL DeleteFont(
    HFONT hfont
);

Parameters

hfont

A handle to the font object.

Return value

Type: BOOL

If DeleteFont succeeds, the return value is nonzero. If the specified handle is not valid or is currently selected into a Device Context, the return value is zero.

Remarks

After the font object is deleted, the specified handle is no longer valid.

The DeleteFont macro is equivalent to calling DeleteObject as follows:

   DeleteObject((HGDIOBJ)(HFONT)(hfont))

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	windowsx.h

See also

DeleteObject

SelectFont