Type: String
Returns a comma delimited list of font names installed on the visitor's system, based on how the FontsToCheck property is set. If FontsToCheck is set to a list of font names, then FontsInstalled will contain a list of those fonts which BrowserHawk determines are installed. If FontsToSet is set to "ALL", then FontsInstalled will be set to all font names on the visitor's system.
Example (checking a specific set of fonts):
<% set bhObj = Server.CreateObject("cyScape.browserObj")
bhObj.SetExtProperties "FontsInstalled"
bhObj.FontsToCheck = "arial, verdana, times"
bhObj.GetExtPropertiesEx
%>
<html>
In checking to see if Arial, Verdana, and Times is installed, BrowserHawk has determined that the following out of that list is installed:
<% Response.Write bhObj.FontsInstalled %>
</html>
Example (getting a list of all fonts installed):
<% set bhObj = Server.CreateObject("cyScape.browserObj")
bhObj.SetExtProperties "FontsInstalled"
bhObj.FontsToCheck = "all" 'Note that "all' is not case sensitive
bhObj.GetExtPropertiesEx
%>
<html>
The following fonts are installed: <P>
<% Response.Write bhObj.FontsInstalled %>
</html>
Tip: See the source for the BrowserHawk fontcheck.asp sample (\Program Files\cyScape\BrowserHawk\samples\ASP) for more details on detecting fonts with BrowserHawk and a full example.
Special notes for this property:
There is a known issue where IE will crash in some cases if the user presses their browser's back button on a page that has performed a check for "ALL" fonts. This problem does not occur when checking for specific fonts. Therefore it is recommended that you only check for ALL fonts if absolutely necessary.
This property is only available for IE 5 and later on Windows and Mac. The check for ALL fonts however is only available on Windows (checking for ALL fonts on IE Mac will always return an empty string).
If the user’s JavaScript is disabled this property will not be available.
The test for FontsInstalled is not included when asking for "all" tests to be performed. Therefore even if you are calling SetExtProperties and specifying "all", you must also explicitly request the FontsInstalled test using SetExtProperties.
Due to the large amount of data associated with collecting the list of ALL fonts, BrowserHawk automatically switches to a RequestType of POST when you specify that ALL fonts should be checked and your RequestType is set at AUTO (which is the default). If your RequestType is coded for something other than AUTO and POST and you request a test for ALL fonts, BrowserHawk will throw an exception at run-time. This behavior does not occur when checking for specific fonts, and any RequestType can be used in that situation.
See Also: