PIE.NET-SDK组件式二次开发文档

 

一、PIE.Net开发环境及目录说明

1.   开发环境

•  确保Win7系统已安装SP1
•  安装Visual Studio2013（支持VS2010/2012/2013/2015）
•  安装PIESDK.exe二次开发包

2. 【SDK】安装后目录说明

 

1)        Bin>>开发包

2)        Config>>配置文件

3)        Data>>坐标系投影及数据映射表

4)        Document>>帮助文件

5)        Language>>语言国际化

6)        Res>>按钮图标及鼠标Cursor样式

7)        Sample>>实例文件

8)        Style>>符号库文件

9)        Template>>制图模板

二、PIE.NET_SDK二次开发实例

     Tool（工具插件）：适用于与地图或制图组件有交互的插件，只需继承自BaseTool（继承自BaseCommand），根据功能需要可重写OnMouseDown、OnMouseMove等方法，如：拉框放大、探针、画多边形等。

    Command（命令插件）：与地图无交互，只需继承自BaseCommand，重写OnClick方法，如：全图、居中放大、前一视图等。

1. WinForm插件调用

  （1）新建Visual C#的Windows 窗体应用程序，选择新建→项目，选择Visual C #的Windows窗体应用程序，设置.Net Framework4以及工程名称“MapManager”和位置。

 

  （2）设置Debug和Release环境，新建选择x86平台。

 

  （3）配置PIE.NET_SDK：在MapManager.csproj的同级目录下新建“APPDebug”文件夹，修改生成输出路径位置为../ APPDebug/Bin。

 

  （4）代码编写

A：工具箱里MapControl、TOCControl控件拖拽绑定

添加窗体，初始化绑定MapControl、TOCControl控件代码：

tocControl1.SetBuddyControl(mapControl1);

窗体运行显示如下：

 

B：选择工程引用，根据自己开发的插件功能需求进行选择, 浏览本机已经安装位置的【Bin】目录下添加类库，单击确定即可。

C：调用

以地图拉框放大（Tool）和全图（Command）为例

        /// <summary>
        /// 拉框放大
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void toolStripButton_MapZoomIn_Click(object sender, EventArgs e)
        {
            ITool tool = new MapZoomInTool();
            ICommand command = tool as ICommand;
            command.OnCreate(mapControl1);
            mapControl1.CurrentTool = tool;
        }
        /// <summary>
        /// 全图
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        private void toolStripButton_FullExtent_Click(object sender, EventArgs e)
        {
            ICommand cmd = new FullExtentCommand();
            cmd.OnCreate(mapControl1);
            cmd.OnClick();
        }

2. 插件代码实现

    新建插件.cs类

以地图拉框放大（Tool）为例

以全图显示（Command）为例

 

构造函数中的定义可个性化定制，控制实际的显示名称、提示和图片（m_Image），鼠标样式放置在构造函数里设置，如鼠标事件里需要改变鼠标样式，再在鼠标事件里控制即可。

设置Cursor符号cur样式

 

  （1）构造函数

  public ZoomIn()
        {
            this.Caption = "拉框放大";              （Caption属性）
            this.Name = "MapZoomIn";               （名称）
            this.ToolTip = "拉框放大地图";           （提示）
            this.Checked = false;                  （插件是否选择）
            this.Enabled = false;                  （插件是否可用）    （鼠标样式在构造函数）
            this.Cursor = new Cursor(new System.IO.MemoryStream(Properties.Resources.ZoomIn));   
        }

  （2）创建插件对象

    public override void OnCreate(object hook) 
        {
            base.OnCreate(hook);
            m_ActiveView = m_HookHelper.ActiveView;      （当前激活视图获取）
        }

  （3）单击方法

   public override void OnClick()
        {
            if (!this.Enabled) return;
        }

  （4）鼠标事件

    以拉框放大为例：鼠标按下时获取拉框，并给地图设置范围变化、刷新。

         /// <summary>
        /// 鼠标按下
        /// </summary>
        /// <param name="sender">触发对象</param>  
        /// <param name="e">鼠标事件参数</param>
    public override void OnMouseDown(object sender, System.Windows.Forms.MouseEventArgs e)
        {
            if (e.Button != System.Windows.Forms.MouseButtons.Left) return;   //判断左键
            m_ActiveView.Extent = (m_HookHelper.GetContent() as IMapControl).TrackRectangle();
            m_ActiveView.PartialRefresh(ViewDrawPhaseType.ViewAll);
        }