TbtkScriptOperationOptionsObject
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

.. pas:class:: TbtkScriptOperationOptionsObject

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

  .. pas:method:: SetCustomInactive(ActionName: String; Inactivated: Boolean)

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

    :param String ActionName:
      Имя операции присутствующей в выборке, которую необходимо сделать
      доступной или не доступной.

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

      True
        операция скрыта

      False
        операция видима.

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

    .. attention::

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

  .. pas:method:: SetCustomInactiveOperations(Operations: Array of String; Values: Array of Boolean)

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

    :param Array of String Operations:
      Массив имен операций, присутствующих в выборке, которые необходимо сделать доступными или недоступными.

    :param Array of Boolean Values:
      Массив флагов состояния доступности операций.

    .. note::
  
      Метод использует логику :pas:meth:`SetCustomInactive`, поэтому все ограничения распространяются и на этот метод.
    
    .. warning:: |not_supported|

  .. pas:method:: SetCustomDisabled(ActionName: String; Disabled: Boolean)

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

    :param String ActionName:
      Имя операции присутствующей в выборке, которую необходимо заблокировать
      или разблокировать.

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

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

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


  .. pas:method:: SetStandardDisabled(Action: TbtkDataSetDisabledStandardAct; Disabled: Boolean)

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

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

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

      dsoInsert
        вставка новых записей;

      dsoDelete
        удаление существующих записей;

      dsoEdit
        редактирование существующих записей;

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

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

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

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

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

    .. code-block:: delphi
      :caption: Пример использования

      <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>


TbtkDataSetDisabledStandardAct
...............................

.. pas:class:: TbtkDataSetDisabledStandardAct

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

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

  .. pas:attribute:: dsoCloseFormCancel

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


  .. pas:attribute:: dsoCloseFormOk

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


  .. pas:attribute:: dsoEdit

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


  .. pas:attribute:: dsoDelete

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


  .. pas:attribute:: dsoInsert

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