CAPTION Attribute | caption Property

Internet Development Index

Sets or retrieves a Boolean value that indicates whether the window is set to display a title bar or caption, for the HTML Application (HTA).

Syntax

HTML <HTA:APPLICATION CAPTION = bTitleBar... >
Scripting [ bTitleBar = ] HTA:APPLICATION.caption

Possible Values

bTitleBar Boolean that specifies one of the following values:
yes Default. Title bar is displayed.
no Title bar is not displayed.
The property is read-only. The property has a default value of yes.

Remarks

Note The caption property is read-only; however, the CAPTION attribute can be used to set the initial value.
The application title appears only when the caption property is set to yes. Turning off the caption also disables the program icon and the Minimize and Maximize buttons. In this case, you must provide an alternate way for the user to quit the HTA, such as a button that invokes the close method of the window object.

Example

This example shows how to retrieve the caption property.
<HTML>
<HEAD>
<HTA:APPLICATION ID="oHTA"
CAPTION="yes"
>
<SCRIPT>
alert ("caption    = " + oHTA.caption);
</SCRIPT>
</HEAD>
<BODY SCROLL="no">
</BODY>
</HTML>
This feature requires Microsoft® Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

This property is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .

Applies To

HTA:APPLICATION