PIE SDK线元素的绘制

﹏ヽ暗。殇╰゛Y 2022-01-11 16:41 224阅读 0赞

**1.** **功能简介**

在数据的处理中会用到线元素的绘制，目前PIE SDK支持ILineSymbol的线元素的绘制，LineSymbol对象是用于修饰线状对象的符号，它包括CartographicLineSymbol（制图形式的线符号）、MarkerLineSymbol（由点状符号形成的线符号）、MultiLayerLineSymbol（多个符号叠加生成的新的线符号）、PictureLineSymbol（以图片为背景的线符号）、SimpleLineSymbol（简单类型的线符号）这5个不同类型线符号的子类。

**2.** **功能实现说明**

**2.1. SimpleLineSymbol****类型的线元素的绘制**

#### 2.1.1. 实现思路及原理说明 ####

<table style="width:600px;"> 
 <tbody> 
 <tr> 
 <td> 第一步 </td> 
 <td> 设置点的Geometry信息 </td> 
 </tr> 
 <tr> 
 <td> 第二步 </td> 
 <td> 设置线的符号 </td> 
 </tr> 
 <tr> 
 <td> 第三步 </td> 
 <td> 绘制元素 </td> 
 </tr> 
 </tbody> 
</table>

#### 2.1.2. 核心接口与方法 ####

<table style="width:600px;"> 
 <tbody> 
 <tr> 
 <td> 接口/类 </td> 
 <td> 方法/属性 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; ILineElement </td> 
 <td> Geometry属性 </td> 
 <td> 获取或设置Geometry </td> 
 </tr> 
 <tr> 
 <td> Symbol属性 </td> 
 <td> 获取或设置符号样式 </td> 
 </tr> 
 <tr> 
 <td> IGraphicsContainer </td> 
 <td> AddElement(IElement element) </td> 
 <td> 添加元素 </td> 
 </tr> 
 <tr> 
 <td> ISimpleLineSymbol </td> 
 <td> Style属性 </td> 
 <td> 线样式 </td> 
 </tr> 
 <tr> 
 <td> IsDrawOutline </td> 
 <td> 是否绘制轮廓线 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; &nbsp; ILineSymbol </td> 
 <td> Color属性 </td> 
 <td> 获取或设置线的颜色 </td> 
 </tr> 
 <tr> 
 <td> Width属性 </td> 
 <td> 获取或设置线的宽度 </td> 
 </tr> 
 <tr> 
 <td> Cap属性 </td> 
 <td> 获取或设置线帽的样式 </td> 
 </tr> 
 <tr> 
 <td> Join属性 </td> 
 <td> 获取或设置线的连接样式 </td> 
 </tr> 
 </tbody> 
</table>

#### 2.1.3. 示例代码 ####

#### 2.1.4. 示例截图 ####

![1532888-20181224173448286-1234690497.png][]

**2.2. MarkerLineSymbol****类型的点元素的绘制**

#### 2.2.1. 实现思路及原理说明 ####

#### 2.2.2. 核心接口与方法 ####

<table style="width:600px;"> 
 <tbody> 
 <tr> 
 <td> 接口/类 </td> 
 <td> 方法/属性 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; ILineElement </td> 
 <td> Geometry属性 </td> 
 <td> 获取或设置Geometry </td> 
 </tr> 
 <tr> 
 <td> Symbol属性 </td> 
 <td> 获取或设置符号样式 </td> 
 </tr> 
 <tr> 
 <td> IGraphicsContainer </td> 
 <td> AddElement(IElement element) </td> 
 <td> 添加元素 </td> 
 </tr> 
 <tr> 
 <td> IMarkerLineSymbol </td> 
 <td> Interval属性 </td> 
 <td> 获取或设置线的间距 </td> 
 </tr> 
 <tr> 
 <td> IMarkerSymbol </td> 
 <td> Color，Size,XOffset,YOffset </td> 
 <td> 颜色大小等属性 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; &nbsp; ILineSymbol </td> 
 <td> Color属性 </td> 
 <td> 获取或设置线的颜色 </td> 
 </tr> 
 <tr> 
 <td> Width属性 </td> 
 <td> 获取或设置线的宽度 </td> 
 </tr> 
 <tr> 
 <td> Cap属性 </td> 
 <td> 获取或设置线帽的样式 </td> 
 </tr> 
 <tr> 
 <td> Join属性 </td> 
 <td> 获取或设置线的连接样式 </td> 
 </tr> 
 </tbody> 
</table>

#### 2.2.3. 示例代码 ####

#### 2.2.4. 示例截图 ####

**2.3. CartographicLineSymbol****类型的点元素的绘制**

#### 2.3.1. 实现思路及原理说明 ####

#### 2.3.2. 核心接口与方法 ####

<table style="width:600px;"> 
 <tbody> 
 <tr> 
 <td> 接口/类 </td> 
 <td> 方法/属性 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; ILineElement </td> 
 <td> Geometry属性 </td> 
 <td> 获取或设置Geometry </td> 
 </tr> 
 <tr> 
 <td> Symbol属性 </td> 
 <td> 获取或设置符号样式 </td> 
 </tr> 
 <tr> 
 <td> IGraphicsContainer </td> 
 <td> AddElement(IElement element) </td> 
 <td> 添加元素 </td> 
 </tr> 
 <tr> 
 <td> ICartographicLineSymbol </td> 
 <td> DashPattern属性 </td> 
 <td> 获取或设置制线图规则 </td> 
 </tr> 
 <tr> 
 <td> Width </td> 
 <td> 获取或设置制图线的宽度 </td> 
 </tr> 
 <tr> 
 <td> Interval </td> 
 <td> 获取或设置线的间隔 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; &nbsp; ILineSymbol </td> 
 <td> Color属性 </td> 
 <td> 获取或设置线的颜色 </td> 
 </tr> 
 <tr> 
 <td> Width属性 </td> 
 <td> 获取或设置线的宽度 </td> 
 </tr> 
 <tr> 
 <td> Cap属性 </td> 
 <td> 获取或设置线帽的样式 </td> 
 </tr> 
 <tr> 
 <td> Join属性 </td> 
 <td> 获取或设置线的连接样式 </td> 
 </tr> 
 </tbody> 
</table>

#### 2.3.3. 示例代码 ####

<table style="width:569px;"> 
 <tbody> 
 <tr> 
 <td> 项目路径 </td> 
 <td> 百度云盘地址下/PIE示例程序/08元素绘制/02线的绘制 </td> 
 </tr> 
 <tr> 
 <td> 视频路径 </td> 
 <td> 百度云盘地址下/PIE视频教程/08元素绘制/02线的绘制.avi </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例代码 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 
 <div> 
 <img src="https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif" alt=""> 
 <img src="https://images.cnblogs.com/OutliningIndicators/ExpandedBlockStart.gif" alt=""> 
 <div> 
 <pre> 1 /// &lt;/summary&gt;
 2 /// &lt;param name="sender"&gt;&lt;/param&gt;
 3 /// &lt;param name="e"&gt;&lt;/param&gt;
 4 private void toolStripButton_DrawCartoSyLine_Click(object sender, EventArgs e)
 5 {
 6 //IPolyline polyline = mapControl1.TrackLine();
 7 //定义空间位置
 8 IPointCollection polyLine = new Polyline();
 9 polyLine.AddPoint(100, 100, 0);
10 polyLine.AddPoint(500, 400, 0);
11 //定义线元素
12 ILineElement lineElement = new PIE.Carto.LineElement(); 
13 lineElement.Geometry = polyLine as IGeometry;
14 
15 ICartographicLineSymbol cartoLineSymbol = new CartographicLineSymbol();
16 IList&lt;double&gt; IList = new List&lt;double&gt;();
17 IList.Add(1);
18 IList.Add(2);
19 IList.Add(3);
20 cartoLineSymbol.DashPattern = IList;//制图线规则
21 cartoLineSymbol.Width = 4;
22 cartoLineSymbol.Interval = 3;
23 ///设置符号颜色，偏移量,线帽样式，连接样式
24 ILineSymbol lineSymbol = cartoLineSymbol as ILineSymbol;
25 lineSymbol.Color = Color.Green;
26 lineSymbol.Offset = 20;
27 lineSymbol.Cap = LineCapStyle.LCSRound;
28 lineSymbol.Join = LineJoinStyle.LJSRound;
29 
30 lineElement.Symbol = lineSymbol;
31 mapControlMain.ActiveView.GraphicsContainer.AddElement(lineElement);
32 mapControlMain.PartialRefresh(ViewDrawPhaseType.ViewAll); 
33 } </pre> 
 </div> 
 
 </div> </td> 
 </tr> 
 </tbody> 
</table>

#### 2.3.4. 示例截图 ####

![1532888-20181224173616142-250202467.png][]

**2.4. PictureLineSymbol****类型的点元素的绘制**

#### 2.4.1. 实现思路及原理说明 ####

#### 2.4.2. 核心接口与方法 ####

<table style="width:600px;"> 
 <tbody> 
 <tr> 
 <td> 接口/类 </td> 
 <td> 方法/属性 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; ILineElement </td> 
 <td> Geometry属性 </td> 
 <td> 获取或设置Geometry </td> 
 </tr> 
 <tr> 
 <td> Symbol属性 </td> 
 <td> 获取或设置符号样式 </td> 
 </tr> 
 <tr> 
 <td> IGraphicsContainer </td> 
 <td> AddElement(IElement element) </td> 
 <td> 添加元素 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; &nbsp; IPictureLineSymbol </td> 
 <td> CreateFromFile() </td> 
 <td> 从文件创建 </td> 
 </tr> 
 <tr> 
 <td> XScale() </td> 
 <td> 获取或者设置X方向缩放比例 </td> 
 </tr> 
 <tr> 
 <td> YScale() </td> 
 <td> 获取或者设置Y方向缩放比例 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; &nbsp; ILineSymbol </td> 
 <td> Color属性 </td> 
 <td> 获取或设置线的颜色 </td> 
 </tr> 
 <tr> 
 <td> Width属性 </td> 
 <td> 获取或设置线的宽度 </td> 
 </tr> 
 <tr> 
 <td> Cap属性 </td> 
 <td> 获取或设置线帽的样式 </td> 
 </tr> 
 <tr> 
 <td> Join属性 </td> 
 <td> 获取或设置线的连接样式 </td> 
 </tr> 
 <tr> 
 <td> MiterLimit </td> 
 <td> 获取或设置线的MiterLimit </td> 
 </tr> 
 </tbody> 
</table>

#### 2.4.3. 示例代码 ####

<table style="width:600px;"> 
 <tbody> 
 <tr> 
 <td> 项目路径 </td> 
 <td> 百度云盘地址下/PIE示例程序/08元素绘制/02线的绘制 </td> 
 </tr> 
 <tr> 
 <td> 视频路径 </td> 
 <td> 百度云盘地址下/PIE视频教程/08元素绘制/02线的绘制.avi </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例代码 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 
 <div> 
 <img src="https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif" alt=""> 
 <img src="https://images.cnblogs.com/OutliningIndicators/ExpandedBlockStart.gif" alt=""> 
 <div> 
 <pre> 1 /// &lt;summary&gt;
 2 /// 图片为填充背景的线绘制
 3 /// &lt;/summary&gt;
 4 /// &lt;param name="sender"&gt;&lt;/param&gt;
 5 /// &lt;param name="e"&gt;&lt;/param&gt;
 6 private void toolStripButton_DrawPicSyLine_Click(object sender, EventArgs e)
 7 {
 8 //IPolyline polyline = mapControl1.TrackLine();
 9 //定义空间位置
10 IPointCollection polyLine = new Polyline();
11 polyLine.AddPoint(100, 100, 0);
12 polyLine.AddPoint(500, 400, 0);
13 //定义线元素
14 ILineElement lineElement = new PIE.Carto.LineElement(); 
15 lineElement.Geometry = polyLine as IGeometry;
16 
17 IPictureLineSymbol picLineSymbol = new PictureLineSymbol();
18 OpenFileDialog openFileDialog = new OpenFileDialog();
19 openFileDialog.Filter = "Picture File|*.bmp";
20 openFileDialog.Title = "请选择一整图片：";
21 if (openFileDialog.ShowDialog() != DialogResult.OK) return;
22 bool ok = picLineSymbol.CreateFromFile(openFileDialog.FileName);
23 if (ok)
24 {
25 picLineSymbol.XScale = 0.5;
26 picLineSymbol.YScale = 0.5;
27 
28 ILineSymbol lineSymbol = picLineSymbol as ILineSymbol;
29 lineSymbol.Width = 50;
30 lineSymbol.Offset = 3;
31 lineSymbol.MiterLimit = 4;
32 lineElement.Symbol = lineSymbol;
33 mapControlMain.ActiveView.GraphicsContainer.AddElement(lineElement);
34 mapControlMain.PartialRefresh(ViewDrawPhaseType.ViewAll); 
35 } 
36 }</pre> 
 </div> 
 
 </div> </td> 
 </tr> 
 </tbody> 
</table>

#### 2.4.4. 示例截图 ####

![1532888-20181224173700120-107548686.png][]

**2.5. MultiLayerLineSymbol****类型的点元素的绘制**

#### 2.5.1. 实现思路及原理说明 ####

#### 2.5.2. 核心接口与方法 ####

<table style="width:600px;"> 
 <tbody> 
 <tr> 
 <td> 接口/类 </td> 
 <td> 方法/属性 </td> 
 <td> 说明 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; ILineElement </td> 
 <td> Geometry属性 </td> 
 <td> 获取或设置Geometry </td> 
 </tr> 
 <tr> 
 <td> Symbol属性 </td> 
 <td> 获取或设置符号样式 </td> 
 </tr> 
 <tr> 
 <td> IGraphicsContainer </td> 
 <td> AddElement(IElement element) </td> 
 <td> 添加元素 </td> 
 </tr> 
 <tr> 
 <td> IMultiLayerLineSymbol </td> 
 <td> AddLayer() </td> 
 <td> 添加线符号样式图层 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; &nbsp; ILineSymbol </td> 
 <td> Color属性 </td> 
 <td> 获取或设置线的颜色 </td> 
 </tr> 
 <tr> 
 <td> Width属性 </td> 
 <td> 获取或设置线的宽度 </td> 
 </tr> 
 <tr> 
 <td> Cap属性 </td> 
 <td> 获取或设置线帽的样式 </td> 
 </tr> 
 <tr> 
 <td> Join属性 </td> 
 <td> 获取或设置线的连接样式 </td> 
 </tr> 
 </tbody> 
</table>

#### 2.5.3. 示例代码 ####

<table style="width:600px;"> 
 <tbody> 
 <tr> 
 <td> 项目路径 </td> 
 <td> 百度云盘地址下/PIE示例程序/08元素绘制/02线的绘制 </td> 
 </tr> 
 <tr> 
 <td> 视频路径 </td> 
 <td> 百度云盘地址下/PIE视频教程/08元素绘制/02线的绘制.avi </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 示例代码 </td> 
 </tr> 
 <tr> 
 <td colspan="2"> 
 <div> 
 <img src="https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif" alt=""> 
 <img src="https://images.cnblogs.com/OutliningIndicators/ExpandedBlockStart.gif" alt=""> 
 <div> 
 <pre> 1 /// &lt;summary&gt;
 2 /// 多个符号叠加生成的线样式的线绘制
 3 /// &lt;/summary&gt;
 4 /// &lt;param name="sender"&gt;&lt;/param&gt;
 5 /// &lt;param name="e"&gt;&lt;/param&gt;
 6 private void toolStripButton_DrawMultiSyLine_Click(object sender, EventArgs e)
 7 {
 8 //定义空间位置
 9 IPointCollection polyLine = new Polyline();
10 polyLine.AddPoint(100, 100, 0);
11 polyLine.AddPoint(500, 400, 0);
12 //定义线元素
13 ILineElement lineElement = new PIE.Carto.LineElement(); 
14 lineElement.Geometry = polyLine as IGeometry;
15 
16 #region IMultiLayerLineSymbol多个符号生成的线组成的符号
17 IMultiLayerLineSymbol mulLayerLineSymbol = new MultiLayerLineSymbol();
18 //IPictureLineSymbol图片符号
19 IPictureLineSymbol picLineSymbol = new PictureLineSymbol();
20 OpenFileDialog openFileDialog = new OpenFileDialog();
21 openFileDialog.Filter = "Picture File|*.bmp";
22 openFileDialog.Title = "请选择一整图片：";
23 if (openFileDialog.ShowDialog() != DialogResult.OK) return;
24 bool ok = picLineSymbol.CreateFromFile(openFileDialog.FileName);
25 ILineSymbol lineSymbol = picLineSymbol as ILineSymbol;
26 if (ok)
27 {
28 picLineSymbol.XScale = 0.5;
29 picLineSymbol.YScale = 0.5;
30 lineSymbol.Width = 60;
31 lineSymbol.Offset = 3;
32 lineSymbol.MiterLimit = 4;
33 }
34 
35 //IMarkLineSymbol
36 ISimpleMarkerSymbol simpleMarkerSymbol = new SimpleMarkerSymbol();
37 simpleMarkerSymbol.Style = SimpleMarkerStyle.SMSCircle;
38 simpleMarkerSymbol.IsDrawOutline = true;
39 IMarkerSymbol markerSymbol = simpleMarkerSymbol as IMarkerSymbol;
40 markerSymbol.Size = 10;
41 markerSymbol.Color = Color.Green;
42 
43 IMarkerLineSymbol markerLineSymbol = new MarkerLineSymbol();
44 markerLineSymbol.MarkerSymbol = markerSymbol;
45 
46 ILineSymbol lineSymbol2 = markerLineSymbol as ILineSymbol;
47 mulLayerLineSymbol.AddLayer(lineSymbol, false);
48 mulLayerLineSymbol.AddLayer(lineSymbol2, false);
49 
50 lineElement.Symbol = mulLayerLineSymbol as ILineSymbol;
51 mapControlMain.ActiveView.GraphicsContainer.AddElement(lineElement);
52 mapControlMain.PartialRefresh(ViewDrawPhaseType.ViewAll);
53 #endregion
54 }</pre> 
 </div> 
 
 </div> </td> 
 </tr> 
 </tbody> 
</table>

#### 2.5.4. 示例截图 ####

![1532888-20181224173748779-2032711298.png][]

转载于:https://www.cnblogs.com/PIESat/p/10169961.html

[1532888-20181224173448286-1234690497.png]: /images/20220110/5aed055992b8489fa9beefd8ee11eeff.png
[1532888-20181224173616142-250202467.png]: /images/20220110/bda620381b624a19a37ca29b2f809904.png
[1532888-20181224173700120-107548686.png]: /images/20220110/7ccd51e07fce44e69e18ea2c9cd3d1d3.png
[1532888-20181224173748779-2032711298.png]: /images/20220110/f871c5c560d54285a61ca202edb6cedc.png