Функция GETFLDSTATE( )

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

Синтаксис

GETFLDSTATE(cFieldName | nFieldNumber [, cTableAlias | nWorkArea])

Параметры

cFieldName | nFieldNumber

Задает имя или номер поля, для которого будет возвращен статус редактирования. Номер поля nFieldNumber соответствует позиции поля в структуре таблицы или курсора. Для определения омера поля можно использовать команду DISPLAY STRUCTURE или функцию FIELD( ).

Можно задать 1 в качестве nFieldNumber, чтобы возвращалась символьная строка, состоящая из значений статуса удаления и редактирования для всех полей таблицы или курсора. Например, если в таблице пять полей и редактировалось только первое поле, функция GETFLDSTATE( ) возв атит следующее:

121111

Значение 1 в первой позиции указывает, что статус удаления не изменился.

Можно также задать 0 в качестве nFieldNumber, чтобы определить, изменился ли статус удаления для текущей записи с тех пор, как была открыта таблица или курсор.

Замечание Функция GETFLDSTATE( ) позволяет определить только то, изменился ли статус у аления для текущей записи. Например, если пометить запись для удаления и затем отменить удаление, GETFLDSTATE( ) укажет, что статус удаления изменился, есмотря на то, что он в итоге вернулся в первоначальное состояние. Определить текущий статус удаления записи можно с помощью функции DELETED( ).

cTableAlias

Задает псевдоним таблицы или курсора, для которых будет возвращен статус ре актирования поля или удаления записи.

nWorkArea

Задает рабочую область таблицы или курсора, для которых будет возвращен статус редактирования поля или удаления записи.

Если ни псевдоним, ни рабочая область не заданы, GETFLDSTATE( ) возвращает з ачение статуса для поля в выбранной таблице или курсоре.

Результат

Числовой

Комментарии

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

Возвращаемое значение	Статус редактирования или удаления
1	Поле не редактировалось или статус удаления не изменился.
2	Поле редактировалось или статус удаления изменился.
3	Поле в добавленной записи не редактировалось или статус удаления для присоеди енной записи не изменился.
4	Поле в добавленной записи редактировалось или статус удаления для добавленной записи изменился.

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

Если функция GETFLDSTATE( ) выдана без необязательных аргументов cTableAlias или nWorkArea, возвращается статус редактирования или удаления для таблицы или курсора, отк ытого в выбранной в данный момент рабочей области.