iCreateFont (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Standard functions / Print functions

Default font
Font and family
Getting the list of fonts installed on a computer
Differences between FontCreate and iCreateFont
Miscellaneous
Freeing the fonts created by iCreateFont

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

iCreateFont (Function)

In french: iCréePolice

Creates a new print font. This font can be used in the different processes. This font is referenced by a font number, chosen during the development. To choose this font and use it in the different print functions, simply select it with iFont.

Remark: This function MUST NECESSARILY be called AFTER iPreview. Otherwise, the previews will be ignored.

Example

See additional examples

// Create a 48-point Pica font
iCreateFont(1, 48, iBold + iItalic, iRoman)
// Print a text with this font
iPrint(iFont(1) + "48-pica text")

Syntax

Create a new font Hide the details

iCreateFont(<Identifier> , <Size> , <Style> , <Name> [, <Color> [, <Angle>]])

<Identifier>: Integer

Font identifier. This identifier will be used in the different print functions to specify the font used.

<Size>: Integer

Height of font in Pica points (1 Pica point = 0.353 mm).

<Style>: Integer constant (or combination of constants)

Font attributes.
iBold Bold font
iCondensed Condensed characters
This option is ignored.
iExtended Extended characters
This option is ignored.
iItalic Italic font
iLarge Large characters
This option is ignored.
iNormal
(default value) Standard font, without attributes
iStrikeOut Strikethrough font
iUnderlined Underlined font

<Name>: Character string

Name of font (among the fonts installed on the current computer).
Printing in PDF: only the following fonts are supported: Courier, Helvetica, Times, Symbol and ZapfDingbats. If the name of specified font does not correspond to a supported font, the Helvetica font will be used.

<Color>: Optional integer

Color used for the font. If this parameter is not specified, the color used is black.
This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color.

<Angle>: Optional integer

Angle (in degrees) according to which the text will be printed. The angle is calculated counterclockwise from an horizontal line (trigonometric direction).

Creating a font family Hide the details

iCreateFont(<Identifier> , <Size> , <Style> , <Family> [, <Color> [, <Angle>]])

<Identifier>: Integer

Font identifier. This identifier will be used in the different print functions to specify the font used.

<Size>: Integer

Height of font in Pica points (1 Pica point = 0.353 mm).

<Style>: Integer constant (or combination of constants)

Font attributes.
iBold Bold font
iCondensed Condensed characters
iExtended Extended characters
iItalic Italic font
iLarge Large characters
iNormal
(default value) Standard font, without attributes
iStrikeOut Strikethrough font
iUnderlined Underlined font

<Family>: Integer constant

Font family.
iCourier Courier font (fixed character width)
iDefault Any font ("Don't care")
iRoman Roman font (exotic font)
iSwiss Swiss font (quality font)

<Color>: Optional integer

Color used for the font. If this parameter is not specified, the color used is black.
This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color.

<Angle>: Optional integer

Angle (in degrees) according to which the text will be printed. The angle is calculated counterclockwise from a horizontal line (trigonometric direction).

Remarks

Default font

If iCreateFont is not used, the default font will have the following characteristics:

Font #0,
size: 12,
normal style.

Font and family

With some configurations, iPrint can produce unexpected results if the name of a font family was specified in iCreateFont. It is recommended to specify the name of a font in iCreateFont.

Getting the list of fonts installed on a computer

To get the list fonts installed on a computer:

In the program manager of Windows, select the main group.
Click the "Control panel" icon and select "Fonts".
In the list of fonts installed, write down the names without taking the attributes and the types into account.

Remarks:

FontList returns the list of fonts installed on a computer.
iSelectFont creates a font from the Windows font selection window

Differences between FontCreate and iCreateFont

FontCreate creates a font definition that can be used in all the elements of a WINDEV or WEBDEV application. This font is stored using the Font variable type and can be used:

to write text in drawings (dFont).
to select a print font (iFont).
to set the font used in the controls of a window (Font of window controls property).
to set the font used in the controls of a report (Font of report controls property).
to select the font used in charts (grLabelFont, grLegendFont, grTitleFont, grAxisTitleFont).

iCreateFont can only create a font that can be used by print functions.

Miscellaneous

iCreateFont can be used to create as many fonts as necessary (memory limit).
You must create as many fonts as the number of colors found in the text.
When printing to an HTML or RTF file (iPreview or iDestination), vertical fonts (at 90º) are replaced with horizontal fonts (at 0º): the text is printed horizontally.

Freeing the fonts created by iCreateFont

When no longer used, the fonts created with iCreateFont can be destroyed by iReset to free resources. If iReset is not used, the fonts will be automatically destroyed when the application is closed.

Component: wd300prn.dll