Type: String
To perform the FontsInstalled check, you must first set the FontsToCheck property to a specific list of font names you wish to check for. Multiple names must be separated by commas.
For example, if you want to check if the visitor has arial, times, and verdana fonts installed, you would set this property to "arial, times, verdana". Only the fonts specified in FontsToCheck will be checked. By only checking the client for a specific set of fonts, BrowserHawk is able to test these fonts very quickly.
Upon completion of the FontsInstalled test, the FontsInstalled property will contain a list of comma-separated font names that are installed in the client based on what you specified in FontsToCheck. For example if you set FontsToCheck to "arial, times, verdana" and verdana is not installed but the other two are, FontsInstalled will be set to "arial, times".
If you want to retrieve the names of all fonts installed, you should pass "all" in for the FontsToCheck property instead of a comma separated list of font names. The FontsInstalled property will then contain a comma separated list of all fonts installed. Note that the test for all fonts installed can take a few seconds to execute. Therefore it is recommended that you only check for "all" when you really need to obtain a list of all fonts.
Note about checking for all fonts: Because of the potential for a very large list of font names being returned by the browser, BrowserHawk automatically switches to a RequestType of POST for processing when FontsToCheck is set to "all". For more information about the RequestType parameter see Detecting Extended Properties.
If you mainly want to know whether a particular font or a group of fonts are installed, set FontsToCheck to just those font names in instead of "all" for a faster and more efficient test.
Tip: Use the FontInstalled method to easily check whether a specific font came back as installed.
See Also: