System charset and font operations
[GDI functions]

Defines

• #define SYSLOGFONT_DEFAULT   0
• #define SYSLOGFONT_WCHAR_DEF   1
• #define SYSLOGFONT_FIXED   2
• #define SYSLOGFONT_CAPTION   3
• #define SYSLOGFONT_MENU   4
• #define SYSLOGFONT_CONTROL   5

Functions

• static PLOGFONT GUIAPI GetSystemFont (int font_id)

  Gets the system logical font through an font identifier.
  

• MG_EXPORT int GUIAPI GetSysFontMaxWidth (int font_id)

  Gets the maximal width of a single-byte character of a system font.
  

• MG_EXPORT int GUIAPI GetSysFontAveWidth (int font_id)

  Gets the average width of a single-byte character of a system font.
  

• MG_EXPORT int GUIAPI GetSysFontHeight (int font_id)

  Gets the height of a single-byte character of a system font.
  

• MG_EXPORT const char *GUIAPI GetSysCharset (BOOL wchar)

  Gets the current system charset.
  

• MG_EXPORT int GUIAPI GetSysCharHeight (void)

  Gets the height of a character of the default system font.
  

• MG_EXPORT int GUIAPI GetSysCharWidth (void)

  Gets the width of a single-byte character of the default system font.
  

• MG_EXPORT int GUIAPI GetSysCCharWidth (void)

  Gets the width of a multi-byte character of the default system font.
  

---

Detailed Description

MiniGUI creates a few system fonts to draw menu text, window caption, or other general items. MiniGUI at least creates two system fonts: one mono-space logical font for single-byte charset, and one mono-space logical font for multi-byte charset. For the multi-byte charset, the width of one multi-byte character should be equal to the width of two single-byte characters.

---

Define Documentation

#define SYSLOGFONT_CAPTION   3

See also: GetSystemFont Definition at line 5783 of file gdi.h.

#define SYSLOGFONT_CONTROL   5

See also: GetSystemFont Definition at line 5795 of file gdi.h.

#define SYSLOGFONT_DEFAULT   0

See also: GetSystemFont Definition at line 5765 of file gdi.h.

#define SYSLOGFONT_FIXED   2

See also: GetSystemFont Definition at line 5777 of file gdi.h.

#define SYSLOGFONT_MENU   4

See also: GetSystemFont Definition at line 5789 of file gdi.h.

#define SYSLOGFONT_WCHAR_DEF   1

See also: GetSystemFont Definition at line 5771 of file gdi.h.

---

Function Documentation

int GUIAPI GetSysCCharWidth (  void   )

Gets the width of a multi-byte character of the default system font. This function returns the width of a multi-byte character of the default system font. MiniGUI uses mono-space font as the system default font. Returns: The width of multi-byte character of the default system font. See also: GetSysCharHeight, GetSysCharWidth

int GUIAPI GetSysCharHeight (  void   )

Gets the height of a character of the default system font. This function returns the height of a character of the system default font. MiniGUI uses mono-space font as the default system font. Normally, the width of one multi-byte character is equal to the width of two single-byte character when using the default system font. Returns: The character height of the default system font. See also: GetSysCharWidth, GetSysCCharWidth

const char *GUIAPI GetSysCharset (  BOOL  wchar  )

Gets the current system charset. This function gets the current system charset and returns the charset name. By default, the system charset is ISO8859-1 (for single-byte charset) or GB2312.1980-0 (for wide charset), but you can change it by modifying MiniGUI.cfg. Parameters: wchar  Whether to retrive the wide charset supported currently. Returns: The read-only buffer of charset name. If you pass wchar TRUE, This function may return NULL, if there is not any wide charset supported.

int GUIAPI GetSysCharWidth (  void   )

Gets the width of a single-byte character of the default system font. This function returns the width of a single-byte character of the default system font. MiniGUI uses mono-space font as the default system font, but you can specify a different font to output text in windows of MiniGUI. Returns: The width of single-byte character of the default system font. See also: GetSysCharHeight, GetSysCCharWidth, SelectFont, CreateLogFont

int GUIAPI GetSysFontAveWidth (  int  font_id  )

Gets the average width of a single-byte character of a system font. This function returns the average width of a single-byte character of one system font. Parameters: font_id  The identifier of a system font. Returns: The average width of single-byte character of the default system font. See also: GetSystemFont

int GUIAPI GetSysFontHeight (  int  font_id  )

Gets the height of a single-byte character of a system font. This function returns the height of a single-byte character of one system font. Parameters: font_id  The identifier of a system font. Returns: The height of single-byte character of the default system font. See also: GetSystemFont

int GUIAPI GetSysFontMaxWidth (  int  font_id  )

Gets the maximal width of a single-byte character of a system font. This function returns the maximal width of a single-byte character of one system font. Parameters: font_id  The identifier of a system font. Returns: The maximal width of single-byte character of the default system font. See also: GetSystemFont

PLOGFONT GUIAPI GetSystemFont (  int  font_id  )  [inline, static]

Gets the system logical font through an font identifier. This function returns the system logical font through the font identifier font_id. Parameters: font_id  The identifier of a system font, can be one of the following values: SYSLOGFONT_DEFAULT The default system logical font in single-byte charset, must be rbf. SYSLOGFONT_WCHAR_DEF The default system logical font in multi-byte charset, must be rbf. SYSLOGFONT_FIXED The fixed space system logical font. SYSLOGFONT_CAPTION The system logical font used to draw caption text. SYSLOGFONT_MENU The system logical font used to draw menu items. SYSLOGFONT_CONTROL The system logical font used to draw controls. Returns: The pointer to the system logical font. NULL on error. Definition at line 5825 of file gdi.h. References NULL.

---