The 'caption' property

Alternative name: title

Character vector

Valid for: Window, Form, Dialog, Document, Browser, Chart, Label, Menu, Check, Radio, Button, ToolButton, Combo, Page, Frame, Chart, Printer (Windows only), MsgBox, ChooseDir, OpenFile, SaveFile

The caption property is the text displayed by a text control such as a static text, button, radio or check object, and the title of a menu, pre-defined dialog, or window. For a Printer object under Windows, it is the name of the print job which will display in the printer queue. It defaults to the name of the object when it is created. For example:

Create a button called OK on the window Win1. Its caption will be 'OK':

      Win1.OK←'⎕' ⎕NEW 'Button'

Change its caption to 'Yes':

      Win1.OK.caption←'Yes'

Note: Because of a limitation in Windows, you cannot change the title of the ChooseFont and ChooseColor pre-defined dialogs.

For a Chart object, the caption property is one of three labels (the others are subtitle and note). It is intended as a title for the whole chart. However, you can use it in any way you wish, or omit it altogether by leaving it as an empty vector. You can specify the position, color and font of the displayed text by using the placetitle, colortitle and fonttitle properties.

For a Browser object, the caption property is read-only. It corresponds to the HTML Title tag in the page header, so should normally represent the title of the web-page currently displayed.