Method XbpFontDialog():new()

Creates an instance of the XbpFontDialog class.

XbpFontDialog():new( [<oParent>]  , ;
                     [<oOwner>]   , ;
                     [<oScreenPS>], ;
                     [<oPrintPS>] , ;
                     [<aPos>]       ) --> oXbpFontDialog

The parent for an XbpFontDialog object can be optionally specified using the parameter <oParent>. By default <oParent> is the active window (the return value of SetAppWindow()).

<oOwner> can be used to set the owner for the XbpFontDialog object. By default <oOwner> is the same as <oParent>.

The parameter <oScreenPS> defines a presentation space that is valid for the screen. This parameter is optional unless custom units are selected for the coordinate system of the screen PS the font is used with. This only applies to presentation space objects created by XbpPresSpace:create(). If no presentation space is specified, the font dialog defines a font that can be used on the screen. The metrics of the font are returned in the unit pixel.

The optional parameter <oPrintPS> defines a second presentation space (see XbpPresSpace()) where the XbpFont object defined in the XbpFontDialog should be valid. This second presentation space must be associated with a printer.

<aPos> := { nX, nY }

The optional parameter <aPos> can be used to specify the position where the XbpFontDialog object is displayed. By default, this parameter contains the array {0,0}. This specifies the position for the lower left corner of the XbpFontDialog object. The first element contains the x coordinate and the second element contains the y coordinate. The coordinates are relative to the coordinate system of <oParent>.

The font dialog is opened at a position predefined by the operating system.

The method :new() returns an instance of the XbpFontDialog class. This is an object that provides a font dialog. The font dialog can be configured by assigning various values to the instance variables of an XbpFontDialog object. The font dialog itself is provided by the operating system and must be requested using the method :create().

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.

Method XbpFontDialog():new() Foundation