【024】

【024】◀▶ArcObjects 类库（一）ArcObjects 类库（一）---------------------------------------------------------------------------------------------------------●·● 目录：O0 …………在线帮助& 本地帮助OMD（对象模型图）Geodatabase 命名空间A1 …………IWorkspaceFactory 接口A2 …………IWorkspace 接口IFeatureWorkspace 接口IWorkspaceEdit 接口A3 …………IFeatureClass 接口A4 …………IFeatureCursor 接口A5 …………IFeature 接口A6 …………IField 接口IFieldEdit 接口A7 …………IFields 接口IFieldsEdit 接口A8 …………IQueryFilter 接口A9 …………IGeoDataset 接口Aa …………IDataset 接口Carto 命名空间G1 …………ILayer 接口G2 …………IFeatureLayer 接口IFeatureSelection 接口ISelectionSet 接口IEnumIDs 接口G3 …………IMap 接口G4 …………IMapDocument 接口G5 …………IGraphicsContainer 接口G6 …………IActiveView 接口G7 …………IFillShapeElement 接口G8 …………IElement 接口G9 …………IFrameProperties 接口Ga …………IMapFrame 接口Gb …………IMapGrid 接口Gc …………IMapGrids 接口Gd …………ISelectionEnvironment 接口Ge …………IPage 接口Gf …………ISnapGrid 接口Gg …………ISnapGuides 接口Gh …………IRulerSettings 接口Gi …………IGraphicsContainer 接口Gj …………IActiveView 接口Gk …………IFillShapeElement 接口Gl …………IElement 接口Gm…………IElement 接口Gn …………IElement 接口Controls 命名空间U1 …………LicenseControl 控件U2 …………MapControl 控件U3 …………IMapControl2 接口U4 …………IMapControl3 接口U5 …………IMapControlEvents2 接口U6 …………PageLayoutControl 控件U7 …………IPageLayoutControl 接口U8 …………IPageLayoutControlEvents 控件U9 …………ToolbarControl 控件Ua …………IToolbarControl2 接口Ub …………TOCControl 控件Uc …………ITOCControl 接口ILegendGroup 接口ILegendClass 接口Ud …………ITOCControlEvents 接口Ue …………IHookHelper 接口Uf …………SymbologyControl 控件Ug …………ISymbologyControl 接口ISymbologyStyleClass 接口Uh …………ISymbologyControlEvents 接口Ui …………TOCControl 控件Uj …………ITOCControl 接口Uk …………ITOCControlEvents 接口Ul …………GlobeControl 接口Um…………GlobeControl 接口---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第O0个╠══════════════════════════════════════════════════╣╚════════╝●·●在线帮助 & 本地帮助：1. 通过在线帮助和本地帮助可以得到相同的内容，但是本地帮助速度更快，但是在线帮组效果更好，下面的图示展示了如何将二者联系起来，因为二者的排版还是存在一定的差别的！---------------------------------------------------------------------------------------------------------●·●OMD（对象模型图）：1> AbstractClass：抽象类算一个超类，不能用来实例化一个对象，比如Line就是一个抽象类，其他的线是Line之上，Line给出了所有线的共同特性和方法。

符号：平面矩形，白色。

2> CoClass：这种类可以直接通过new方法实例化出一个对象。

符号：长方体，灰色。

3> Class：这种类不能直接new出一个对象，但是可以通过实例的属性得到或者通过某个方法生成一个对象。

符号：长方体，白色。

4> Association（关联）：表示一个类的实例可以和几个其他类的实例相关联，比如一个Line Symbol对象只能和一个线对象相关。

符号：灰色的线。

5> Type Inheritance（继承）：是一个类可以通过继承，得到其父类的属性和方法，比如Line这个超类之上可以有其他类型的特定线类。

符号：空心三角箭头。

6> Instantiation（实例化）：是某个类的某个方法可以实例化其他类的实例，比如:IWorkspaceFactory类的OpenFromFile()方法可以实例化一个IFeatureWorkspace类的实例。

符号：虚线箭头。

7> Composition（组成）：是一个强制的关系，是一个类的实例包含了其他的类的实例，比如一个points会包含很多个point，当这么多的point的生命周期没有结束，points对象就不能从内存中卸载掉。

符号：黑色菱形。

8> Inbounde Interface（入接口）：封装了若干属性和方法。

符号：空心圆。

9> Outbound Interface（出接口）：封装的事件，即对象支持哪些事件的触发。

符号：实心圆。

※参考：CoClass 和Class 的区别1※参考：CoClass 和Class 的区别2※参考：ArcObjects学习的重要工具Object Model Diagrams※参考：关于接口的理解※参考：Arcgis Engine -- 接口编程思想View Code接口只需提供方法，但是不用提供解决的途径，解决的途径在相应的类中定义，一个类可以同时集成多个接口，这些接口可以没有任何关系，但是类只能继承一个类，这里就体现出接口的优势，不同的接口可以将类的方法有机的分离开，更好的实现管理！（@McDelfino 拙见）参考：其中，Nest和Chicken 是聚合关系（Aggregation），既它们之间不共存。

Wings和Chicken是组合关系（Composition)，它们共存，翅膀是鸡的一部分，鸡不在了翅膀也就没了。

Bird和Chicken是继承关系（Type Inheritance），鸡是鸟的一种。

Egg和Chicken是实例化关系（Instantiation），鸡蛋可以用鸡的方法来实例化，鸡下蛋实例化鸡蛋。

Bird是AbstractClass，不能实例化。

Chicken和Nest是CoClass，可以通过New关键字来实例化。

Egg和Wings是Class，可以通过其他实例的方法来实例化。

---------------------------------------------------------------------------------------------------------●·●Geodatabase 命名空间1. 该类库提供了统一的接口来访问空间数据，使用频率非常高的接口IFeatureClass、ITable、IQueryFilter 等接口都是位于该类库中。

用户在打开要素类、打开表、查询数据、读取数据、更新数据时都需要引用此类库。

下图描述了表格、要素类、字段等对象之间的关系。

---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第A1个╠══════════════════════════════════════════════════╣╚════════╝---------------------------------------------------------------------------------------------------------●·●IFeatureWorkspace 接口：---------------------------------------------------------------------------------------------------------●·●IWorkspaceEdit 接口：1. Provides access to members that control Workspace Editing. Note: the IWorkspaceEdit interface has been superseded by IWorkspaceEdit2. Please consider using the more recent version.※参考：/content.php?id=317提取要素属性：ILayer pLayer = axMapControl1.get_Layer(0); //获取图层IFeatureLayer pFLayer = pLayer as IFeatureLayer; //获取矢量图层IFeatureClass pFC = pFLayer.FeatureClass; //获取属性列表IFeatureCursor pFCursor = pFC.Search(null, false); //访问要素 IFeature pFeature = pFCursor.NextFeature(); //获取单个要素DataTable pTable = new DataTable();DataColumn colName = new DataColumn("国家名");colName.DataType = System.Type.GetType("System.String");pTable.Columns.Add(colName);DataColumn colArea = new DataColumn("洲名");colArea.DataType = System.Type.GetType("System.String");pTable.Columns.Add(colArea);int indexOfName = pFC.FindField("NAME");int indexOfName2 = pFC.FindField("REGION");while (pFeature != null){string name = pFeature.get_Value(indexOfName);string area = pFeature.get_Value(indexOfName2);DataRow pRow = pTable.NewRow();pRow[0] = name;pRow[1] = area;pTable.Rows.Add(pRow);pFeature = pFCursor.NextFeature();}dataGridView1.DataSource = pTable;※参考：/shuai686868@126/blog/static/20303461201010261381 4320/※参考：/content.php?id=319---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第A5个╠══════════════════════════════════════════════════╣╚════════╝●·●IFeature 接口：※参考：/content.php?id=315IFeature pFeature = pFeatureClass.CreateFeature();pFeature.Shape = pPointColl as IPolygon;pFeature.Store();pFeature.set_Value(pFeature.Fields.FindField(pColumns[2]), pBuildingList[i].Trim());pFeature.Store();---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第A6个╠══════════════════════════════════════════════════╣╚════════╝●·●IField 接口：1. Provides access to members that return information about thefield. Note: the IField interface has been superseded by IField2. Please consider using the more recent version.The field object represents a column in a table. A field has many properties, the most obvious ones being its name and its datatype.The esriFieldType enumeration lists the possible datatypes.CoClasses that implement IField---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第A7个╠══════════════════════════════════════════════════╣╚════════╝●·●IFields 接口：1. Provides access to members that return information about thefields. Note: the IFields interface has been superseded by IFields2. Please consider using the more recent version.The Fields object represents a collection of columns in a table. Theterm field is synonymous with column. Each table in a database has an ordered collection of fields, there is always at least one field in a table. The ordered collection behaves like a list, so it is possible to access individual fields by a numbered position (or index) in the list.CoClasses that implement IField①将矢量数据的所有字段名称加到comboBox1 中！private void loadData(){ILayer pLayer = axMapControl1.get_Layer(0); //获取图层IFeatureLayer pFLayer = pLayer as IFeatureLayer; //转换为矢量图层IFeatureClass pFClass = pFLayer.FeatureClass; //获取图层表格数据IFields pFields = pFClass.Fields; //获取字段集合for (int i = 2; i < pFields.FieldCount;i++ ) //遍历字段{comboBox1.Items.Add(pFields.Field[i].Name); //获取每个字段的名称}comboBox1.Text = comboBox1.Items[2].ToString(); //设置默认显示}②将矢量数据某个字段的全部feature 值加入到comboBox2 中！private void loadFieldData(){comboBox2.Items.Clear(); //删除所有值ILayer pLayer = axMapControl1.get_Layer(0); //获取图层IFeatureLayer pFLayer = pLayer as IFeatureLayer; //转换为矢量图层IFeatureClass pFClass = pFLayer.FeatureClass; //获取图层表格值IFields pFields = pFClass.Fields; //获取所有字段int Index = pFClass.FindField(comboBox1.Text); //找到列所在的 Index！IFeatureCursor pFCursor = pFClass.Search(null, false); //用于循环null就是遍历全部IFeature pFeature = pFCursor.NextFeature(); //用于获取每一个featurewhile (pFeature != null){string name = pFeature.get_Value(Index); //获取 Index 列的值！ comboBox2.Items.Add(name); //添加pFeature = pFCursor.NextFeature(); //下一个要素}comboBox2.Text = comboBox2.Items[0].ToString(); //初始化}③在地图上选择特定的feature！private void comboBox2_SelectedIndexChanged(object sender, EventArgs e){axMapControl1.Map.ClearSelection(); //清除地图上的选择axMapControl1.Refresh(esriViewDrawPhase.esriViewGeography, null, null); //刷新地图ILayer pLayer = axMapControl1.get_Layer(0); //获取图层IFeatureLayer pFLayer = pLayer as IFeatureLayer; //获取矢量图层IFeatureClass pFC = pFLayer.FeatureClass; //获取属性IQueryFilter pQFilter = new QueryFilter(); //新建查询pQFilter.WhereClause = comboBox1.Text + "='" + comboBox2.Text + "'"; //查询内容IFeatureCursor pFCursor = pFC.Search(pQFilter, false); //新建鼠标指针遍历IFeature pFeature = null; //新建一个要素pFeature = pFCursor.NextFeature(); //下一个要素if (pFeature != null) //遍历{axMapControl1.Map.SelectFeature(axMapControl1.get_Layer(0), pFeature); //选择要素axMapControl1.Refresh(esriViewDrawPhase.esriViewGraphicSelection, null, null); //刷新}}---------------------------------------------------------------------------------------------------------●·●IFieldsEdit 接口：1. Provides access to members that modify a fields collection.Members---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第A8个╠══════════════════════════════════════════════════╣╚════════╝●·●IQueryFilter 接口：1. Provides access to members that filter data based on attribute values and or relationships.IQueryFilter filters data based on an attribute query. A string defining a where clause is required. An optional list of columns may be included to specify the column values to be retrieved. If no columns are specified, all values will be returned.CoClasses that implement IQueryFilter---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第A9个╠══════════════════════════════════════════════════╣╚════════╝●·●IGeoDataset 接口：MembersIFeatureLayer：对图层缩放显示！---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Aa个╠══════════════════════════════════════════════════╣╚════════╝●·●IDataset 接口：1. Provides access to members that supply dataset information.Members※参考：/content.php?id=321插入矢量数据：OpenFileDialog ofd = new OpenFileDialog();ofd.Filter = "shapefile文件(*.shp)|*.shp";ofd.InitialDirectory = @"F:\Desktop\Temp\ArcGIS_Data";if (ofd.ShowDialog() != DialogResult.OK)return;FileInfo file = new FileInfo(ofd.FileName);IWorkspaceFactory pWorkspaceFactory = new ShapefileWorkspaceFactory(); //工厂IWorkspace pWorkspace = pWorkspaceFactory.OpenFromFile(file.DirectoryName, 0); //实例化工作空间IFeatureWorkspace pFeatrueWorkspace = pWorkspace as IFeatureWorkspace; //实例化矢量工作空间IFeatureClass pFC = pFeatrueWorkspace.OpenFeatureClass(); //实例化矢量要素类IFeatureLayer pFLayer = new FeatureLayer(); //实例化矢量图层pFLayer.FeatureClass = pFC; //建立连接 = pFC.AliasName; //命名IMap pMap = axMapControl1.Map; //实例地图pMap.AddLayer(pFLayer as ILayer); //增加图层---------------------------------------------------------------------------------------------------------●·●IFeatureSelection 接口：1. Provides access to members that control feature selection.获取选择集！---------------------------------------------------------------------------------------------------------●·●ISelectionSet 接口：1. Provides access to members that manage a set of selected table rows or features. Note: the ISelectionSet interface has been supersededby ISelectionSet2. Please consider using the more recent version.实例化选择集！---------------------------------------------------------------------------------------------------------●·●IEnumIDs 接口：1. Provides access to members that enumerate through IDs.获取选择集中要素的FID值集合，依次可以获取选择的要素~实现：缩放到所有选择要素IEnvelope layerEnvelope = null; //实例化一个envelopeIFeatureClass pFeatCls = pLayer.FeatureClass;IFeatureSelection selectLayer = pLayer as IFeatureSelection; //QI一个要素选择接口ISelectionSet selectionSet = selectLayer.SelectionSet; //获取选择集IEnumIDs enumIDs = selectionSet.IDs; //从选择集中获取FID值IFeature feature;int i = 1;int iD = enumIDs.Next(); //读取第一个FID值while(iD != -1) //-1 is reutned after the last valid ID has been reached {pMapControl.ActiveView.Refresh();}---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第G4个╠═════════════════════════---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第G5个╠══════════════════════════════════════════════════╣╚════════╝●·●IGraphicsContainer 接口：---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第G6个╠══════════════════════════════════════════════════╣╚════════╝●·●IActiveView 接口：1. Provides access to members that control the active view - the main application window.This interface manages the main application window in ArcMap and all drawing operations.In ArcMap, two objects implement【实现】this interface: PageLayout and Map. These two objects correspond to the two different views in ArcMap: layout and data view. Only one view can be active at a time and this is termed the active view. IMxDocument::ActiveView holds a reference to the current active view object (a Map or the PageLayout). For example, if the ArcMap application is in layout mode, IMxDocument::ActiveView returns an IActiveView reference to the PageLayout object. Alternatively, if the application is in data view, this propery returns a reference【参考】to the focus map.ArcMap has view commands which allow users to toggle【切换】between layout view and data view. These commands appear on the View menu and on the scroll bar.---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第G7个╠══════════════════════════════════════════════════╣╚════════╝●·●IFillShapeElement 接口：1. IFillShapeElement is a generic interface implemented by all 2d elements (CircleElement, EllipseElement, PolygonElement, and RectangleElement).Use this interface when you want to retrieve or set the fill symbol being used by one of the fill shape elements.CoClasses that implement IFillShapeElement---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第G8个╠══════════════════════════════════════════════════╣╚════════╝●·●IElement 接口：1. Provides access to members that control the Element.CoClasses that implement IElement---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Ga个╠══════════════════════════════════════════════════╣╚════════╝●·●IMapFrame 接口：1. Provides access to the members that control the map element object.IMapFrame is the default interface for the MapFrame object. The main purpose of the interface is to give the developer access to the mapobject stored within the frame, and it's associated locator rectangles.Inherited InterfacesCoClasses that implement IMapFrame---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Gb个╠══════════════════════════════════════════════════╣╚════════╝●·●IMapGrid 接口：1. Provides access to members that control a map grid.IMapGrid is the main interface for setting properties that apply to all other types of grids. There are four specific types of MapGrid that all implementthe IMapGrid interface. They are: IMeasuredGrid , IGraticule , IndexGrid , and ICustomGridOverlay .CoClasses that implement IMapGrid---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Gc个╠══════════════════════════════════════════════════╣╚════════╝●·●IMapGrids 接口：1. Provides access to members that control the map grids in a data frame.IMapGrids is implemented only by the MapFrame object, but it is not the default interface for that object (IMapFrame is the default). Use this interface when you want to retrieve or set the grids (sometimes known as graticules) displayed with a particular MapFrame. The Grids are used to provide reference information for the map.CoClasses that implement IMapGrids---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Gd个╠══════════════════════════════════════════════════╣╚════════╝●·●ISelectionEnvironment 接口：1. Provides access to members that control the selection environment.CoClasses that implement ISelectionEnvironment---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Ge个╠══════════════════════════════════════════════════╣╚════════╝●·●IPage 接口：1. Provides access to members that control the Page.private void button2_Click(object sender, EventArgs e){ColorDialog cd = new ColorDialog();cd.ShowDialog();IPage pPage = axPageLayoutControl1.PageLayout.Page;IRgbColor pColor = new RgbColor();pColor.Red = cd.Color.R;pColor.Green = cd.Color.G;pColor.Blue = cd.Color.B;pPage.BackgroundColor = pColor;}---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Gf个╠══════════════════════════════════════════════════╣╚════════╝●·●ISnapGrid 接口：1. Provides access to members that control the Snapping grid.private void button3_Click(object sender, EventArgs e){ISnapGrid pSnapGrid = axPageLayoutControl1.PageLayout.SnapGrid; pSnapGrid.VerticalSpacing = .2;pSnapGrid.HorizontalSpacing = .1;pSnapGrid.IsVisible = true;axPageLayoutControl1.ActiveView.Refresh();}---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Gg个╠══════════════════════════════════════════════════╣╚════════╝●·●ISnapGuides 接口：1. Provides access to members that control the Snapping guides.private void button4_Click(object sender, EventArgs e){ISnapGuides pSnapGuides =axPageLayoutControl1.PageLayout.HorizontalSnapGuides;for (int i = 0; i < 30;i++ ){pSnapGuides.AddGuide(i);}pSnapGuides.AreVisible = true;ISnapGuides pSnapGuides2 =axPageLayoutControl1.PageLayout.VerticalSnapGuides;for (int i = 0; i < 20;i++ ){pSnapGuides2.AddGuide(i);}pSnapGuides2.AreVisible = true;axPageLayoutControl1.ActiveView.Refresh();}---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Gh个╠══════════════════════════════════════════════════╣╚════════╝●·●IRulerSettings 接口：1. Provides access to members that control Ruler setup.---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Gh个╠══════════════════════════════════════════════════╣╚════════╝●·●IRulerSettings 接口：1. Provides access to members that control Ruler setup.---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Gi 个╠══════════════════════════════════════════════════╣╚════════╝●·●IRulerSettings 接口：1. Provides access to members that control Ruler setup.---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第Gj 个╠══════════════════════════════════════════════════╣╚════════╝●·●IRulerSettings 接口：1. Provides access to members that control Ruler setup.---------------------------------------------------------------------------------------------------------●·●Controls 命名空间---------------------------------------------------------------------------------------------------------╔════════╗╠════╣第U1个╠══════════════════════════════════════════════════╣╚════════╝●·●LicenseControl 类：1. 用来给控件提供许可，并不现实在程序上。