EhLib.WinForms 0.98 Build 0.98.040 source included version.
----------------------------------------------------------

Библиотека EhLib.WinForms содержит компоненты и классы для 
Microsoft Visual Studio версии 2012, 2015 и 2017.
(Бета версия)

Бинарные файлы библиотеки (dll) скомпилированы в режиме 
совместимости с ".NET Framework 4".

ОГЛАВЛЕНИЕ
-----------------
1. С чего начать.
2. Обзор
3. Установка библиотеки
4. Демонстрационные проекты
5. Регистрация и цены
6. Контакты


-----------------
1. С чего начать.
-----------------

Начните обзор библиотеки EhLib.WinForms с основного демонстрационного 
приложения .\Demos\MainDemo\bin\Release\MainDemo.Exe
(Скомпилированные Demo проекты доступны в оценочной Trial версии библиотеки, либо в архиве
"EhLib Скомпилированная демо-версия" который можно загрузить по следующему адресу 
http://www.ehlib.com/ru/zagruzki).

Основной Демонстрационный проект библиотеки находится в 
.\Demos\MainDemo\MainDemo.csproj

Открытие, компиляция и запуск Демонстрационных проектов из папки Demos
должны работать без установки библиотеки в Visual Studio IDE.

Для установки библиотеки в IDE прочитайте раздел 2 (Установка библиотеки)

Если на этапе инсталляции возникнут проблемы, пишите письма в тех. поддержку 
на адрес support@ehlib.com

Полную инструкцию по работе с компонентами библиотеки смотрите в файле
.\Doc\RUS\"EhLib.WinForms - Руководство разработчика.doc"

--------
2. Обзор
--------

Библиотека содержит несколько элементов управления и классов для работы с 
табличными данными.

Основные элементы управления библиотеки это DataGridEh и DataVertGridEh.

Элемент управления DataGridEh
-----------------------------

Элемент управления DataGridEh представляет собой визуальный компонент (контрол) 
для отображения и редактирования данных в табличном формате.
DataGridEh можно настраивать заданием значений свойств и расширять написанием 
обработчиков событий или создавая новые типы колонок, ячеек и другие элементы
грида.
В качестве источника данных могут использоваться хранилища данных различных типов.
Грид НЕ может работать без привязки к источнику данных.

DataGridEh имеет следующие возможности:
   - Позволяет выделять записи, столбцы и прямоугольные области.
   - Позволяет копировать выделенную область в буфер обмена и заполнять 
     содержимое грида из буфера обмена.
   - Позволяет создавать специальные сложные заголовки (MultiTitle),
     которые могут занимать пространство над несколькими столбцами.
   - Позволяет создавать нижний колонтитул (footer), в котором можно 
     отображать сумму/количество/ и др. агрегированные значения полей.
   - Позволяет автоматически изменять размеров столбцов так, чтобы суммарная ширина
     столбцов всегда соответствовала ширине видимой части окна грида.
   - Позволяет настраивать высоту строк и заголовков с помощью свойств.
   - Позволяет автоматически переносить однострочные заголовки столбцов и 
     данные в строке на многострочные с автоматическим расширением высоты строк.
   - Позволяет сортировать данные при нажатии мышкой на заголовок столбца.
   - Позволяет задавать фиксированные непрокручиваемые столбцы в левой и правой 
     части грида.
   - Позволяет отображать всплывающие подсказки (ToolTips) для текста, который 
     не помещается в ячейку грида.
   - Позволяет визуально осуществлять поиск данных в источнике данных с помощью
     встроенного визуального элемента SearchBox.
   - Позволять фильтровать и выбирать элементы для фильтрации с помощью 
     встроенного визуального элемента TitleFilter.
   - Позволяет создавать столбцы динамически на основе списка свойств в 
     источнике данных.
   - Позволяет создавать статические столбцы следующих типов
       DataGridTextColumn - столбец для просмотра данных в виде текста.
       DataGridComboBoxColumn - столбец для просмотра данных в виде текста с 
         выпадающем списком.
       DataGriButtonColumn - столбец с кнопкой. 
       DataGridCheckBoxColumn - столбец для просмотра данных в виде элемента
         CheckBox.
       DataGridRadioButtonColumn - столбец для просмотра данных в виде элемента
         RadioButton.
       DataGridImageColumn - столбец для просмотра данных в виде картинки.
       DataGridProgressBarColumn - столбец для просмотра данных в виде 
         индикатора выполнения.
   - Имеет процедуры для сохранения/восстановления расположения столбцов
     (видимые столбцы, порядок следования столбцов, ширина столбца, порядок сортировки) 
     в/из классов, которые можно затем сериализовать в текстовое представление 
     для сохранения в файле настроек.
   - Имеет методы для печати и предварительного просмотра грида перед печатью.


Элемент управления DataVertGridEh
---------------------------------

Элемент управления DataVertGridEh представляет собой визуальный компонент (контрол) 
для отображения и редактирования данных в табличном формате.
В отличие от DataGridEh, DataVertGridEh отображает содержимое одной записи в
вертикальном представлении.
В текущей версии библиотеки DataVertGridEh может одновременно отображать только
одну запись на экране.
Визуально DataVertGridEh похож на элемент Windows.Forms.PropertyGrid.
Грид НЕ может работать без привязки к источнику данных.

DataVertGridEh имеет следующие возможности:
   - Позволяет автоматически изменять размеров столбцов так, чтобы суммарная ширина
     столбцов всегда соответствовала ширине видимой части окна грида.
   - Позволяет настраивать высоту строк и заголовков с помощью свойств.
   - Позволяет автоматически переносить однострочные заголовки столбцов и 
     данные в строке на многострочные с автоматическим расширением высоты строк.
   - Позволяет отображать всплывающие подсказки (ToolTips) для текста, который 
     не помещается в ячейку грида.
   - Позволяет создавать строки динамически на основе списка свойств в 
     источнике данных.
   - Позволяет создавать статические строки следующих типов
       DataVertGridTextRow - строка для просмотра данных в виде текста.
       DataGridImageRow - строка для просмотра данных в виде картинки.

----------------------
3 Установка Библиотеки
----------------------

3.1 Автоматическая установка Библиотеки
----------------------------------------

Текущая версия не содержит средств для автоматической 
установки сборок в Visual Studio.

3.2 Ручная установка Библиотеки
--------------------------------

Обратите внимание, что для запуска демонстрационных проектов из папки
.\Demos\Data
установка библиотеки в Visual Studio IDE не требуется.

Установка библиотеки в Visual Studio представляет собой 
процесс добавления компонент библиотеки в окно Toolbox, для последующего 
их перемещения на создаваемые формы ваших проектов.

Добавление компонент в окно Toolbox
----

Для добавления компонент в окно Toolbox выполните следующие действия:
   - Запустите Visual Studio.
   - Откройте окно Toolbox (Меню View-Toolbox).
   - В окне Toolbox по правой кнопке откройте контекстное меню и 
       выберите элемент "Choose items..."
   - В окне диалога "Choose Toolbox Items" на вкладке ".NET Framework Components" 
       нажмите кнопку "Browse..." 
   - В окне диалога "Open" найдите и выберите сборку "EhLib.WinForms.dll" из 
       распакованного архива библиотеки и нажмите "Open".
   - В окне "Choose Toolbox Items" должны появиться новые элементы 
       библиотеки DataGridEh, DataVertGridEh и т.д. 
   - Галочка в первом столбце напротив элементов должна быть в 
       состоянии "Checked".
   - В окне "Choose Toolbox Items" нажмите "Ok".  VisualStudio сообщит 
       об успешной установке компонент библиотеки.
   - Откройте или создайте новый проект типа Windows Forms.
   - Откройте любую форму в режиме дизайнера и проверьте, что компоненты 
     библиотеки DataGridEh, DataVertGridEh и т.д. видны в окне "Toolbox".
   - Компоненты должны появиться на закладке General.
   - Если в ваших проектах используется много сторонних компонент то, 
     для удобства работы вы можете в окне "Toolbox" создать новую закладку 
     с именем "EhLib" и перенести на нее компоненты библиотеки.

Добавление ссылок на сборки библиотеки в раздел References вашего проекта:
----

После создания проекта, добавьте ссылки на сборки EhLib.WinForms.dll и 
EhLib.WinForms.Design.dll в раздел References вашего проекта. Для сборки 
EhLib.WinForms.Design.dll в свойствах сборки укажите свойство “Copy Local” = “False” 
т.к. данная сборка не нужна в период Run-Time работы приложения.
Это предотвратит копирование сборки в папку запуска приложения 
bin\Debug (или bin\Release).

Для тестирования работы компонент в design-time и корректности работы 
ссылок на сборки перенесите контрол DataGridEh на форму вашего проекта 
и перекомпилируйте проект.

Отсутствие сборки EhLib.WinForms.Design.dll в разделе References проекта
----

Если вы не добавите ссылки на сборки EhLib.WinForms.dll и EhLib.WinForms.Design.dll 
вручную и перенесете на форму проекта один из компонент библиотеки, 
то IDE добавить ссылку вручную, но только на одну сборку - EhLib.WinForms.dll. 
В этом случае вы Design-Time функционал не заработает. Вы можете понять, что случилась 
именно подобная ситуация попытавшись в Design-Time выбрать компонент DataGridEh и 
открыть выпадающее окно Смарт-Тегов (smart tags). 
При отсутствии в ссылки на EhLib.WinForms.Design.dll значок открытия Смарт-Тегов на 
компоненте DataGridEh будет отсутствовать.
Также при добавлении контролов библиотеки на форму, они будут появляться 
под формой, в разделе невизуальных компонент, а не на форме как положено.

-----------------------------
4. Демонстрационные Проекты
-----------------------------

Демонстрационные Проекты находятся в папке 
.\Demos
Демонстрационный примеры используют таблицы из папки
.\Demos\DataFiles.

---------------------
5. Регистрация и Цены
---------------------

Текущая версия библиотеки EhLib.WinForms поставляется в составе 
библиотеки EhLib для Delphi/C++ Builder (EhLib.VCL).

----
Вы можете прочитать подробную информацию о регистрации и ценах на 
домашней странице библиотеки 
http://www.ehlib.com

----
После регистрации Вы получите адрес (только по эл.почте)
зарегистрированной версии для загрузки и пароль для распаковки.

Регистрируя библиотеку, вы также получаете следующие преимущества:

  1. Вы будете получать новые версии библиотеки бесплатно в течении года со дня покупки.
  2. Вы будете получать техническую поддержку по библиотеки 
     любого уровня сложности неограниченно по времени.
  3. Приобретая легальную версию вы способствуете дальнейшему развитию библиотеки.


6. Контакты
--------

Если у вас есть вопросы, комментарии 
или предложения, обращайтесь к разработчикам по следующим адресам.
  www: http://www.ehlib.com
  Эл.почта: support@ehlib.com
  Skype support: ehlib.support
