Download 1. Основные компоненты Lazarus

Основные компоненты
Lazarus
Обухов Сергей
TControl
Базовый класс для всех элементов управления
Свойство
Тип
Описание
Name
String
Имя (идентификатор) компонента. Используется программистами
в исходном коде, не допускаются русские символы
Caption
String
Заголовок. Текст, который отображается на экране, может
содержать любые символы (в том числе русские)
Top, Left
Integer
Позиция элемента управления на форме
Width, Height
Integer
Размер элемента управления
Visible
Boolean
Видимость элемента управления
Enabled
Boolean
Доступность элемента управления для взаимодействия с
пользователем. Enabled = false делает элемент управления
неактивным
TLabel (вкладка Standard)
Надпись
Свойство
Тип
Описание
Caption
String
Заголовок. Текст, который отображается на экране, его видит
пользователь
AutoSize
Boolean
Размер элемента задается автоматически в зависимости от
размера текста (true по умолчанию)
WordWrap
Boolean
Перенос длинного текста на другую строку по словам
(false по умолчанию)
Font
TFont
Шрифт текста (размер, гарнитура, начертание, цвет)
Color
TColor
Цвет заднего фона
Alignment
TAligment
Выравнивание текста. Перечисление: taLeftJustify(по левому краю),
taCenter (по центру), taRightJustify (по правому краю)
TEdit (вкладка Standard)
Поле ввода
Свойство
Тип
Описание
Text
String
Текст, который пользователь вводит с клавиатуры
ReadOnly
Boolean
Тест доступен только для чтения (выделения и копирования).
Пользователь не может его изменить
NumbersOnly
Boolean
Для ввода с клавиатуры доступны только цифры. Применяется для
ввода целых чисел (false по умолчанию)
MaxLength
Integer
Максимальная длинна введенного текста.
Значение по умолчанию 0 – нет ограничений
PasswordChar
Char
Символ-заместитель для ввода пароля.
Значение по умолчанию #0 – вводимые символы отображаются
Событие
Когда происходит
OnChange
Изменение свойства Text
TButton (вкладка Standard)
Кнопка
Свойство
Тип
Описание
Default
Boolean
Если Default = true, то кнопка активируется при нажатии на
клавишу Enter (false по умолчанию)
Cancel
Boolean
Если Cancel = true, то кнопка активируется при нажатии на клавишу
Escape (false по умолчанию)
Action
TAction
Связанное с нажатием на кнопку действие (см. компонент
TActionList)
ModalResult
Char
Применяется в модальных окнах. При ModalResult <> mrNone
нажатие на кнопку автоматически закрывает модальное окно, а
значение ModalResult возвращается при вызове метода
TForm.ShowModal
Событие
Когда происходит
OnClick
Нажатие на кнопку с помощью мыши или клавиатуры
TCheckBox (вкладка Standard)
Переключатель
Свойство
Тип
Описание
Checked
Boolean
Показывает, включен ли данный переключатель
AllowGrayed
Boolean
Разрешает промежуточное состояние переключателя
(false по умолчанию)
State
TCheckBoxState Состояние переключателя. Возможные значения: cbChecked
(включен), cbGrayed(промежуточное состояние), cbUnchecked
(выключен)
Событие
Когда происходит
OnChange
Изменение свойства State
TRadioButton (вкладка Standard)
Радио-кнопка. В пределах одного родительского элементаконтейнера может быть выбрана только одна радио-кнопка. Для
группировки нескольких радио-кнопок можно применять
контейнеры TGroupBox, TPanel, TRadioGroup и т.д.
Свойство
Тип
Описание
Checked
Boolean
Показывает, включен ли данный переключатель
Событие
Когда происходит
OnChange
Изменение свойства Checked
TGroupBox (вкладка Standard)
Элемент управления – контейнер. Контейнеры позволяют
объединять несколько дочерних элементов управления в одну
логически связанную группу компонентов.
Наряду с TGroupBox контейнерами являются:
• TForm – форма;
• TPanel – панель, похожа на TGroupBox, но без заголовка;
• TRadioGroup – объединяет несколько радио-кнопок;
• TCheckGroup – объединяет несколько переключателей.
TListBox (вкладка Standard)
Список
Свойство
Тип
Описание
Items
TStrings
Элементы списка (см. класс TStrings)
ItemIndex
Integer
Номер выбранного элемента списка. Значение по умолчанию
-1 – элемент списка не выбран
MultiSelect
Boolean
Разрешено выбирать несколько элементов из списка
Sorted
Boolean
Производить автоматическую сортировку элементов списка
Событие
Когда происходит
OnSelectionChange
Выбран другой элемент списка
Класс TStrings
Служит для хранения списка строк (ООП-аналог массива строк)
Метод
Описание
Count
Количество элементов в списке (свойство только для чтения)
[num]
Оператор индексирования. Аналогично массивам позволяет получить строку с
номером num. Индексация от 0
Add(str)
Добавляет строку str в конец списка
Insert(index, str)
Вставляет новую строку str в позицию index
Delete(index)
Удаляет строку из списка с заданным номером
Clear
Удаляет все строки из списка
LoadFromFile(filename) Загружает список строк из текстового файла filename
SaveToFile(filename)
Сохраняет список строк в текстовом файле filename
TComboBox (вкладка Standard)
Выпадающий список. Объединяет в себе TEdit и TListBox.
Свойство
Тип
Описание
Text
String
Введённый пользователем текст
Items
TStrings
Элементы выпадающего списка (см. класс TStrings)
ItemIndex
Integer
Номер выбранного элемента управления. Значение по умолчанию
-1 – элемент списка не выбран
Style
TComboBox
Style
Задает поведение выпадающего списка. Перечисление:
csDropDown (пользователю может редактировать или добавлять
новые строки в список); csDropDownList (пользователю разрешено
выбирать только существующие элементы)
Событие
Когда происходит
OnChange
Изменение свойства Text
OnSelect
Выбран элемент списка
TMemo (вкладка Standard)
Многострочный редактор текста
Свойство
Тип
Описание
Lines
TStrings
Введённый пользователем текст, разделенный на строки
Text
String
Весь текст одной строкой
ReadOnly
Boolean
Текст доступен только для чтение (false по умолчанию)
SelText
String
Выделенный текст
SetStart
Integer
Номер символа, с которого начинается выделение
SelLength
Integer
Длинна выделенного текста
CaretPos
TPoint
Позиция каретки ввода (номер текущей строки и столбца)
Событие
Когда происходит
OnChange
Изменение теста
TMemo (вкладка Standard)
Многострочный редактор текста
Метод
Описание
CopyToClipboard
Копировать выбранный текст в буфер обмена (Ctrl+C)
PasteFromClipboard Вставить текст из буфера обмена (Ctrl+V)
CutToClipboard
Вырезать выбранный текст в буфер обмена (Ctrl+X)
SelectAll
Выбрать весь текст (Ctrl+A)
Clear
Удалить весь текст
Undo
Отменить последнюю правку текста (Ctrl+Z)
TStringGrid (вкладка Additional)
Таблица
Свойство
Тип
Описание
RowCount,
ColCount
Integer
Общее количество строк и столбцов (размерность)
FixedCols,
FixedRows
Integer
Количество строк и столбцов, выделенных под заголовок
(заголовки не доступны для редактирования пользователем)
Cells[j, i]
String
Значение ячейки в i-той строке, j-том столбце. Индексация от нуля.
Сначала идут ячейки, содержащие заголовок (если такие есть).
Обратите внимание – сначала указываем номер столбца, а
потом номер строки! (не как матрицы в математике)
DefaultColWidth,
DefaultRowHeight
Integer
Ширина и высота ячейки в пикселах по умолчанию
GridLineWidth
Integer
Ширина линии, ограничивающая ячейки таблицы
TStringGrid (вкладка Additional)
Свойство Options - множество опций для тонкой настройки поведения таблицы. Если значения опции,
описанной ниже, равно True, то они присутствуют, если False — то нет
Опция
Описание
goEditing
Доступно редактирование значений в ячейках. False по умолчанию
goAlwaysShowEditor
если True содержимое выбранной ячейки сразу будет доступно для
редактирования, а при False — сначала нужно щёлкнуть по ячейке мышкой
или нажать F2
goRowSizing, goColSizing
Возможность изменять высоту строки или ширину столбца с пом. мышки
goRowMoving, goColMoving Возможность менять местами строки/столбцы с помощью мышки
goRangeSelect
Возможность выделить диапазон ячеек таблицы
goRowSelect
При выборе конкретной ячейки выделяется вся строка
goHorzLine, goVertLine
Горизонтальные/вертикальные линии между основными ячейками
goFixedHorzLine,
goFixedVertLine
Горизонтальные/вертикальные линии между ячейками заголовка
TImageList (владка Common Controls)
Хранит в себе список изображений (иконок). Не визуальный
компонент (не отражается на форме во время выполнения
программы, в редакторе форм имеет вид небольшой иконки).
Для отображения иконок в элементах управления TMainMenu,
TPopupMenu, TToolBar, TActionList, TBitBtn необходимо:
1. Создать список изображений ImageList1.
2. Связать TMainMenu/TActionList со списком изображений с
помощью свойства Images.
3. Конкретные пункты меню или команды имеют свойство
ItemIndex (Integer) – индекс изображения из списка.
Список изображений обеспечивает централизованное хранение
графики. При изменении иконки в списке изображений эта
иконка автоматически обновится во всех элементах
управления, которые ссылаются на эту иконку через свойство
Images и ImageIndex.
TActionList (вкладка Standard)
Приложение может содержать список команд (не визуальный
компонент TActionList). Каждая команда (action) может быть вызвана
(execute) пользователем различными способами – нажатием кнопки,
пункта основного или контекстного меню, сочетанием “горячих” клавиш
(ShortCut). Вне зависимости от способа вызова команды, она
обрабатывается единообразно, через вызов обработчика события
OnExecute компонента TAction.
Для связывания пункта меню или кнопки с командой, используйте
свойство Action соответствующего элемента управления.
Список команд обеспечивает централизованное хранение информации
о команде. При изменении свойства команды (например, заголовок),
автоматически обновляются все элементы управления (пункты меню,
кнопки и так далее), которые ссылаются на эту команду.
Общий обработчик команды TAction.OnExecute позволяет избежать
дублирования кода.
TAction (редактор Action List)
Хранит информацию о команде
Свойство
Тип
Описание
Caption
String
Заголовок (кнопки, пункта меню и так далее)
Enabled
Boolean
Позволяет сделать активной/не активной определенную команду.
Неактивную команду нельзя вызвать. Связанные пункты меню
становятся неактивными
Checked
Boolean
Пункты меню могут содержать переключатель (аналог TCheckBox),
который может быть выбран либо не выбран
ImageIndex
Integer
Привязать иконку к команде. Если в выпадающем списке не
отображаются иконки, то проверьте, что свойство
TActionList.Images задано корректно
ShortCut
TShortCut
“Горячие” клавиши для быстрого вызова команды
Событие
Когда происходит
OnExecute
Происходит при вызове команды
TMainMenu (вкладка Standard)
Главное меню приложения. Не визуальный компонент.
Отдельные пункты меню добавляются через редактор меню.
Каждый элемент меню (TMenuItem) имеет свойства Caption,
ImageIndex, Enabled, Checked и так далее, событие OnClick. Но
лучше вместо этого использовать только свойство Action для
централизованного управления командами.
Для создания разделителя достаточно создать пункт меню со
свойством Caption = '-' (знак минус).
Для меню, которое вызывает подменю более низкого уровня,
достаточно задать свойство Caption (без связки с Action или
обработки события OnClick).
TPopupMenu (вкладка Standard)
Контекстное меню элемента управления. Не визуальный
компонент.
В отличие от главного меню, контекстное меню может быть разным
для каждого элемента управления. Вызывается нажатием правой
кнопки мыши по элементу управления.
Для связи контекстного меню с элементом управления необходимо
задать свойство PopupMenu выбранного компонента.
TToolBar (вкладка Common Controls)
Панель инструментов. Как правило, отображается сверху под
главным меню.
Состоит из разделителей и кнопок TToolButton. К каждой кнопке
можно привязать команду с помощью свойства Action.
Для корректного отображения иконок проверьте свойство Images
компонента TToolBar.
TStatusBar (вкладка Common Controls)
Строка состояния. Отображается внизу главного окна.
Состоит из панелей (TStatusPanel). Панели добавляются с помощью свойства Panels или через редактор
панелей. В исходном коде, Panels[i] позволяет обращаться к нужной панели по индексу i.
TStatusPanel (редактор панелей)
Свойство
Тип
Описание
Text
String
Отображаемый текст
Width
Integer
Ширина панели в пикселах
Пример изменения текста из исходного кода
(необходимо предварительно создать хотя-бы одну панель):
StatusBar1.Panels[0].Text = 'New Text';
TOpenDialog (вкладка Dialogs)
Стандартный диалог открытия файла
Свойство
Тип
Описание
FileName
String
Пильное имя файла (включая путь)
Filter
String
Фильтр задает типы файлов, которые доступны для открытия.
Например 'Images|*.jpg, *.png' - указано название
фильтра (Images) и расширения файлов для данного фильтра (jpg и
png)
Title
String
Название диалогового окна
Метод
Описание
Execute
Метод Execute отображает диалог на экране. Возвращает True если пользователь
выбрал файл и нажал кнопку “Открыть”. Возвращает False если пользователь нажал
на отмену. Пример использования:
if OpenDialog.Execute then // только если пользователь выбрал файл
Memo.LoadFromFile(OpenDialog.Filename); // делаем что-то с именем файла
* Аналогичные свойства и методы у компонента TSaveDialog
TTimer (вкладка System)
Таймер – генерирует событие через равные интервалы времени.
Не визуальный компонент
Свойство
Тип
Описание
Interval
Integer
Интервал времени в миллисекундах между вызовами OnTimer
Enabled
Boolean
Событие генерируется, только если таймер включен
Событие
Когда происходит
OnTimer
Каждый раз при срабатывании таймера (через равные промежутки времени)
OnStartTimer
При старте таймера (Enabled только что присвоили значение true)
OnStopTimer
При остановке таймера (Enabled только что присвоили значение false)