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: Ранее данный метод изменял не видимость операций, а активность, что не только скрывало операции с панелей инструментов и меню, но и запрещало их выполнение. Причиной отказа от старого поведения послужили сторонние эффекты при смене активности, такие как перестроение панелей инструментов и т.п.

SetCustomInactiveOperations(Operations: Array of String; Values: Array of Boolean)¶

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

Parameters:	of String Operations (Array) – Массив имен операций, пристуствующих в выборке, которые необходимо сделать доступными или недоступными. of Boolean Values (Array) – Массив флагов состояния доступности операций.

Note

Метод использует логику SetCustomInactive(), поэтому все ограничения распространяются и на этот метод.

Changed in version 5.12.0_ms_9.

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

SetCustomDisabled(ActionName: String; Disabled: Boolean)¶

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

Parameters:

ActionName (String) – Имя операции присутствующей в выборке, которую необходимо заблокировать или разблокировать.
Disabled (Boolean) –
Флаг состояния блокировки операции. Может принимать значения:

True
операция заблокирована

False
операция не заблокирована (разрешена)

SetStandardDisabled(Action: TbtkDataSetDisabledStandardAct; Disabled: 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¶: Стандартная операция вставки новых записей.