The properties of the BrowserHawk ActiveX component are categorized as either browser properties or internal properties. Internal properties are properties that you set as a developer to control BrowserHawk's behavior or to access information related to the component itself.
Both types of properties are accessed by referring to the name of the variable containing the BrowserHawk object, then placing a "." followed by the name of the property you are interested in. Whether you are interested in a browser property or accessing an internal property you use the same method. Example:
<%Set thisBrow = Server.CreateObject("cyScape.browserObj")
canDoFrames = thisBrowser.frames %>
The vast majority of the time you will be interested in accessing BrowserHawk's browser properties. Browser properties are the properties that represent the capabilities of the visiting browser. Examples include frames, StyleSheets, CookiesEnabled, and Plugin_Flash.
See the Properties Reference Guide for a listing of all the browser properties supported and an explanation for each.
Unlike internal properties, the browser properties supported by the component is dynamically determined at run-time, according to what is defined in the Master BDF. For example, if you add a property called MyProp using the BrowserHawk Editor, then when you create an instance of the BrowserHawk ActiveX component it will automatically support the MyProp property! This makes it easy for you to customize the BDF. The other big benefit is that this technique allows you to download BDF updates from cyScape that contain new properties and start using those properties right away, without having to install a new version of the ActiveX component!
Tip: You can also use the showbrow.asp script located in your BrowserHawk install directory to enumerate all the browser properties supported by the component.
Internal properties are different than browser properties in that they do not represent properties of the visiting browser. Instead internal properties are used to access internal information from the component or to set preferences such as the location to redirect someone to if their browser does not support cookies.
The remaining topics in this section focus only on the Internal Properties. If you are interested in the browser properties supported, see the Properties Reference Guide for a detailed listing.