DISPLAY FONT statement  

Purpose

Display a font selection dialog to return user choices.

Syntax

DISPLAY FONT [hParent], [xpos], [ypos], defname$, defpoints&, defstyle&, flags& _
TO fontname$, points&, style& [,color&, charset&]

hParent

Handle of the parent window or dialog.  If there is no parent, use zero (0) or %HWND_DESKTOP.

xpos

Horizontal position, in pixels, relative to the parent window.  If omitted, PowerBASIC selects the position (offset from the parent, or centered if no parent).

ypos

Vertical position, in pixels, relative to the parent window.  If missing, PowerBASIC selects the position (offset from the parent, or centered if no parent).

defname$

The name of the default, pre-selected font which will be initially highlighted when the font dialog is displayed. A default font may be disabled by passing a nul, zero-length string ("").

defpoints&

The point size of the default, pre-selected font.

defstyle&

The style attribute of the default, pre-selected font. See the specific definition of style& below.

flags&

The style attributes of the FONT Dialog.  The following  values may be used alone or combined, and are predefined in the PowerBASIC compiler:

%CF_BOTH

Causes the dialog box to list both screen and printer fonts.

%CF_TTONLY

Specifies that Font selection dialog should only enumerate and allow the selection of TrueType fonts.

%CF_EFFECTS

Specifies that Font selection dialog should enable strikeout, underline, and color effect choices.

%CF_FIXEDPITCHONLY

Specifies that Font selection dialog should select only fixed-pitch fonts.

%CF_FORCEFONTEXIST

Specifies that Font selection dialog should indicate an error condition if the user attempts to select a font or style that does not exist.

%CF_NOSTYLESEL

Specifies that Font selection dialog should not make an initial style selection.

%CF_NOSIZESEL

Specifies that Font selection dialog should not make an initial size selection.

%CF_NOSIMULATIONS

Specifies that Font selection dialog should not allow graphics device interface (GDI) font simulations.

%CF_NOVECTORFONTS

Specifies that Font selection dialog should not allow vector font selections.

%CF_PRINTERFONTS

Causes the Font selection dialog box to list only the fonts supported by the printer.

%CF_SCALABLEONLY

Specifies that Font selection dialog should allow only the selection of scalable fonts. (Scalable fonts include vector fonts, scalable printer fonts, TrueType fonts, and fonts scaled by other technologies.)

%CF_SCREENFONTS

Causes the Font selection dialog box to list only the screen fonts supported by the system.

%CF_WYSIWYG

Specifies that the Font selection dialog should allow only the selection of fonts available on both the printer and the display. If this flag is specified, the %CF_BOTH and %CF_SCALABLEONLY flags should also be specified.

fontname$

The name of the font selected by the user

points&

The point size of the font selected by the user.

style&

The style attribute of the selected font.  Any of the following values can be combined or used alone:

0

Normal

1

Bold

2

Italic

4

Underline

8

Strikeout

For example, if a style& value of 3 is returned, it specifies that a combination of both bold and italic attributes was selected by the user.

color&

The RGB value of the selected color.

charset&

The chosen character set - 0 if a standard U.S. charset.

See also

CONTROL SET FONT, DIALOG FONT, DISPLAY BROWSE, DISPLAY COLOR, DISPLAY OPENFILE, DISPLAY SAVEFILE, FONT END, FONT NEW, GRAPHIC SET FONT, XPRINT SET FONT