GIS-Lab - Вклад [ru]

Расширение функциональности MapInfo на основе SmartPanels

2018-04-09T09:18:28Z

Wasposa:

{{Статья|Опубликована|mapinfo-smartpanels}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}

==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.

С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами по их настройке, удалению и добавлению в SmartPanels. Второй пункт отвечает за отображение списка всех зарегистрированных панелей, позволяет их показывать или скрывать. 

[[Image:SmartPanels_img10a.png|450px|center|Меню SmartPanels в Mapinfo до 16 версии]]
[[Image:SmartPanels_img10b.png|450px|center|Меню SmartPanels в Mapinfo в 16 версии]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio. Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Image:SmartPanels_img11.png|center|frame|Настройка загрузчика MSVisualStudio]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта:'' Файл – Проект – Cоздать – Библиотека классов (.NET Framework)''

[[Image:SmartPanels_img12.png|center|frame|Общий вид меню «Создание проекта».]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
Свойства:
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически сохранять и восстанавливать при запуске.
Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.

Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Image:SmartPanels_img13.png|center|frame|Класс CloneLayout.]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и одну кнопку. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Image:SmartPanels_img15.png|center|frame|Пользовательские элементы управления.]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:

<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Image:SmartPanels_img16.png|center|frame|Измененный класс CloneLayout.]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Image:SmartPanels_img17.png|750px|center|Добавление созданного плагина]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Image:SmartPanels_img18.png|center|frame|Новый плагин в MapInfo]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Image:SmartPanels_img19.png|center|frame|Измененный класс LayoutControl]]

После сборки решения открываем MapInfo и проверяем результат.

[[Image:SmartPanels_img20.png|center|frame|Плагин в действии]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Файл:Poland.png

2018-03-29T10:35:37Z

Wasposa:

Расширение функциональности MapInfo на основе SmartPanels

2018-03-28T06:01:08Z

Wasposa: /* Заключение */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами по их настройке, удалению и добавлению в SmartPanels. Второй пункт отвечает за отображение списка всех зарегистрированных панелей, позволяет их показывать или скрывать. 

[[Image:SmartPanels_img10a.png|450px|center|Меню SmartPanels в Mapinfo до 16 версии]]
[[Image:SmartPanels_img10b.png|450px|center|Меню SmartPanels в Mapinfo в 16 версии]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio. Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Image:SmartPanels_img11.png|center|frame|Настройка загрузчика MSVisualStudio]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта:'' Файл – Проект – Cоздать – Библиотека классов (.NET Framework)''

[[Image:SmartPanels_img12.png|center|frame|Общий вид меню «Создание проекта».]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
Свойства:
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически сохранять и восстанавливать при запуске.
Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.

Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Image:SmartPanels_img13.png|center|frame|Класс CloneLayout.]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и одну кнопку. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Image:SmartPanels_img15.png|center|frame|Пользовательские элементы управления.]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:

<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Image:SmartPanels_img16.png|center|frame|Измененный класс CloneLayout.]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Image:SmartPanels_img17.png|750px|center|Добавление созданного плагина]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Image:SmartPanels_img18.png|center|frame|Новый плагин в MapInfo]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Image:SmartPanels_img19.png|center|frame|Измененный класс LayoutControl]]

После сборки решения открываем MapInfo и проверяем результат.

[[Image:SmartPanels_img20.png|center|frame|Плагин в действии]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T14:13:44Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами по их настройке, удалению и добавлению в SmartPanels. Второй пункт отвечает за отображение списка всех зарегистрированных панелей, позволяет их показывать или скрывать. 

[[Image:SmartPanels_img10a.png|450px|center|Меню SmartPanels в Mapinfo до 16 версии]]
[[Image:SmartPanels_img10b.png|450px|center|Меню SmartPanels в Mapinfo в 16 версии]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio. Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Image:SmartPanels_img11.png|center|frame|Настройка загрузчика MSVisualStudio]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта:'' Файл – Проект – Cоздать – Библиотека классов (.NET Framework)''

[[Image:SmartPanels_img12.png|center|frame|Общий вид меню «Создание проекта».]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
Свойства:
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически сохранять и восстанавливать при запуске.
Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.

Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Image:SmartPanels_img13.png|center|frame|Класс CloneLayout.]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и одну кнопку. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Image:SmartPanels_img15.png|center|frame|Пользовательские элементы управления.]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:

<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Image:SmartPanels_img16.png|center|frame|Измененный класс CloneLayout.]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Image:SmartPanels_img17.png|750px|center|Добавление созданного плагина]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Image:SmartPanels_img18.png|center|frame|Новый плагин в MapInfo]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Image:SmartPanels_img19.png|center|frame|Измененный класс LayoutControl]]

После сборки решения открываем MapInfo и проверяем результат.

[[Image:SmartPanels_img20.png|center|frame|Плагин в действии]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T14:09:35Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами по их настройке, удалению и добавлению в SmartPanels. Второй пункт отвечает за отображение списка всех зарегистрированных панелей, позволяет их показывать или скрывать. 

[[Image:SmartPanels_img10a.png|450px|center|Меню SmartPanels в Mapinfo до 16 версии]]
[[Image:SmartPanels_img10b.png|450px|center|Меню SmartPanels в Mapinfo в 16 версии]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio. Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Image:SmartPanels_img11.png|center|frame|Настройка загрузчика MSVisualStudio]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта:'' Файл – Проект – Cоздать – Библиотека классов (.NET Framework)''

[[Image:SmartPanels_img12.png|center|frame|Общий вид меню «Создание проекта».]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
Свойства:
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически сохранять и восстанавливать при запуске.
Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.

Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Image:SmartPanels_img13.png|center|frame|Класс CloneLayout.]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и одну кнопку. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Image:SmartPanels_img15.png|center|frame|Пользовательские элементы управления.]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:

<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Image:SmartPanels_img16.png|center|frame|Измененный класс CloneLayout.]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Image:SmartPanels_img17.png|400px|center|Добавление созданного плагина]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Image:SmartPanels_img18.png|center|frame|Новый плагин в MapInfo]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T14:01:52Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами по их настройке, удалению и добавлению в SmartPanels. Второй пункт отвечает за отображение списка всех зарегистрированных панелей, позволяет их показывать или скрывать. 

[[Image:SmartPanels_img10a.png|450px|center|Меню SmartPanels в Mapinfo до 16 версии]]
[[Image:SmartPanels_img10b.png|450px|center|Меню SmartPanels в Mapinfo в 16 версии]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio. Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Image:SmartPanels_img11.png|center|frame|Настройка загрузчика MSVisualStudio]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта:'' Файл – Проект – Cоздать – Библиотека классов (.NET Framework)''

[[Image:SmartPanels_img12.png|center|frame|Общий вид меню «Создание проекта».]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
Свойства:
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически сохранять и восстанавливать при запуске.
Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.

Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Image:SmartPanels_img13.png|center|frame|Класс CloneLayout.]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и одну кнопку. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Image:SmartPanels_img15.png|center|frame|Пользовательские элементы управления.]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:

<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T13:58:25Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами по их настройке, удалению и добавлению в SmartPanels. Второй пункт отвечает за отображение списка всех зарегистрированных панелей, позволяет их показывать или скрывать. 

[[Image:SmartPanels_img10a.png|450px|center|Меню SmartPanels в Mapinfo до 16 версии]]
[[Image:SmartPanels_img10b.png|450px|center|Меню SmartPanels в Mapinfo в 16 версии]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio. Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Image:SmartPanels_img11.png|center|frame|Настройка загрузчика MSVisualStudio]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта:'' Файл – Проект – Cоздать – Библиотека классов (.NET Framework)''

[[Image:SmartPanels_img12.png|center|frame|Общий вид меню «Создание проекта».]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
Свойства:
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически сохранять и восстанавливать при запуске.
Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.

Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Image:SmartPanels_img13.png|center|frame|Общий вид меню «Создание проекта».]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T13:48:46Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами по их настройке, удалению и добавлению в SmartPanels. Второй пункт отвечает за отображение списка всех зарегистрированных панелей, позволяет их показывать или скрывать. 

[[Image:SmartPanels_img10a.png|450px|center|Меню SmartPanels в Mapinfo до 16 версии]]
[[Image:SmartPanels_img10b.png|450px|center|Меню SmartPanels в Mapinfo в 16 версии]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio. Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Image:SmartPanels_img11.png|frame|Настройка загрузчика MSVisualStudio]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Image:SmartPanels_img12.png|frame|Общий вид меню «Создание проекта».]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T13:47:15Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами по их настройке, удалению и добавлению в SmartPanels. Второй пункт отвечает за отображение списка всех зарегистрированных панелей, позволяет их показывать или скрывать. 

[[Image:SmartPanels_img10a.png|450px|center|Меню SmartPanels в Mapinfo до 16 версии]]
[[Image:SmartPanels_img10b.png|450px|center|Меню SmartPanels в Mapinfo в 16 версии]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio. Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Image:SmartPanels_img11.png|450px|center|frame|Настройка загрузчика MSVisualStudio]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T13:39:35Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами по их настройке, удалению и добавлению в SmartPanels. Второй пункт отвечает за отображение списка всех зарегистрированных панелей, позволяет их показывать или скрывать. 
<gallery>
Изображение:SmartPanels_img10a.png|450px|center|frame|Меню SmartPanels‎
Изображение:SmartPanels_img10b.png‎|450px|center|frame|Меню SmartPanels‎
</gallery>
Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Файл:SmartPanels img10b.png

2018-03-27T13:36:54Z

Wasposa:

Файл:SmartPanels img10a.png

2018-03-27T13:36:04Z

Wasposa:

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T13:24:57Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T13:24:06Z

Wasposa: /* Описание */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Файл:SPInstaller64.zip

2018-03-27T13:23:43Z

Wasposa:

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T13:22:28Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T13:21:06Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]] для 32 разрядной версии и [[Медиа:SPInstaller64.zip]] для 64 разрядной. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T13:17:29Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [[Медиа:SPInstaller32.zip‎]]. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Файл:SPInstaller32.zip

2018-03-27T13:04:30Z

Wasposa: Установщик SartPanels. 32 разрядная версия

Установщик SartPanels. 32 разрядная версия

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T12:58:38Z

Wasposa: /* Примеры реализации */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Изображение:SmartPanels_img1.png|800px|center|frame|Вкладки документов и прикрепляемые панели.]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Изображение:SmartPanels_img2.png|800px|center|frame|Вид окна "Информация" SmaprtPanels.]]

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

[[Изображение:SmartPanels_img3.png|800px|center|frame|Настройка окна "Информация"]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Изображение:SmartPanels_img4.png|800px|center|frame|Выбранный населенный пункт (ОКАТО) в центре карты.]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Изображение:SmartPanels_img5.png|800px|center|frame|Представление результатов переписи населения в иерархическом списке.]]

[[Изображение:SmartPanels_img6.png|800px|center|frame|Представление результатов переписи населения в виде круговой диаграммы.]]

[[Изображение:SmartPanels_img7.png|800px|center|frame|Представление результатов переписи населения в виде столбчатой диаграммы.]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Изображение:SmartPanels_img8.png|800px|center|frame|Использование панорамы Yandex.]]

[[Изображение:SmartPanels_img9.png|800px|center|frame|Использование панорамы Google.]]

===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [http://www.mapinfo.ru/product/mapinfo-plugin]. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T11:31:47Z

Wasposa: /* Примеры реализации */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo. Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее.<ref>в MapInfo 16 версии это уже штатный функционал, но и режим отображения окон документов только один – "во все окно".</ref> Вторым дополнением к пользовательскому интерфейсу <ref>Данная возможность обеспечивается непосредственно SmartPanels</ref> является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Файл:SmartPanels_img1.png]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Файл:SmartPanels_img2.png]]

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

[[Файл:SmartPanels_img3.png]]
Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Файл:SmartPanels_img4.png]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Файл:SmartPanels_img5.png]]

[[Файл:SmartPanels_img6.png]]

[[Файл:SmartPanels_img7.png]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Файл:SmartPanels_img8.png]]

[[Файл:SmartPanels_img9.png]]
===Примечания===
<references/>

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [http://www.mapinfo.ru/product/mapinfo-plugin]. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T11:21:01Z

Wasposa: /* Описание */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.


С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo.
Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее (в MapInfo 16 версии это уже штатный функционал, но там и режим отображения окон документов только один – во все окно). Вторым дополнением к пользовательскому интерфейсу, но который обеспечивает непосредственно SmartPanels, является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Файл:SmartPanels_img1.png]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Файл:SmartPanels_img2.png]]

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

[[Файл:SmartPanels_img3.png]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Файл:SmartPanels_img4.png]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Файл:SmartPanels_img5.png]]

[[Файл:SmartPanels_img6.png]]

[[Файл:SmartPanels_img7.png]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Файл:SmartPanels_img8.png]]

[[Файл:SmartPanels_img9.png]]

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [http://www.mapinfo.ru/product/mapinfo-plugin]. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T11:20:09Z

Wasposa: /* Описание */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления.<ref>В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести новые или изменить расположение существующих элементов управления.</ref>
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.
С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП.<ref> Официальный дистрибьютер MapInfo в России и СНГ</ref> Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.
====Примечания====
<references/>

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo.
Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее (в MapInfo 16 версии это уже штатный функционал, но там и режим отображения окон документов только один – во все окно). Вторым дополнением к пользовательскому интерфейсу, но который обеспечивает непосредственно SmartPanels, является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Файл:SmartPanels_img1.png]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Файл:SmartPanels_img2.png]]

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

[[Файл:SmartPanels_img3.png]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Файл:SmartPanels_img4.png]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Файл:SmartPanels_img5.png]]

[[Файл:SmartPanels_img6.png]]

[[Файл:SmartPanels_img7.png]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Файл:SmartPanels_img8.png]]

[[Файл:SmartPanels_img9.png]]

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [http://www.mapinfo.ru/product/mapinfo-plugin]. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-27T11:03:20Z

Wasposa: /* Описание */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.

MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления. В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести еще один или изменить расположение существующих;
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.
С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.

Разработчиками предпринимались различные попытки обойти ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MSAccess с использованием MapX, динамическое связывание MapInfo и MSAccess посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был. Однако для его использования необходимо было быть специалистом в C++, а точнее хорошо разбираться в тонкостях создания библиотек DLL (разработка, подключение их в MapBasic, вызов из них внешних подпрограммы и пр.) что, согласитесь, для прикладного программиста MapBasic не является характерным.

Ситуация изменилась коренным образом с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП . Разработка данной утилиты стала возможной, благодаря переходу MapInfo начиная с версии 9.5 на платформу Microsoft .NET. С помощью этой утилиты стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. Утилита является, как бы, посредником между MapInfo и внешним приложением. При этом для разработки прикладного решения не требуется установленного компилятора MapBasic. Все что нужно–это установленная утилита SmartPanel и среда разработки MSVisualStudio.

==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo.
Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее (в MapInfo 16 версии это уже штатный функционал, но там и режим отображения окон документов только один – во все окно). Вторым дополнением к пользовательскому интерфейсу, но который обеспечивает непосредственно SmartPanels, является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Файл:SmartPanels_img1.png]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Файл:SmartPanels_img2.png]]

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

[[Файл:SmartPanels_img3.png]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Файл:SmartPanels_img4.png]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Файл:SmartPanels_img5.png]]

[[Файл:SmartPanels_img6.png]]

[[Файл:SmartPanels_img7.png]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Файл:SmartPanels_img8.png]]

[[Файл:SmartPanels_img9.png]]

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [http://www.mapinfo.ru/product/mapinfo-plugin]. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Расширение функциональности MapInfo на основе SmartPanels

2018-03-22T07:07:50Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.
MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления. В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести еще один или изменить расположение существующих;
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.
С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.
Предпринимались различные попытки обойти указанные ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MS Access с использованием MapX, динамическое связывание MapInfo и MS Access посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был, но необходимо было быть специалистом в тонкостях создания библиотек DLL, подключения их в MapBasic, вызовам из них внешних подпрограмм и т.п., что, согласитесь, для прикладного программиста MapBasic не является характерным.
Данная ситуация продолжалось до тех пор, пока не вышла версия MapInfo 9.5, которая была реализована уже на платформе .NET. В соответствующей версии MapBasic была реализована поддержка данной платформы. Но всё равно задача создания и подключения внешних библиотек оставалась нетривиальной.
Все изменилось с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП, которая является официальным дистрибьютером MapInfo в России и СНГ. С её помощью стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. SmartPanels служит своеобразным посредником между MapInfo и внешним приложением. Для разработки прикладного решения не требуется установленного компилятора MapBasic, все что необходимо - это установленная утилита SmartPanel и среда разработки MS Visual Studio.
==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo.
Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее (в MapInfo 16 версии это уже штатный функционал, но там и режим отображения окон документов только один – во все окно). Вторым дополнением к пользовательскому интерфейсу, но который обеспечивает непосредственно SmartPanels, является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Файл:SmartPanels_img1.png]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Файл:SmartPanels_img2.png]]

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

[[Файл:SmartPanels_img3.png]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Файл:SmartPanels_img4.png]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Файл:SmartPanels_img5.png]]

[[Файл:SmartPanels_img6.png]]

[[Файл:SmartPanels_img7.png]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Файл:SmartPanels_img8.png]]

[[Файл:SmartPanels_img9.png]]

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [http://www.mapinfo.ru/product/mapinfo-plugin]. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio.

Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

[[Файл:SmartPanels_img17.png|700px|||описание]]

К сожалению, существует особенность, при которой необходимо перезагружать MapInfo (или SamrtPanels) после установки нового плагина. После перезагрузки в списке установленных плагинов появится новый плагин.

[[Файл:SmartPanels_img18.png|700px|||описание]]

Теперь реализуем взаимодействие с MapInfo. В класс LayoutControl.cs добавим реализацию метода, который будет опрашивать MapInfo на предмет открытых окон и их типа. Если тип окна «Отчет», то имя окна и его ID будет добавляться в список формы. Для этого будем использовать метод <code>MiHost.MB.GetWindows</code>, возвращающий коллекцию всех открытых в MapInfo окон. Этот метод может получать в качестве параметра фильтр <code>MbCommands.MiWindowInfo.WindowTypeFilter</code>, который будет указывать SmartPanels возвращать окна только определенного типа.
<syntaxhighlight lang="java">
private void fillList() {
listLayout.Items.Clear();
foreach (var lw in MiHost.MB.GetWindows(MbCommands.MiWindowInfo.WindowTypeFilter.WIN_LAYOUT)) {
listLayout.Items.Add(string.Format("{0}#{1}", lw.WindowID, lw.WindowName));
}
//Пусть последний элемент списка всегда будет выделенным
if (listLayout.Items.Count>0) {
listLayout.SelectedIndex = listLayout.Items.Count - 1;
}
}
</syntaxhighlight>
Хотя SmartPanels и имеет развитый программный интерфейс (API), в большинстве случаев, можно обойтись всего двумя командами - <code>MiHost.MB.EvalCommand</code> и <code>MiHost.MB.EvalCommandX</code>, где X обозначает тип возвращаемого значения (EvalCommandS – для String, EvalCommandI – для Integer и т.п.), первая команда просто выполняет команду, а вторая еще и возвращает полученное значение. На следующем шаге создадим метод, вызываемый при нажатии на кнопку «Клонировать». Данный метод будет определять активный элемент списка и засылать в MapInfo команду на дублирование этого окна.
<syntaxhighlight lang="java">
private void btnClone_Click(object sender, EventArgs e)
{
if (listLayout.SelectedItem != null)
{
string item = listLayout.SelectedItem.ToString();
string idWin = item.Substring(item.IndexOf("#")+1);
//Засылаем в MI команду на клонирование окна
MiHost.MB.EvalCommand("Run Command WindowInfo("+idWin+", 15)");
}
}
</syntaxhighlight>
Осталось только определить, как будет обновляться список отчетов. Для этого попросим MapInfo присылать сообщение при открытии или закрытии окон. При получении такого сообщения будем обновлять список отчетов.
<syntaxhighlight lang="java">
public LayoutControl()
{
InitializeComponent();
//Будем следить за новыми окнами в MI
MiHost.AddDocumentWindow += MI_NewWin;
//и за закрытыми окнами в MI
MiHost.RemoveDocumentWindow+= MI_RemoveWin;
}
void MI_NewWin(object sender, EventArgs e) {
fillList();
}
void MI_ RemoveWin(object sender, EventArgs e)
{
fillList();
}
</syntaxhighlight>
После внесенных изменений класс должен выглядеть следующим образом:

[[Файл:SmartPanels_img19.png]]

После сборки решения открываем MapInfo и проверяем результат.

[[Файл:SmartPanels_img20.png‎]]

==Заключение==

SmartPanels существенно облегчает жизнь разработчикам приложений MapInfo и позволяет осуществлять проекты любой сложности. Это могут быть как проекты, реализующие конкретные прикладные задачи, так и проекты, расширяющие функциональные возможности MapInfo. В качестве примера последнего можно привести разрабатываемый в настоящий момент плагин, который является аналогом Редактора моделей анализа в QGIS и ModelBuidler в ArcGIS.

Файл:SmartPanels img20.png

2018-03-22T07:00:51Z

Wasposa:

Файл:SmartPanels img19.png

2018-03-22T06:56:29Z

Wasposa:

Файл:SmartPanels img18.png

2018-03-22T06:45:48Z

Wasposa:

Файл:SmartPanels img17.png

2018-03-22T06:28:29Z

Wasposa:

Расширение функциональности MapInfo на основе SmartPanels

2018-03-21T15:00:07Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.
MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления. В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести еще один или изменить расположение существующих;
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.
С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.
Предпринимались различные попытки обойти указанные ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MS Access с использованием MapX, динамическое связывание MapInfo и MS Access посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был, но необходимо было быть специалистом в тонкостях создания библиотек DLL, подключения их в MapBasic, вызовам из них внешних подпрограмм и т.п., что, согласитесь, для прикладного программиста MapBasic не является характерным.
Данная ситуация продолжалось до тех пор, пока не вышла версия MapInfo 9.5, которая была реализована уже на платформе .NET. В соответствующей версии MapBasic была реализована поддержка данной платформы. Но всё равно задача создания и подключения внешних библиотек оставалась нетривиальной.
Все изменилось с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП, которая является официальным дистрибьютером MapInfo в России и СНГ. С её помощью стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. SmartPanels служит своеобразным посредником между MapInfo и внешним приложением. Для разработки прикладного решения не требуется установленного компилятора MapBasic, все что необходимо - это установленная утилита SmartPanel и среда разработки MS Visual Studio.
==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo.
Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее (в MapInfo 16 версии это уже штатный функционал, но там и режим отображения окон документов только один – во все окно). Вторым дополнением к пользовательскому интерфейсу, но который обеспечивает непосредственно SmartPanels, является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Файл:SmartPanels_img1.png]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Файл:SmartPanels_img2.png]]

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

[[Файл:SmartPanels_img3.png]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Файл:SmartPanels_img4.png]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Файл:SmartPanels_img5.png]]

[[Файл:SmartPanels_img6.png]]

[[Файл:SmartPanels_img7.png]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Файл:SmartPanels_img8.png]]

[[Файл:SmartPanels_img9.png]]

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [http://www.mapinfo.ru/product/mapinfo-plugin]. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio. Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

[[Файл:SmartPanels_img16.png‎|центр|500]]

На этом основная работа по созданию и регистрации нового плагина выполнена. На этом этапе возможно посмотреть, как будет выглядеть плагин в MapInfo. Для этого необходимо собрать решение:''Сборка – Собрать решение F6'' и дождаться окончания сборки. По умолчанию готовая сборка в виде файла CloneLayout.dll будет находится в каталоге \bin\Debug корневого каталога проекта. Далее необходимо его загрузить в SmartPanels в Mapinfo: меню ''SmartPanels – Настройки – вкладка Плагины - кнопка Добавить''

Файл:SmartPanels img16.png

2018-03-21T14:54:52Z

Wasposa:

Расширение функциональности MapInfo на основе SmartPanels

2018-03-21T14:49:00Z

Wasposa: /* Пример создания плагина для SmartPanel */

{{Статья|Черновик}}
{{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.}}
==Описание==
В данной статье речь пойдет об утилите SmartPanels для MapInfo, позволяющей достаточно просто интегрировать в MapInfo пользовательские специализированные приложения или приложения, расширяющие функциональность MapInfo.
MapInfo имеет штатный язык программирования MapBasic, который позволяет автоматизировать практически все операции MapInfo. Всем хорош MapBasic, пока дело не доходит до создания с его помощью достаточно развитого пользовательского интерфейса. Тут возникает сразу несколько проблем:
* большая трудоемкость при создании и размещении элементов управления. В качестве примера можно привести ситуацию, когда в уже созданный диалог с большим количеством элементов управления нужно внести еще один или изменить расположение существующих;
* невозможность создавать немодальные окна;
* ограниченный набор элементов управления состоящий всего из 15 элементов.
С другой стороны, существует достаточно широкий класс задач, где развитой пользовательский интерфейс просто необходим. В качестве характерного примера можно привести тот же кадастровый учет, в котором необходимо отображать большое количество разнообразной информации, привязанной к одному участку.
Предпринимались различные попытки обойти указанные ограничения MapBasic. К ним можно отнести создание визуальных редакторов диалогов (своеобразные IDE), реализация функционала MapInfo в среде MS Access с использованием MapX, динамическое связывание MapInfo и MS Access посредством механизма DDE и т.п. Но какого-то универсального инструмента не существовало. Точнее он был, но необходимо было быть специалистом в тонкостях создания библиотек DLL, подключения их в MapBasic, вызовам из них внешних подпрограмм и т.п., что, согласитесь, для прикладного программиста MapBasic не является характерным.
Данная ситуация продолжалось до тех пор, пока не вышла версия MapInfo 9.5, которая была реализована уже на платформе .NET. В соответствующей версии MapBasic была реализована поддержка данной платформы. Но всё равно задача создания и подключения внешних библиотек оставалась нетривиальной.
Все изменилось с выходом утилиты SmartPanels, разработанной специалистами компании ЭСТИ МАП, которая является официальным дистрибьютером MapInfo в России и СНГ. С её помощью стало возможным быстро подключать (регистрировать) к MapInfo пользовательские приложения, созданные на любом из языков семейства .NET. SmartPanels служит своеобразным посредником между MapInfo и внешним приложением. Для разработки прикладного решения не требуется установленного компилятора MapBasic, все что необходимо - это установленная утилита SmartPanel и среда разработки MS Visual Studio.
==Примеры реализации==
Для наглядного представления о том, что представляет из себя SmartPanels, приведем примеры четырех плагинов. Первые два поставляются в качестве примеров вместе со SmartPanels и представляет собой плагины общего назначения, т.е. расширяющие стандартные возможности MapInfo.
Первый из них - «Вкладки» вносит полезное дополнение к пользовательскому интерфейсу MapInfo. Так при развернутых окнах, в верхней части окон появляются вкладки с именами документов и переключения между ними становится намного удобнее (в MapInfo 16 версии это уже штатный функционал, но там и режим отображения окон документов только один – во все окно). Вторым дополнением к пользовательскому интерфейсу, но который обеспечивает непосредственно SmartPanels, является возможность «прикреплять» панели к одной из сторон окна MapInfo с помощью соответствующих инструментов, отображающихся при перемещении панелей. Если ко одной стороне будет прикреплено несколько панелей, то они также будут отображаться в виде вкладок.

[[Файл:SmartPanels_img1.png]]

Второй плагин – «Информация». Его задачей является отображение и редактирование информации по выбранному объекту в настраиваемой пользователем форме. При первом запуске он ничем не отличается от стандартного окна информации MapInfo.

[[Файл:SmartPanels_img2.png]]

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

[[Файл:SmartPanels_img3.png]]

Остальные два плагина были созданы под конкретные проекты. Первый из них предназначен для отображения данных переписи населения.
Задача состояла в представлении данных переписи населения в различных разрезах. В MapInfo имелся слой с населенными пунктами и имелась база данных с результатами переписи. Плагин выполняет две основные задачи:
*получает от MapInfo уникальный код населенного пункта (код ОКАТО), осуществлял выборку данных из БД их интерпретацию и представление.
*передает MapInfo команду на позиционирование окна карты в центре с выбранным пользователем в иерархическом списке населенным пунктом.

[[Файл:SmartPanels_img4.png]]

При использовании специального инструмента «Информация» при выборе населенного пункта на карте происходит отображение информации в различных разрезах

[[Файл:SmartPanels_img5.png]]

[[Файл:SmartPanels_img6.png]]

[[Файл:SmartPanels_img7.png]]

И еще один пример. В данном случае был разработан плагин для отображения панорам Yandex и Google при выборе точки на карте и использования поискового сервиса Yandex.

[[Файл:SmartPanels_img8.png]]

[[Файл:SmartPanels_img9.png]]

==Пример создания плагина для SmartPanel==
Особый интерес, конечно же, представляет возможность создания собственных плагинов. В качестве примера рассмотрим создание приложения, которое будет не просто приветствовать этот мир, но реализовать полезную функцию – клонировать окно отчета. В стандартном MapIinfo такая возможность отсутствует, в отличие от окна карты.
Для начала необходимо скачать и установить SmartPanel. Утилита является абсолютно бесплатной и скачать ее можно по ссылке [http://www.mapinfo.ru/product/mapinfo-plugin]. В терминах SmartPanel все подключаемые пользовательские приложения носят названия плагинов. В качестве примеров вместе с самой утилитой распространяются также бесплатные плагины – «Вкладки» и «Расширенная панель информации». Подробное описание этих плагинов можно найти по той же ссылке.
После установки в основном меню MapInfo появится новый пункт – SmartPanel. Данный пункт содержит два элемента: Настройки и Панели. Пункт «Настройки» предназначен для основных действий с плагинами – их настройка, удаление и добавление в SmartPanel. Второй пункт просто отображает список всех зарегистрированных панелей и позволяет их скрывать и отображать.

[[Файл:SmartPanels_img10.png‎]]

Теперь все готово для добавления своего собственного плагина. Для его создания необходимо установить MS Visual Studio. Вполне подойдет и бесплатная версия этой IDE – Community [https://www.visualstudio.com/ru/downloads]. После запуска загрузчика рекомендуется выбрать пункт «Разработка классических приложений .NET»

[[Файл:SmartPanels_img11.png‎]]

После установки MS VisualStudio можно приступать непосредственно к созданию нашего проекта: Файл – Проект – Cоздать – Библиотека классов (.NET Framework)

[[Файл:SmartPanels_img12.png‎]]

В созданном проекте нужно указать ссылку на библиотеку SmarPanels.dll. Данная библиотека находится в корневом каталоге установки SmartPanel. Если при установке утилиты были использованы настройки по умолчанию, то эта библиотека будет находится в каталоге C:\Program Files\ESTI MAP\SmartPanels. Для создания ссылки необходимо в панели «Обозреватель решения» вызвать диалог добавления ссылки путем нажатия правой клавиши мыши на пункте «Ссылки» и далее «Добавить ссылку…». После инициализации проекта был создан класс по умолчанию Class1. Название класса можно оставить без изменений, а можно переименовать, но в любом случае этот класс должен реализовывать интерфейс SPNet.IMiPlugin. Это и есть предопределенный шаблон плагина. В контексте этого интерфейса наш класс должен реализовывать пять свойств и три метода.
*PluginName - название плагина, которое будет отображаться в списке установленных плагинов.
*PluginDescription - описание плагина.
*PluginUID – глобально уникальный идентификатор плагина.
*PluginVersion - версия плагина.
*RestoredPanels - список панелей, местоположение которых SmartPanels будет автоматически
*сохранять и восстанавливать при запуске.
*Методы:
*Init - производит инициализацию плагина.
*LoadPluginSettings - загружает состояние плагина.
*Dispose - освобождение используемых ресурсов при завершении приложения.
Для краткости не будем здесь приводить подробное описание этих свойств и методов. В состав дистрибутива SamrtPanel входит полная документация разработчика, где все подробно описано. Для генерации PluginUID можно воспользоваться соответствующим пунктом меню VisualStudio:'' Средства - Создать GUID ''. В конечном итоге проект должен выглядеть аналогично снимку ниже.

[[Файл:SmartPanels_img13.png‎]]

На данном этапе плагин создан и готов к добавлению в SmartPanels, но он еще не имеет визуального представления. Добавим в проект панель для размещения на ней элементов управления:'' Проект – Добавить пользовательский элемент управления… ''. В качестве имени задайте LayoutControl.cs. На созданном элементе управления разместите группирующую панель (Panel в разделе Контейнеры панели Элементы управления), элемент управления «ListBox» и две кнопки. (раздел Стандартные элементы управления). Новый элемент управления должен выглядеть примерно следующим образом:

[[Файл:SmartPanels_img15.png‎]]

Экранная форма плагина создана. Теперь надо сообщить об этом SmartPanels. В классе CloneLayout.cs необходимо добавить следующий код:
<syntaxhighlight lang="java">
//Создаем новый объект – панель SmartPanels и его идентификатор
// Guid необходимо сформировать с помощью меню Средства-Создать GUID
MiDockPanel pnl = null;
Guid pnlID = new Guid("{77BCA491-65DA-4C40-A1AE-B792C77DFDAC}");
//Заменияем public List<Guid> RestoredPanels{get{return null;}} на
public List<Guid> RestoredPanels
{
get
{List<Guid> l = new List<Guid>();
l.Add(pnlID);
return l;}
}
//Реализовываем метод Init(), который вызывается при инициализации плагина
public void Init()
{
//Событие MiHost.Inited вызывается после инициализации всех плагинов.
MiHost.Inited += MiHost_Inited;
//Добавляем панель
pnl = MiHost.AddDockPanel("Клонирование отчета", pnlID);
//Создаем экземпляр нашего элемента управления
LayoutControl ctrl = new LayoutControl();
ctrl.Dock = DockStyle.Fill;
//Созданная панель должна иметь вид нашего элемента управления
pnl.Controls.Add(ctrl);
}
//Добавляем метод Init(), который будет выполняться при инициализации плагина
//Подробное описание команд см. Документацию
void MiHost_Inited(object sender, EventArgs e)
{try
{
MiHost.AddPanelToMenu("Клонирование отчета",SPNet.MbCommands.MenuItemShortcut
.CreateShortcut(SPNet.MbCommands.MenuItemShortcut.ModifierKey.Ctrl,(byte)'T'), "Клонирование отчета",pnl);
}
catch (Exception except)
{ MessageBox.Show(MiHost.MainHandle,
"Произошла ошибка при инициализации плагина:" + except.Message,
"Клонирование отчета",
MessageBoxButtons.OK,
MessageBoxIcon.Error);
}
}
</syntaxhighlight>

После сделанных изменения класс CloneLayout.cs должен выглядеть следующим образом:

Файл:SmartPanels img15.png

2018-03-21T14:37:18Z

Wasposa: Wasposa загружена новая версия «Файл:SmartPanels img15.png»

Файл:SmartPanels img15.png

2018-03-21T14:36:23Z

Wasposa:

Расширение функциональности MapInfo на основе SmartPanels

2018-03-21T14:31:16Z

Wasposa: /* Пример создания плагина для SmartPanel */

Файл:SmartPanels img13.png

2018-03-21T14:21:56Z

Wasposa:

Файл:SmartPanels img12.png

2018-03-21T14:15:14Z

Wasposa:

Файл:SmartPanels img11.png

2018-03-21T14:13:16Z

Wasposa:

Расширение функциональности MapInfo на основе SmartPanels

2018-03-21T14:07:52Z

Wasposa: /* Пример создания плагина для SmartPanel */

Файл:SmartPanels img10.png

2018-03-21T14:05:04Z

Wasposa:

Расширение функциональности MapInfo на основе SmartPanels

2018-03-21T13:57:54Z

Wasposa: /* Примеры реализации */

Расширение функциональности MapInfo на основе SmartPanels

2018-03-21T13:57:25Z

Wasposa: /* Примеры реализации */

Файл:SmartPanels img9.png

2018-03-21T13:53:16Z

Wasposa:

Файл:SmartPanels img8.png

2018-03-21T13:53:07Z

Wasposa:

Файл:SmartPanels img7.png

2018-03-21T13:49:15Z

Wasposa:

Файл:SmartPanels img6.png

2018-03-21T13:49:05Z

Wasposa:

Файл:SmartPanels img5.png

2018-03-21T13:45:47Z

Wasposa:

Файл:SmartPanels img4.png

2018-03-21T13:43:47Z

Wasposa:

Файл:SmartPanels img3.png

2018-03-21T13:36:24Z

Wasposa:

Расширение функциональности MapInfo на основе SmartPanels

2018-03-21T13:32:59Z

Wasposa: Новая страница: «{{Статья|Черновик}} {{Аннотация|В данной статье речь пойдет об утилите SmartPanels для MapInfo, позв…»