iBrowse User Guide
Table of Contents
Thank you for using iBrowse, the interactive web browser for Microsoft PowerPoint presentations. We are sure that you will find iBrowse to be the easiest way to add dynamic web content to your presentations.
iBrowse works with versions of Microsoft Windows 98 and higher and versions of Microsoft PowerPoint 98 and higher.
If you have any questions or problems, please email us at: firstname.lastname@example.org.
We truly hope that you enjoy the product.
The T-Dog Software Team
You can download iBrowse from the T-Dog Software Company web site at http://www.tdogsoftware.com.
The installation program will install iBrowse onto your computer, and immediately launch a demo presentation that you can use to try all of the features in the product. The iBrowse installation program will also provide you with easy access to the help documentation and a demo presentation through your desktop’s start menu. If you need to get to the help or demo, you can simply click on the desktop start menu and follow the menus to T-Dog iBrowse files.
You will be able to run iBrowse without a license for as long as you like. However, each time you enter a slide that contains iBrowse, you will be prompted to enter a registration key (for each instance of iBrowse in the page). This will continue every 60 seconds until the product is registered. The registration popup will not appear again once the product has been registered. Each iBrowse license entitles you to register the product on one computer only. You may use as many copies of iBrowse on one computer as you like.
Registering iBrowse entitles you to future software upgrades, and unlimited use of the product on a single computer.
To purchase iBrowse licenses, go to www.tdogsoftware.com. We use PayPal to conduct credit card transactions.
Once your purchase has been completed, you will be emailed a license that can be used to register the copies of iBrowse that you have purchased. You can register the product the next time the dialog appears, or within the ibrowse Properties page (see the section on Configuring iBrowse ).
The following steps illustrate how to add iBrowse to a slide in a presentation.
In PowerPoint, open the slide that you wish to insert iBrowse into. Then go to the menu bar in PowerPoint and select the Insert -> Object… menu entry. This will cause the Insert Object form to appear.
In the Insert Object form, scroll down the list of controls and select the T-Dog iBrowse entry, then hit the OK button. This will add an instance of iBrowse into the current slide in PowerPoint.
Once you have inserted iBrowse into your slide, you can adjust the position of the control by selecting the object with your mouse, and dragging it to the desired location. You may also resize iBrowse by clicking on a corner or edge of the control and stretching it with your mouse to the desired size.
5 Configuring iBrowse Properties
Once iBrowse has been inserted into your presentation, you may configure it with the proper properties.
Use your left mouse button to first select the control that you would like to configure (if it is not already selected). You will notice that when iBrowse is selected, it will display 8 small squares located on the corners and edges of the bounding box.
Once the control is selected, click your right mouse button (while the mouse is still over the control). You will see a popup menu appear under your mouse. Follow the menu through T-Dog iBrowse Object -> Properties.
Selecting this menu entry will cause the iBrowse Properties window to appear. You may also select the User Guide menu entry to view this documentation.
The iBrowse properties window allows you to set various attributes. Each instance of iBrowse may be configured independently to have its own properties. All of the iBrowse properties settings will be saved within your presentation.
The Show Navigation Toolbar controls whether iBrowse will display its navigation toolbar (see the Navigation Toolbar section).
The Show Border toggle button controls whether iBrowse will display a border around itself. The border is a thin black line that outlines the control. Toggling this button off will hide the border completely.
The Use Scroll Bars button controls whether iBrowse will display scroll bars on pages that require them.
The Home URL field allows you to select a starting page for iBrowse. When this instance of iBrowse appears in the slide show, it will automatically go to this URL. The URL can be set to a remote location (such as http://www.tdogsoftware.com) or a local file on your computer (such as C:\foo.html). You can use the Browse button to browse for files located on your computer. If you do not specify a URL, iBrowse will default to using a blank HTML page.
Currently, relative file names are not supported.
The Font Size feature allows you to select the font size to use in the HTML page. This can be set to “Default, Largest, Large, Medium, Small, or Smallest”. This feature will only affect the fonts if the HTML page is designed to use browser font changes. Some pages do not accommodate browser font overrides.
The Scroll to X and Y fields can be used to automatically scroll the web page displayed in iBrowse to a specified location. This is useful when you want to automatically show content within a large web page that may be out of view when the web page is loaded without manually scrolling to it. The X and Y parameters are measured in pixels, and are relative to the upper left corner of the browser window.
This feature will only apply to the URL specified in the Home URL field. If you navigate or are automatically redirected to another page (and the URL does not match the URL in the Home URL field), iBrowse will not do any automatic scrolling.
This feature only works on pages that do not contain frames. iBrowse must also load the entire page first, then jump to the desired scroll location, so there may be a delay before the window is scrolled to the proper viewport.
This feature also requires that you have Active Scripting Enabled within your Internet Security Settings.
The Refresh feature allows you to automatically refresh the web content in the slide after the specified duration of time has elapsed. The clock will be started after the page has completed loading. We recommend that you use at least 5 second intervals for refreshes.
This feature will only apply to the URL specified in the Home URL field. If you navigate or are automatically redirected to another page (and the URL does not match the URL in the Home URL field), iBrowse will not do any automatic refreshing.
The Page Not Found URL may be used to set an alternate page to navigate to if you attempt to navigate to a page that cannot be found.
The Register iBrowse button will appear in the Properties window only if the product has not been registered. Click on this button to enter your license key (see the Registering iBrowse section).
The Navigation Toolbar allows you to easily navigate between web pages with iBrowse.
The toolbar contains 8 buttons and one URL text field.
The URL text field will display the current page that you are visiting. You can type directly into this text field and either hit return or the Go button to navigate to the page. iBrowse supports all of the protocols that Internet Explorer supports (http://, file://, c:\, etc.).
The back button allows you to traverse back over the history of the pages that you have visited.
The forward button allows you to traverse forward over the history of pages that you have visited.
The stop button allows you to halt the loading of a page.
The refresh button allows you to reload the current page.
The home button allows you to go to the first page that you have visited. The home URL is also the URL that you have specified in the Home URL field in the properties window (see the Home URL section).
The search button will take you to an Internet search engine page.
The file button will allow you to browse for a file on your system.
The go button will cause iBrowse to navigate to the URL listed in the URL field. Hitting this button is equivalent to hitting the return button within the URL text field.
You may use iBrowse to view local or cached content while not connected to the Internet. Both Internet Explorer and iBrowse will cache all of the pages that you visit while online. Therefore, if you plan to take your presentation offline, simply browse to all of the pages that you may plan to visit while presenting your presentation before taking your computer offline. iBrowse will store the pages locally, and retrieve them from your browser’s cache while you are not connected to the Internet.
It is often good to cache web pages even if you plan to work online so that they will load more quickly during your presentation.
When taking your presentation offline, be sure to tell your computer that you are working offline. The easiest way to do this is to launch an Internet Explorer Web Browser, and then select the “Work Offline” entry from the “File” menu before you start your presentation.
Once you tell your computer to work offline, iBrowse will automatically look in your web browser cache for pages that have been stored locally.
Always test your presentations offline before your present to an audience to ensure that all of the pages have been cached properly and are available locally.
iBrowse will leverage any popup blocking software that you have installed for you Internet Explorer (IE) web browser. iBrowse will use the same settings and block popup windows the same way IE does. If you want popups on a particular web page to appear, try using Internet Explorer to navigate to the pages first, and make sure that the popups that you wish to see are allowed for that page. If they appear (without using the keyboard to allow them) in IE, they should also appear in iBrowse.
If you do not have popup blocking software installed, and want it, try visiting Yahoo or Google to download their free browser toolbars and popup blocking software.
You can control the navigation of iBrowse using VBA within PowerPoint. This allows you to create your own buttons and customize iBrowse in many ways.
Each time you insert a copy of iBrowse into a slide, the object is assigned a name. By default, the names start with PPWB1, PPWB2, PPWB3, and so on, for each instance of iBrowse within a slide.
You can find out the iBrowse object instance name by clicking on the standard properties window. To do this, first select the instance of iBrowse that you are interested in scripting then click the right mouse button. Select the Properties entry in the menu, and a Properties window will appear.
Notice the name of the object in the Properties window. It will probably be named PPWB1. You may change this name to whatever you like or leave it as is.
You can call different methods on this object to control the behavior of iBrowse. These methods are covered in the next section.
iBrowse currently supports 8 methods. Each method can be executed on the iBrowse object to perform some type of action. For example, if the object is named PPWB1, you could call PPWB1.goHome from a script, and it would cause that instance of iBrowse to navigate to its home page.
Your presentation must have Macros enabled in order for these APIs to work.
The goBack method will cause iBrowse to navigate back to the previous page in its history.
The goForward method will cause iBrowse to navigate forward to the next page in its history.
The goHome method will cause iBrowse to navigate to the home URL.
The goSearch method will cause iBrowse to navigate to the default search page.
The refresh method will cause iBrowse to refresh the current page.
The setUrl method takes one string argument. Calling this method will cause iBrowse to navigate to the given URL.
The getUrl method will cause iBrowse to return the current URL.
The following example will illustrate how to add a button to a slide to navigate to the T-Dog home page. For a more detailed example, see the iBrowse demo presentation.
Use the knowledge that you acquired above to insert an instance of iBrowse into a slide (see the Adding iBrowse to a Presentation section).
Use the knowledge that you acquired above to identify the name of the instance (see the Identifying the iBrowse Object Instance Name section). In this example, we are assuming that the name is PPWB1.
Locate and press the Command Button icon in the Control Toolbox. Then use the mouse cross hairs to lay out the button in the slide.
You will notice that after you have laid the button out, it will also be displayed in the properties window. The name of the command button will be something like CommandButton1.
Double click on the command button that you just created. A Visual Basic editor should appear with a subroutine shell defined. This is the script that will be called when the command button (that you just created) is pressed.
Enter the code to have the instance of iBrowse (PPWB1) navigate to the T-Dog home page as shown below. When you are done, close the editor.
Save the presentation, and then hit the F5 button to go into slide-show mode. You will notice that both iBrowse and the command button appear in the presentation. When you click on the button, iBrowse should navigate to the T-Dog Software Company web page.
Note: you must have Macros enabled in order for the APIs to work.
Here are some helpful hints:
Before you give a presentation to an audience, go into slide-show mode and view a slide that contains iBrowse once. This will load iBrowse into memory so that it will appear quicker during your presentation.
If you plan to take your presentation offline, run through it (while connected to the Internet) so that all of the pages that you need get stored in your browser cache. You should then be able to take your presentation offline and work in offline mode. iBrowse will draw web pages from the browser cache.
Cache any pages that you anticipate that you will need before you present to an audience. It will help pages to load more quickly.
If you plan to use custom buttons, be sure to enable macros. The VB API for iBrowse requires that macros are enabled.
Be careful when resizing the size of your desktop. PowerPoint uses vector graphics that will resize according to your desktop size. Web pages do not use vector graphics. This may cause pages to get clipped (and scrollbars to appear) if you run the presentation on a computer with a smaller desktop size.
Updates of iBrowse will be available at www.tdogsoftware.com. We advise you to periodically check for updates and download newer versions of the product. Users are entitled to lifetime downloads of new versions of the product.