Conduit API
Case Study
HTML Apps & Gadget -> HTML Apps Height
 
You can set a fixed height of an HTML Component using the “Height” drop-down on the HTML Component’s page in the Control Panel. Available values are between 20 px to 26 px. As a result of this action, the toolbar will contain the HTML content in a window with the selected height.

 
If you set the height to a value that is larger than 20 px, and you have users with a toolbar version earlier than those mentioned in the ‘Supporting Versions’ table below, it is recommended that you will call the HandleHeight() function in the “onload” event of your web page. This function call will replace the content of the HTML Component with the display of an ‘Upgrade’ button. When users click the button, they will be redirected to a download file of the newest version of you toolbar. After the user will install the latest version, he will see the HTML Component with the right dimensions.

New toolbars will ignore this call automatically.
 
If your users might have a toolbar installed on clients prior to these dates, you should consider adding the HandleHeight() function as suggested:

Client Name Version Release Date
Internet Explorer Toolbar 5.3.3 October 3, 2009
Firefox Toolbar 2.5.4 January 4, 2010
Safari Toolbar 1.3.0.7 January 26, 2010
 
In order to change the height of an HTML Component from a JS code, you can call the ChangeHeight(newHeight) function. This function will enforce the HTML Component’s container height to the given value. Possible values are 20-26 px.