1.8.23. TbtkScriptOperationOptionsObject

class TbtkScriptOperationOptionsObject

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

SetCustomInactive(ActionName: String; Inactivated: Boolean)

Метод предназначен для управления видимостью пользовательской операции. Т.е. после вызова Selection.OperationOptions.SetCustomInactive('MyOperation', true); операция исчезнет с панели управления и из меню.

Parameters:
  • ActionName (String) -- Имя операции присутствующей в выборке, которую необходимо сделать доступной или не доступной.
  • Inactivated (Boolean) --

    Флаг состояния доступности операции. Может принимать значения:

    True
    операция скрыта
    False
    операция видима.

Note

Для сохранения обратной совместимости реализовано следующее поведение: при вызове SetCustomInactive с флагом False, если операция изначально пришла из метаданных неактивной (со значением свойства "Флаг активности операции" равным False), то она активируется. Такое поведение актуально только для неархивного режима загрузки метаданных, т.к. в архивном режиме неактивные операции не высылаются на клиент.

Attention

Существует ограничение на использование данного метода: метод нельзя использовать в операциях, которые выполняются вследствие нажатия на кнопку панели управления. Ограничение актуально для случая, когда метод активирует изначально неактивную операцию.

Changed in version 5.6.8.4630: Ранее данный метод изменял не видимость операций, а активность, что не только скрывало операции с панелей инструментов и меню, но и запрещало их выполнение. Причиной отказа от старого поведения послужили сторонние эффекты при смене активности, такие как перестроение панелей инструментов и т.п.

SetCustomDisabled(AActionName: String; ADisabled: Boolean)

Метод запрещает или разрешает стандартную операцию AActionName, в зависимости от значения флага ADisabled

Parameters:
  • AActionName (String) -- Имя операции присутствующей в выборке, которую необходимо заблокировать или разблокировать.
  • ADisabled (Boolean) --

    Флаг состояния блокировки операции. Может принимать значения:

    True
    операция заблокирована
    False
    операция не заблокирована (разрешена)
SetStandardDisabled(AAction: TbtkDataSetDisabledStandardAct; ADisabled: Boolean)

Метод запрещает или разрешает стандартную операцию Action, в зависимости от значения флага Disabled.

При этом если запрещается операция “редактирование” (SetStandardDisabled(dsoEdit, True)), изменения свойства ReadOnly у полей выборки не скажутся на возможности редактирования до снятия блокировки с операции SetStandardDisabled(dsoEdit, False).

Parameters:
  • Action (TbtkDataSetDisabledStandardAct) --

    Стандартная операция. Может принимать следующие значения:

    dsoInsert
    вставка новых записей;
    dsoDelete
    удаление существующих записей;
    dsoEdit
    редактирование существующих записей;
    dsoCloseFormOk
    операция закрытия формы с подтверждением выбора;
    dsoCloseFormCancel
    операция закрытия формы по кнопке "Выход" или по кнопке закрытия окна «крестик».
  • Disabled (Boolean) --

    Флаг состояния блокировки операции. Может принимать значения:

    True
    операция заблокирована
    False
    операция не заблокирована (разрешена)
Пример использования
<pascal>
Selection.OperationOptions.SetStandardDisabled(dsoInsert, True);
// запретить вставку

Selection.OperationOptions.SetStandardDisabled(dsoEdit, False);
// разрешить редактирование

Selection.SetFieldsReadOnly('FooField1', False);
SetVar('FooField1', 'some value');
// Не приведет к ошибке. Поле будет изменено

Selection.OperationOptions.SetStandardDisabled(dsoEdit, True);
SetVar('FooField1', 'some value');
// Приведет к ошибке так как запрещено редактирование

Selection.SetFieldsReadOnly('FooField1', True);
Selection.OperationOptions.SetStandardDisabled(dsoEdit, False);
SetVar('FooField1', 'some value');
// Приведет к ошибке, так как поле ReadOnly
</pascal>

1.8.23.1. TbtkDataSetDisabledStandardAct

class TbtkDataSetDisabledStandardAct

Перечисление

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

dsoCloseFormCancel

Стандартная операция закрытия формы по кнопке "Выход" или по кнопке закрытия окна «крестик».

dsoCloseFormOk

Стандартная операция закрытия формы с подтверждением выбора.

dsoEdit

Стандартная операция редактирования существующих записей.

dsoDelete

Стандартная операция удаления существующих записей.

dsoInsert

Стандартная операция вставки новых записей.