Назначение


Компонент служит для показа/выбора записи.



Класс: TdbComboBox



Свойства компонента

 Свойство

 Тип

 Описание

 sqlValue

 String

  Возвращает id выбранной записи в компоненте, для использования в SQL запросах. В случае пустого значение, вернет строку NULL

 пример: SQLExecute ('INSERT INTO tablename (fieldname) VALUES ('+Form1.ComboBox1.sqlValue+')');

 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.

 Color

 TColor

 Цвет фона компонента. Подробней.

 Cursor

 TCursor

 Позволяет выбрать вид курсора для компонента. Подробней.

 DroppedDown

 Boolean

 Свойство возвращает True, когда выпадающий список раскрыт, иначе False

 Enabled

 Boolean

 Определяет доступность компонента для пользователя.

 Focused

 Boolean

 Проверяет, имеет ли компонент фокус ввода. Только для чтения.

 Font

 TFont

 Позволяет задать имя, размер, цвет и стиль шрифта. Подробней.

 GetCount

 Integer

 Позволяет получить количество записей в компоненте.

 HideTextIfNotExists

 Boolean

 Имеет смысл если свойство Searchable = True. Установите HideTextIfNotExists = False, чтобы введенный текст не исчезал, если он не найден среди записей.

 Hint

 String

 Текст всплывающей подсказки, см. также ShowHint

 ItemIndex

 Integer

 Порядковый номер выбранной записи в списке. Нумерация начинается с нуля.

 Items

 TStringList

 Ссылка на экземпляр класса 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

 При покидании курсора мыши компонента.

 OnDropFiles

 При попытке перетащить файл из проводника на компонент. Подробней.