Другие управляющие элементы

1. Изображение

Изображение – элемент Image панели Additional – обеспечивает средства для рисования и вывода изображений.

Свойство	Описание
Canvas	Обеспечивает поверхность для рисования. Доступно во время работы приложения.
Transparent	Если свойство имеет значение true, фон изображения становится прозрачным.

1.1. Холст

Холст – свойство управляющего элемента изображение. Именно свойства и методы этого элемента позволяют рисовать изображения, состоящие из простых элементов – линий, прямоугольников, эллипсов и т.п.

Свойство	Описание
Font	Шрифт для вывода текста.
Pen	Карандаш. С помощью карандаша рисуются линии и границы фигур.
Brush	Кисть. С помощью кисти заполняются фигуры и фон.
PenPos	Позиция для рисования карандашом. Установка значения в это свойство эквивалентно вызову метод MoveTo.

Метод	Описание
Arc	Рисует дугу.
Ellipse	Рисует эллипс.
LineTo	Рисует линию от текущей позиции карандаша в заданную точку. Текущая позиция карандаша также перемещается в заданную точку.
MoveTo	Перемещает позицию карандаша в заданную точку без рисования.
Rectangle	Рисует прямоугольник.
RoundRect	Рисует прямоугольник со скруглёнными углами.
TextOut	Выводит строку.

1.1.1. Карандаш

Карандаш используется для рисования линий.

Свойство	Описание
Color	Цвет линии.
Style	Стиль линии. Может принимать одно из следующих значений: psSolid, psDash, psDot, psDashDot, psDashDotDot, psClear.
Width	Толщина линии.

1.1.2. Кисть

Кисть используется для заполнения фигур.

Свойство	Описание
Color	Цвет кисти.
Style	Стиль кисти. Может принимать одно из следующих значений: bsSolid, bsClear, bsHorizontal, bsVertical, bsFDiagonal, bsBDiagonal, bsCross, bsDiagCross.

2. Главное меню

Главное меню – элемент TMainMenu панели Standard – обеспечивает средства для создания главного меню формы. Элемент TMainMenu можно располагать в любом месте формы – главное меню в любом случае выводится под заголовком формы. Двойной щелчок мыши по элементу TMainMenu открывает окно редактирования меню. Каждый пункт меню может иметь подменю, которое будет открывать при щелчке мышью по родительскому пункту меню.

2.1. Свойства и события пункта меню

Свойство	Описание
Break	Определяет, что данный пункт меню начинает новую колонку меню – таким способом длинные меню можно разбить на несколько колонок.
Caption	Текст пункта меню. Символ &, поставленной перед какой-либо буквой текста, определяет клавишу, с помощью которой можно выбрать данный пункт меню.
Checked	Если свойство имеет значение true, пункт меню помечается галочкой.
Default	Определяет, что данный пункт меню выбирается при двойном щелчке мышью по родительскому пункту меню.
ShortCut	Задаёт сочетание клавиш для выбора пункта меню.

Событие	Описание
OnClick	Нажатие мышью на пункт меню.

3. Диалоги открытия и сохранения

Диалоги открытия и сохранения – элементы TOpenDialog и TSaveDialog панели Dialogs – обеспечивают работу с диалогами открытия и сохранения, которые позволяют выбрать файл для чтения или записи данных. Элемент диалог может быть расположен в любом месте формы – значок элемента не отображается на форме, а сам диалог открывается только при выполнении метода Execute. Этот метод открывает диалог и возвращает значение true, если пользователь выбирает файл и нажимает кнопку «Открыть» или «Сохранить». В противном случае метод возвращает значение false.

Свойство	Описание
DefaultExt	Задаёт расширение файла по умолчанию. Это расширение будет автоматически добавлено к имени файла, если оно не содержит расширения или содержит незарегистрированное расширение.
FileName	Полный путь к последнему выбранному файлу.
Filter	Задаёт маски файлов, доступные в диалоге.
FilterIndex	Индекс маски файлов, которая применяется по умолчанию.
InitialDir	Директория, которая показывается при открытии диалога. Обычно удобно, чтобы это была та директория, из которой запущена программа. Устанавливать это значение при разработке нецелесообразно – файл программы может быть перенесён, и тогда будет открываться неправильная директория. С другой стороны, если это свойство не задано, открывается последняя выбранная директория. Программно в это свойство можно установить имя директории, из которой запущено приложение.
Title	Заголовок окна диалога.
Options	Опции, определяющие поведение диалога. Описание см. ниже.
Options.ofReadOnly	По умолчанию устанавливает свойство файла «Только чтение».
Options.ofOverwritePrompt	Диалог выдаёт предупреждение, если выбран уже существующий файл.
Options.ofHideReadOnly	Скрывает кнопку-флажок «Только чтение».
Options.ofNoChangeDir	После закрытия диалога текущей становится директория, которая была текущей до открытия диалога.
Options.ofHowHelp	Добавляет на диалог кнопку «Справка».
Options.ofNoValidate	Позволяет выбрать имя файла с некорректными символами.
Options.ofAllowMultiSelect	Позволяет выбрать несколько файлов.
Options.ofPathMustExist	Генерирует сообщение, если пользователь пытается выбрать файл с несуществующей директорией в имени.
Options.ofFileMustExist	Генерирует сообщение, если пользователь пытается выбрать несуществующий файл (эта опция применима только к диалогу открытия).
Options.ofCreatePrompt	Выдаёт предупреждение, если пользователь пытается выбрать несуществующий файл, предлагая создать файл с таким именем (эта опция применима только к диалогу открытия).
Options.ofNoReadOnlyReturn	Выдаёт сообщение об ошибке, если пользователь пытается выбрать файл, предназначенный только для чтения.
Options.ofForceShowHidden	Показывает скрытые файлы.

Для диалога открытия имеет смысл установить значение true в свойстве ofFileMustExists, для диалога сохранения – в свойстве ofOverwritePrompt. Остальные опции можно оставить без изменения.

Двойной щелчок по значению свойства Filter открывает окно редактирования фильтров:

4. Список

Список – элемент TListBox панели Standard позволяет хранить список элементов, выделять их, добавлять и удалять.

Свойство	Описание
Columns	Количество видимых столбцов.
Count	Количество элементов списка.
ExtendedSelect	Позволяет выделять несколько подряд идущих элементов. Если это свойство имеет значение true, выделение осуществляется щелчком мыши при нажатых клавишах Ctrl и Shift. В противном случае, выделение и снятие выделения осуществляется щелчком мыши. Изменение этого свойства оказывает влияние на управляющий элемент, только если значение свойства MultiSelect равно true.
ItemIndex	Возвращает номер выделенного элемента списка. Номера начинаются с 0. Если нет выделенных элементов, значение свойства равно -1.
Items	Элементы списка.
MultiSelect	Определяет, что пользователь может выделить несколько элементов списка.
Selected[i]	Проверяет, что i-ый элемент списка выбран.
Sorted	Определяет, что элементы списка сортируются в алфавитном порядке.

Метод	Описание
Clear	Удаление всех элементов списка.
DeleteSelected	Удаление выделенного элемента списка.

Свойство Items элемента TListBox представляет собой объект класса TStrings, который содержит элементы списка. К этому объекту применимы следующие методы.

Метод	Описание
Add	Добавление элемента в конец списка.
Clear	Удаление всех элементов списка.
Delete	Удаление из списка элемента с заданным номером.
IndexOf	Номер первого вхождения в список заданной строки.
Insert	Вставка элемента в указанную позицию.
LoadFromFile	Заполнение списка строками, содержащимися в указанном файле. Предварительно список очищается.
SaveToFile	Сохранение элементов списка в указанный файл.

5. Выпадающее меню

Выпадающее меню – элемент TPopupMenu панели Standard – обеспечивает средства для создания контекстного меню, вызываемого обычно правой кнопкой мыши. Элемент TPopupMenu можно располагать в любом месте формы – выпадающее меню появляется при щелчке правой кнопкой мыши по элементу, с которым связано выпадающее меню. Двойной щелчок мыши по элементу TPopupMenu открывает окно редактирования меню.

Свойство	Описание
AutoPopup	Определяет, что меню автоматически отображается при нажатии правой кнопкой мыши по элементу, с которым связано меню. В противном случае необходимо отображать меню с помощью метода Popup.
MenuAnimation	Определяет способ прорисовки меню.

Событие	Описание
OnPopup	Событие OnPopup наступает непосредственно перед появлением выпадающего меню.

Пункты выпадающего меню имеют те же свойства и события, что и пункты главного меню.

6. Дерево

Дерево – элемент TTreeView панели Win32 – позволяет хранить набор элементов, организованных в виде дерева, добавлять и удалять элементы, сворачивать и разворачивать ветви дерева.

Свойство	Описание
AutoExpand	Если это свойство имеет значение true, то ветви дерева, идущие от выделенной вершины, автоматически разворачиваются, а остальные – сворачиваются.
HotTrack	Если это свойство имеет значение true, вершины дерева выделяются, когда на них наводится курсор мыши.
Images	Позволяет задавать список изображений, которые будут соответствовать вершинам дерева.
Items	Вершины дерева.
MultiSelect	Определяет, что пользователь может выделить несколько вершин дерева.
MultiSelectStyle	Определяет способ выделения нескольких вершин дерева.
RightClickSelect	Если это свойство имеет значение true, то пользователь может выделять вершины дерева как левой, так и правой кнопкой мыши.
Selected	Возвращает выделенную вершину дерева.
SelectionCount	Возвращает число выделенных вершин дерева.
Selections[i]	Возвращает i-ую выделенную вершину.
ShowButton	Определяет, будут ли вершины дерева иметь кнопки со знаком + или –, с помощью которых можно сворачивать и разворачивать ветви дерева.
ShowLines	Определяет, будет ли дерево иметь линии, соединяющие родительские и подчинённые вершины дерева.
ShowRoot	Определяет, будет ли дерево иметь единственную корневую вершину.
SortType	Определяет способ сортировки вершин дерева.

Событие	Описание
OnAddition	Добавление вершины дерева.
OnCollapsed	Событие OnCollapsed происходит сразу после сворачивания ветви дерева.
OnCollapsing	Событие OnCollapsing происходит непосредственно перед сворачиванием ветви дерева.
OnDeletion	Удаление вершины дерева.
OnEdited	Событие OnEdited происходит после редактирования пользователем текста вершины дерева.
OnEditing	Событие OnEditing происходит, когда пользователь начинает редактировать текст вершины дерева.
OnExpanded	Событие OnExpended происходит сразу после разворачивания ветви дерева.
OnExpanding	Событие OnExpending происходит непосредственно перед разворачиванием ветви дерева.

Метод	Описание
AlphaSort	Сортировка вершин дерева.
ClearSelection	Снятие выделения с вершин дерева.
FindNextToSelect	Находит следующую выделенную вершину.
FullCollapse	Сворачивание дерева.
FullExpand	Разворачивание дерева.
LoadFromFile	Загружает дерево из файла.
SaveToFile	Сохраняет дерево в файл.
Select	Выделяет одну или несколько вершин дерева.

Свойство Items элемента TTreeView представляет собой объект класса TTreeNodes, который содержит вершины дерева. Этот объект имеет следующие свойства и методы.

Свойство	Описание
Count	Количество вершин дерева.
Item[i]	Возвращает i-ую вершину дерева.

Метод	Описание
Add	Добавление вершины, родственной заданной.
AddChild	Добавление подвершины к указанной вершине.
AddChildFirst	Добавление подвершины к указанной вершине. Новая вершина становится первой.
AddFirst	Добавление вершины, родственной заданной. Новая вершина становится первой.
Clear	Удаление всех вершин дерева.
Delete	Удаление указанной вершины.
GetFirstNode	Первая вершина дерева.
Insert	Добавление вершины, родственной заданной, перед заданной вершиной.

Ряд методов, например, Selected или GetFirstNode, возвращает объект класса TTreeNode, который содержит информацию об одной вершине дерева. Этот объект имеет следующие свойства и методы.

Свойство	Описание
AbsoluteIndex	Индекс вершины в дереве.
Count	Количество подвершин некоторой вершины.
Expanded	Определяет, что поддерево вершины развёрнуто.
HasChildren	Определяет, что вершина имеет подвершины.
Index	Индекс вершины в списке подвершин родительской вершины.
Level	Уровень, на котором находится вершина. Корневая вершина дерева имеет уровень 0.
Parent	Родительская вершина.
Selected	Определяет, выделена ли вершина.
Text	Метка вершины.

Метод	Описание
Collapse	Сворачивание поддерева, связанного с заданной вершиной.
Delete	Удаление вершины и её подвершин.
DeleteChildren	Удаление подвершин некоторой вершины.
Expand	Разворачивание поддерева, связанного с заданной вершиной.
getFirstChild	Первая подвершина заданной вершины.
GetLastChild	Последняя подвершина заданной вершины.
GetNext	Следующая вершина дерева.
GetNextChild	Следующая подвершина.
getNextSibling	Следующая родственная вершина.
GetPrev	Предыдущая вершина дерева.
GetPrevChild	Предыдущая подвершина.
getPrevSibling	Предыдущая родственная вершина.
IsFirstNode	Проверка того, что вершина является первой вершиной дерева.

7. Панель инструментов

Панель инструментов – элемент TToolBar панели Win32 – является контейнером для кнопок, позволяющих получить быстрый доступ к командам меню и другим действиям. Все кнопки панели инструментов имеют одинаковую высоту и ширину. На панель инструментов, кроме кнопок, можно поместить и другие управляющие элементы, которые будут иметь одинаковую высоту. Если ширины окна недостаточно для размещения всех элементов панели инструментов, кнопки и управляющие элементы переносятся на новую строку панели инструментов. Разделители, которые, по сути, являются специально сконфигурированными кнопками, могут группировать элементы панели инструментов как визуально, так и функционально.

Свойство	Описание
AllowTextButtons	Определяет, что панель инструментов может содержать кнопки, содержащие только текст.
AutoSize	Определяет, что высота панели инструментов меняется автоматически при переносе элементов на новую строку.
BorderWidth	Задаёт ширину границы панели инструментов.
ButtonCount	Количество кнопок панели инструментов.
ButtonHeight	Задаёт высоту кнопок панели инструментов.
Buttons	Список кнопок (элементов TToolButton), содержащихся в панели инструментов.
ButtonWidth	Задаёт ширину кнопок панели инструментов.
Customizable	Определят, может ли пользователь менять вид панели инструментов. Если это свойство имеет значение true, пользователь может перемещать кнопки панели инструментов с помощью мыши, удерживая клавишу Shift, а также использовать двойной щелчок мышью по панели инструментов для открытия диалога настройки панели инструментов.
DisabledImaged	Задаёт список изображений для кнопок панели инструментов. Изображения этого списка отображаются на кнопках, когда те находятся в деактивированном состоянии.
DrawingStyle	Задаёт стиль панели инструментов – обычный или градиентный.
GradientDirection	Задаёт направление заливки панели инструментов. Это свойство имеет силу, только если стиль панели инструментов установлен как градиентный.
GradientEndColor GradientStartColor	Задают начальный и конечный цвета для заливки.
HotImages	Задаёт список изображений для кнопок панели инструментов. Изображения этого списка отображаются на кнопках, когда курсор мыши наведён на кнопку.
HotTrackColor	Задаёт цвет фона кнопки, используемый при наведении курсора на кнопку, если панель инструментов имеет градиентный стиль.
Images	Задаёт список изображений для кнопок панели инструментов.
Indent	Задаёт отступ первой кнопки от левого края панели инструментов.
List	Если значение этого свойства равно true, то надписи на кнопках отображаются справа от изображений. В противном случае надписи на кнопках отображаются под изображением. Свойство имеет силу, только если свойство ShowCaptions имеет значение true.
Menu	Определяет, что кнопки панели инструментов соответствуют пунктам указанного меню.
RowCount	Количество строк в панели инструментов.
ShowCaptions	Определяет, будут ли отображаться надписи на кнопках.
Wrapable	Определяет, будут ли кнопки панели инструментов автоматически переноситься на следующую строку.

8. Кнопка панели инструментов

Кнопка панели инструментов – элемент TToolButton – как и обычная кнопка, позволяет выполнять некоторые действия. Для добавления кнопки на панель инструментов необходимо щелкнуть по панели инструментов правой кнопкой мыши и из появившегося меню выбрать пункт New Button.

Свойство	Описание
AllowAllUp	Определяет, что все кнопки в группе кнопок могут быть отжаты.
AutoSize	Определяет, что размер кнопки автоматически изменяется так, чтобы вмещать изображение и надпись на кнопке.
Caption	Задаёт надпись на кнопке.
Down	Определяет, будет ли кнопка изначально нажата или отжата.
DropdownMenu	Задаёт выпадающее меню, связанное с кнопкой.
Grouped	Объединяет несколько соседних кнопок типа tbsCheck в группу.
ImageIndex	Задаёт номер изображения для кнопки. Изображения берутся из списков изображений, связанных с панелью инструментов, на которой находится кнопка.
Indeterminate	Определяет для кнопки третье состояние, когда кнопка не нажата и не отжата. Значение этого свойства обычно устанавливается в true в программе для того, чтобы показать, что кнопка не применима в каком-либо состоянии.
MenuItem	Задаёт пункт меню, с которым связана кнопка.
Style	Задаёт тип кнопки. Это свойство может принимать следующие значения: tbsButton – обычная кнопка; tbsCheck – кнопка-переключатель, которая может быть нажата или отжата; tbsDropDown – кнопка с выпадающим меню, справа от такой кнопки появляется стрелочка, этот тип кнопки удобно использовать, когда при нажатии на кнопку отображается выпадающее меню, которое может быть связано с кнопкой либо через родительский пункт меню, если кнопка соответствует некоторому пункту меню, либо через свойство кнопки DropdownMenu; tbsSeparator и tbsDivider – разделители; tbsTextButton – кнопка без изображения, имеющая только текст.
Wrap	Если это свойство имеет значение true, кнопка будет последней в строке. Однако это свойство действительно, только если свойство Wrapable панели инструментов имеет значение false.