Краткий справочник по компонентам Borland C++ Builder

Компонент Форма

Форма (объект типа TForm) является основой любого Windows приложения. Свойства формы (табл. 1) определяют вид окна приложения.

Все компоненты имеют следующие свойства:

Name	Имя компонента. Используется в приложении для доступа к компоненту и его свойствам
Тор	Расстояние от верхней границы компонента до верхней границы формы
Left	Расстояние от левой границы компонента до левой границы формы
Width	Ширина компонента
Height	Высота компонента
Visible	Позволяет скрыть компонент (false) или сделать его видимым (true)
ParentFont	Признак наследования компонентом характеристик шрифта формы, на которой находится компонент. Если значение свойства равно true, то текст выводится шрифтом, установленным для формы

Таблица1. Свойства формы

Свойство	Описание
Caption	Текст заголовка для управления формой и доступа к компонентам формы
ClientWidth	Ширина рабочей (клиентской) области формы, т. е. без учета ширины левой и правой границ
ClientHeight	Высота рабочей (клиентской) области формы, т. е. без учета высоты заголовка и ширины нижней границы формы
BorderStyle	Вид границы. Граница может быть обычной (bsSize-able), тонкой (bsSingle) или отсутствовать (bsNone). Если у окна обычная граница, то во время работы приложения пользователь может при помощи мыши изменить размер окна. Изменить размер окна с тонкой границей нельзя. Если граница отсутствует, то на экран во время работы приложения будет выведено окно без заголовка. Положение и размер такого окна во время работы приложения изменить нельзя
Borderlcons	Кнопки управления окном. Значение свойства определяет, какие кнопки управления окном будут доступны пользователю во время работы приложения. Значение свойства задается путем присвоения значений уточняющим свойствам biSystemMenu, biMinimize, biMaximize и biHelp. Свойство biSystemMenu определяет доступность кнопки системного меню, biMinimi ze - кнопки Свернуть, biMaximize- кнопки Развернуть, biHelp- кнопки вывода справочной информации
Icon	Значок в заголовке окна
Color	Цвет фона. Цвет можно задать, указав название цвета или привязку к текущей цветовой схеме операционной системы. Во втором случае цвет определяется текущей цветовой схемой, выбранным компонентом привязки и меняется при изменении цветовой схемы операционной системы
Font	Шрифт, используемый "по умолчанию" компонентами, находящимися на поверхности формы. Изменение свойства Font формы приводит к автоматическому изменению свойства Font компонента, располагающегося на поверхности формы. То есть компоненты наследуют свойство Font от формы (имеется возможность запретить наследование)
Canvas	Поверхность, на которую можно вывести графику

Компонент Label

Компонент Label предназначен для вывода текста на поверхность формы. Свойства компонента (табл. 2.) определяют вид и расположение текста.

Таблица 2. Свойства компонента Label (поле вывода текста)

Свойство	Описание
Caption	Отображаемый текст
Autosize	Признак того, что размер поля определяется его содержимым
Wordwrap	Признак того, что слова, которые не помещаются в текущей строке, автоматически переносятся на следующую строку (значение свойства Autosize должно быть false)
Alignment	Задает способ выравнивания текста внутри поля. Текст может быть выравнен по левому краю (taLeftJustify), по центру (taCenter) или по правому краю (taRightJustify)
Font	Шрифт, используемый для отображения текста. Уточняющие свойства определяют шрифт (Name), размер (size), стиль (style) и цвет символов (color)
Color	Цвет фона области вывода текста
Transparent	Управляет отображением фона области вывода текста. Значение true делает область вывода текста прозрачной (область вывода не закрашивается цветом, заданным свойством Color)

Компонент Edit

Компонент Edit представляет собой поле ввода/ редактирования строки символов. Свойства компонента приведены в табл. 3.

Таблица 3. Свойства компонента Edit (поле ввода/редактирования)

Свойство	Описание
Text	Текст, находящийся в поле ввода и редактирования
Font	Шрифт, используемый для отображения вводимого текста
Enabled	Используется для ограничения возможности изменить текст в поле редактирования. Если значение свойства равно false, то текст в поле редактирования изменить нельзя

Компонент Button

Компонент Button представляет собой командную кнопку. Свойства компонента приведены в табл. 4.

Таблица 4. Свойства компонента Button (командная кнопка)

Свойство	Описание
Caption	Текст на кнопке
Enabled	Признак доступности кнопки. Если значение свойства равно true, то кнопка доступна. Если значение свойства равно false, то кнопка не доступна, например, в результате щелчка на кнопке событие click не возникает
Hint	Подсказка - текст, который появляется рядом с указателем мыши при позиционировании указателя на командной кнопке (для того чтобы текст появился, значение свойства showHint должно быть true)
ShowHint	Разрешает (true) или запрещает (false) отображение подсказки при позиционировании указателя на кнопке

Компонент Memo

Компонент Memo представляет собой элемент редактирования текста, который может состоять из нескольких строк. Свойства компонента приведены в табл. 5.

Таблица 5. Свойства компонента Memo

Свойство	Описание
Text	Текст, находящийся в поле Memo. Рассматривается как единое целое
Lines	Массив строк, соответствующий содержимому поля. Доступ к строке осуществляется по номеру. Строки нумеруются с нуля
Font	Шрифт, используемый для отображения вводимого текста

Компонент RadioButton

Компонент RadioButton представляет зависимую кнопку, состояние которой определяется состоянием других кнопок группы. Свойства компонента приведены в табл. 6.

Если в диалоговом окне надо организовать несколько групп радиокнопок, то каждую группу следует представить компонентом RadioGroup.

Таблица.6. Свойства компонента RadioButton

Свойство	Описание
Caption	Текст, который находится справа от кнопки
checked	Состояние, внешний вид кнопки: если кнопка выбрана, то checked = true, если кнопка не выбрана, то Checked= false
Font	Шрифт, используемый для отображения поясняющего текста

Компонент CheckBox

Компонент CheckBox представляет собой независимую кнопку (переключатель). Свойства компонента приведены в табл. 7.

Таблица7. Свойства компонента CheckBox

Свойство	Описание
Caption	Текст, который находится справа от флажка
Checked	Состояние, внешний вид флажка: если флажок установлен (в квадратике есть "галочка"), то значение Checked равно true; если флажок сброшен (нет "галочки"), то значение Checked равно false
State	Состояние флажка. В отличие от свойства Checked, позволяет различать установленное, сброшенное и промежуточное состояния. Состояние флажка определяет одна из констант: cbChecked (установлен); cbGrayed (серый, неопределенное состояние); cbUnChecked (сброшен)
AllowGrayed	Свойство определяет, может ли флажок быть в промежуточном состоянии: если значение AllowGrayed равно false, то флажок может быть только установленным или сброшенным; если значение AllowGrayed равно true, то допустимо промежуточное состояние
Font	Шрифт, используемый для отображения поясняющего текста

Компонент ListBox

Компонент ListBox представляет собой список, в котором можно выбрать нужный элемент. Свойства компонента приведены в табл. 8.

Таблица 8. Свойства компонента ListBox

Свойство	Описание
Items	Элементы списка - массив строк (нумеруются с нуля)
Count	Количество элементов списка
Sorted	Признак необходимости автоматической сортировки (true) списка после добавления очередного элемента.
ItemIndex	Номер выбранного элемента (элементы списка нумеруются с нуля). Если в списке ни один из элементов не выбран, то значение свойства равно -1
Font	Шрифт, используемый для отображения элементов списка

Компонент ComboBox

Компонент ComboBox дает возможность ввести данные в поле редактирования путем набора на клавиатуре или выбором из списка. Свойства компонента приведены в табл. 9.

Таблица 9. Свойства компонента C

Свойство	Описание
Text	Текст, находящийся в поле ввода/редактирования
Items	Элементы списка - массив строк (нумеруются с нуля)
Count	Количество элементов списка
Itemlndex	Номер элемента, выбранного в списке. Если ни один из элементов списка не был выбран, то значение свойства равно минус 2
Sorted	Признак необходимости автоматической сортировки (true) списка после добавления очередного элемента
DropDownCount	Количество отображаемых элементов в раскрытом списке. Если количество элементов списка больше чем DropDownCount, то появляется вертикальная полоса прокрутки
Font	Шрифт, используемый для отображения элементов списка

Компонент StringGrid

Компонент StringGrid представляет собой таблицу, ячейки которой содержат строки символов. Свойства компонента приведены в табл. 10.

Таблица 10. Свойства компонента StringGrid

Свойство	Описание
ColCount	Количество колонок таблицы
RowCount	Количество строк таблицы
DefaultColWidth	Ширина колонок таблицы
DefaultRowHeight	Высота строк таблицы
Fixedcols	Количество зафиксированных слева колонок таблицы. Зафиксированные колонки выделяются цветом и при горизонтальной прокрутке таблицы остаются на месте
FixedRows	Количество зафиксированных сверху строк таблицы. Зафиксированные строки выделяются цветом и при вертикальной прокрутке таблицы остаются на месте
Cells	Соответствующий таблице двумерный массив. Ячейке таблицы, находящейся на пересечении столбца с номером col и строки с номером row, соответствует элемент cells[col][row]
GridLineWidth	Ширина линий, ограничивающих ячейки таблицы
Options.goEditing	Признак допустимости редактирования содержимого ячеек таблицы, true- редактирование разрешено, false - запрещено
Options.goTab	Разрешает (true) или запрещает (false) использование клавиши <ТаЬ> для перемещения курсора в следующую ячейку таблицы
Options .	Признак нахождения компонента в режиме goAlwaysShowEditor редактирования. Если значение свойства false, то для того, чтобы в ячейке появился курсор, надо начать набирать текст, нажать клавишу <F2> или сделать щелчок мышью
Font	Шрифт, используемый для отображения содержимого ячеек таблицы

Компонент Image

Компонент image обеспечивает вывод на поверхность формы иллюстраций, представленных в формате BMP (чтобы компонент можно было использовать для отображения иллюстраций в формате JPG, надо подключить модуль JPEG - включить в текст приложения директиву #inciude <jpeg.hpp>). Свойства компонента image приведены в табл. 11.

Picture	Иллюстрация, которая отображается в поле компонента
Width, Height	Размер компонента. Если размер компонента меньше размера иллюстрации и значение свойств AutoSize, Strech и Proportional равно false, то отображается часть иллюстрации
Proportional	Признак автоматического масштабирования картинки без искажения. Чтобы масштабирование было выполнено, значение свойства AutoSize должно быть false
Strech	Признак автоматического масштабирования (сжатия или растяжения) иллюстрации в соответствии с реальным размером компонента. Если размер компонента не пропорционален размеру иллюстрации, то иллюстрация будет искажена
AutoSize	Признак автоматического изменения размера компонента в соответствии с реальным размером иллюстрации
Center	Признак определяет расположение картинки в поле компонента по горизонтали, если ширина картинки меньше ширины поля компонента. Если значение свойства равно false, то картинка прижата к правой границе компонента, если true - то картинка располагается по центру
Canvas	Поверхность, на которую можно вывести графику

Компонент Timer

Компонент Timer обеспечивает генерацию последовательности событий OnTimer. Свойства компонента приведены в табл..12.

Interval	Период генерации события OnTimer. Задается в миллисекундах
Enabled	Разрешение работы. Разрешает (значение true) или запрещает (значение false) генерацию события OnTimer

Компонент SpeedButton

Компонент SpeedButton представляет собой кнопку, на поверхности которой находится картинка. Свойства компонента приведены в табл. 13.

Таблица.13. Свойства компонента SpeedButton

Свойство	Описание
Glyph	Битовый образ, в котором находятся картинки для каждого из состояний кнопки. В битовом образе может быть до четырех изображений кнопки
NumGlyphs	Количество картинок в битовом образе Glyph
Flat	Свойство Flat определяет вид кнопки (наличие границы). Если значение свойства равно true, то граница кнопки появляется только при позиционировании указателя мыши на кнопке
Groupindex	Идентификатор группы кнопок. Кнопки, имеющие одинаковый идентификатор группы, работают подобно радиокнопкам: нажатие одной из кнопок группы вызывает срабатывание других кнопок этой группы. Чтобы кнопку можно было зафиксировать, значение свойства Groupindex не должно быть равно нулю
Down	Идентификатор состояния кнопки. Изменить значение свойства можно, если значение свойства Groupindex не равно 0
AllowAllUp	Свойство определяет возможность отжать кнопку. Если кнопка нажата и значение свойства равно true, то кнопку можно отжать
Enabled	Признак доступности кнопки. Если значение свойства равно true, то кнопка доступна. Если значение свойства равно false, то кнопка не доступна
visible	Позволяет скрыть кнопку (false) или сделать ее видимой (true)
Hint	Подсказка - текст, который появляется рядом с указателем мыши при позиционировании указателя на командной кнопке (для того чтобы текст появился, надо, чтобы значение свойства ShowHint было true)
ShowHint	Разрешает (true) или запрещает (false) отображение подсказки при позиционировании указателя на кнопке

Компонент UpDown

Компонент upDown представляет собой две кнопки, используя которые можно изменить значение внутренней переменной-счетчика на определенную величину. Увеличение или уменьшение значения происходит при каждом щелчке на одной из кнопок. Свойства компонента приведены в табл. 14.

Таблица 14. Свойства компонента vpDown

Свойство	Описание
Position	Счетчик. Значение свойства изменяется в результате щелчка на кнопке up (увеличивается) или Down (уменьшается). Диапазон изменения определяют свойства Min и Мах, величину изменения - свойство Increment
Min	Нижняя граница диапазона изменения свойства Position
Мах	Верхняя граница диапазона изменения свойства Position
Increment	Величина, на которую изменяется значение свойства Position в результате щелчка на одной из кнопок компонента
Associate	Определяет компонент (Edit - поле ввода/редактирования), используемый в качестве индикатора значения свойства Position. Если значение свойства задано, то при изменении содержимого поля редактирования автоматически меняется значение свойства Position
Orientation	Задает ориентацию кнопок компонента". Кнопки могут быть ориентированы вертикально (udvertical) или горизонтально (udHorizontal)

Компонент Progress Bar

Компонент ProgressBar представляет собой индикатор, который обычно используется для наглядного представления протекания процесса, например, обработки (копирования) файлов, загрузки информации и т. п. Свойства компонента ProgressBar приведены в табл. 15.

Таблица 15. Свойства компонента ProgressBar

Свойство	Описание
Position	Значение, которое отображается в поле компонента в виде последовательности прямоугольников (сегментов) или полосы. Количество прямоугольников (длина полосы) пропорционально значению свойства Position
Min	Минимально допустимое значение свойства Position
Мах	Максимально допустимое значение свойства
Position
step	Приращение (шаг) изменения значения свойства Position при использовании для изменения значения свойства Value метода stepi t
Smooth	Определяет вид индикатора. Индикатор может быть разделен на сегменты (false) или представлять собой полосу

Компонент StatusBar

Компонент statusBar представляет собой область (полосу) вывода служебной информации, которая находится в нижней части окна приложения (иногда полосу вывода служебной информации называют панелью или строкой состояния). Обычно панель вывода служебной информации разделена на области. Свойства компонента statusBar приведены в табл. 16.

Таблица 16. Свойства компонента statusBar

Свойство	Описание
Panels	Коллекция объектов типа TStatusPanel (табл.17), каждый из которых представляет собой отдельную область панели StatusBar
simplePanel	Признак, определяющий вид панели состояния. Если значение свойства равно true, то панель состояния не разделяется на области, а текст, отображаемый в строке состояния, определяет свойство SimpleText
simpleText	Текст, который отображается в панели состояния, если панель не разделена на области (значение свойства SimplePanel равно true). Если панель разделена на области, то текст, находящийся в области, определяет свойство Text соответствующего элемента коллекции Panels

Таблица 17. Свойства объекта statusPanel

Свойство	Описание
Text	Текст, отображаемый в области
width	Ширина области. Ширина самой правой области устанавливается так, что правая граница области совпадает с правой границей панели (компонента StatusBar)

Компонент Animate

Компонент Animate позволяет воспроизводить простую, не сопровождаемую звуком анимацию, кадры которой находятся в файле формата AVI. Свойства компонента приведены в табл. 18.

Таблица 18. Свойства компонента Animate

Свойство	Описание
FileName	Имя файла формата AVI, в котором находится анимация, отображаемая при помощи компонента
StartFrame	Номер кадра, с которого начинается отображение анимации
StopFrame	Номер кадра, на котором заканчивается отображение анимации
Activate	Признак активизации процесса отображения кадров анимации
Color	Цвет фона компонента (цвет "экрана"), на котором воспроизводится анимация
Transparent	Режим использования "прозрачного" цвета при отображении анимации
Repetitions	Количество повторов отображения анимации

Компонент MediaPlayer

Компонент MediaPlayer позволяет воспроизвести видеоролик, звук и сопровождаемую звуком анимацию. Свойства компонента приведены в табл. 19.

Таблица 19. Свойства компонента MediaPlayer

Свойство	Описание
DeviceType	Тип устройства. Определяет конкретное устройство, которое представляет собой компонент MediaPlayer. Тип устройства задается именованной константой: dtAutoSelect- тип устройства определяется автоматически, dtvaweAudio - проигрыватель звука, dtAVivideo - видеопроигрыватель, dtCDAudio - CD-проигрыватель
FileName	Имя файла, в котором находится воспроизводимый звуковой фрагмент или видеоролик
AutoOpen	Признак автоматического открытия сразу после запуска приложения, файла видеоролика или звукового фрагмента
Display	Определяет компонент, на поверхности которого воспроизводится видеоролик (обычно в качестве экрана для отображения видео используют компонент Panel)
visibleButtons	Составное свойство. Определяет видимые кнопки компонента. Позволяет сделать невидимыми некоторые кнопки

Компонент Table

Компонент Table представляет собой таблицу базы данных. Свойства компонента приведены в табл. 20.

Таблица.20. Свойства компонента Table

Свойство	Описание
DatabaseName	Имя базы данных, частью которой является таблица (файл данных), для доступа к которой используется компонент. В качестве значения свойства следует использовать псевдоним базы данных
ТаbleName	Имя файла данных (таблицы данных), для доступа к которому используется компонент
ТаbleТуре	Тип таблицы. Таблица может быть набором данных а формате Paradox (ttParadox), dBase (ttDBase), FoxPro (ttFoxPro) или представлять собой форматированный текстовый файл (ttASCii)
Active	Признак того, что таблица активна (файл данных открыт). В результате присваивания свойству значения true происходит открытие файла таблицы

Компонент Query

Компонент Query представляет часть базы данных - записи, удовлетворяющие критерию SQL-запроса к таблице. Свойства компонента приведены в табл. 21.

Таблица 21. Свойства компонента Query

Свойство	Описание
SQL	Записанный на языке SQL-запрос к базе данных (к таблице)
Active	При присвоении свойству значения true активизирует выполнение запроса
RecordCount	Количество записей в базе данных, удовлетворяющих критерию запроса

Компонент DataSource

Компонент DataSource обеспечивает связь между данными, представленными компонентом Table или Query, и Компонентами отображения данных (DBEdit, DBMemo или DBGrid). Свойства компонента приведены в табл. 22.

Таблица 22. Свойства компонента DataSource

Свойство	Описание
DataSet	Компонент, представляющий собой входные данные(Table или Query)

Компонент DBEdit, DBMemo, DBText

Компоненты DBEdit и DBMemo обеспечивают просмотр и редактирование полей записи базы данных, компонент DBText - только просмотр. Свойства компонентов приведены в табл. 23.

Таблица 23. Свойства компонентов DBText, DBEdi t и DBMemo

Свойство	Описание
DataSource	Компонент-источник данных
DataField	Поле базы данных, для отображения или редактирования которого используется компонент

Компонент DBGrid

Компонент DBGrid используется для просмотра и редактирования базы данных в режиме таблицы. Свойства компонента приведены в табл. 24.

Таблица 24. Свойства компонента DBGrid

Свойство	Описание
DataSource	Источник отображаемых в таблице данных (компонент DataSource
Columns	Свойство columns представляет собой массив объектов типа TColumn, каждый из которых определяет колонку таблицы и отображаемую в ней информацию (табл. 25)
Options.dgTitles	Разрешает вывод строки заголовка столбцов
Options.dglndicator	Разрешает вывод колонки индикатора. Во время работы с базой данных текущая запись помечается в колонке индикатора треугольником, новая запись - звездочкой, редактируемая - специальным значком
Options.dgColumnResize	Разрешает менять во время работы приложения ширину колонок таблицы
Options .dgColLines	Разрешает выводить линии, разделяющие колонки таблицы
Options.dgRowLines	Разрешает выводить линии, разделяющие строки таблицы

Таблица 25. Свойства объекта TColumn

Свойство	Описание
FieldName	Поле записи, содержимое которого выводится в колонке
Width	Ширина колонки в пикселах
Font	Шрифт, используемый для вывода текста в ячейках колонки
Color	Цвет фона колонки
Alignment	Способ выравнивания текста в ячейках колон ки. Текст может быть выровнен по левому кргно (taLeftJustify), по центру (taCenter) или по правому краю (taRightJustify)
Title.Caption	Заголовок колонки. Значением по умолчанию является имя поля записи
Title.Alignment	Способ выравнивания заголовка колонки. Заголовок может быть выровнен по левому краю (taLeftJustify), по центру (taCenter) или по правому краю (taRightJustify)
Title. Color	Цвет фона заголовка колонки
Title .Font	Шрифт заголовка колонки

Компонент DBNavigator

Компонент DBNavigator обеспечивает перемещение указателя текущей записи, активизацию режима редактирования, добавление и удаление записей.

Компонент представляет собой совокупность командных кнопок. Свойства компонента приведены в табл. 27.

Таблица 26. Кнопки компонента DBNavigator

Кнопка	Обозначение	Действие
К первой	nbFirst	Указатель текущей записи перемещается к первой записи файла данных
К предыдущей записи файла данных	nbPrior	Указатель текущей записи перемещается к предыдущей
К следующей записи файла данных	nbNext	Указатель текущей записи перемещается к следующей
К последней записи файла данных	nbLast	Указатель текущей записи перемещается к последней
Добавить	nblnsert	В файл данных добавляется новая запись
Удалить	nbDelete	Удаляется текущая запись файла данных
Редактирование	nbEdit	Устанавливает режим редактирования текущей записи
Сохранить	nbPost	Изменения, внесенные в текущую запись, записываются в файл данных
Отменить	Cancel	Отменяет внесенные в текущую запись изменения
Обновить	nbRefresh	Обновить

Таблица27. Свойства компонента DBNavigator

Свойство	Определяет
DataSource	Имя компонента, являющегося источником данных. В качестве источника данных может выступать база данных (компонент Database), таблица (компонент Table) или результат выполнения запроса (компонент Query)
VisibleButtons	Видимые командные кнопки