| |
Приложение. C++ Builder — краткий справочник
Форма
Форма (объект тип TForm) является основой программы. Свойства формы (табл. П.1) определяют вид окна программы.
Таблица П.1. Свойства формы (объекта TForm)
Свойство |
Описание
|
Name
|
Имя формы. В программе имя формы используется для управления формой и доступа к компонентам формы
|
Caption
|
Текст заголовка
|
Top
|
Расстояние от верхней границы формы до верхней границы экрана
|
Left
|
Расстояние от левой границы формы до левой границы экрана
|
Width
|
Ширина формы
|
Height
|
Высота формы :
|
ClientWidth
|
Ширина рабочей (клиентской) области формы, т. е. без учета ширины левой и правой границ
|
ClientHeight
|
Высота рабочей (клиентской) области формы, т. е. без учета высоты заголовка и ширины нижней границы формы
|
BorderStyle
|
Вид границы. Граница может быть обычной (bsSizeable), тонкой (bsSingle) или отсутствовать (bsNone). Если у окна обычная граница, то во время работы программы пользователь может при помощи мыши изменить размер окна. Изменить размер окна с тонкой границей нельзя. Если граница отсутствует, то на экран во время работы программы будет выведено окно без заголовка. Положение и размер такого окна во время работы программы изменить нельзя
|
Borderlcons
|
Кнопки управления окном. Значение свойства определяет, какие кнопки управления окном будут доступны пользователю во время работы программы. Значение свойства задается путем присвоения значений уточняющим свойствам biSystemMenu, biMinimize, biMaximize и biHelp. Свойство biSystemMenu определяет доступность кнопки Свернуть и кнопки системного меню, biMinimize— кнопки Свернуть, biMaximize— кнопки Развернуть, biHelp — кнопки вывода справочной информации
|
Icon
|
Значок в заголовке диалогового окна, обозначающий кнопку вывода системного меню
|
Color
|
Цвет фона. Цвет можно задать, указав название цвета или элемент цветовой схемы операционной системы. Во втором случае цвет компонента "привязан" к цветовой схеме операционной системы и будет изменяться при каждой смене цветовой схемы
|
Font
|
Шрифт. Шрифт, используемый "по умолчанию" компонентами, находящимися на поверхности формы. Изменение свойства Font формы приводит к автоматическому изменению свойства Font компонента, располагающегося на поверхности формы. То есть компоненты наследуют свойство Font от формы (имеется возможность запретить наследование)
|
Canvas
|
Поверхность, на которую можно вывести графику
|
Label
Компонент Label ( 1) предназначен для вывода текста на поверхность формы. Свойства компонента (табл. П.2) определяют вид и расположение текста.
Таблица П.2. Свойства компонента Label (поле вывода текста)
|
Edit
Компонент Edit ( 2) представляет собой поле ввода-редактирования строки символов. Свойства компонента приведены в табл. П.3.
Таблица П.3. Свойства компонента Edit (поле редактирования)
Свойство |
Описание
|
Name
|
Имя компонента. Используется в программе для доступа к компоненту и его свойствам, в частности для доступа к тексту, введенному в поле редактирования
|
Text
|
Текст, находящийся в поле ввода и редактирования
|
Left
|
Расстояние от левой границы компонента до левой границы формы
|
Top
|
Расстояние от верхней границы компонента до верхней границы формы
|
Height
|
Высота поля
|
Width
|
Ширина поля
|
Font
|
Шрифт, используемый для отображения вводимого текста
|
ParentFont
|
Признак наследования компонентом характеристик шрифта формы, на которой находится компонент. Если значение свойства равно true, то при изменении свойства Font формы автоматически меняется значение свойства Font компонента
|
Enabled
|
Используется для ограничения возможности изменить текст в поле редактирования. Если значение свойства равно false, то текст в поле редактирования изменить нельзя
|
Visible
|
Позволяет скрыть компонент (false) или сделать его видимым (true)
|
|
Button
Компонент Button ( 3) представляет собой командную кнопку. Свойства компонента приведены в табл. П.4.
Таблица П.4. Свойства компонента Button (командная кнопка)
Свойство |
Описание
|
Name
|
Имя компонента. Используется в программе для доступа к компоненту и его свойствам
|
Caption
|
Текст на кнопке
|
Left
|
Расстояние от левой границы кнопки до левой границы формы
|
Top
|
Расстояние от верхней границы кнопки до верхней границы формы
|
Height
|
Высота кнопки
|
Width
|
Ширина кнопки
|
Enabled
|
Признак доступности кнопки. Если значение свойства равно true, то кнопка доступна. Если значение свойства равно false, то кнопка недоступна— например, в результате щелчка на кнопке, событие Click не возникает
|
Visible
|
Позволяет скрыть кнопку (false) или сделать ее видимой (true)
|
Hint
|
Подсказка— текст, который появляется рядом с указателем мыши при позиционировании указателя на командной кнопке (для того чтобы текст появился, надо, чтобы значение свойства ShowHint было true)
|
ShowHint
|
Разрешает (true) или запрещает (false) отображение подсказки при позиционировании указателя на кнопке
|
|
Memo
Компонент Memo ( 4) представляет собой элемент редактирования текста, который может состоять из нескольких строк. Свойства компонента приведены в табл. П.5.
Таблица П.5. Свойства компонента Memo
Свойство |
Описание
|
Name
|
Имя компонента. Используется для доступа к свойствам компонента
|
Text
|
Текст, находящийся в поле Memo. Рассматривается как единое целое
|
Lines
|
Массив строк, соответствующий содержимому поля. Доступ к строке осуществляется по номеру. Строки нумеруются с нуля
|
Left
|
Расстояние от левой границы поля до левой границы формы
|
Top
|
Расстояние от верхней границы поля до верхней границы формы
|
Height
|
Высота поля
|
Width
|
Ширина поля
|
Font
|
Шрифт, используемый для отображения вводимого текста
|
Parent Font
|
Признак наследования свойств шрифта родительской формы
|
|
RadioButton
Компонент RadioButton ( 5) представляет зависимую кнопку, состояние которой определяется состоянием других кнопок группы. Свойства компонента приведены в табл. П.6.
Если в диалоговом окне надо организовать несколько групп радиокнопок, то каждую группу следует представить компонентом RadioGroup.
Рис. П.5. Компонент RadioButton
Таблица П.6. Свойства компонента RadioButton
Свойство |
Описание
|
Name
|
Имя компонента. Используется для доступа к свойствам компонента
|
Caption
|
Текст, который находится справа от кнопки
|
Checked
|
Состояние, внешний вид кнопки. Если кнопка выбрана, то значение свойства checked равно true, если кнопка не выбрана, то false
|
Left
|
Расстояние от левой границы флажка до левой границы формы
|
Top
|
Расстояние от верхней границы флажка до верхней границы формы
|
Height
|
Высота поля вывода поясняющего текста
|
Width
|
Ширина поля вывода поясняющего текста
|
Font
|
Шрифт, используемый для отображения поясняющего текста
|
Pa rent Font
|
Признак наследования характеристик шрифта родительской формы
|
CheckBox
Компонент CheckBox ( 6) представляет собой независимую кнопку (переключатель). Свойства компонента приведены в табл. П.7.
Таблица П.7. Свойства компонента CheckBox
Свойство |
Описание
|
Name
|
Имя компонента. Используется для доступа к свойствам компонента
|
Caption
|
Текст, который находится справа от флажка
|
Checked
|
Состояние, внешний вид флажка. Если флажок установлен (в квадратике есть "галочка"), то значение свойства checked равно true; если флажок сброшен (нет "галочки"), то значение Checked равно false
|
State
|
Состояние флажка. В отличие от свойства Checked, позволяет различать установленное, сброшенное и промежуточное состояния. Состояние флажка определяет одна из констант: cbchecked (установлен); cbGrayed (серый, неопределенное состояние); cbUnChecked (сброшен)
|
AllowGrayed
|
Свойство определяет, может ли флажок быть в промежуточном состоянии: если значение AllowGrayed равно false, то флажок может быть только установленным или сброшенным; если значение AllowGrayed равно true, то допустимо промежуточное состояние
|
Left
|
Расстояние от левой границы флажка до левой границы формы
|
Top
|
Расстояние от верхней границы флажка до верхней границы формы
|
Height
|
Высота поля вывода поясняющего текста
|
Width
|
Ширина поля вывода поясняющего текста
|
Font
|
Шрифт, используемый для отображения поясняющего текста
|
Parent Font
|
Признак наследования характеристик шрифта родительской формы
|
|
ListBox
Компонент ListBox ( 7) представляет собой список, в котором можно выбрать нужный элемент. Свойства компонента приведены в табл. П.8.
Таблица П.8. Свойства компонента ListBox
Свойство |
Описание
|
Name
|
Имя компонента. В программе используется для доступа к компоненту и его свойствам
|
Items
|
Элементы списка — массив строк
|
Count
|
Количество элементов списка
|
Sorted
|
Признак необходимости автоматической сортировки (true) списка после добавления очередного элемента
|
Itemlndex
|
Номер выбранного элемента (элементы списка нумеруются с нуля). Если в списке ни один из элементов не выбран, то значение свойства равно -1 (минус один)
|
Left
|
Расстояние от левой границы списка до левой границы формы
|
Top
|
Расстояние от верхней границы списка до верхней границы формы
|
Height
|
Высота поля списка
|
Width
|
Ширина поля списка
|
Font
|
Шрифт, используемый для отображения элементов списка
|
ParentFont
|
Признак наследования свойств шрифта родительской формы
|
|
ComboBox
Компонент ComboBox ( 8) дает возможность ввести данные в поле редактирования путем набора на клавиатуре или выбором из списка. Свойства компонента приведены в табл. П.9.
Таблица П.9. Свойства компонента ComboBox
Свойство |
Описание
|
Name
|
Имя компонента. Используется для доступа к свойствам компонента
|
Text
|
Текст, находящийся в поле ввода/редактирования
|
Items
|
Элементы списка — массив строк
|
Count
|
Количество элементов списка
|
Itemlndex
|
Номер элемента, выбранного в списке. Если ни один из элементов списка не был выбран, то значение свойства равно -1 (минус один)
|
Sorted
|
Признак необходимости автоматической сортировки (true) списка после добавления очередного элемента
|
DropDownCount
|
Количество отображаемых элементов в раскрытом списке. Если количество элементов списка больше, чем DropDownCount, то появляется вертикальная полоса прокрутки
|
Left
|
Расстояние от левой границы компонента до левой границы формы
|
Top
|
Расстояние от верхней границы компонента до верхней границы формы
|
Height
|
Высота компонента (поля ввода/редактирования)
|
Width
|
Ширина компонента
|
Font
|
Шрифт, используемый для отображения элементов списка
|
ParentFont
|
Признак наследования свойств шрифта родительской формы
|
|
StringGrid
Компонент StringGrid ( 9) представляет собой таблицу, ячейки которой содержат строки символов. Свойства компонента StringGrid приведены в табл. П.10.
Таблица П.10. Свойства компонента StringGrid
|
Image
Компонент image ( 10) обеспечивает вывод на поверхность формы иллюстраций, представленных в формате BMP (чтобы компонент можно было использовать для отображения иллюстраций в формате JPG, надо подключить модуль JPEG — включить в текст программы директиву #inciude <jpeg.hpp>). Свойства компонента image приведены в табл. П.11.
Таблица П.11. Свойства компонента image
|
Timer
Компонент Timer ( 11) обеспечивает генерацию последовательности событий onTimer. Свойства компонента приведены в табл. П.12.
Таблица П.12. Свойства компонента Timer
Свойство |
Описание
|
Name
|
Имя компонента. Используется для доступа к компоненту
|
Interval
|
Период генерации события OnTimer. Задается в миллисекундах
|
Enabled
|
Разрешение работы. Разрешает (значение true) или запрещает (значение false) генерацию события OnTimer
|
|
Animate
Компонент Animate ( 12) позволяет воспроизводить простую, не сопровождаемую звуком анимацию, кадры которой находятся в AVI-файле. Свойства компонента приведены в табл. П.13.
Таблица П.13. Свойства компонента Animate
Свойство |
Описание
|
Name
|
Имя компонента. Используется для доступа к свойствам компонента и управления его поведением
|
FileName
|
Имя AVI-файла, в котором находится анимация, отображаемая при помощи компонента
|
StartFrame
|
Номер кадра, с которого начинается отображение анимации
|
StopFrame
|
Номер кадра, на котором заканчивается отображение анимации
|
Activate
|
Признак активизации процесса отображения кадров анимации
|
Color
|
Цвет фона компонента (цвет "экрана"), на котором воспроизводится анимация
|
Transparent
|
Режим использования "прозрачного" цвета при отображении анимации
|
Repetitions
|
Количество повторов отображения анимации
|
|
MediaPlayer
Компонент MediaPlayer ( 13) позволяет воспроизвести видеоролик, звук и сопровождаемую звуком анимацию. Свойства компонента приведены в табл. П.14.
Таблица П.14. Свойства компонента MediaPlayer
Свойство |
Описание
|
Name
|
Имя компонента. Используется для доступа к свойствам компонента и управления работой плеера
|
DeviceType
|
Тип устройства. Определяет конкретное устройство, которое представляет собой компонент MediaPlayer. Тип устройства задается именованной константой: dtAutoSelect — тип устройства определяется автоматически; dtVaweAudio— проигрыватель звука; dtAViVideo— видеопроигрыватель; dtCDAudio — CD-проигрыватель
|
FileName
|
Имя файла, в котором находится воспроизводимый звуковой фрагмент или видеоролик
|
AutoOpen
|
Признак автоматического открытия сразу после запуска программы файла видеоролика или звукового фрагмента
|
Display
|
Определяет компонент, на поверхности которого воспроизводится видеоролик (обычно в качестве экрана для отображения видео используют компонент Panel)
|
VisibleButtons
|
Составное свойство. Определяет видимые кнопки компонента. Позволяет сделать невидимыми некоторые кнопки
|
|
SpeedButton
Компонент SpeedButton ( 14) представляет собой кнопку, на поверхности которой находится картинка. Свойства компонента приведены в табл. П.15.
Таблица П.15. Свойства компонента SpeedButton
|
UpDown
Компонент UpDown ( 16) представляет собой две кнопки, используя которые можно изменить значение внутренней переменной-счетчика на определенную величину. Увеличение или уменьшение значения происходит при каждом щелчке на одной из кнопок. Свойства компонента приведены в табл. П.16.
Таблица П.16. Свойства компонента UpDown
Свойство |
Описание
|
Name
|
Имя компонента. Используется для доступа к компоненту и его свойствам
|
Position
|
Счетчик. Значение свойства изменяется в результате щелчка на кнопке Up (увеличивается) или Down (уменьшается). Диапазон изменения определяют свойства Min и Мах, величину изменения — свойство Increment
|
Min
|
Нижняя граница диапазона изменения свойства Position
|
Max
|
Верхняя граница диапазона изменения свойства Position
|
Increment
|
Величина, на которую изменяется значение свойства Position в результате щелчка на одной из кнопок компонента
|
Associate
|
Определяет компонент (Edit— поле ввода/редактирования), используемый в качестве индикатора значения свойства Position. Если значение свойства задано, то при изменении содержимого поля редактирования автоматически меняется значение свойства Position
|
Orientation
|
Задает ориентацию кнопок компонента. Кнопки могут быть ориентированы вертикально (udVertical) или горизонтально (udHorizontal)
|
|
Table
Компонент Table ( 17) представляет всю таблицу базы данных. Свойства компонента приведены в табл. П1.17.
Таблица П.17. Свойства компонента Table
Свойство |
Определяет
|
Name
|
Имя компонента. Используется для доступа к свойствам компонента
|
DatabaseName
|
Имя базы данных, частью которой является таблица (файл данных), для доступа к которой применяется компонент. В качестве значения свойства следует использовать псевдоним базы данных
|
TableName
|
Имя файла данных (таблицы данных), для доступа к которому используется компонент
|
TableType
|
Тип таблицы. Таблица может быть набором данных в формате Paradox (ttParadox), dBase (ttDBase), FoxPro (ttFoxPro) или представлять собой форматированный текстовый файл(ttASCIl)
|
Active
|
Признак того, что таблица активна (файл данных открыт). В результате присваивания свойству значения true происходит открытие файла таблицы
|
|
Query
Компонент Query ( 18) представляет часть базы данных— записи, содержимое которых удовлетворяет критерию SQL-запроса к таблице. Свойства компонента приведены в табл. П.18.
Таблица П.18. Свойства компонента Query
Свойство |
Определяет
|
Name
|
Имя компонента. Используется компонентом Datasource для связи результата выполнения запроса (набора записей) с компонентом, обеспечивающим просмотр записей, например DBGrid
|
SQL
|
Записанный на языке SQL-запрос к базе данных (к таблице)
|
Active
|
При присвоении свойству значения true активизирует выполнение запроса
|
RecordCount
|
Количество записей в базе данных, удовлетворяющих критерию запроса
|
|
DataSource
Компонент DataSource ( 19) обеспечивает связь между данными, представленными компонентом Table или Query, и компонентами отображения данных (DBEdit, DBMemo, DBGrid). Свойства компонента приведены в табл. П.19.
Таблица П.19. Свойства компонента DataSource
Свойство |
Определяет
|
Name
|
Имя компонента. Используется компонентом отображения данных для доступа к компоненту и, следовательно, к данным, связь с которыми обеспечивает компонент
|
DataSet
|
Компонент, представляющий собой входные данные (Table или Query)
|
|
DBEdit, DBMemo, DBText
Компоненты DBEdit и DBMemo ( 20) обеспечивают просмотр и редактирование полей записи базы данных, компонент DBText — только просмотр. Свойства компонентов приведены в табл. П.20.
Таблица П.20. Свойства компонентов DBText, DBEdit и DBMemo
Свойство |
Определяет
|
Name
|
Имя компонента. Используется для доступа к свойствам компонента
|
DataSource
|
Компонент-источник данных
|
DataField
|
Поле базы данных, для отображения или редактирования которого используется компонент
|
|
DBNavigator
Компонент DBNavigator ( 22 и П.23) обеспечивает перемещение указателя текущей записи, активизацию режима редактирования, добавление и удаление записей. Компонент представляет собой совокупность командных кнопок (табл. П1.23). Свойства компонента приведены в табл. П.24.
Таблица П.23. Кнопки компонента DBNavigator
Таблица П.24. Свойства компонента DBNavigator
Свойство |
Определяет
|
Name
|
Имя компонента. Используется для доступа к свойствам компонента
|
DataSource
|
Имя компонента, являющегося источником данных. В качестве источника данных может выступать база данных (компонент Database), таблица (компонент Table) или результат выполнения запроса (компонент Query)
|
VisibleButtons
|
Видимые командные кнопки
|
|
Реn
Объект Реn является свойством объекта Canvas. Свойства объекта Реn (табл. П.27) определяют цвет, стиль и толщину линий, вычерчиваемых методами вывода графических примитивов.
Таблица П.27. Свойства объекта Реn
Свойство |
Описание
|
Color
|
Цвет линии (clBlack — черный; clMaroon — каштановый; clGreen — зеленый; clOlive— оливковый; clNavy— темно-синий; clPurple — розовый; clTeal — зелено-голубой; clGray— серый; clSilver— серебристый; clRed — красный; clLime — салатный; clBlue — синий; clFuchsia — ярко-розовый; clAqua — бирюзовый; clWhite — белый)
|
Style
|
Стиль (вид) линии. Линия может быть: psSolid— сплошная; psDash — пунктирная (длинные штрихи); psDot — пунктирная (короткие штрихи); psDashDot — пунктирная (чередование длинного и короткого штрихов); psDashDotDot — пунктирная (чередование одного длинного и двух коротких штрихов); psClear— не отображается (используется, если не надо изображать границу, например, прямоугольника)
|
Width
|
Толщина линии задается в пикселах. Толщина пунктирной линии не может быть больше 1
|
|
Brush
Объект Brush является свойством объекта Canvas. Свойства объекта Brush (табл. П.28) определяют цвет, стиль закраски внутренних областей контуров, вычерчиваемых методами вывода графических примитивов.
Таблица П.28. Свойства объекта Brush
Свойство |
Определяет
|
Color
|
Цвет закрашивания замкнутой области
|
Style
|
Стиль (тип) заполнения области (bsSolid— сплошная заливка; bsClear— область не закрашивается; bsHorizontal— горизонтальная штриховка; bsVertical— вертикальная штриховка; bsFDiagonal — диагональная штриховка с наклоном линий вперед; bsBDiagonal — диагональная штриховка с наклоном линий назад; bsCross — горизонтально-вертикальная штриховка, в клетку; bsDiagCross — диагональная штриховка, в клетку)
|
|
Функции
В этом разделе приведено краткое описание наиболее часто используемых функций. Подробное их описание можно найти в справочной системе. |
Функции ввода и вывода
Таблица П.29. Функции ввода и вывода
Функция |
Описание
|
InputBox (Заголовок, Подсказка, Значение)
|
В результате выполнения функции на экране появляется диалоговое окно, в поле которого пользователь может ввести строку символов. Значением функции является введенная строка. Параметр Значение задает значение функции "по умолчанию", т. е. строку, которая будет в поле редактирования в момент появления окна
|
ShowMessage (s)
|
Процедура ShowMessage выводит окно, в котором находится сообщение s и командная кнопка ОК
|
MessageDlg (s, t,b/h)
|
Выводит на экран диалоговое окно с сообщением s и возвращает код кнопки, щелчком на которой пользователь закрыл окно. Параметр t определяет тип окна: mtwarning — Внимание; mtError— ошибка; mtlnformation— информация; mtConfirmation— запрос; mtCustom— пользовательское (без значка).
|
Параметр b (множество — заключенный в квадратные скобки список констант) задает командные кнопки диалогового окна (mbYes, mbNo, mbOK, mbCancel, mbHelp, mbAbort, mbRetry, mblgnore И mbAll). Параметр h задает раздел справочной системы программы, который появится в результате нажатия кнопки Help или клавиши <F1>. Если справочная система не используется, значение параметра должно быть 0. Значение функции равно коду кнопки, которую нажал пользователь (mrAbort, mrYes, mrOk, mrRetry, mrNo, mrCancel, mrlgnore или mrAll)
|
|
Функции преобразования
Таблица П.31. Функции преобразования
Функция |
Значение функции
|
IntToStr(k)
|
Строка, являющаяся изображением целого k
|
FloatToStr (n)
|
Строка, являющаяся изображением вещественного n
|
FloatToStrF(n, f,k,m)
|
Строка, являющаяся изображением вещественного п. При вызове функции указывают: f — формат; k — точность; f— количество цифр после десятичной точки. Формат определяет способ изображения числа: ffGeneral — универсальный; ffExponent — научный; ffFixed — с фиксированной точкой; ffNumber — с разделителями групп разрядов; ffCurrency — финансовый. Точность — нужное общее количество цифр: 7 или меньше для значения типа Single, 15 или меньше для значения типа Double и 18 или меньше для значения типа Extended
|
StrToInt(s)
|
Целое число, изображением которого является строка s
|
StrToFloat(s)
|
Дробное число, изображением которого является строка S
|
|
|
|
|
