====== CHOOSEFONT method (System) ======


 
==== Description ====
 
 
Displays the "Choose Font" Windows Common Dialog Box to allow the user to select a font:
 
 
 
{{Choosefont.png?441x477}}
 
 
 
 
 
 
==== Syntax ====
 
<code>
Font = Exec_Method( "SYSTEM",          
                    "CHOOSEFILE",      
                    OwnerWindow,       
                    ChooseFontOptions, 
                    HideColors )
</code>
 
 
 
==== Parameters ====
 
 
 
^Name^Required^Description^
|OwnerWindow|No|ID of the parent window for the dialog.  This can be null, in which case the parent window is the desktop.|
|ChooseFontOptions|No|Contains an @Fm-delimited dynamic array of options that control the behavior of the dialog. It has the following structure:\\ \\ <1> @Svm-delimited FONT structure\\ <2> Flags|
|HideColors|No|If TRUE$ then hide the color selection combobox.|

 


 
==== Returns ====
 
 
An @Svm-delimited FONT structure in the format:
 
 
<code>
<0,0,1>  FaceName
 
<0,0,2>  Height
 
<0,0,3>  Weight
 
<0,0,4>  Italic
 
<0,0,5>  Underline
 
<0,0,6>  Width
 
<0,0,7>  CharSet
 
<0,0,8>  PitchAndFamily
 
<0,0,9>  Strikeout
 
<0,0,10> OutPrecision
 
<0,0,11> ClipPrecision
 
<0,0,12> Quality
</code>
 
 
If the HideColors option is not set then the selected color RGB values are appended to the structure like so:
 
 
<code>
<0,0,13> Red
 
<0,0,14> Green
 
<0,0,15> Blue
</code>
 
 
 
==== Remarks ====
 
 
The ChooseFontOptions argument is composed of two fields which control the behavior of the dialog – each field is described fully below:
 
 
 
^Field^Name^Description^
|<1>|InitialFont|Specifies the font to preselect in the dialog.  This can be:\\ \\ 1. An @Svm-delimited structure in the same format as the return value described above, or\\ 2. The name of an existing control whose FONT property is used to preselect in the dialog.|
|<2>|Flags|A set of bitmask flags that specify the dialog behavior.  These are fully described in the Microsoft documentation for the "flags" member of the CHOOSEFONT structure, and equates constants for these flags can be found in the MSWIN_CHOOSEFONT_EQUATES insert record (See below for an example of using them).|
 
 
 
The CHOOSEFONT method is basically a wrapper around the ChooseFont Windows API function, so it is worth examining at the documentation for this on the MSDN website to get a better idea of the capabilities of this method.
 
 
 
Equated constants for use with the CHOOSEFONT method can be found in the PS_CHOOSEFONT_EQUATES and MSWIN_CHOOSEFONT_EQUATES insert records.
 
 
 
==== See Also ====
 
 
FONT property