Edit

Share via


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