Archives by date

Для подключения нового плагина необходимо сначала подключить интерфейс. Для этого выбираем вкладки:
«Меню» -> «Проект»->«Добавить ссылку…». И во вкладке «Обзор» выбираем файлы «Interop.mvMapLib.dll», «AxInterop.mvMapLib.dll», «Interfaces.dll».

Рисунок 1

Добавленные файлы отобразятся в окне «Обозреватель решений» в разделе «Ссылки».

Рисунок 2

В добавленных файлах необходимо выбрать значение «False» для действия «Копировать локально» (это избавит нас от лишнего «мусора» в папке Plugins).

Рисунок 3

Для кода плагина в первую очередь необходимо подготовить файл AssemblyInfo.cs. Более подробное его описание будет дано в разделе «Настройки файла AssemblyInfo.cs».

Так как плагин должен содержать реализацию интерфейса «Interfaces.IMainPlugin», напишем минимально-допустимый код, который должен содержать плагин:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Interfaces;
using System.Xml.Linq;
using System.Reflection;
namespace NewPlugin
{
    public class MainClass : Interfaces.IMainPlugin
    {
        #region Члены IMainPlugin
        string Interfaces.IMainPlugin.Name
        {
            get { return AssemblyClass.GetName(Assembly.GetExecutingAssembly()); }
        }
        string Interfaces.IMainPlugin.GUID
        {
            get { return AssemblyClass.GetGuid(Assembly.GetExecutingAssembly()); }
        }
        public void StartPlugin(XElement XSettings, IMainApp app, IWorkClass work)
        {
            // Код Плагина
        }
        public Interfaces.Forms.IControlSettings SettingsForm
        {
            get { return null; }
        }
        #endregion
    }
}

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

Все настройки плагинов расположены в разделе «Инструменты»-> «Настройки…». Однако они требуются не каждому плагину.

Если есть необходимость в настройках, добавьте UserControl («Меню» -> «Проект» -> «Добавить пользовательский элемент управления...»). Назовём его «UCSettings.cs».

Для того чтобы работала наша форма с интерфейсом настроек, добавляем к классу UCSettings наследование интерфейса Interfaces.Forms.IControlSettings .

Полный пример кода для плагина:

using System.Windows.Forms;
using System.Xml.Linq;
namespace NewPlugin
{
    public partial class UCSettings : UserControl, Interfaces.Forms.IControlSettings
    {
        private XElement _data;          
        public UCSettings()
        {
            InitializeComponent();
        }
        public bool LoadSettings(XElement data)
        {
            _data = data;
            // функция загрузки плагина 
            return true;
        }
        public bool SaveSettings()
        {
            // проверочный код на сохранение результатов
            //Сохранение, изменения переменной _data сохраняются в файле settings.riws
            return true;
        }
    }
}

А также необходимо его передать свойству SettingsForm в классе MainClass.

Перепишем это свойство:

        private Interfaces.Forms.IControlSettings _controlSettings;
        public Interfaces.Forms.IControlSettings SettingsForm
        {
            get
            {
                if (_controlSettings == null)
                    _controlSettings = new UCSettings();
                return _controlSettings;
            }
        }

Для добавления компонента карты в свой проект в панели Toolbox выберите компонент MapLib Control и перетащите его к себе на форму. На форме появится компонент карты. Настройте необходимые для вас размеры и положение карты на форме.

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

axMapLIb1.LoadMap("\\map\\map_file.vmp", "id");

События позволяют компоненту карты уведомлять другие классы или объекты о возникновении каких-либо ситуаций. Ниже рассмотрены наиболее важные события.

MouseDownEvent

Происходит при нажатии на клавишу мыши

if (e.button == TxMouseButton.mvMouseRight)
{
    //ваш код
}

ObjectAfterCreate

Происходит после создания объекта в базе данных

int id_new = 0;
try
{
   id_new = Convert.ToInt32(e.obj.fieldValue("id").ToString());
    axMapLIb1.StatusInfo = "Идентификатор объекта получен (id=" + id_new + ")";
}
catch
{
    writeLogFile("Ошибка получения идентификатора объекта!");
   return;
}

Здесь в строку состояния карты записывается идентификатор ранее созданного объекта.

ObjectEdited
Событие, срабатывающее при редактировании информации объекта на слое

if (axMapLIb1.getLayer(e.layer.NAME) != null)
{
    if (axMapLIb1.getLayer(e.layer.NAME).External == true)
    {
       axMapLIb1.getLayer(e.layer.NAME).ExternalFullReload(
            axMapLIb1.getLayer(e.layer.NAME).getBbox());
        axMapLIb1.mapRepaint();
       axMapLIb1.mapUpdate();
       axMapLIb1.StatusInfo = "У Вас недостаточно прав на редактирование таблицы";
    }
}

В примерах выше были рассмотрены наиболее важные события. Полный список приведен в таблице ниже:

Для подписей объектов можно указать шрифт, цвет, размер, минимальный и максимальный масштаб, при котором будут отображаться подписи, привязку к графическим единицам (то есть будет ли подпись увеличиваться и уменьшаться пропорционально объектам слоя при изменении масштаба), а также некоторые другие параметры. Для указания всех этих параметров, используется специальный объект mvMapLib.mvFontObject:

mvLayer layer = axMapLIb1.getLayer(“Name of layer”); //получение слоя, для которого будем устанавливать стиль подписей
mvFontObject mvfontObject = axMapLIb1.createFontObject(); //создание объекта mvFontObject
mvfontObject.Color = 0xFFFFFFFF; //устанавливаем цвет подписей
mvfontObject.fontname = “MapFontName”; //указываем название семейства шрифтов
mvfontObject.size = 33; //размер шрифта
mvfontObject.strikeout = false; //будет ли текст выводиться зачеркнутым
mvfontObject.italic = true; //делаем шрифт курсивным
mvfontObject.underline = true; //будет ли текст подчеркнутым
mvfontObject.graphicUnits = true; //будет ли привязка к графическим единицам
vfontObject.framecolor =  true;// цвет каймы вокруг текста
vfontObject.framecolor =  true; //цвет каймы вокруг текста
layer.labelBounds = true; //будет ли подпись выводиться в определенном диапазоне масштаба
layer.labelMinScale  = 5000; //минимальный масштаб при котором будет отображаться подпись
layer.labelMaxScale = 200000; //максимальный масштаб при котором будет отображаться подпись
layer.labelParallel =  true; //будет ли подпись выводиться параллельно объекту ( в случае если это линейный объект)
layer.labelOverlap = false; //могут ли подписи перекрываться
layer.labelOffset =  30; //отступ при выводе подписи
layer.SetLabelstyle(mvfontObject); //устанавливаем только что созданный стиль