Method XbpFont():create() Foundation
Selects a font that corresponds with the instance variables of the XbpFont object.
:create( [<cFontName>|<nFontId>] ) --> self
FONT_DEFFIXED_SMALL |
FONT_DEFFIXED_MEDIUM |
FONT_DEFFIXED_LARGE |
FONT_DEFFIXED_XLARGE |
FONT_DEFPROP_SMALL |
FONT_DEFPROP_MEDIUM |
FONT_DEFPROP_LARGE |
FONT_DEFPROP_XLARGE |
FONT_HELV_SMALL |
FONT_HELV_MEDIUM |
FONT_HELV_LARGE |
FONT_HELV_XLARGE |
FONT_COURIER_SMALL |
FONT_COURIER_MEDIUM |
FONT_COURIER_LARGE |
FONT_COURIER_XLARGE |
FONT_TIMES_SMALL |
FONT_TIMES_MEDIUM |
FONT_TIMES_LARGE |
FONT_TIMES_XLARGE |
FONT_STYLE_BOLD |
FONT_STYLE_ITALIC |
This method returns the object executing the method (self).
After the font has been described by assigning values to the instance variables of the XbpFont object, the font must be loaded into memory by the operating system. This is done when the method :create() is called. After the method terminates, the instance variables of the object contain the definition of the font that has actually been created.
When the optional parameter <cFontName> is passed, it must contain a character expression that begins with the point size and is followed by the complete name of the font. In this case, the font properties specified in the font object's instance variable are ignored. The same is true if a font identifier is passed in the <nFontId> parameter. This causes one of the pre-defined system fonts to be created by the font object.
If the font height and name attributes are insufficient to describe the desired font, the <cFontName> and <nFontId> parameter must be omitted. In this case, the font object attempts to select a font that most closely matches the font object's properties.
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.