Delphi 3 и создание приложений баз данных

       

Методы


procedure Apply Updates (const DataSets: array of TDataSet); -

применяется для подтверждения кэшированных изменений сразу в нескольких НД. Список НД определяется параметром DataSets. В случае указания нескольких НД их имена разделяются запятыми.

procedure Close; -

закрывает БД и все связанные с ней открытые НД.

procedure CloseDatasets; -

закрывает открытые НД, связанные с БД, но не закрывает саму БД.

procedure Commit; -

подтверждает текущую транзакцию, т.е. подтверждает все модификации в БД, имевшие место с момента последнего вызова метода Start Transaction. Если ни одна транзакция не активна, возбуждается исключение.

procedure Open; -

открывает БД, соединяя компонент TDatabase с сервером или BDE для Paradox или dBASE.

procedure Rollback; -

откатывает текущую транзакцию, т.е. отменяет все модификации в БД, имевшие место с момента последнего вызова метода Start Transaction.

procedure StartTransaction;

- инициирует начало транзакции. Если в этот момент активна некоторая транзакция, возбуждается исключение. Транзакционные изменения в наборах БД, имевшие место после выполнения метода StartTransaction, либо подтверждаются методом Commit, либо отменяются методом Rollback. До подтверждения или отмены изменений транзакция, начатая StartTransaction, считается активной.

procedure Append; -

переводит НД в состояние dslnsert, добавляет новую запись с пустыми полями. Применение метода Род! запоминает новую запись в БД после последней записи. Метод рассчитан на неиндексированные НД. Для индексированных НД его выполнение имеет те же последствия, что и выполнение метода Insert.

procedure AppendRecordfconst Values: array of const); -

метод аналогичен последовательному выполнению цепочки "выполнить метод Append", "присвоить значения полям данных из списка", "выполнить метод Post".

procedure Apply Updates; -

применяется для подтверждения кэшированных изменений для отдельного НД.

procedure Cancel; -

отменяет изменения, сделанные в существующей записи (режим dsEdit), или добавление новой записи в БД (режим dslnsert).

procedure CancelUpdates; -

отменяет кэшированные изменения в НД, сделанные с момента последнего выполнения метода ApplyUpdates, либо, если такой метод ни разу не выполнялся, все изменения, сделанные с момента перехода НД в режим кэшированных изменений (CachedUpdates = True).

procedure ClearFields

; - очищает содержимое полей текущей записи набора данных. Если НД не находится в режиме вставки новой записи или редактирования, возбуждается исключение. В случае успешного выполнения вызывается обработчик события OnDalaChange (компонент TDataSource, связанный с НД), поскольку реальное содержимое записи при очистке полей изменяется.

procedure Close; -

закрывает НД;

procedure CommitUpdates; -

применяется для обновления в БД кэшированных изменений, успешно подтвержденных методом Apply Updates. Успешность подтверждения состоит в том, что при подтверждении кэшированных изменений не было выдано ни одной ошибки.

procedure Delete; -

удаляет текущую запись из НД, сдвигая оставшиеся записи "вверх".

procedure DisableControls;

и procedure EnableControls; -
отключают и затем восстанавливают связь с визуальными компонентами, связанными с данным НД (например, TDBGrid). Это важно при выполнении действий с НД, влекущих за собой частое изменение местоположения курсора БД, чтобы в визуальном компоненте не возникал эффект "прокрутки" записей и не тратилось время на обновление изменений.

procedure Edit; -

переводит НД в режим редактирования (dsEdit), после чего значения полей можно изменять. Выполнение метода Post приводит к сохранению измененной записи в НД. Выполнение метода Cancel приводит к отказу от сделанных изменений.

function FindFirst: Boolean; -

ищет первую в НД запись, удовлетворяющую фильтру, условие которого определяется обработчиком события OnFi/terRecord или (и) свойством Filter.

function FindLast: Boolean; -

ищет последнюю запись, удовлетворяющую фильтру, условие которого определяется обработчиком события OnFilterRecord или (и) свойством Filter.

function FindNext: Boolean; -

переходит на следующую запись, удовлетворяющую фильтру, условие которого определяется обработчиком события OnFilterRecord или (и) свойством Filter.

junction FindPrior: Boolean; -

переходит на предыдущую запись, удовлетворяющую фильтру, условие которого определяется обработчиком события OnFilterRecord или (и) свойством Filter.

procedure First; -

устанавливает курсор на логически первую запись в наборе данных.

procedure FreeBookmark( Bookmark: TBookmark); -

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

function GetBookmark: TBookmark; -

создает для текущей записи закладку и возвращает ссылку на нее;

procedure GotoBookmark( Bookmark: TBookmark); -

перемещает курсор БД на запись, определяемую закладкой Bookmark;

procedure Insert; -

переводит НД в состояние dslnsert, добавляет новую запись с пустыми полями. Метод Post запоминает новую запись в БД после текущей записи. Выполнение метода Cancel приводит к отказу от добавления новой записи.

procedure InsertRecord(const Values: array ofconst); -

аналогична последовательному выполнению цепочки "выполнить метод Insert", "назначить значения полям данных из списка", "выполнить метод Post".

procedure Last; -

устанавливает курсор на логически последнюю запись в наборе данных.

function Locate(const KeyFields: string; const KeyValues: Variant;

Options: TLocateOptions): Boolean; -

осуществляет поиск в НД записи, удовлетворяющей (полностью или частично) условиям KeyValues, в полях, список которых задается KeyFields. При нахождении записи делает ее текущей в НД. В качестве поисковых могут задаваться как индексные, так и неиндексные поля. Текущий индекс значения не имеет.

procedure LockTable(LockType: TLockType); -

накладывает на таблицу БД (Paradox, dBase) блокировку на операции чтения или записи; в дальнейшем блокировка может быть снята методом Unlock Table.

TLockType = (ItReadLock, ItWriteLock);

function Lookup(const KeyFields: string; const KeyValues: Variant;

const ResultFields: string): Variant; -

ищет в НД запись, удовлетворяющую условию KeyValues, в полях, список которых задается KeyFields, и возвращает список значений полей, заданных ResultFields. Указатель записи при этом не изменяется. В качестве поисковых могут задаваться как индексные, так и неиндексные поля. Текущий индекс значения не имеет.

function MoveBy (Distance: Integer): Integer; -

перемещает курсор НД на Distance записей к концу набора данных (Distance > 0) или к его началу (Distance < 0) в логическом порядке, определенном индексом (свойство IndexFieldNames или IndexName).

procedure Next; -

перемещает курсор НД на следующую запись в НД в логическом порядке, определенном индексом (свойство IndexFieldNames или IndexName).

procedure Open; •

открывает НД.

procedure Post; -

переводит НД из режимов dsEdit или dslnsert в режим dsBrowse. Измененная (режим dsEdit) или новая запись (режим dslnsert) записывается в НД.

procedure Prior; -

перемещает курсор НД на предыдущую запись в НД в логическом порядке, определенном индексом (свойство IndexFieldNames или IndexName}.

procedure Refresh; -

обновляет НД из таблицы БД; служит для синхронизации нескольких НД, работающих с одной таблицей в одном приложении, а также -в многопользовательском режиме в архитектуре "файл-сервер" - для показа в НД обновлений, внесенных в таблицу другими пользователями.

procedure SelFields (const Values: array ofconst);

- аналогична последовательному выполнению цепочки "выполнить метод Edit", "присвоить значения полям данных из списка", "выполнить метод Post".

procedure UnlockTable(LockType: TLockType); •

снимает с таблицы БД (Paradox, dBase) блокировку на операции чтения или записи, ранее наложенную на таблицу методом Lock Table.

TLockType = (ItReadLock, ItWriteLock);

События property AfterCancel: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает немедленно после выполнения метода Cancel. В момент события изменения в записи уже потеряны. Это событие может не возникнуть в том случае, если вызов обработчика метода Cancel блокирован в силу наступления каких-либо условий в обработчике события BeforeCancel

property AfterClose: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает немедленно после выполнения метода Close или установки свойства Active в False. В момент события НД уже закрыт. Это событие может не возникнуть в том случае, если вызов обработчика метода Close блокирован в силу наступления каких-либо условий в обработчике события BeforeClose.

property AfterDelete: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает немедленно после выполнения метода Delete. В момент события запись уже удалена. Это событие может не возникнуть в том случае, если вызов обработчика метода Delete блокирован в силу наступления каких-либо условий в обработчике события BeforeDelete.

property AfterEdit: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает немедленно после выполнения метода Edit, сразу же после перехода в состояние dsEdit из состояния dsBrowse. В момент события изменения в запись еще не внесены. Это событие может не возникнуть в том случае, если вызов обработчика метода Edit блокирован в силу наступления каких-либо условий в обработчике события BeforeEdit.

property Afterlnsert: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает немедленно после выполнения метода Insert или Append, сразу же после перехода в состояние dslnsert из состояния dsBrowse. В момент события изменения в запись еще не внесены. Это событие может не возникнуть в том случае, если вызов обработчика метода Insert блокирован в силу наступления каких-либо условий в обработчике события Beforelnsert.

Назначить полям добавляемой записи значения по умолчанию можно в методе OnNewRecord.

property AfterOpen: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает немедленно после выполнения метода Open или установки свойства Active в True. В момент события НД уже открыт. Это событие может не возникнуть в том случае, если вызов обработчика метода Open блокирован в силу наступления каких-либо условий в обработчике события BeforeOpen.

property AfterPost: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает после выполнения метода Post. Курсор в момент наступления события не позиционирован на запомненную запись, если НД (в этом случае компонент TTable) ранжирован (отфильтрован) при помощи методов ApplyRange или SetRange свойства Filter или события OnFUterRecord, а запоминаемая запись имеет значения фильтруемых полей, выходящих за диапазон фильтра. В противных случаях курсор указывает на запомненную запись.

Это событие может не возникнуть в том случае, если вызов обработчика метода Post блокирован в силу наступления каких-либо условий в обработчике события BeforePost.

property AfterScroll: TDataSetNotifyEventI;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Событие наступает после перехода на другую запись в НД. property BeforeCancel: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает перед выполнением метода Cancel, но после обращения к нему. В обработчике можно воспрепятствовать выполнению метода Cancel путем принудительного возбуждения исключительной ситуации, вызова метода Abort или выполнения иных действий, которые заведомо приведут к возбуждению исключения.

property BeforeClose: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает перед выполнением метода Close, но после его вызова. В обработчике можно воспрепятствовать выполнению метода Close путем принудительного возбуждения исключительной ситуации, вызова метода Abort или выполнения иных действий, которые заведомо приведут к возбуждению исключения.

Используется для перевода НД в режим dsBrowse, если на момент закрытия НД находится в режимах dsEdit или dslnsert. В этом случае для перевода НД в режим dsBrowse нужно вызвать метод Post (с запоминанием изменений) или метод Cancel (для отмены изменений).

property BeforeDelete: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает перед выполнением метода Delete, но после его вызова. В обработчике можно воспрепятствовать выполнению метода Delete путем принудительного возбуждения исключительной ситуации, вызова метода Abort или выполнения иных действий, которые заведомо приведут к возбуждению исключения.

property BeforeEdit: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает перед выполнением метода Edit, но после его вызова. В обработчике можно воспрепятствовать выполнению метода Edit путем принудительного возбуждения исключительной ситуации, вызова метода Abort или выполнения иных действий, которые заведомо приведут к возбуждению исключения.

property Beforelnsert: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает перед физическим выполнением метода Insert, но после его вызова.

В обработчике можно воспрепятствовать выполнению метода Insert путем принудительного возбуждения исключительной ситуации, вызова метода Abort или выполнения иных действий, которые заведомо приведут к возбуждению исключения.

property BeforeOpen: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает перед физическим выполнением метода Open, но после его вызова. В обработчике можно воспрепятствовать выполнению метода Open путем принудительного возбуждения исключительной ситуации, вызова метода Abort или выполнения иных действий, которые заведомо приведут к возбуждению исключения property BeforePost: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Наступает перед физическим выполнением метода Post, но после его вызова. В обработчике можно воспрепятствовать выполнению метода Post путем принудительного возбуждения исключительной ситуации, вызова метода Abort или выполнения иных действий, которые заведомо приведут к возбуждению исключения.

property BeforeScroll: TDataSetNotifyEventI;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Событие наступает перед выполнением перехода на другую запись в НД. property OnDeleteError: TDataSet ErrorEvent;

TDataSetErrorEvent = procedure(DataSet: TDataSet; E: EDatabaseError;

var Action: TDataAction) of object;

TDataAction = (daFail, daAbort, daRetry);

Наступает при неудачном выполнении метода Delete.

property OnCalcFields: TDafaSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Используется для расчета значений вычисляемых полей. Определяет алгоритм, по которому следует рассчитывать значения таких полей. Наступает при чтении информации из ТБД. Кроме того, если свойство AutoCalcFields имеет значение True, событие OnCalcFields наступает также и при модификации значений невычисляемых полей в режимах dslnsert и dsEdit данного НД или НД, с ним связанного (когда установлены ограничения целостности в самой ТБД, а не тогда, когда они подразумеваются).

Поскольку событие OnCalcFields наступает очень часто, его обработчик должен содержать максимально возможно короткий код.

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

property OnEditError: TDataSetErrorEvent;

TDataSetErrorEvent = procedure(DataSet: TDataSet; E: EDatabaseError;

var Action: TDataAction) of object;

TDataAction = (daFail, daAbort, daRetry);

Наступает при неудачном выполнении методов Insert и Edit. property OnFilterRecord: TFilterRecordEvent;

TFilterRecordEvent = procedure(DataSet: TDataSet; var Accept: Boolean) of object;

Задает условия фильтрации; возникает, когда свойство Filtered устанавливается в True. Альтернативный способ фильтрации по любым” в том числе неиндексным, полям, для свойства Filter. Однако может использоваться совместно с ним, а также с фильтрациями, накладываемыми при помощи методов SetRange и Apply Range.

property OnNewRecord: TDataSetNotifyEvent;

TDataSetNotifyEvent = procedure(DataSet: TDataSet) of object;

Используется для присваивания значений по умолчанию полям вновь создаваемой записи НД перед тем как эта запись станет доступна пользователю для ввода значений полей. Присваивание значений по умолчанию не устанавливает в свойство Modifyed значение True. Наступает после события BeforeInserf и до события Afterlnsert.

property OnPostError: TDataSetErrorEvent;

TDataSetErrorEvent = procedure(DataSet: TDataSet; E: EDatabaseError;

var Action: TDataAction) of object;

TDataAction = (daFail, daAbort, daRetry);

Наступает при неудачном выполнении метода Post. property OnUpdate Error: TUpdateErrorEvent;

TUpdateErrorEvent = procedure(DataSet: TDataSet; E: EDatabaseError;

UpdateKind: TUpdateKind; var UpdateAction: TUpdateAction) of object;

Наступает в случае, если при попытке подтверждения кэшированных изменений для НД происходит ошибка.

property OnUpdateRecord: TUpdateRecordEvent;

TUpdateErrorEvent = procedure(DataSet: TDataSet; E: EDatabaseError;

UpdateKind: TUpdateKind; var UpdateAction: TUpdateAction) of object;

Наступает для каждого факта внесения изменений в запись НД (добавление, изменение, удаление записи), если НД находится в режиме кэшированных изменений.




function SeriesCount : Longint; -

возвращает число серий, присутствующих в текущий момент в графике.

procedure RefreshData; -

обновляет данные в серии из НД, которые служат их источником.


procedure DoKey(Key: DBCtrlGridKey); -

выполняет определенное действие, задаваемое параметром Key. Некоторые из возможных значений этого параметра:

gkNull

Действия нет.

gkEditMode

Перевод в режим редактирования.

gkLeft Moves

Перемещение на 1 колонку влево со скроллингом (если нужен).

gkRight

Перемещение на 1 колонку вправо.

gkUp

Перемещение на 1 запись вверх.

gkDown

Перемещение на 1 запись вниз.

gkScrolIUp

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

gkScrollDown

Делает запись в следующей строке текущей, без изменения ее местоположения.

gkPage Up

Перемещение к предыдущей странице TDBCtrlGrid.

gkPageDown

Перемещение к следующей странице TDBCtrlGrid.

gkHome

Перемещение на первую запись.

gkEnd Moves

Перемещение на последнюю запись.


• procedure DefaultDrawColumnCell(const Rect: TRect; DataCol: Integer; Column:

TColumn; State: TGridDrawState); -

выводит ячейки TDBGrid стандартным способом (по умолчанию), как это было бы, если бы свойство TDBGrid Default Drawing содержало значение True. Обычно это актуально, если свойство Default Drawing равно False и для вывода содержимого ячеек используется обработчик OnDrawColumnCell или OnDrawDataCell, где некоторые ячейки (строки) могут выводиться нестандартно (иным цветом, шрифтом, фоном, с особенным форматированием значения), а некоторые ячейки должны выводиться стандартным способом. В последнем случае из OnDrawColumnCell или OnDrawDataCell и вызывается метод DefaultDrawColumnCell.

• function ValidFieldIndex(FieldIndex: Integer): Boolean; -

возвращает True, если значение Fieldlndex является правильным индексом столбца TDBGrid, и False -в противном случае.


procedure CloseUp; -

сворачивает распахнутый список выбора.

procedure DropDown; -

раскрывает ("распахивает") список выбора.

Компонент TDBLookupListBox




LoadFromFile(const FileName: string);

загружает в TDBMemo содержимое файла, имя которого определяется константой или переменной FileName.

SaveToFUe(const FileName: string);

записывает содержимое TDBMemo в файл, имя которого определяется константой или переменной FileName.




procedure Clear; -

полностью удаляет текст из компонента.

procedure ClearSelection; -

удаляет выделенный фрагмент текста.

procedure CopyToClipboard; -

копирует выделенный фрагмент текста в буфер обмена Windows.

procedure CutToClipboard; -

вырезает выделенный фрагмент текста и вставляет его в буфер обмена Windows.

junction GetTextLen: Integer; -

возвращает длину текста.

function FindText(const SearchStr: string; StartPos, Length: Integer; Options:

TSearchTypes): Integer; -

производит поиск вхождения в текст комментария строки SearchStr. Поиск производится во фрагменте текста, начиная с позиции StartPos и заканчивая StartPos + Length -1. Первый символ текста комментария имеет номер 0.

Если поиск успешен, возвращается номер символа, начиная с которого SearchStr входит в текст комментария. В противном случае возвращается -1.

Параметр Options представляет собой множество, в которое могут входить элементы:

st Whole Word - строка SearchStr должна содержать целое слово (если занимает фрагмент слова, этот факт при поиске не учитывается);

stMatchCase -

величина букв SearchStr и найденного фрагмента должна совпадать.

procedure LoadMemo; -

загружает содержимое поля комментария в компонент TDBRichEdit. Этот метод необходимо использовать, когда при изменении курсора набора данных не происходит обновления компонента TDBRichEdit содержимым поля комментария текущей записи, т.е. когда свойство AutoDisplay находится в значении False.

procedure PasteFromClipboard; -

вставляет содержимое буфера обмена Windows в текст комментария, начиная с текущей позиции курсора.

procedure Print (const Caption: string); -

выводит текст комментария на печать. Параметр Caption определяет заголовок в очереди печати.

procedure SelectAll; -

выделяет весь текст.


procedure ShowCubeDialog; -

во время выполнения осуществляет вход в редактор куба, в котором могут быть изменены или переопределены свойства куба, установленные во время разработки. Более подробно см. свойство DimensionMap.


procedure RegisterEvents; -

выполняет регистрацию приложения как приемника сообщений от сервера БД о наступлении событий, определяемых свойством Events

procedure UnregisterEvents; -

отключает регистрацию приложения как приемника сообщений от сервера БД о наступлении событий, определяемых свойством Events. Данный метод не может применяться в обработчике события OnEventAlert. Перед выполнением метода в обработчике OnEventAlert полезно установить изменяемый параметр CancelAlerts ъ False.


procedure ExecSQL; -

открывает НД, если в свойстве SQL содержится SQL-запрос на выполнение действия (отличный от оператора SELECT).

procedure Open; -

открывает НД, если в свойстве SQL содержится SQL-запрос на выборку данных (оператор SELECT).

procedure Prepare; -

подготавливает динамический запрос к выполнению.

procedure UnPrepare; -

высвобождает ресурсы, занимаемые запросом, ранее подготовленным к выполнению методом Prepare.


procedure NewPage; -

выполняет переход на новую страницу. Может использоваться в обработчиках событий компонентов отчета BeforePrint или AfterPrint и не может - в обработчиках событий OnPrint, OnStartPage и OnEndPage.

procedure Preview; -

выводит отчет в окно предварительного просмотра. procedure Print; - печатает отчет.

procedure PrinterSetup; -

выдает диалоговое окно установки параметров принтера.


function AddXY(Const AXValue, AYValue: Double; Const AXLabel: String; A Color: TColor) : Longint; -

добавляет новую точку в серию. Параметры AXValue и AYValue содержат соответственно значения по осям Х и Y. Параметр AXLabel содержит метку для добавляемой точки серии. Параметр AColor определяет цвет. Функция возвращает позицию новой точки в серии.

function AddY (Const A Y Value: Double; Const AXLabel: String; AColor: TColor):

Longint; -

добавляет в серию новое значение по оси X. Применяется для тех серий, в которых график строится по Х и меткам значений по Х (например, Pie, Bar). Назначение параметров такое же, как у метода AddXY.

procedure Assign Values (Source : TChartSeries); -

копирует все точки из серии Source в текущую серию.

procedure CheckDataSource; -

обновляет точки в серии, независимо от того, какой компонент является источником данных - НД или другая серия. Обновление производится по текущим данным источника. Метод рекомендуется вызывать в случае изменений данных в источнике.

procedure Clear; -

удаляет все значения из серии; если вслед за этим не занести новых точек, будет показываться пустой график.

procedure ColorRange(A ValueList: TChartValueList; Const From Value, To Value:

Double; AColor: TColor); -

изменяет цвет указанного диапазона точек серии. AValueList - либо XValues, либо YValues. FromValue указывает начальное, а То Value конечное значение в списке AValueList. AColor - новый цвет.

function Count: Longint; -

возвращает число точек в серии.

procedure Delete (Valuelndex : Longint); -

удаляет из серии точку с номером ValueIndex. График, к которому принадлежит серия, автоматически перерисовывается.

procedure DoSeriesClick( Valuelndex.•Longint; Button:TMouseB utton; Shift:

TShiftState; X, Y: Integer); virtual; -

инициирует наступление события OnCUck.

function GetCursor Valuelndex : Longint; -

возвращает индекс точки серии в TChart ValueList, ближе всего к которой расположен курсор мыши. Если такую точку определить не удается, возвращается -1.

procedure GetCursor Values ( Var x,y : Double ); -

возвращает значения по X и Y точки графика (а не только серии), ближе всего к которой расположен курсор мыши.;

function GetHorizAxis :• TChartAxis; -

возвращает указатель на назначенную серии горизонтальную ось. Используя данный указатель, можно вызывать методы оси, обращаться к ее свойствам.

function GetVertAxis:TChartAxis; -

возвращает указатель на вертикальную ось.

function MaxX Value: Double; virtual; -

возвращает максимальное значение по X.

function MinXValue : Double; virtual; -

возвращает минимальное значение по X.

function MaxY Value: Double; virtual; -

возвращает максимальное значение по Y. function MinYValue: Double; virtual; - возвращает минимальное значение по Y.

procedure RefreshSeries; -

обновляет значения серии из источника данных, указанного в свойстве DataSource.

procedure Repaint; -

приводит к полной перерисовке всего графика. Рекомендуется вызывать этот метод в случае изменения хотя бы одного из основополагающих свойств серии (например, при изменении значения в DataSource и др.).

function ValuesListCount:Longint; -

возвращает количество используемых в серии списков значений точки. Обычно это 2 списка (XValues и YValues), но некоторые серии используют 3 (BubbleSeries - XValues, YValues, Radius; GanttSeries -Y, Start, End).

function VisibleCount: Longint; -

возвращает количество видимых на графике точек серии,


procedure AddPassword(const Password: string); -

добавляет пароль.

procedure CloseDatabase (Database: TDatabase); -

закрывает открытую БД, определяемую параметром Database. Принудительное закрытие БД практикуется достаточно редко, поскольку закрытие всех открытых БД производится при окончании работы приложения.

procedure DropConnections; -

разрывает имеющиеся соединения с БД в рамках сессии.

function FindDatabase (const DatabaseName: string): TDatabase; -

пытается отыскать БД (компонент TDatabase} в коллекции TSession. Databases (коллекция открытых БД). Имя искомой БД определяется строковым параметром DatabaseName. Если в коллекции открытых БД сессии имеется такая БД, у которой значение DatabaseName совпадает с параметром DatabaseName метода FindDatabase, в качестве результата возвращается указатель на найденный компонент TDatabase. В противном случае (поиск неудачен) возвращается nil.

procedure Get AliasNamesf List: TStrings); -

очищает список List и затем заносит в него список псевдонимов БД , определенных в BDE.

procedure GetAliasParams(const AliasName: string; List: TStrings); -

очищает список List и затем помещает в него параметры псевдонима, определяемого строкой AliasName.

procedure GetDriverNames(List: TStrings); -

очищает список List и затем заносит в него информацию об установленных на текущий момент драйверах BDE. Заметим, что драйверов 'PARADOX' и 'DBASE' не существует, поскольку эти СУБД управляются драйвером 'STANDARD'.

procedure GetDriverParams(const DriverName: string; List: TStrings); -

очищает список List и затем заносит в него умалчиваемые параметры для драйвера, указанного в параметре DriverName. В случае использования Paradox или dBASE (DriverName = 'STANDARD'), в списке указывается только один параметр - 'РАТН='. Драйверы SQL-СУБД могут иметь переменное число параметров.

function GetPassword: Boolean; -

реализует принудительный вызов стандартного диалога ввода паролей.

procedure GetTableNames (const DatabaseName, Pattern: string; Extensions, SystemTables: Boolean; List: TStrings); -

очищает список List и добавляет в него имена всех таблиц, определяемых параметром DatabaseName. Если необходимо добавить имена только некоторых таблиц, шаблон их имени указывается параметром Pattern. Значение параметра System Tables, равное True, включит в состав таблиц, чьи имена занесены в List, имена системных таблиц (для удаленных баз данных). Установка в True параметра Extensions приведет к включению в имена таблиц расширений имени файла.

function OpenDatabase(const DatabaseName: string): TDatabase; -

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

procedure RemoveAllPasswords; -

удаляет все пароли.

procedure RemovePassword(const Password: string); -

удаляет конкретный пароль.


procedure ApplyRange; -

осуществляет фильтрацию записей в TTable. Условия фильтрации определяются SetRangeStart и SetRangeEnd.

procedure CancelRange; -

отменяет режим фильтрации. НД возвращается к неотфильтрованному состоянию.

procedure DeleteTable; -

физически удаляет ТБД из базы данных. Метод применим только к закрытым НД.

procedure EditKey; -

используется для перевода в состояние dsSetKey, если ранее для поиска с использованием GoToKey или GoToNearest по этому же индексу использовался SetKey.

procedure EditRangeEnd;

- позволяет изменить верхнюю границу фильтра, ранее установленную при помощи SetRangeEnd.

procedure EditRangeStart;

- позволяет изменить нижнюю границу фильтра, ранее установленную при помощи SetRangeStart.

procedure Empty Table; -

уничтожает все записи в ТБД, связанной с НД. После этой операции ТБД будет пустой. Метод применим только к закрытым НД.

function FindKey (const Key Values: array ofconst): Boolean; -

осуществляет поиск в НД записи, у которой индексные поля текущего индекса НД содержат те же значения, что и Key Values. Если запись найдена, курсор НД перемещается на нее и метод возвращает True. В противном случае местоположение курсора не изменяется и метод возвращает False.

procedure FindNearest(const Key Values: array ofconst); -

осуществляет поиск в НД записи, у которой индексные поля текущего индекса НД содержат те же значения, что и Key Values. Если запись найдена, курсор НД перемещается на нее. В противном случае курсор перемещается на запись с большим значением индекса.

procedure GotoCurrent (Tablet: TTable); -

устанавливает курсор БД набора данных Table 1 на ту же запись, на которой находится курсор БД набора данных Table2. Это важно в тех случаях, когда при одновременной работе с одной и той же ТБД выгодно применять два или более НД. В этом случае требуется совместить курсоры БД двух НД, чтобы работа производилась с одной и той же физической записью ТБД.

function GotoKey: Boolean; -

аналогичен FindKey, однако значения индексных полей должны быть установлены явно (через Fields [индекс}, FieldByName или имя поля}.

procedure GotoNearest; -

аналогичен FindNearest, однако значения индексных полей должны быть установлены явно (через Fields [индекс], FieldByName или имя поля).

procedure SetKey; -

переводит НД в состояние dsSetKey поиска записи. Метод используется явно для методов поиска на точное соответствие GoToKey и неточное соответствие GoToNearest, дублирующих методы FindKey и FindNearest (при их выполнении SetKey вызывается неявно).

procedure SetRange (const Start Values, EndValues: array ofconst); -

имеет тот же эффект, как и применение SetRangeStart, Set Range End” Apply Range. В качестве параметра используются массивы констант, каждый из которых содержит значения ключевых полей.

procedure SetRangeEnd; -

устанавливает, что определяемое ниже значение ключевого поля (полей) будет рассматриваться как верхняя граница фильтра;

procedure SetRangeStart; -

устанавливает, что определяемое ниже значение ключевого поля (полей) будет рассматриваться как нижняя граница фильтра;


procedure SetParams(UpdateKind: TUpdateKind); -

используется для установки значений параметров SQL-оператора, который должен обновить кэшированные изменения записи НД. Вид соответствующего оператора выбирается из свойств InsertSQL, ModifySQL, DeleteSQL компонента TUpdateSQL и определяется параметром UpdateKind.

Применяется только при способе подтверждения изменений, использующем обработчик On UpdateRecord изменяемого набора данных.

procedure ExecSQL (UpdateKind: TUpdateKind); -

выполняет SQL-оператор для записи результатов кэшированных изменений в физическую ТБД. Вид соответствующего оператора выбирается из свойств InsertSQL, ModifySQL, DeleteSQL компонента TUpdateSQL и определяется параметром UpdateKind.

Применяется только при способе подтверждения изменений, использующем обработчик On UpdateRecord изменяемого набора данных.

procedure Apply (UpdateKind: TUpdateKind); -

объединяет в себе функциональность методов SetParams и ExecSQL. В соответствии со зныачением параметра UpdateKind определяет требуемый SQL-оператор, заносит действительные значения в параметры этого оператора и затем выполняет сам оператор.

Содержание раздела