TdxQueryGrid

Наследование: TDBGrid > TCustomGrid > TGridControl > TCustomControl > TWinControl > TControl > TComponent > TPersistent > TObject -DESKTOP- -WEB-

Запрос - важный компонент в системе 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Вызывается каждый раз при обновлении состояния кнопок и меню запроса.