Свойство Caption

Задает текст, отображаемый в названии объекта.

Применение

CheckBox, CommandButton, Form, Header, Label, OptionButton, Page, _SCREEN, ToolBar

Синтаксис

Object.Caption[ = cText]

Установки

cText

Задает текст, отображаемый вместе с объектом.

Комментарии

Доступно на этапе разработки и на этапе выполнения.

Чтобы назначить элементу управления клавишу доступа, поставьте обратную косую черту со знаком "меньше" (\<) непосредственно перед символом, который вы хотите использовать в качестве клавиши доступа. Когда объект появится на экране, этот символ будет подчеркнут. Если пользователь нажмет клавишу ALT и клавишу подчеркнутого символа, данный элемент управления получит фокус.

Отображение названий зависит от конкретного объекта:

Для объектов Form свойство Caption задает текст, отображаемый в строке заго овка Form. Когда объект Form свернут, этот текст отображается под значком Form.

Для объектов Page в составе PageFrame свойство Caption задает текст, отоб ажаемый на вкладке каждой из страниц.

Для элементов управления свойство Caption задает текст, отображаемый на элеме те управления или рядом с ним.

Для элементов управления, свойство Style которых установлено равным 1 (Graphical), и для свернутых объектов Form название отображается под значком.

Когда вы создаете новый объект Form или новый элемент управления, его название по умолчанию совпадает с установкой свойства Name, используемой по умолчанию. Такое название состоит из класса объекта и целого числа, например Command1, Combo1, Form1.

Замечание Свойство Name показывает, как вы ссылаетесь на объект в коде; свойство Caption описывает, что появляется на экране в качестве идентификатора элемента управ ения. Эти два свойства вначале имеют одинаковые значения, но затем они устанав иваются независимо друг от друга.

Если для данного элемента управления не установлено значение свойства Width, о автоматически изменяется в размерах, чтобы вместить название.

В случае объектов CommandGroup и OptionGroup название отображается только в том случае, если свойство BorderStyle установлено равным 1 (Fixed Single).

Замечание В случае элемента управления Label установите для свойства AutoSize значение "истина" (.T.); тогда этот элемент управления будет автоматически регулировать свои размеры, чтобы вместить свое название. Максимальное число символов свойства Caption для элемента управления Label равняется 256.