ComboBox
Назначение
Компонент служит для показа/выбора записи.
Класс: TdbComboBox
Свойства компонента
Свойство |
Тип |
Описание |
sqlValue |
String |
Возвращает id выбранной записи в компоненте, для использования в SQL запросах. В случае пустого значение, вернет строку NULL |
dbItemID |
Integer |
Идентификатор выбранной записи в компоненте. Идентификатор соотвествует полю id в базе данных. |
dbSortField |
String |
Поле БД, по которому будут отсортированы записи в компоненте. |
dbSortAsc |
Boolean |
Если True, то записи будут отсортированы по возрастанию, иначе по убыванию. |
dbFilter |
String |
Позволяет задать дополнительный фильтр, который будет использован для заполнения компонента данными из БД. Например: tablename.fieldname = 1 |
dbForeignKey |
String |
Определяет, к какому внешнему ключу таблицы базы данных принадлежит данный компонент. |
dbField |
String |
Определяет, к какому полю таблицы базы данных принадлежит данный компонент. |
dbIncremSearch |
String |
Позволяет указать имя кнопки на текущей форме с действием "Поиск" или "SQL запрос", которая будет автоматически нажиматься при вводе текста пользователем для моментального поиска. |
dbSQL |
String |
Содержит SQL запрос, который был использован при вызове метода SQLExecute. |
CanFocus |
Boolean |
Проверяет, может ли компонент получить фокус ввода. Обычно свойство используется совместно с методом SetFocus. |
TColor |
Цвет фона компонента. Подробней. |
|
TCursor |
Позволяет выбрать вид курсора для компонента. Подробней. |
|
DroppedDown |
Boolean |
Свойство возвращает True, когда выпадающий список раскрыт, иначе False |
Enabled |
Boolean |
Определяет доступность компонента для пользователя. |
Focused |
Boolean |
Проверяет, имеет ли компонент фокус ввода. Только для чтения. |
TFont |
Позволяет задать имя, размер, цвет и стиль шрифта. Подробней. |
|
GetCount |
Integer |
Позволяет получить количество записей в компоненте. |
HideTextIfNotExists |
Boolean |
Имеет смысл если свойство Searchable = True. Установите HideTextIfNotExists = False, чтобы введенный текст не исчезал, если он не найден среди записей. |
Hint |
String |
Текст всплывающей подсказки, см. также ShowHint |
ItemIndex |
Integer |
Порядковый номер выбранной записи в списке. Нумерация начинается с нуля. |
Ссылка на экземпляр класса TStringList для построчной работы с текстом в компоненте. Подробней. |
||
Items[i] |
String |
Построчный доступ к списку записей. Например ShowMessage(Form1.ComboBox1.Items[1]); // покажет сообщение со второй строкой (нумерация с нуля). |
ItemsChecked[i] |
Boolean |
Имеет смысл, если свойство MultiSelect = True, позволяет прочитать/установить галочку напротив записи. |
MultiSelect |
Boolean |
Включает возможность множественного выбора записей в компоненте. Применяется при использовании кнопки с действием "Поиск" или скриптом. |
Name |
String |
Уникальное имя компонента на форме. |
ShowHint |
Boolean |
Определяет, показывать ли всплывающую подсказку, см. также Hint |
SearchableType |
TSearchType' |
Имеет смысл если свойство Searchable = True. Тип поиска. Значения: stExact - поиск полного совпадения, stContain - поиск подстроки в строке. |
SelectedCount |
Integer |
Имеет смысл если свойство MultiSelect = True. Возвращает количество выбранных записей в компоненте. |
SelLength |
Integer |
Длинна выделенного текста в компоненте. |
SelStart |
Integer |
Определяет позиция первого выделенного символа. Если нет выделенного текста, возвращает позицию курсора в тексте. |
Sorted |
Boolean |
Определяет, будут ли отсортированы записи в компоненте. По умолчанию, сортировка происходит по полю БД указанному в свойстве dbField, вы можете изменить поле, которое будет использоваться для сортировки с помощью свойства dbSortField. Определить тип сортировки можно в свойстве dbSortAsc. |
TabOrder |
Integer |
Определяет порядковый номер компонента в очереди обхода фокусом ввода компонентов, находящихся на Форме, при нажатии клавиши Tab |
TabStop |
Boolean |
Определяет, будет ли компонент получать фокус, при нажатии клавиши Tab на форме |
Tag |
Integer |
Позволяет присвоить число компоненту для собственных нужд. |
TagString |
String |
Позволяет присвоить строку компоненту для собственных нужд. |
Text |
String |
Текст компонента. |
TextHint |
String |
Подсказка, которая видна, когда в компоненте нет текста. |
Visible |
Boolean |
Определяет видимость компонента. |
Left |
Integer |
X координата компонента на форме |
Top |
Integer |
Y координата компонента на форме |
Width |
Integer |
Ширина компонента |
Height |
Integer |
Высота компонента |
Методы компонента
Метод |
Описание |
procedure dbAddRecord (id: integer; text: string) |
Добавляет запись в компонент и присваивает ей указанный id. Запись в базу данных при это не добавляется. |
procedure dbEditRecord (id: integer; text: string) |
Редактирует запись в компоненте с указанным id. Запись в базе данных при это не редактируется. |
procedure dbDeleteRecord (id: integer) |
Удаляет запись из компонента с казанным id. Запись из базы данных при этом не удаляется. |
function dbGetFieldValue (FieldName: string): variant |
Функция позволяет получить значение указанного поля из БД для выбранной записи в компоненте. Если запись в компоненте не выбрана, функция возвращает значение Unassigned. |
function dbIndexToID (index: integer): integer |
Функция позволяет получить id записи, указав ее порядковый номер в списке. |
procedure dbSQLExecute (sql: string) |
Процедура позволяет заполнить компонент данными из БД с помощью SQL запроса. Указанный SQL запрос сохраняется в свойстве dbSQL. |
procedure dbUpdate |
Принудительно обновляет данные в компоненте. Как правило компонент обновляет данные автоматически, если данные были изменены. |
procedure Clear |
Очищает содержимое компоненте. |
procedure DoOnChange |
Принудительно выполняет событие OnChange, если оно было определено для компонента. |
procedure SetAllCheckBoxes (const Checked: boolean) |
Имеет смысл если свойство MultiSelect = True. Менят состояние флажка напротив каждой записи. |
procedure SetFocus |
Устанавливает фокус ввода для компонента. |
События компонента
Событие |
Описание |
OnChange |
При изменении содержимого компонента пользователем. |
OnClick |
При клике мышкой по компоненту. |
OnCloseUp |
При закрытии выпадающего списка. |
OnDoubleClick |
При двойном клике мышкой по компоненту. |
OnDropDown |
При открытии выпадающего списка, когда пользователь нажимает кнопку со стрелкой вниз. |
OnEnter |
При получении компонентом фокуса ввода. |
OnExit |
При потере компонентом фокуса ввода. |
OnKeyDown |
При нажатии на любую кнопку клавиатуры. |
OnKeyPress |
При нажатии на кнопку клавиатуры. Работает только для печатных символов. |
OnKeyUp |
При отпускании любой кнопки на клавиатуре. |
OnMouseEnter |
При заходе курсора мыши на компонент. |
OnMouseLeave |
При покидании курсора мыши компонента. |
При попытке перетащить файл из проводника на компонент. Подробней. |