用VC++对MapX进行二次开发总结(二)(

3．MapX在VC++ 环境下GIS基本功能的实现

在进行MapX 开发之前，确保已经在计算机中正确的安装了MapX 控件。下面就用一个具体的实例，介绍在VC+ +中集成MapX 的方法。

3.1 将MapX支持类库加入工程

在您的项目中包括MapX.cpp和.h文件。这两个文件包含用于对MapX控件进行访问的类定义和方法实现。MapX.h 和 MapX.cpp 文件可能位于安装有 MapX 的 Samples50CPP 子目录中（如果您安装的事MapX 4.0，则路径为 … Samples40C++Cpp）。

利用VC++ 环境下的应用程序生成向导创建一单文档应用程序MapSample。将MapX.h和MapX.cpp文件拷贝到当前工程路径下，然后从Project菜单中选择Add
to Project >Files命令，此时打开Insert Files into Project对话框，选择MapSample文件夹下的MapX.h和MapX〉cpp文件加入到工程中。

警告：不要选择Project菜单中的Add to Project > Components And Controls命令。这样做将会创建一个.cpp文件，但该文件将是不完整的。我一开始就是这么做的，结果很多常用函数都没有，郁闷了我很长时间。希望大家一起要切记这一点。

3.2 使用VC++创建MapX控件

在将包含该控件得视图中包括它：

#include “MapX.h”

：

：

：

Class CMapXSampleView : public CView

{

：

：

：

Protected:

CMapX m_ctrlMapX;

：

：

}

要声明表示用于MapX的控件ID的常数：

（1）选择“View”>”Resource Symble”。

（2）单击“New”。

（3）键入“IDC_MAP”来作为名称。

要在类向导中为WM_SIZE和WM_CREATE消息创建处理程序：

（1）转入”View”>”ClassWizard”；

（2）从“Class Name”组合框中选择您的视图类。

（3）在“Messages”列表框中，单击“WM_CREATE”，然后单击“Add Function”。

（4）接着还在该消息框中选择” WM_SIZE”并单击“Add Function”。

（5）然后，单击“Edit Code”

在创建视图时创建该控件。在CMapXSampleView::OnCreate中：

//create map with default size

//resize message will cause it to be size to the client area of the view

If(!m_ctrlMapX.Create(NULL,WS_VISIBLE, CRect(0,0,100,100),this,IDC_MAP))

Returen -1;

Keep the control’s size in sync with the containing window;

//resize the map to be the same size as our client area

Void CMapXSampleView:: OnSize(UINT nType, int cx, int cy)

{

CView::OnSize(nType, cx, cy);

if(cx!=0 && cy!=0)

m_ctrlMapX.MoveWindow(0,0,cx,cy);

}

像您为WM_CREATE消息所作的一样为WM_SETFOCUS消息创建新消息标头。

在我们的示例中，我们想要确保只要窗口被激活MapX就获得焦点：

void CMapXSampleView::OnSetFocus(CWnd* pOldWnd)

{

CView::OnSetFocus(pOldWnd);

m_ctrlMapX.SetFocus();

}

3.3 使用地图标准工具

在地图显示出来后，用户通常要以各种比例查看地图的全局、局部或细部，必须提供诸如放大、缩小和漫游等功能。采用MapX通用工具，可以非常方便地实现上述功能。设定MapX使用标准工具的方法很简单，只需设定地图对象的CurrentTool属性。下面的例子是用标准放大工具实现放大功能。

添加新菜单项资源，输入标题“工具”，在“工具”下添加子菜单，输入标题“放大”及ID 为ID_ZOOM_ IN。打开类向导，选择视图类CMapXSampleView，为菜单项ID_ZOOM_IN 添加COMMAND 消息映射函数OnZoomIn ( )，并编辑码如下。

void CMapXSampleView::OnZoomIn()

{

m_ctrlMapX.SetCurrentTool(miZoomInTool);// miZoomInTool为放大工具常量

}

编译运行程序，选择“工具|放大”，就会看到此时光标变为放大镜，单击鼠标就会实现放大功能。可用相同方法实现其他标准工具的功能。MapX提供的可用标准工具如下表。

工具	常数	说明
添加线条	miAddLineTool	将线条图元添加到插入图层中。
添加点	miAddPointTool	单击该工具可将点图元添加到插入图层中。
添加折线	miAddPolyLineTool	将折线图元添加到插入图层中。
添加区域	miAddRegionTool	将区域图元添加到插入图层中。
箭头	miArrowTool	单击标题或注释此外，在可编辑图层中移动选定图元或调整选定图元的大小。
居中	miCenterTool	单击该工具可以重新将地图居中。
加标签	miLabelTool	在一个图元上单击可以给该图元加标签。
平移	miPanTool	拖动该工具可以重新将地图居中。
多边形选择	miPolygonSelectTool	单击该工具可以绘制一个多边形；该多边形内的对象将被选定。
半径选择	miRadiusSelectTool	拖动该工具可以选择半径内的图元。
矩形选择	miRectSelectTool	拖动该工具可以选择矩形内的图元。
选择工具	miSelectTool	单击该工具可以选择图元。
符号	miSymbolTool	放置符号注释。
文本	miTextTool	放置文本注释。
放大	miZoomInTool	放大。
缩小	miZoomOutTool	缩小。

3.4 使用自定义工具

MapX提供的地图标准工具能满足一般需要，但在一些特殊地方，用户可能需要某种特殊工具来完成某些特定的地图操作功能。因此，MapX提供了用户自定义工具的方法，这样可以大大扩展MapX的应用范围。开发者可使用地图对象的CreateCustomTool 方法创建自定义工具。一旦您已使用CreateCustomTool方法创建了定制工具后，就可以在用户使用定制工具时使用ToolUsed事件执行操作。

此示例进行测试以了解正使用哪一工具。然后，根据正在使用的工具，该示例或者：

• 更改光标下的地图图元的样式，或者

• 在用户单击处放置新符号。

void CMapXSampleView::OnToolUsed(short ToolNum, double X1,
double Y1, double X2, double Y2, double Distance,BOOL Shift, BOOL Ctrl, BOOL* EnableDefault)

{

CString str;

CMapXPoint pnt;

str.Format("Tool=%d, [%f,%f] [%f, %f], dist=%f, %s %sn",

ToolNum, X1,Y1,X2,Y2,Distance,

(Shift)?"Shift":"",(Ctrl)?"Ctrl":"");

TRACE(str);

// change the style of the feature under the cursor

if (ToolNum == MAP_TOOL_CHANGESTYLE) {

try {

// Need the dispatch to use the point

if (pnt.CreateDispatch(pnt.GetClsid())) {

pnt.Set(X1, Y1);

}

else {

// something went wrong, can't use the point...

AfxThrowOleException(CO_E_CLASS_CREATE_FAILED);

}

CMapXLayers layers = m_ctrlMapX.GetLayers();

// Get the USA feature under the cursor

CMapXFeatures ftrs =

layers.Item("USA").SearchAtPoint(LPDISPATCH(pnt));

// work on only the first feature

CMapXFeatureftr = ftrs.Item(1);

// get the style object from the feature

CMapXStylestyle = ftr.GetStyle();

style.SetRegionBackColor(255);

// update the feature in the layer

ftr.Update();

}

catch (COleDispatchException *e) {

e->ReportError();

e->Delete();

}

catch (COleException *e) {

e->ReportError();

e->Delete();

}

}

// place a new symbol at the point clicked on

else if (ToolNum == MAP_TOOL_NEWPOINT) {

try {

CMapXLayers layers = m_ctrlMapX.GetLayers();

CMapXFeatureftr;

// Need the dispatch id to use the feature

if (ftr.CreateDispatch(ftr.GetClsid())) {

// Symbol feature

ftr.SetType(miFeatureTypeSymbol);

// Get the point object from the feature

// and call the Set method

ftr.GetPoint().Set(X1, Y1);

// Add it to the layer

layers.Item("USA").AddFeature(ftr);

}

else {

AfxThrowOleException(CO_E_CLASS_CREATE_FAILED);

}

}

catch (COleDispatchException *e) {

e->ReportError();

e->Delete();

}

catch (COleException *e) {

e->ReportError();

e->Delete();

}

}

}

3.5 处理MapX事件

若要处理MapX事件，您首先需要为感兴趣的事件建立eventsink地图。用于事件DISPATCH id 的常数是在MapX.h中为MapX定制事件定义的，并且是在中为 OLE 普通事件定义的。

// From MapX.h

#define MAPX_DISPID_SELECTION_CHANGED 0x1

#define MAPX_DISPID_RESOLVEDATABIND 0x2

#define MAPX_DISPID_TOOLUSED 0x3

#define MAPX_DISPID_REQUESTDATA 0x4

#define MAPX_DISPID_DATAMISMATCH 0x5

#define MAPX_DISPID_MAPVIEWCHANGED 0x6

#define MAPX_DISPID_ANNOTATIONADDED 0x7

#define MAPX_DISPID_ANNOTATIONCHANGED 0x8

#define MAPX_DISPID_THEMEMODIFYREQUESTED 0x9

#define MAPX_DISPID_DRAWUSERLAYER 0x0a

#define MAPX_DISPID_POLYTOOLUSED 0x0b

// From

#define DISPID_CLICK (-600)

#define DISPID_DBLCLICK (-601)

#define DISPID_KEYDOWN (-602)

#define DISPID_KEYPRESS (-603)

#define DISPID_KEYUP (-604)

#define DISPID_MOUSEDOWN (-605)

#define DISPID_MOUSEMOVE (-606)

#define DISPID_MOUSEUP (-607)

#define DISPID_ERROREVENT (-608)

EVENT_SINK中的ON_EVENT 宏也为MapX控件指定一个ID （在该示例中为 IDC_MAP），指定该事件的参数，并且指定事件处理程序方法的名称。

在视图标头文件MapXSampView.h中，将“DECLARE_EVENTSINK_MAP ()”一行放置于“DECLARE_MESSAGE_MAP”行之下。

从CMapXSampleView.cpp：

BEGIN_EVENTSINK_MAP(CMapXSampleView, CView)

ON_EVENT(CMapXSampleView, IDC_MAP, DISPID_MOUSEMOVE,

OnMouseMoveInMap,VTS_I2 VTS_I2 VTS_XPOS_PIXELS VTS_YPOS_PIXELS)

ON_EVENT(CMapXSampleView, IDC_MAP, MAPX_DISPID_MAPVIEWCHANGED,

OnMapViewChanged, VTS_NONE)

ON_EVENT(CMapXSampleView, IDC_MAP, DISPID_MOUSEUP,

OnMouseUpInMap, VTS_I2 VTS_I2 VTS_XPOS_PIXELS VTS_YPOS_PIXELS)

ON_EVENT(CMapXSampleView, IDC_MAP, MAPX_DISPID_TOOLUSED,

OnToolUsed, VTS_I2 VTS_R8 VTS_R8 VTS_R8 VTS_R8 VTS_R8 VTS_BOOL

VTS_BOOL VTS_PBOOL)

ON_EVENT(CMapXSampleView, IDC_MAP,

MAPX_DISPID_THEMEMODIFYREQUESTED, OnThemeModifyRequested,

VTS_DISPATCH)

END_EVENTSINK_MAP()

随后是用于OnToolUsed 事件的事件处理程序代码。来自CMapXSampleView.h 的声明：

void OnToolUsed(short ToolNum, double X1, double Y1, double X2,double Y2, double

Distance, BOOL Shift, BOOL Ctrl, BOOL* EnableDefault);

…以及来自CMapXSampleView.cpp 的实现方式（我们只使用 TRACE 宏将参数输出到调试窗口）：

void CMapxSampleView::OnToolUsed(short ToolNum, double X1, double Y1,

double X2, double Y2, double Distance, BOOL Shift, BOOL Ctrl, BOOL* EnableDefault)

{

CString str;

str.Format("Tool=%d, [%f,%f] [%f, %f], dist=%f, %s %sn",ToolNum, X1,Y1,X2,Y2,Distance,

(Shift)?"Shift":"",(Ctrl)?"Ctrl":"");

TRACE(str);

}

3.6 添加快捷菜单

DISPID_MOUSEUP事件可用于添加快捷（鼠标右键按钮）菜单。为您的快捷菜单创建菜单资源（如果菜单资源的ID为IDR_CONTEXTMENU）。OnMouseUpInMap 处理程序类似于以下代码：

// if right mouse button, display the context menu

BOOL CMapxSampleView::OnMouseUpInMap(short Button, short Shift,

OLE_XPOS_PIXELS x,OLE_YPOS_PIXELS y)

{

if (Button == 2) { // right button

CMenu menu; // top-level menu

CMenu *pMenu=NULL; // pop-up menu

// Load the menu resource.

menu.LoadMenu(IDR_CONTEXTMENU);

// TrackPopupMenu cannot display the top-level menu, so get

// the handle of the first pop-up menu.

pMenu = menu.GetSubMenu(0);

if (!pMenu) {

return TRUE;

}

SetMenuDefaultItem(pMenu->m_hMenu, ID_VIEW_PROPERTIES,

FALSE);

// Display the floating pop-up menu. Track the right mouse

// button on the assumption that this function is called

// during WM_CONTEXTMENU processing.

POINT pt;

GetCursorPos(&pt);

pMenu->TrackPopupMenu(TPM_LEFTALIGN | TPM_RIGHTBUTTON,

pt.x, pt.y, this, NULL);

// Destroy the menu.

menu.DestroyMenu();

}

return TRUE;

}

3.7 MapX异常错误处理

MapX通过报告（引发）COleDispatchException 来报告大多数错误。在调用 MapX 时捕获异常错误是十分重要的，因为MFC的默认异常错误处理程序不捕获它们并且您的应用程序将退出。在消息框中显示对错误的说明也是非常有用的。错误消息的文本将帮助您确定是否正确使用了 MapX 图元，或者是否已发生某一其它问题。

COleDispatchException类还在公共成员m_wCode中包括错误代码，以便您的程序可以标识和处理不同类型的错误。对于错误代码及其说明的列表，请参见联机帮助中的 MapX 错误代码。

如果在尝试调用MapX时具有一般的OLE错误（在您使用过时的MapX.h 或 MapX.cpp 版本时可能发生），则 MFC 将引发 COleException。建议你在调用 MapX 时捕获全部两个异常错误类型。

MapX 也可能在 Error 事件中传递错误（尽管非常少见）。只有在不从MapX属性或方法直接调用的异步处理（像redraw）期间出现某种类型的错误时，才可能发生上述情况。

在此示例的 ThemeModifyRequested 事件的事件处理程序中，我们显示普通的“主题”属性对话框以让用户更改主题颜色等。请注意异常错误处理的方式。

// Note: in objects passed to events, the event handler

// does not change the reference count

// ie: do not call release on the object

void CMapxSampleView::OnThemeModifyRequested(LPDISPATCH Theme)

{

try {

CMapXTheme theme;

COptionalVariant vHelpFile, vHelpID;

// mark as optional since we don't have a helpfile

theme.AttachDispatch(Theme, FALSE); // don't auto release

theme.ThemeDlg(vHelpFile, vHelpID);

// could decide to bring up legend dlg here instead

//CMapXLegend leg(theme.GetLegend());

//leg.LegendDlg(vHelpFile, vHelpID);

}

catch (COleDispatchException *e) {

e->ReportError();

e->Delete();

}

catch (COleException *e) {

e->ReportError();

e->Delete();

}

}