Help Center

AfxModifyFontFaceNamefunction

Modifies the face name of the font of a window or control.

WindowsfunctionAfxWin.incdocumented

Syntax

FUNCTION AfxModifyFontFaceName (BYVAL hwnd AS HWND, BYREF wszNewFaceName AS WSTRING) AS HFONT

Parameters

NameDescription
hwndHandle to the window or control.
wszNewFaceNameThe new face name of the font.

Return value

The handle of the new font on success, or NULL on failure.

To get extended error information call GetLastError.

Description

Modifies the face name of the font of a window or control.

Remarks

The returned font must be destroyed with DeleteObject or the macro DeleteFont when no longer needed to prevent memory leaks.

Reference

  • Include file AfxWin.inc
  • Defined in AfxNova/AfxWin.inc:3520
  • Documented in Windows/Windows Procedures.md
  • Topic: Windows Procedures