Button
Назначение
Компонент служит для выполнения действий при нажатии на него пользователем.
Класс: TdbButton
Свойства компонента
Свойство |
Тип |
Описание |
dbGeneralTableId |
Integer |
Имеет смысл если кнопке присвоено действие "Сохранить запись". Содержит id записи, если запись не сохранена, возвращает значение -1 |
dbGeneralTable |
String |
Имеет смысл если кнопке присвоено действие "Поиск", "Сохранить запись", "Отчет". Содержит имя главной таблицы БД. |
dbGetSqlStatement |
String |
Имеет смысл если кнопке присвоено действие "Поиск" или "Отчет". Содержит последний автоматически сгенерированный SQL запрос. |
dbParentTableId |
Integer |
Имеет смысл если кнопке присвоено действие "Сохранить запись". Содержит id дочерней записи, если запись не сохранена, возвращает значение -1 |
dbParentTable |
Integer |
Имеет смысл если кнопке присвоено действие "Сохранить запись". Содержит имя дочерней таблицы БД. |
dbSQL |
String |
Имеет смысл если кнопке присвоено действие "SQL запрос" или "Отчет (SQL)". Доступ к SQL запросу. |
dbFilter |
String |
Имеет смысл если кнопке присвоено действие "Поиск" или "Отчет". Позволяет задать дополнительный фильтр для запроса в БД. Например: tablename.fieldname = 1 |
dbReportFile |
String |
Имеет смысл если кнопке присвоено действие "Отчет" или "Отчет (SQL)". Имя файла шаблона для отчета. Если не указан абсолютный путь файла, значит файл расположен в папке Report вашего проекта. |
dbReportResultFile |
String |
Имеет смысл если кнопке присвоено действие "Отчет" или "Отчет (SQL)". Позволяет задать имя файла для сгенерированного отчета. |
dbReportOpenIn |
TReportOpenIn |
Имеет смысл если кнопке присвоено действие "Отчет" или "Отчет (SQL)". Позволяет задать действие после создания отчета. Значения: rpoPreview, rpoPrint, rpoPrintQuick, rpoExcel, rpoWord, rpoPDF, rpoHTML, rpoODT, rpoODS, rpoJPEG, rpoTIFF, rpoDesigner |
dbActionType |
TActionDbType |
Определяет действие кнопки. Доступные значения: adbNone, adbSearch, adbNewRecord, adbSaveRecord, adbShowRecord, adbDelete, adbSQL, adbReportNoSQL, adbReport, adbShowForm, adbCloseForm, adbGridToExcel |
dbDoCloseForm |
Boolean |
Имеет смысл если кнопке присвоено действие "Сохранить запись". Определяет, будет ли форма закрыта после нажатия на кнопку. |
dbDontResetID |
Boolean |
Имеет смысл если кнопке присвоено действие "Сохранить запись". Определяет, будет ли сохраняться id записи в свойстве dbGeneralTableId, после того, как запись будет сохранена. |
Cancel |
Boolean |
Определяет, будет ли кнопка автоматически нажата, при нажатии пользователем кнопки Escape. |
CanFocus |
Boolean |
Проверяет, может ли компонент получить фокус ввода. Обычно свойство используется совместно с методом SetFocus. |
TCursor |
Позволяет выбрать вид курсора для компонента. Подробней. |
|
Caption |
String |
Текст надписи |
Default |
Boolean |
Определяет, будет ли кнопка автоматически нажата, при нажатии клавиши Enter, если фокус ввода расположен в компоненте для ввода информации. |
Enabled |
Boolean |
Определяет доступность компонента для пользователя. |
Focused |
Boolean |
Проверяет, имеет ли компонент фокус ввода. Только для чтения. |
TFont |
Позволяет задать имя, размер, цвет и стиль шрифта. Подробней. |
|
Hint |
String |
Текст всплывающей подсказки, см. также ShowHint |
ImageMargins |
TImageMargins |
Позволяет задать отступы по краям для иконки. Например: Form1.Button1.ImageMargins.Left := 10; Помимо Left, доступны свойства: Top, Right и Bottom |
Name |
String |
Уникальное имя компонента на форме. |
ShowHint |
Boolean |
Определяет, показывать ли всплывающую подсказку, см. также Hint |
Tag |
Integer |
Позволяет присвоить число компоненту для собственных нужд. |
TagString |
String |
Позволяет присвоить строку компоненту для собственных нужд. |
TabOrder |
Integer |
Определяет порядковый номер компонента в очереди обхода фокусом ввода компонентов, находящихся на Форме, при нажатии клавиши Tab |
TabStop |
Boolean |
Определяет, будет ли компонент получать фокус, при нажатии клавиши Tab на форме |
Visible |
Boolean |
Определяет видимость компонента. |
WordWrap |
Boolean |
Определяет возможность переносить текст надписи (Caption) на новую строку. |
Left |
Integer |
X координата компонента на форме. |
Top |
Integer |
Y координата компонента на форме. |
Width |
Integer |
Ширина компонента. |
Height |
Integer |
Высота компонента. |
Методы компонента
Метод |
Описание |
procedure Click |
Позволяет программно нажать на кнопку, тем самым выполнить действие, которое задано в свойсте Action (dbActionType), а также в событиях OnClick и OnAfterClick |
procedure SetFocus |
Устанавливает фокус ввода для формы. |
События компонента
Событие |
Описание |
При клике мышкой по компоненту. Событие также позволяет предотвратить выполнение выбранного действия для кнопки. Подробней. |
|
OnAfterClick |
При клике мышкой по компоненту после выполнения действия заданного для кнопки. Если для кнопки не задано действие, событие не вызывается. |
OnEnter |
При получении компонентом фокуса ввода. |
OnExit |
При потере компонентом фокуса ввода. |
OnKeyDown |
При нажатии на любую кнопку клавиатуры. |
OnKeyPress |
При нажатии на кнопку клавиатуры. Работает только для печатных символов. |
OnKeyUp |
При отпускании любой кнопки на клавиатуре. |
OnMouseDown |
При нажатии кнопки мыши. |
OnMouseEnter |
При заходе курсора мыши на компонент. |
OnMouseLeave |
При покидании курсора мыши компонент. |
OnMouseMove |
При перемещении курсора мыши по компоненту. |
OnMouseUp |
При отпускании кнопки мыши. |
При попытке перетащить файл из проводника на компонент. Подробней. |