
.. include:: RESOURCE.rst    

.. index:: Общие элементы управления

==================================================
Общие элементы управления
==================================================

  * :ref:`Основные понятия<total>`
  * :ref:`Таблицы<table_work>`
  * :ref:`Поверхности<surface_type_info>`
  * :ref:`Команды управления областью отображения графиков<toolmanager>`
  
.. НАДО ЛИ ГДЕ-ТО ОПИСЫВАТЬ, КАК ВЫГЛЯДИТ BLN ФАЙЛ??????????????

  
.. _total:  


----------------------------------------
Основные понятия
----------------------------------------

Виджет - элемент управления пользовательским интерфейсом высокого уровня.

- |check|, |uncheck| - чекбокс;
- |combobox| - комбобокс или список выбора значения;
- |slider| - слайдер, элемент управления для изменения данных внутри некоторого диапазона;
- |lineedit| - строка ввода данных;
- |spinbox| - спинбокс или 
  поле ввода числовых данных с возможностью перемещения внутри некоторого диапазона;
- |radiobutton| - радиокнопка или кнопка выбора эксклюзивного режима.
  

.. _table_work:

--------------------------------------------------
Таблицы
--------------------------------------------------

.. _table_example_image:
.. figure:: pictures\\table_widget.png
            :align: center
            :scale: 100%
            
            Пример таблицы
            
            
Создать строку в таблице можно:
  1. нажатием мыши в область таблицы, где нет строк;
  2. кнопкой |add|.
  
Удалить выбранную строку из таблицы можно:
  1. кнопкой |table_remove|;
  2. командой *Контекстное меню* | *Удалить*.

Добавить изолинию в :ref:`таблице<2dvisual_ref>` можно:
  1. нажатием кнопки |add_izo| :numref:`(Рис. %s)<table_examp_image>`, после чего откроется диалоговое окно "Добавить изолинию" :numref:`(Рис. %s)<table_exa_image>` в котором необходимо ввести "Значение".  
  
      .. _table_examp_image:
      .. figure:: pictures\\vis2d\\add_izo.png
            :align: center
            :scale: 100%
        
            Пример таблицы с добавлением изолинии  
			
      .. _table_exa_image:
      .. figure:: pictures\\vis2d\\add_izoline.png
            :align: center
            :scale: 100%
        
            Диалоговое окно "Добавить изолинию" 			
  
**Показать/скрыть график временных зависимостей** можно с помощью **|>>|** / **|<<|**

  
Контекстное меню:

  .. figure:: pictures\\sako_table_widget.png
        :align: center
        :scale: 100%
        
        Пример таблицы
    
  * «Реверс» - записывает данные таблицы в обратном порядке;
  * «Очистить таблицу» - команда удаления таблицы целиком;
  * «:ref:`Загрузить данные из файла<importFile>`»;
  * «Вставить данные из буфера в таблицу» - вставить в таблицу скопированные данные из стороннего файлов.. 

    
Вызвать контекстное меню можно правой кнопкой мыши.

Перейти к редактированию поля таблицы можно двойным щелчком мыши.

Выбрать строку таблицы можно, нажав левой кнопкой мыши на номер строки таблицы, 
выбрать столбец, - нажав на его заголовок.

Если кликнуть левой кнопкой мыши по заголовку столбца таблицы,
затем кликнуть правой кнопкой мыши, 
откроется контекстное меню с командами :numref:`(Рис. %s)<table_image>`:

  * **Заменить значение столбца** - установить новое значение для каждого элемента выбранного столбца;
  * **Оставить только 2 знака после запятой** - все числовые значения будут с 2 знаками после запятой;
  * **Преобразовать в научный формат (E)** - все числовые значения будут преобразованы в формат типа "1.25е-10" или "2.2646е+04";
  * **Разделить на заданное значение** - разделить значение для каждого элемента выбранного столбца на заданное число;
  * **Прибавить заданное значение** - прибавить к значению каждого элемента выбранного столбца заданное значение;
  * **Умножить на заданное значение** - умножить значение каждого элемента выбранного столбца на заданное значение;
  * **Отсортировать по возрастанию** - сортировать значения в выбранном столбце по возрастанию;
  * **Отсортировать по убыванию** - сортировать значения в выбранном столбце по убыванию;
  * **Сохранить таблицу в CSV** - сохранение таблицы в формат :strong:`*.csv`;
  * **Создать N строк** - команда создания нужного количества строк;
  * **Копировать параметры сверху в новую строку** |check|/|uncheck| - копировать/не копировать параметры в новую строку из предыдущей;
  * **Авторастяжение последнего столбца** |check|/|uncheck| - включить/выключить растягивание последнего столбца;
  * **Авторастяжение столбцов** |check|/|uncheck| - включить/выключить растягивание столбцов автоматически.
  

.. _table_image:  
.. figure:: pictures\\sako_point.png
            :align: center
            :scale: 100%
            
            Контекстное меню с командами    
    


.. note::

    * Разделителем для вещественных чисел в таблице является « . » (точка).

    * Если столбец таблицы заполнен чекбоксами или комбобоксами, 
      то команд *Прибавить заданное значение*, *Умножить на заданное значение*,
      *Разделить на заданное значение* в меню не будет. Если столбец заполнен чекбоксами, 
      команда *Заменить значение столбца* снимает/установит галочки во всем столбце, если комбобоксами - установить во всем столбце одинаковое значение из комбобокса.
 
.. _importFile:
 
----------------------------
Импорт данных в таблицу
----------------------------
   
Загрузить данные можно из файла формата: TXT, CSV, XLSX. 
После выбора файла на экране появится диалог :numref:`(Рис. %s)<import_from_csv_image>`. 
В диалоге необходимо указать соответствие столбцов из файла столбцам таблицы.

Для этого можно использовать вспомогательные функции:

 * **Номера первой и последней строк**. Позволяет выбрать нужный диапазон  импорта строк.
 * **Взять заголовки из файла**. Если столбцы в файле имеют названия эта 
   функция поможет упростить расстановку соответствий.
   При использовании данной функции уменьшается диапазон строк файла, которые будут использоваться для разбора. 
   (номер первой строки для разбора увеличивается)
 * **Расставить ключи**. Эта функция расставляет соответствия в автоматическом порядке.
 * **Заменить запятые на точки**. Если в файле десятичным разделителем являются запятые,
   то нужно отметить поле «заменить запятые на точки», для корректного импорта данных.

А также в зависимости от формата файла пользователь может выбрать:

 * XLSX какой лист таблицы необходимо импортировать, 
 * CSV кодировку текста и вид разделителя данных, 
 * TXT вид разделителя данных.

 
	.. figure:: pictures\\csv_file_for_table.png
                :align: center
                :scale: 100%
        
                Пример CSV файла

        
    .. _import_from_csv_image:
    .. figure:: pictures\\import_from_csv.png
                :align: center
                :scale: 100%
                
                Диалог импорта данных из XLSX файла в таблицу    
    

	
.. _surface_type_info:
    
---------------------------------------------------------
Поверхности
---------------------------------------------------------

В препроцессоре можно работать с поверхностями следующих типов:

  #. поверхность задается уравнением *Z = Const* (или *Постоянное*);
  #. поверхность типа *2D карта* (или *Значение в узлах 2d карты*) - задается уравнением 
     *Z = f(x,y)*, где *f* - функция, заданная на регулярной прямоугольной сетке :numref:`(Рис. %s)<sako_image>`;
     
     .. _sako_image:
     .. figure:: pictures\\sako_surface.png
            :align: center
            :scale: 100%
            
            Диалоговое окно задания параметров поверхности 
     
     При работе с ГУ добавляется еще один тип:    
     
  #. *Зависит от времени* - поверхность, меняющая аппликату во времени :numref:`(Рис. %s)<sako_time_image>`.

     .. _sako_time_image:
     .. figure:: pictures\\sako_time_perem.png
            :align: center
            :scale: 100%
            
            Диалоговое окно управления параметрами 
  

    
.. _toolmanager:
    
-----------------------------------------------------------------
Команды управления областью отображения графиков
-----------------------------------------------------------------
    
+---------------------+-------------------------------------------------------------------------------------+
| |original_view1|    | отменить масштабирование области отображения                                        |  
+---------------------+-------------------------------------------------------------------------------------+
| |zoom|              | масштабировать область отображения                                                  |  
+---------------------+-------------------------------------------------------------------------------------+  
| |move|              | переместить график                                                                  |  
+---------------------+-------------------------------------------------------------------------------------+
| |bound|             | установить границы отображения                                                      |  
+---------------------+-------------------------------------------------------------------------------------+
| |save_png|          | сохранить область отображения в виде PNG изображения                                |  
+---------------------+-------------------------------------------------------------------------------------+  
    
.. include:: 3d_scene.rst
    