## 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.

Topic: APLX Help : System Classes : Properties : caption

[ Previous | Next | Contents | Index ]