TdxQueryGrid
Наследование: TDBGrid > TCustomGrid > TGridControl > TCustomControl > TWinControl > TControl > TComponent > TPersistent > TObject
Запрос - важный компонент в системе DataExpress.
С запросом может быть связана форма, если запрос редактируемый. Чтобы запрос был редактируемым, он должен быть с одним источником и без группировок. Только в этом случае можно однозначно идентифицировать запись.
Свойство RecId и метод GotoRecord можно вызывать только для редактируемых запросов. В ином случае сработает исключение.
Методы | |
BOF | Возвращает True, если достигнуто начало набора данных. Всегда True после открытия набора данных и после вызова метода MoveFirst. После перемещения на другую запись BOF будет False. |
ClearRowsSelection | Снимает выделение строк. Используется при множественном выделении строк. |
ControlsDisabled | Возвращает True, если связь с компонентами отключена. |
CurrentRowSelected | Возвращает True, если текущая строка выделена. Используется при множественном выделении строк. |
DisableControls | Отключает связь с компонентами. Это значит, что компоненты не будут обновляться при изменениях в наборе данных. |
DisableScrollEvents | Отключает события перехода OnBeforeScroll, OnAfterScroll. |
EnableControls | Восстанавливает связь с компонентами. |
EnableScrollEvents | Восстанавливает обработку событий перемещения OnBeforeScroll, OnAfterScroll. |
EOF | Возвращает True, если достигнут конец набора данных или набор данных пуст. Вызов метода MoveLast приводит к тому же результату. |
FindColumnByTitle | Ищет столбец по заголовку. Если не находит, возвращает nil. |
GetSourceFileName | Возвращает исходный путь загруженного файла или изображения. |
GetStoredFileName | Возвращает имя файла в папке хранения. |
GotoRecord | Переходит на запись с указанным ID. Нельзя применять в запросах с группировкой и несколькими источниками. |
Locate | Ищет запись с указанными значениями и переходит на найденную запись. Поиск ведется с начала набора данных. |
MoveBy | Переходит на Distance записей вперед. Если значение отрицательное, то переходит назад. Переход может вызвать чтение очередной порции данных с сервера. |
MoveFirst | Переходит на первую запись. После перехода BOF = True. |
MoveLast | Переходит на последнюю запись. Это приводит к чтению всех данных с сервера. После перехода EOF = True. |
MoveNext | Переходит на следующую запись. Переход может вызвать чтение очередной порции данных с сервера. Если достигнут конец набора данных, EOF = True. |
MovePrior | Переходит на предыдущую запись. Если достигнуто начало набора данных, BOF = True. |
MoveTo | Переходит на запись с номером RecNo. Может вызвать чтение очередной порции данных с сервера. Если номер записи выходит за пределы набора данных, переходит на последнюю и EOF = True. |
MoveToSelectedRow | Переходит на выделенную строку с указанным индексом. Используется при множественном выделении строк. |
RecId | Возвращает ID текущей записи. Сработает исключение, если запрос не редактируемый - с группировкой или несколькими источниками. |
RecNo | Возвращает номер текущей записи. |
RecordCount | Возвращает текущее количество записей в наборе данных. |
Refresh | Повторно отправляет запрос на сервер и читает первую порцию данных (100 записей). |
SaveThumbnailToStream | Сохраняет миниатюру изображения в поток. |
SaveToFile | Сохраняет файл или изображение в файл. |
SaveToStream | Сохранять файл или изображение в поток. |
ScrollEventsDisabled | Возвращает True если события перехода отключены. |
Свойства | |
AllowChangeSort | Разрешить/запретить изменение сортировки. |
AsDT | Значение поля как дата/время. Null преобразуется в 0. |
AsF | Значение поля как число. Null преобразуется в 0. |
AsI | Значение поля как целое число. Null преобразуется в 0. |
AsS | Значение поля как строка. Null преобразуется в пустую строку. |
Editable | Является ли запрос редактируемым. В редактируемых запросах возможно использование функции RecId. |
Fields | Доступ к полю набора данных. |
InactiveSelectedColor | Цвет фона неактивного выделения. |
InactiveSelectedTextColor | Цвет текста неактивного выделения. |
ManualRefresh | Включить/выключить ручное обновление. Запрос будет обновлен автоматически только в случаях добавления, изменения записи. |
QueryName | Имя запроса. |
SelectedRowCount | Количество выделенных строк при множественном выделении. |
SelectedTextColor | Цвет текста активного выделения. |
SortColumns | Доступ к сортировке. После изменения сортировки следует обновить данные методом Refresh, чтобы сортировка сработала. |
События | |
OnAfterClose | Вызывается после закрытия набора данных. |
OnAfterOpen | Вызывается после открытия набора данных. |
OnAfterScroll | Вызывается после перехода на запись. |
OnBeforeClose | Вызывается до закрытия набора данных. |
OnBeforeOpen | Вызывается до открытия набора данных. |
OnBeforeScroll | Вызывается до перехода на запись. |
OnCreateForm | Вызывается при создании форма, связанной с запросом. Форма создается один раз при добавлении, изменении или удалении записи из запроса. |
OnStateChange | Вызывается каждый раз при обновлении состояния кнопок и меню запроса. |