Выборка
----------------------------------------------------------------------

.. pas:function:: Selection(): TbtkScriptSelectionObject

  Доступ к объекту выборки текущего контекста.

  :rtype: TbtkScriptSelectionObject


.. pas:function:: CreateSelection(): TbtkScriptSelectionObject

  Создает экземпляр выборки.

  :rtype: TbtkScriptSelectionObject


.. pas:function:: FindSelection(EntityName: Variant): TbtkScriptSelectionObject

  Ищет выборку на текущей форме по системному имени выборки.

  :param Variant EntityName:
    Системное имя выборки

  :rtype: TbtkScriptSelectionObject


.. pas:function:: FindSelectionEx(EntityName: String; ParamNames, ParamValues: Array): TbtkScriptSelectionObject

  Ищет выборку на активной форме по системному имени выборки и
  отображению.

  :param String EntityName:
    Системное имя выборки

  :param Array ParamNames:
    В качестве параметров метод может принимать *"Representation"*,
    *"FindChild"*, *"PrevSelection"*. Первый параметр задает отображение,
    второй - задает поиск выборки только на текущем фрейме и компонентах
    расположенных на нем.

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

  :param Array ParamValues:
    Массив значений параметров

  :rtype: TbtkScriptSelectionObject

  .. code-block:: delphi
    :caption: Пример перебора всех выборок с одним именем:

    <PASCAL>
      sel := FindSelectionEx('SEL_EO_ACCVALGRID', ['Representation'],['TRANSGRIDBYVD']);  //ищем первую выборку

      while Assigned(Sel) do // перебираем все выборки с именем SEL_EO_ACCVALGRID.TRANSGRIDBYVD
      begin
        sel := FindSelectionEx('SEL_EO_ACCVALGRID', ['Representation','PrevSelection'],['TRANSGRIDBYVD',sel]);
      end;
    </PASCAL>

.. toctree::
  :maxdepth: 1

  fast_access.rst
  client_lib.rst
  list_control.rst