Приложение 2

Основные свойства компонентов C++ Builder

Ниже приводится таблица, в которой приведен перечень основных свойств наиболее часто используемых компонентов C++ Builder.

Примечания к данным в таблице

1. Все свойства объекта доступны не только на этапе проектирования, но и во время работы программы – их значения можно менять и в ходе ее выполнения, в программном коде.

2. Свойства, начинающиеся со слова Parent (Родитель), определяют различные аспекты общения объекта со своим «родителем» – объектом, на котором он расположен. Например, когда поле ввода помещается на форму, то для него «родителем» будет форма. Если командная кнопка размещена на панели инструментов, то для нее «родителем» будет панель и т. д.

Основные свойства компонентов

Таблица П2.1. Перечень основных свойств всех компонентов

Свойства	Выполняемые действия
ActiveControl	Определяет, какой элемент управления на форме будет выделен (имеет фокус) при запуске программы
Align	Выравнивание объекта внутри родителя. Принимает значения: alNone – нет выравнивания; alIop – по верхней границе; alBottom – по нижней границе; alLeft – по левой границе; alRight – по правой границе; alClient – по всему размеру «родителя»
Alignment	Горизонтальное выравнивание: по левому краю (taLeftJustify); по правому (taRightJustify); по центру (taCenter)
Anchors	Определяет, как объект будет перемещаться или сжиматься при изменении размеров «родителя». Например, если включить два подсвойства akLeft и akRight, то ширина объекта будет сжиматься при уменьшении его ширины. По умолчанию не используется
AutoScroll	Если равно true, то разрешается автоматическое появление полос прокрутки, когда содержимое объекта не умещается в его видимой части
AutoSize	Если равно true, то размер объекта будет автоматически подстраиваться под размер его содержимого
BiDiMode	Способ поведения объекта с учетом национальной специфики – ввод текста и прокручивание информации слева направо (bdLeftToRight, по умолчанию) или справа налево (bdRightToLeft)
BorderIcons	Набор значков в системном меню формы
BorderStyle	Вид рамки объекта. Принимает значения: bsNone (нет рамки); bsSingle (простая рамка); bsSizeable (рамка, позволяющая изменять размеры объекта мышью); bsDialog (рамка в стиле диалоговых окон); bsToolWindow (как bsSingle, но с небольшим заголовком); bsSizeToolWin (как bsSizeable, но с небольшим заголовком)
BorderWidth	Ширина рамки
Cancel	Определяет, будет ли происходить для данного объекта событие OnClick, когда пользователь нажмет клавишу <Esc> (для этого значение Cancel должно быть равно true)
Caption	Заголовок. Для одних объектов применяется, чтобы задать заголовок в окне или надпись на кнопке, для других описывает их содержимое (например, у полей надписи)
Checked	Свойство, определяющее состояние флажков (true – включено)
Color	Цвет объекта
Columns	Число столбцов
Constraints	Содержит четыре подсвойства, определяющие минимально и максимально допустимые размеры объекта
CtI3D	Вид объекта в объемном стиле (стандарт для Windows 95 и выше)
Cursor	Задает вид указателя, который отображается при наведении на объект
Default	Определяет, будет ли происходить для данного объекта событие OnClick, когда пользователь нажмет клавишу <Enter> (для этого свойство Default должно иметь значение true)
DockSite	Применяется для различных панелей, объектов группирования и т. д. Когда включено (true), позволяет использовать этот объект как базу для стыковки других объектов на форме при перетаскивании. Обеспечивает режим «прилипания» (см. свойство DragKind)
Down	Состояние кнопки (true – нажато)
DragCurcor	Задает вид указателя, который отображается при перетаскивании объекта мышью
DragKind	Определяет, можно ли объект произвольно перетаскивать по окну (dkDrag) или же его можно перемещать как стыкуемый объект (dkDock), который сам определяет свою форму при стыковке с другими объектами
DragMode	Определяет, можно ли объект перетаскивать (значение dmAutomatic) или нет (dmManual, по умолчанию) в соответствии с режимом, указанном в DragKind
Enabled	Включен ли объект. Когда свойство Enabled имеет значение false, объект становится недоступным для пользователя (например, кнопка делается серой, и щелкнуть на ней нельзя)
FileName	Имя файла. Используется для сохранения имени выбранного файла в стандартных диалоговых окнах для указания файла с мультимедийным содержимым, для компонентов воспроизведения музыки или звука и т. д.
Flat	Вид границ объекта (true – плоские)
Font	Определяет шрифт, которым будут делаться все надписи внутри объекта. Содержит множество подсвойств
FormStyle	Стиль формы. Может принимать значения: fsNormal (обычное окно); fsMDIChild (внутренне окно многооконного приложения); fsMDIForm (родительское окно многооконного приложения); fsStayOnTop (всегда на поверхности экрана)
Glyph	Картинка, содержащая от одного до четырех (отпущено, недоступно, нажато, выделено) изображений графической кнопки
Height	Высота объекта
HelpContext	Номер экрана справочной системы, который будет вызываться при нажатии клавиши F1 при работе с объектом (требует знания устрой2ства справочной системы Windows)
HelpFile	Имя файла справочной системы для данного приложения или окна
HorzScrollBar	Вид и стиль горизонтальной полосы прокрутки. Состоит из множества подсвойств
Hint	Текст подсказки, которая всплывает при наведении указателя мыши на объект. Эта подсказка будет показываться, если свойство ShowHint установлено в true
Icon	Имя файла со значком для приложения
Images	Список картинок, которые будут использоваться для показа кнопок на панели инструментов, в пунктах меню и т. д.
ItemIndex	Текущий выбранный элемент в списке Items. Нумерация начинается с нуля. Если ничего не выбрано, то значение ItemIndex равно (-1)
Items	Список объектов, хранящих основные данные. Используется во всевозможных списках, меню, наборах
Kind	Вид (тип) объекта. Для разных компонентов может принимать разные значения
Left	Левая координата объекта на родительском объекте
Lines	Список строк. Используется в многострочных текстовых элементах. По структуре похож на свойство Items
Max	Максимальное значение диапазона, используемого во всевозможных компонентах прокрутки, ползунках и т. п.
MaxLength	Максимально допустимая длина вводимой строки символов
Min	Минимальное значение диапазона, используемого во всевозможных компонентах прокрутки, ползунках и т. п.
ModalResult	Значение, которое возвращает модальное диалоговое окно при его закрытии. Может принимать значения mrNone (по умолчанию), mrOk, mrCancel, mrAbort, mrRetry, mrIgnore, mrYes, mrNo и mrAll. Если во время работы диалога в это свойство записать значение, не равное mrNone, то диалоговое окно сразу закроется
Name	Название объекта (имя переменной, которая будет использоваться в программе для обращения к этому объекту)
Options	Параметры настройки объекта. Различны для разных компонентов
Orientation	Ориентация объекта. Может быть горизонтальной (udHorizontal) или вертикальной (unVertical)
OwnerDraw	Характеризует, будет ли объект рисовать свой образ на экране самостоятельно (true)
Picture	Картинка
PixelsPerInch	Число точек (пикселов) на дюйм экрана. Используется для масштабирования формы в зависимости от экранного разрешения. Будет учитываться, если свойство Scaled имеет значение true
PopupMenu	Контекстное меню, связанное с объектом, и вызываемое при щелчке правой кнопки мыши над этим объектом. Выбирается в раскрывающемся списке доступных меню и должно быть подготовлено заранее
Position	Для формы – положение на экране. Принимает значение: poDesigned – положение окна во время работы программы соответствует положению формы на экране на этапе проектирования; poDefault – положение определяется Windows; poDefaultPosOnly – используются размеры, заданные разработчиком; poScreenCenter – положение в центре экрана для многомониторных систем; poDesktopCenter – положение в центре экрана. Для всевозможных компонентов прокрутки, движков и т. п. – текущее положение движка
ReadOnly	Если данное свойство имеет значение true, то объект будет доступен в режиме «только для чтения». Например, поле ввода с включенным свойством ReadOnly позволяет просматривать содержимое, но не изменять его
Scaled	Если имеет значение true, то учитывается свойство PixelsPerInch
ShowHint	Определяет, надо ли показывать всплывающую подсказку, хранящуюся в свойстве Hint
Sorted	Используется во всевозможных списках. Когда включено (true), содержимое списка будет автоматически сортироваться перед выводом на экран
Style	Стиль объекта. Специфичен для разных компонентов (кнопок, списков, шрифтов и т. д.)
TabOrder	Определяет номер объекта при передвижении по элементам управления в родительском окне с помощью клавиши <Tab>. Начинается с 0
TabStop	Определяет, будет ли происходить выделение данного объекта и остановка на нем при передвижении по элементам управления в родительском окне с помощью клавиши <Tab>
Tag	Свойство, сделанное специально для разработчиков. Оно нигде не используется и предназначено только для хранения числа типа int. Tag можно рассматривать как пользовательское свойство и применять его для любых собственных нужд
Text	Содержимое различных текстовых элементов управления (полей ввода и т. п.)
Title	Титул (заголовок) приложения, колонки, сообщения
Top	Верхняя координата объекта на родителе
Transparent	Прозрачность фона объекта. Например, если свойство Transparent имеет значение true для поля надписи, помещенного на объект-изображение, то отображаться на этом изображении будет только текст, а затирания изображения фоном не произойдет
VertScrollBar	Вид и стиль вертикальной полосы прокрутки. Состоит из множества подсвойств
Visible	Определяет, будет ли виден объект во время работы программы (по умолчанию – true)
Width	Ширина объекта
WindowState	Статус окна при его открытии. Принимает значения: WsNormal – используются размеры и положение, заданное на этапе проектирования; WsMinimized – в свернутом виде; WsMaximized – в развернутом виде