GetMainFrameTitle - Develop Apps

Conduit API

Case Study

HTML Apps -> GetMainFrameTitle

- Description

This function is used to get the title of the current page loaded in the main browser.

- Syntax

GetMainFrameTitle()

- Parameters

None.

- Return Value

Description	Type
Current page's title.	string

- Remarks

In order to retrieve the main frame URL, you will need to apply the following security settings for your toolbar.
This function can be used both with the HTML component and with the gadget window.
This function cannot be used inside the EBNavigateComplete event (the return value may not be valid).
*Notice: API methods must be invoked after the web page has triggered the "onload" event.

- Code Example

HTML | Gadget

This example is an icon GetMainFrameTitle

that when clicked, returns a message to the user containing the main frame title.

<html>
<head>
<style type= "text/css">
BODY
{
margin-left:0;
margin-right:0;
margin-top:0;
margin-bottom:0;
width:100%;
height:100%;
overflow:hidden;
background-color:threedface;
}
</style>
<!-- Conduit API script declaration -->
<script type="text/javascript" language="javascript" src="http://api.conduit.com/BrowserCompApi.js"></script>
</head>
<body>
<img alt="GetMainFrameTitle" style="vertical-align:bottom" src="http://www.conduit.com/developers/api/Images/Toolbars/HTML/GetMainFrameTitle.gif" onclick="alert('Main frame title is: ' + GetMainFrameTitle())" />
</body>
</html>

<html>
<head>
<style type= "text/css">
BODY
{
margin-left:0;
margin-right:0;
margin-top:0;
margin-bottom:0;
width:100%;
height:100%;
overflow:hidden;
background-color:threedface;
}
</style>
<!-- Conduit API script declaration -->
<script type="text/javascript" language="javascript" src="http://api.conduit.com/BrowserCompApi.js"></script>
</head>
<body>
<input type="button" value="Get main frame title" onclick="alert('Main frame title is: ' + GetMainFrameTitle())" />
</body>
</html>

- Code Usage

See code usage for HTML component
See code usage for gadget