set_fontset_fontSetFontSetFont (Operator)

Name

set_fontset_fontSetFontSetFont — Set the font used for text output.

Signature

Description

set_fontset_fontSetFontSetFontSetFont sets the font FontFontFontFontfont for the output window WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle. All subsequent text outputs (e.g., with the operators disp_textdisp_textDispTextDispTextDispText, write_stringwrite_stringWriteStringWriteStringWriteString or read_stringread_stringReadStringReadStringReadString) will now use the new font instead of the default font (see set_system('default_font',Font)set_system("default_font",Font)SetSystem("default_font",Font)SetSystem("default_font",Font)SetSystem("default_font",Font)). All available fonts can be queried with query_fontquery_fontQueryFontQueryFontQueryFont.

The syntax for the specification of FontFontFontFontfont is the following:

FONTNAME[-STYLE]-FONT_SIZE.

The optional STYLE may be one of the following (other values are possible as well):

• Normal,

• Bold,

• BoldItalic, or

• Italic.

The FONT_SIZE is measured in pixels.

An example of a valid string for FontFontFontFontfont would be

'Courier-Bold-14'.

Attention

For different machines the available fonts may differ a lot. Therefore it is suggested to use the operator query_fontquery_fontQueryFontQueryFontQueryFont or the procedure set_display_font.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Example (HDevelop)

dev_get_window (WindowHandle)
query_font (WindowHandle, Font)
* Specify font name and size
FontWithSize := Font[0]+'-20'
set_font (WindowHandle, FontWithSize)
dev_disp_text ('Font set to: '+FontWithSize, 'window', 20, 12, 'black', [], [])
* Specify font name, style, and size
FontWithStyleAndSize := Font[0]+'-Bold-20'
set_font (WindowHandle, FontWithStyleAndSize)
dev_disp_text ('Font set to: '+FontWithStyleAndSize, 'window', 50, 12, 'black', [], [])

Result

set_fontset_fontSetFontSetFontSetFont returns 2 (H_MSG_TRUE) if the font name can be resolved. Otherwise an exception is raised.

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowOpenWindow

Possible Successors

query_fontquery_fontQueryFontQueryFontQueryFont

See also

get_fontget_fontGetFontGetFontGetFont, query_fontquery_fontQueryFontQueryFontQueryFont, open_windowopen_windowOpenWindowOpenWindowOpenWindow

Module

Foundation