Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

------------------------------------------------------------------------------------------------Chng ny dnh cho nhng nh lp trnh mun xy dng v trin khai mt ng dng s dng .NET. N miu t qu trnh xy dng v trin khai mt ng dng se dng Cc iu khin ArcGIS.

Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

Miu t d n.

Mc ch ca vic xy dng cc ng dng vi Window Control l gip bn quen thuc vi cc bc cn thit pht trin v trin khai mt ng dng Web s dng cc iu khin ArcGIS tiu chun bn trong VS .NET API. v d ny s dng cc iu khin MapControl, PageLayoutControl, T - 1 -Chu :OC Control v ToolbarControl nh l nhng iu khin ca Windows bn trong mi trng .NET. cac nh lp trnh COM, Java, v C++ nn tp trung vo cc v d sau: Xy dng cc ng dng vi ActiveX, xy dng cc ng dng vi visual JavaBeans,... V d ny cung cp cc bc cn thit to ra mt ng dng GIS cho vic xem cc ti liu bn c to ra t trc s dng ArcMap - mt ng dng ArcGIS Desktop: + Np v nhng cc iu khin ArcGIS Control trong .NET. + Np ti liu c to ra t trc trong MapControl v PageLayoutControl. + Thit t cc iu khin ToolbarControl v TOCControl. + iu khin vic thay i kch c form. + Thm cc lnh v cc cng c ArcGIS Engine cho ToolbarControl. + To ra cc thanh cng c x xung. + Qun l vic chnh sa nhn trong TOCControl. + V cc hnh khi trong MapControl. + To ra mt cng c ngi dng lm vic vi MapControl, PageLayoutControl v ToolbarControl. + Trin khai ng dng trong h iu hnh Win.

Ni dung.

V d ny c thc thi trong mi trng .NET v s dng cc thnh phn ESRI cha ArcGIS bn trong cc iu khin Windows. Cc thnh phn ESRI ny hot ng nh mt cu ni gia m khng c qun l (unmanaged code) ca COM v cc cc m .NET c qun l.Bt c tham chiu no ti cc thnh vin ca cc iu khin ArcGIS COM u c hng toi i tng COM thc s. Tng t nh vy, nhng phn hi t i tng COM cng c a qua cc thnh phn c th tch hp ESRI ri a ti ng dng .NET. Mi iu khin ArcGIS Engine u c cc s kin, thuc tnh v phng thc c th c truy nhp khi c nhng bn trong .NET form. Cc i tong v chc nng bn trong mi iu khin c th c
----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 1

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

kt hp vi cc iu khin ESRI v iu khin t to khc to ra ng dng cui cng pha ngi dng. V d ny c vit bi c CSharp v VisualBasic.NET, mc d qu trnh thc thi sau tp trung vo cc v d CSharp. Nhiu nh lp trnh s cm thy thoi mi hn vi VB.NET, trong khi cu trc ca ngn ng lp trnh CSharp s quen thuc hn vi nhng nh lp trnh Java v C++. D mi trng lp trnh th no i na, bn s thnh cng vi cc iu khin ArcGIS ph thuc vo k nng trong trong mi trng lp trnh v ArcObjects. MapControl, PageLayoutControl,TOCControl v ToolbarControl c s dng trong v d ny cung cp giao din lp trnh ng dng cho ngi s dng.C iu khin ArcGIS ny c s dng lm cu ni trung gian gia cc ArcObjects khc v c cu lnh ArcGIS Engine to ra mt ng dng hin th thng tin a l.

Thit k.

ng dng ny c thit k trc ht lm ni bt vn cc iu khin ArcGIS s tng tc vi nhau nh th no, v th hai biu din mt vi kiu i tng iu khin ArcGIS cho ngi lp trnh. Mi iu khin ArcGIS .NET c mt b cc thuc tnh c th truy nhp khi iu khin c nhng trong mi trng .NET. Nhng trang thuc tnh ny cung cp nhng con ng ngn nht cho vic thit t cc thuc tnh v phng thc ca iu khin, v cho php nh lp trnh xy dng ng dng m khng phi vit code. ng dng ny khng s dng cc trang thuc tnh, m xy dng ng dng thun nht l lp trnh. Mun tm hiu them nhng thng tin v cc trang thuc tnh, hy c ArcGIS Developer Help.

Nhng thnh phn cn thit.

Ci t ArcGIS Engine Developer Kit v cc file bn quyn. Ci t .NET 2003, .NET Framework 1.1 v bn quyn thch hp. Ngi lp trnh phi quen thuc vi h iu hnh Windows v kin thc lm vic vi .NET, hoc vi CSharp hoc vi VB.NET. V d ny cung cp mt s thng tin v cch s dng cc iu khin ArcGIS trong .NET,ch n khng phi l s thay th cho vic thc hnh trong mi trng lp trnh. Kin thc c bn v ArcObjects v ng dng ArcGIS, chng hn ArcMap v ArcCatalog,trong khi khng cn phi nm su lm v cc phn mm ESRI khc. V d ny c trong ng dn: <install_location>\DeveloperKit\Samples\Developer_Guide_Scenarios\ArcGI S_Engine\Building_an_ArcGIS_Control_Application\Map_Viewer. Cc iu khin v th vin s dng trong v d ny bao gm: AxMapControl AxTOCControl AxPageLayoutControl AxToolbarControl ESRI.ArcGIS.Carto ESRI.ArcGIS.System
----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 2

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

ESRI.ArcGIS.Display ESRI.ArcGIS.Geometry esriMapControl esriPageLayoutControl

ESRI.ArcGIS.SystemUI ESRI.ArcGIS.Utility esriTOCControl esriToolbarControl

Thc thi ng dng:

Np cc iu khin ArcGIS: Trc khi bt u lp trnh ng dng, cc iu khin ArcGIS v cc tham chiu th vin ArcGIS Engine khc m ng dng s dng phai c np trong mi trng ng dng. 1. Khi ng VS.NET v to mt ng dng Windows Application ca C# t hp thoi New project. 2. t tn ng dng l Controls, v duyt v tr save ng dng. 3. Bm chut phi vo tab Windows Form ca thanh cng c v chn Add/ Remove Items t menu ng cnh. 4. Trong hp thoi Customize Toolbox, chn .NET Framework v check vo AxMapControl, AxPageLayoutControl,v AxTOCControl. Chn OK. Cc iu khin ny gi y xut hin trong tab Windows Forms ca thanh cng c.

5.Chn Project trn thanh menu ri chn Add Reference 6.Trong hp thoi Add Reference, nhy p vo ESRI.ArcGIS.Carto, ESRI.ArcGIS.Display, ESRI.ArcGIS.Geometry, ESRI.ArcGIS.System, ESRI.ArcGIS.SystemUI, ESRI.ArcGIS.Utility ri chn OK.
----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 3

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

Nhng cc iu khin ArcGIS trong mt container. Trc khi bn c th truy cp cc thuc tnh, phng thc cng nh cc s kin ca cc iu khin, mi iu khin cn c nhng bn trong mt ni cha trong .NET. Khi cc iu khin c nhng bn trong form, chng s xut hin trong giao din lp trnh ngi s dng ca ng dng. 1. M .NET Form 2. Kch p vo AxMapControl trong Windows Forms tab ca thanh cng c them mt MapControl trn form. 3. Lp li thao tc ny vi AxPageLayoutControl, AxTOCControl v AxToolbarControl. 4. Thay i kch thc v thay i v tr ca cc iu khin trn form nh sau:

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

5.Kch p vo form hin th code ca form. S dng cc directives sau ti v tr trn cng ca on m:
using System; using System.Windows.Forms; using ESRI.ArcGIS.SystemUI; using ESRI.ArcGIS.Carto; using ESRI.ArcGIS.Display; using ESRI.ArcGIS.Geometry; using ESRI.ArcGIS.esriSystem; using esriToolbarControl; using esriTOCControl;

Np cc ti liu Map trong PageLayoutControl v MapControl Cc lp d liu v cc ti liu ring bit c to t trc m s dng ArcMap- mt ng dng ArcGIS Desktop, c th c np trong iu khin MapControl v PageLayoutControl.Bn c th np bn theo v d hoc np mt bn bt k theo s thch c nhn. 1.Chn s kin Form_Load v np dng code sau (nu bn s dng bn ring th phi thay th tn file bn chnh xc)
private void Form1_Load(object sender, System.EventArgs e) { //Np bn c to t trc trong PageLayoutControl s dng cc ng dn quan //Np h. string fileName = ----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 5

Nguyn Hong Minh ---------------------------------------------------------------------------------------------------------------------@"..\..\..\..\..\..\..\..\Data\\ArcGIS_Engine_Developer_Guide\Gulf of St. Lawrence.mxd"; if (axPageLayoutControl1.CheckMxFile(fileName)) { axPageLayoutControl1.LoadMxFile(fileName,""); } }

2.Hin th form v chn axPageLayoutControl1 t ca s thuc tnh v hin th cc s kin ca axLayoutControl. Kch p vo s kin OnPageLayoutReplace thm phng thc x l s kin.

3. Trong s kin axPageLayoutControl_ OnPageLayoutReplace thm vo dng code sau np bn tng t vo MapControl.
private void axPageLayoutControl1_OnPageLayoutReplaced(object sender, ESRI.ArcGIS.PageLayoutControl.IPageLayoutControlEvents_OnPageLayoutReplacedEvent e) { //Np cng ti liu bn trong MapControl axMapControl1.LoadMxFile(axPageLayoutControl1.DocumentFilename,null, axMapControl1.LoadMxFile(axPageLayoutControl1.DocumentFilename,null, null); //t s m rng ca iu khin MapControl ty theo kch c thc ca nh ----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 6

Nguyn Hong Minh ---------------------------------------------------------------------------------------------------------------------axMapControl1.Extent = axMapControl1.FullExtent; }

Thit t TOCControl v ToolbarControl TOCControl v ToolbarControl lm vic nh l cu ni vi PageLayoutControl ch khng phi l vi MapControl. lm c nh th, PageLayoutControl phi c thit t l buddy control. TOCControl s dng ActiveView ca buddy cha bn , cc lp v cc biu tng, trong khi bt c cu lnh, cng c hoc cc menu items trn ToolbarControl s tng tc vi s hin th ca buddy control. 1.Trong s kin Form_Load nhp vo nhng dng code sau :
private void Form1_Load(object sender, System.EventArgs e) { //Np bn c to t trc trong PageLayoutControl s dng cc ng dn quan h. string fileName =@"..\..\..\..\..\..\..\..\Data\\ArcGIS_Engine_Developer_Guide\Gulf of St.Lawrence.mxd"; if (axPageLayoutControl1.CheckMxFile(fileName)) { axPageLayoutControl1.LoadMxFile(fileName,""); } //Thit t cc iu khin buddy. axTOCControl1.SetBuddyControl(axPageLayoutControl1); axToolbarControl1.SetBuddyControl(axPageLayoutControl1); }

2. Xy dng v chy ng dng. Bn s c np trong PageLayoutControl v TOCControl s thng k cc lp d liu trong bn . S dng TOCControl thit t cc lp n hay hin bng cch check hay uncheck vo cc hp. Theo mc nh, tiu im bn s c np vo MapControl. Ti thi im ny, toolbarControl s trng bi khng c cu lnh no c add vo. Th thay i kch c ca form, v ch rng cc iu khin khng thay i kch c.

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

iu khin form thay i kch c Khi form thay i kch c ti thi im chng trnh ang chy, PageLayoutControl v MapControl khng t ng thay i kch c theo form. thay i kch c cc control ny chng lun c th ko di lp y form, bn phi c nh (anchor) cc iu khin vo form. Nu PageLayoutControl v MapControl cha nhiu d liu th redraw (np li) d liu khi s kin Form_Resize xy ra. tng hiu qu thc thi, bn c th ngn cn d liu redraw (np li) cho n khi qu trnh thay i kch c kt thc. Trong qu trnh thay i kch c, ch c mt bitmap c v li m thi.
1. Hin thj form v chon axPageLayoutControl1 t ca s thuc tnh. Chn thuc

tnh v c nh axPageLayoutControl vi l trn, di, tri,phi ca form.

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

2. C nh axMapcontrol vi l trn, di v tri ca form.

3.Thm dng code sau vo u s kin Form_Load:

private void Form1_Load(object sender, System.EventArgs e) { //Ngn cn vic v li trong khi thay i kch c form. this.SetStyle(ControlStyles.EnableNotifyMessage,true); }

4.Khai bo cc hng s sau:

public class Form1 : System.Windows.Forms.Form { private const int WM_ENTERSIZEMOVE = 0x231; private const int WM_EXITSIZEMOVE = 0x232;

5.Thm cc dng code sau np chng phng thc OnNotifyMessage

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 9

Nguyn Hong Minh ---------------------------------------------------------------------------------------------------------------------protected override void OnNotifyMessage(System.Windows.Forms.Message m) { base.OnNotifyMessage (m); if (m.Msg == WM_ENTERSIZEMOVE) { axMapControl1.SuppressResizeDrawing(true, 0); axPageLayoutControl1.SuppressResizeDrawing(true, 0); } else if (m.Msg == WM_EXITSIZEMOVE) { axMapControl1.SuppressResizeDrawing(false, 0); axPageLayoutControl1.SuppressResizeDrawing(false, 0); } }

6.Xy dng v sau chy th chng trnh. Th thay i kch c Form Thm cc cu lnh vo ToolbarControl ArcGIS Engine xy dng trn 120 cu lnh v cng c lm vic trc tip vi MapControl, PageLayoutControl v ToolbarControl. Nhng cu lnh v cng c ny cung cp cho bn rt nhiu cc chc nng GIS c s dng thng xuyn cho vic iu chnh bn , qun l nh v la chn cc tnh nng. Bn s thm nhng cu lnh v cng c vo ng dng ca bn. 1.Thm nhng dng m sau vo s kin Form_Load:
private void Form1_Load(object sender, System.EventArgs e) { string progID; //Thm nhng cu lnh thng thng. progID = "esriControlToolsGeneric.ControlsOpenDocCommand"; axToolbarControl1.AddItem(progID, -1 , -1, false, 0, esriCommandStyles.esriCommandStyleIconOnly); //Thm nhng cu lnh iu chnh PageLayout. progID = "esriControlToolsPageLayout.ControlsPageZoomInTool"; axToolbarControl1.AddItem(progID, -1, -1, true, 0, esriCommandStyles.esriCommandStyleIconOnly); progID = "esriControlToolsPageLayout.ControlsPageZoomOutTool"; axToolbarControl1.AddItem(progID, -1, -1, false, 0, esriCommandStyles.esriCommandStyleIconOnly); progID = "esriControlToolsPageLayout.ControlsPagePanTool"; axToolbarControl1.AddItem(progID, -1, -1, false, 0, esriCommandStyles.esriCommandStyleIconOnly); progID = "esriControlToolsPageLayout.ControlsPageZoomWholePageCommand"; axToolbarControl1.AddItem(progID, -1, -1, false, 0, esriCommandStyles.esriCommandStyleIconOnly); progID = ----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 10

Nguyn Hong Minh ---------------------------------------------------------------------------------------------------------------------"esriControlToolsPageLayout.ControlsPageZoomPageToLastExtentBackCommand"; axToolbarControl1.AddItem(progID, -1, -1, false, 0, esriCommandStyles.esriCommandStyleIconOnly); progID = "esriControlToolsPageLayout.ControlsPageZoomPageToLastExtentForwardCommand"; axToolbarControl1.AddItem(progID, -1, -1, false, 0, esriCommandStyles.esriCommandStyleIconOnly); //Thm nhng cu lnh iu chnh Map. //Thm progID = "esriControlToolsMapNavigation.ControlsMapZoomInTool"; axToolbarControl1.AddItem(progID, -1, -1, true, 0, esriCommandStyles.esriCommandStyleIconOnly); progID = "esriControlToolsMapNavigation.ControlsMapZoomOutTool"; axToolbarControl1.AddItem(progID, -1, -1, false, 0, esriCommandStyles.esriCommandStyleIconOnly); progID = "esriControlToolsMapNavigation.ControlsMapPanTool"; axToolbarControl1.AddItem(progID, -1, -1, false, 0, esriCommandStyles.esriCommandStyleIconOnly); progID = "esriControlToolsMapNavigation.ControlsMapFullExtentCommand"; axToolbarControl1.AddItem(progID, -1, -1, false, 0, esriCommandStyles.esriCommandStyleIconOnly); }

Xy dng v chy th ng dng. ToolbarControl by gi cha cc cu lnh ArcGIS Engine v cc cng c bn c th s dng iu chnh bn c np trong PageLayoutControl. S dng cc cu lnh page layout iu chnh quanh page layout thc s v cc cu lnh bn iu chnh d liu xut hin trong khung d liu. S dng cu lnh m ti liu duyt v np cc ti liu khc.

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

11

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

To Popup menu cho LayoutControl Cng vi vic thm cc cu lnh ArcGIS Engine vo ToolbarControl lm vic vi cc buddy control, bn cn c th to cc popup menu t cc cu lnh ArcGIS Engine. Bn s thm mt popup menu lm vic vi PageLayoutControl. Popup Menu ny s hin th bt c khi no bn kch chut phi trong vng hin th ca PageLayoutControl 1. Thm nhng bin thnh vin sau :
public class Form1 : System.Windows.Forms.Form { private ESRI.ArcGIS.ToolbarControl.AxToolbarControl axToolbarControl1; private ESRI.ArcGIS.TOCControl.AxTOCControl axTOCControl1; private ESRI.ArcGIS.MapControl.AxMapControl axMapControl1; private ESRI.ArcGIS.PageLayoutControl.AxPageLayoutControl axPageLayoutControl1; private IToolbarMenu m_ToolbarMenu = new ToolbarMenuClass(); //The popup menu

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

12

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

2. Thm nhng dng code sau vo s kin Form_Load tip theo nhng dng code thm cc lnh vo ToolbarControl, nhng trc cc dng code np (load) bn :
private void Form1_Load(object sender, System.EventArgs e) { //Thm nhng cu lnh iu chnh bn //Chia s command pool ca ToobarControl. m_ToolbarMenu.CommandPool = axToolbarControl1.CommandPool; axToolbarControl1.CommandPool; //Thm nhng cu lnh vo toolbarMenu. progID = "esriControlToolsPageLayout.ControlsPageZoomInFixedCommand"; m_ToolbarMenu.AddItem(progID, -1, -1, false, esriCommandStyles.esriCommandStyleIconAndText); progID = "esriControlToolsPageLayout.ControlsPageZoomOutFixedCommand"; m_ToolbarMenu.AddItem(progID, -1, -1, false, esriCommandStyles.esriCommandStyleIconAndText); progID = "esriControlToolsPageLayout.ControlsPageZoomWholePageCommand"; m_ToolbarMenu.AddItem(progID, -1, -1, false, esriCommandStyles.esriCommandStyleIconAndText); progID = "esriControlToolsPageLayout.ControlsPageZoomPageToLastExtentBackCommand"; m_ToolbarMenu.AddItem(progID, -1, -1, true, esriCommandStyles.esriCommandStyleIconAndText); progID = "esriControlToolsPageLayout.ControlsPageZoomPageToLastExtentForwardCommand"; m_ToolbarMenu.AddItem(progID, -1, -1, false, esriCommandStyles.esriCommandStyleIconAndText); // Mc axPageLayoutControl vi ToolbarMenu. m_ToolbarMenu.SetHook(axPageLayoutControl1); //Np bn ... }

3.Hin th Form dng ang thit k v chn axPageLayoutControl1 t ca s thuc tnh, sau hin th cc s kin ca axPageLayoutControl. Kch p vo s kin OnMouseDown thm phng thc x l s kin 4.Trong s kin axPageLayoutControl_OnMouseDown thm nhng dng code sau:
private void axPageLayoutControl1_OnMouseDown(object sender, ESRI.ArcGIS.PageLayoutControl.IPageLayoutControlEvents_OnMouseDownEvent e) { //popup ToobarMenu. if (e.button == 2) { m_ToolbarMenu.PopupMenu(e.x,e.y,axPageLayoutControl1.hWnd); } } ----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 13

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

5.Xy dng v chy th chng trnh. Kch chut phi ln vng hin th ca PageLayoutControl hin th popup menu, v sau iu chnh quanh page layout.

iu khin vic chnh sa nhn trong TOCControl Theo mc nh, TOCControl cho php ngi dng thit t vic n hay hin ca cc lp v thay i bn v tn cc lp khi chng xut hin. Bn s thm code ngn cn user chnh sa tn v thay th chng vi mt chui trng. 1.Thm nhng dng code vo u s kin Form_Load:
private void Form1_Load(object sender, System.EventArgs e) private { axTOCControl1.LabelEdit = esriTOCControlEdit.esriTOCControlManual; //Thm nhng cu lnh chung }

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

14

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

2.Hin th Form dng thit k v chn AxTOCControl t ca s thuc tnh v hin th cc s kin AxTOCControl. Kch dp vo OnEndLabelEdit thm phng thc x l s kin. 3. Thm nhng dng code vo s kin axTOCControl_OnEndLabelEdit:
private void axTOCControl1_OnEndLabelEdit(object sender, ESRI.ArcGIS.TOCControl.ITOCControlEvents_OnEndLabelEditEvent e) { //Nu nhn mi l mt chui trng th tm ngng vic chnh sa li. string newLabel = e.newLabel; if (newLabel.Trim() == "") { e.canEdit = false; } }

4.Xy dng v chy th chng trnh. iu chnh mt bn , mt lp ,tiu hay cc nhn ch thch trong TOCControl, click vo n 1 ln v sau click vo n ln th 2 bt u thay i nhn. Th thay th nhn vi mt chui trng. Bn c th s dng phm ESC bt c khi no trong qu trnh chnh sa nhn tm ngng vic thay i nhn li.

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

15

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

V cc hnh khi trong MapControl Bn s s dng MapControl nh l mt ca s khung nhn v v ln trn phm vi hin thi ca bn bn trong PageLayoutControl. Khi bn iu chnh xung quanh d liu bn trong khung d liu ca PageLayoutControl, bn s thy cp nht ca khung ca s MapControl. 1. Thm nhng bin thnh vin sau:
public class Form1 : System.Windows.Forms.Form { private ESRI.ArcGIS.ToolbarControl.AxToolbarControl axToolbarControl1; private ESRI.ArcGIS.TOCControl.AxTOCControl axTOCControl1; private ESRI.ArcGIS.MapControl.AxMapControl axMapControl1; private ESRI.ArcGIS.PageLayoutControl.AxPageLayoutControl axPageLayoutControl1; private IToolbarMenu m_ToolbarMenu = new ToolbarMenuClass(); private IEnvelope m_Envelope; //ng bao c v trn MapControl. private Object m_FillSymbol; //Biu tng v ng bao trong MapControl. private ITransformEvents_VisibleBoundsUpdatedEventHandler visBoundsUpdatedE; //S kin tiu im bn ca PageLayoutMapControl.

2. To mt hm mi gi l CreateOverviewSymbol. y l ni bn s to ra cc biu tng c s dng trong MapControl i din cho phm vi ca d liu trong bn ca PageLayoutControl. Thm nhng dng code sau to ra hm:
private void CreateOverviewSymbol() { //Ly giao din IRGBColor. IRgbColor color = new RgbColor(); //t thuc tnh mu. color.RGB = 255; //Ly giao in biu tng ILine ILineSymbol outline = new SimpleLineSymbol(); //t thuc tnh ca biu tng ng thng. outline.Width = 1.5; outline.Color = color; //Ly giao din IFillSymbol. ISimpleFillSymbol simpleFillSymbol = new SimpleFillSymbolClass(); //Thit t thuc tnh ca fill symbol. simpleFillSymbol.Outline = outline; simpleFillSymbol.Style = esriSimpleFillStyle.esriSFSHollow; m_FillSymbol = simpleFillSymbol; }

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

16

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

3. Gi hm CreateOverviewSymbol t s kin Form_Load trc on m v chnh sa nhn cho TOCControl.

private void Form1_Load(object sender, System.EventArgs e) { //To ra biu tng s dng trong MapControl. CreateOverviewSymbol(); //Thit t chnh sa nhn } 4. Thm hm OnVisibleBoundUpdated. Hm ny s lien kt ti mt s kin

c pht sinh bt c khi no phm vi ca bn b thay i v c s dng thit t mt ng bao cho ranh gii nhn thy c ca bn . Lm ti MapControl v hin th mi.
private void OnVisibleBoundsUpdated(IDisplayTransformation sender, bool sizeChanged) { //Thit t ng bao mi cho phm vi nhn thy c. m_Envelope = sender.VisibleBounds; //Refresh MapControl. axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase. esriViewForeground, null, null); }

5. Giao din s kin mc nh ca PageLayoutControl l IPageLayoutControlEvents. Nhng s kin ny khng bit khi no phm vi ca bn bn trong khung d liu thay i. n nhn ra s thay i ny,chng ta phi dng giao din ItransformEvents ca tiu im bn bn trong PageLayoutControl. Thm nhng dng code sau vo hm x l s kin PageLayoutControl_OnPageLayoutReplaced trc on m load bn .
private void axPageLayoutControl1_OnPageLayoutReplaced(object sender, ESRI.ArcGIS.PageLayoutControl.IPageLayoutControlEvents_OnPageLayoutReplacedEvent e) { //Ly giao din IActiveView ca bn trong PageLayoutControl. IActiveView activeView = (IActiveView) axPageLayoutControl1.ActiveView.FocusMap; //By ITranformEvents ca tiu im bn bn trong PageLayoutControl visBoundsUpdatedE = new ITransformEvents_VisibleBoundsUpdatedEventHandler(OnVisibleBoundsUpdated); ((ITransformEvents_Event)activeView.ScreenDisplay. DisplayTransformation).VisibleBoundsUpdated += visBoundsUpdatedE; //Ly phm vi ca bn . //Ly m_Envelope = activeView.Extent; //Np cng bn c to ra t trc trong MapControl. //Np ----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 17

Nguyn Hong Minh ---------------------------------------------------------------------------------------------------------------------axMapControl1.LoadMxFile(axPageLayoutControl1.DocumentFilename,null,null); //t phm vi ca MapControl vi pham vi y ca d liu. //t axMapControl1.Extent = axMapControl1.FullExtent; }

6. Hin th Form ang thit kt v chn axMapControl1 t ca s thuc tnh v hin th cc s kin ca axMapControl. Kch p trn s kin OnAfterDraw v thm trnh x l s kin. 7. Thm nhng dng code sau vo hm x l s kin axMapControl_OnAfterDraw v mt ng bao vi biu tng m bn to ra t trc trn MapControl.
private void axMapControl1_OnAfterDraw(object sender, ESRI.ArcGIS.MapControl.IMapControlEvents2_OnAfterDrawEvent e) { if (m_Envelope == null) { return; } //Nu nn c v li. esriViewDrawPhase viewDrawPhase = (esriViewDrawPhase) e.viewDrawPhase; if (viewDrawPhase == esriViewDrawPhase.esriViewForeground) { IGeometry geometry = m_Envelope; axMapControl1.DrawShape(geometry, ref m_FillSymbol); } }

8. Xy dng chng trnh v chy th. S dng cc cng c iu hng m bn

thm vo t trc thay i phm vi bn trong PageLayoutControl.Phm vi mi s c v ra trong MapControl.

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

18

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

To cng c mi To cc lnh v cng c lm vic vi MapControl v PageLayoutControl rt ging vi vic to cc lnh cho ng dng ESRI ArcMap bn lm cc chng trc. Bn s to mt cng c cho php thm ngy thng hin ti va v tr kch chut trong PageLayoutControl. Bn cng s to cc lnh lm vic vi MapControl v ToolbarControl. on m cho cc cng c ngi dng t nh ngha ny l on m ngun cn li ca v d ny. Nu bn mun s dng lnh ngi dng t nh ngha mt cch trc tip ch khng mun t to n, bn c th i thng ti bc 24. 1. o mt n Class Library trong C# t hp thoi New. 2. t tn chng trnh l Commands, duyt v tr t file v save chng trnh. 3. Click trn menu Project v chn Add Reference 4. Trong hp thoi Add Reference, check ESRI.ArcGIS.Geometry, ESRI.ArcGIS.System , ESRI.ArcGIS.SystemUI , ESRI.ArcGIS.Utility v ESRI.ArcGIS.ControlCommands. 5. Them mt lp vo project, t tn l AddDateTool. 6. Click vo menu Project v chn Add Existing Item. Duyt file date.bmp t v tr m ngun v d v thm n vo n ca bn. 7. Click vo date.bmp trong ca s Solution Explorer hin th cc thuc tnh ca n trong ca s thuc tnh. Thay i thuc tnh Build Action thnh
----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 19

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

Embedded Resource. nh date.bmp c s dng lm trn b mt ca nt lnh. 8. Thay i namespace ca AddDateTool thnh CSharpDotNETCommands.
namespace CSharpDotNETCommands { .

9. Thm nhng directive sau on m trn cng:

using System; using ESRI.ArcGIS.Carto; using ESRI.ArcGIS.Display; using ESRI.ArcGIS.Geometry; using ESRI.ArcGIS.SystemUI; using ESRI.ArcGIS.esriSystem; using ESRI.ArcGIS.ControlCommands; using ESRI.ArcGIS.Utility.BaseClasses; using System.Runtime.InteropServices; 10. Khai bo lp AddDateTool c tha k t lp o ESRI BaseTool v thm

vo modifier sealed:
public sealed class AddDateTool : BaseTool

11. Thm nhng dng code sau vo constructor ca lp AddDateTool. public AddDateTool() {

//Ly mng cc ti nguyn trong Assembly. string[] res = GetType().Assembly.GetManifestResourceNames(); //Thit t thuc tnh cho cng c. base.m_bitmap = new System.Drawing.Bitmap(GetType().Assembly.GetManifestResourceStream(res[0])); base.m_caption = Add Date; base.m_category = "CustomCommands"; base.m_message = "Adds a date element to the page layout"; base.m_name = "CustomCommands_Add Date"; base.m_toolTip = "Add date"; }

12. Thm nhng bin thnh vin sau vo lp AddDateTool:

public sealed class AddDateTool : BaseTool { private IHookHelper m_HookHelper = new HookHelperClass(); ----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 20

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

13. Trong ca s ClassView, iu chnh ti phng thc BaseCommand OnCreate v chn chut phi hin th menu ng cnh.Chn Add, sau np chn Override thm thuc tnh vo ca s vit code 14. Thm on m sau vo phng thc np chng OnCreate:
public override void OnCreate(object hook) { m_HookHelper.Hook = hook; }

15. Trong ca s ClassView, tm thuc tnh BaseCommand Enable, bm chut phi hin th menu ng cnh. Chon Add, Override thm thuc tnh ny vo on m. 16. Thm on m sau np chng gi tr Enable mc nh khi c thc thi bi lp BaseTool.
public override bool Enabled { get { if (m_HookHelper.ActiveView != null) { return true; } else { return false; } } }

17. Trong ca s ClassView, chnh ti phng thc BaseToolOnMouseDown v bm chut phi hin th menu ng cnh. Chn Add, sau Override thm thuc tnh vo on m. 18. Thm on code sau np chng hm mc nh OnMouseDown khi c thc thi bi BaseTool class.
public override void OnMouseDown(int Button, int Shift, int X, int Y) { base.OnMouseDown (Button, Shift, X, Y); //Ly khung nhn ang hot ng. IActiveView activeView = m_HookHelper.ActiveView; //To mt thnh t vn bn mi. ITextElement textElement = new TextElementClass(); //To biu tng vn bn. ITextSymbol textSymbol = new TextSymbolClass(); ----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 21

Nguyn Hong Minh ---------------------------------------------------------------------------------------------------------------------textSymbol.Size = 25; //Thit t thuc tnh ca vn bn. textElement.Symbol = textSymbol; textElement.Text = DateTime.Now.ToShortDateString(); //QI cho IElement. IElement element = (IElement) textElement; //To mt page point. IPoint point = new PointClass(); point = activeView.ScreenDisplay.DisplayTransformation.ToMapPoint(X,Y); //Thit t elements geometry element.Geometry = point; activeView.GraphicsContainer.AddElement(element, 0); //Lm ti graphics. activeView.PartialRefresh(esriViewDrawPhase.esriViewGraphics, null, null); }

19. ArcGIS Engine thch hp vi cc lnh ngi dng t nh ngha l mt lp COM, bi vy, lp .NET m bn to phi c biu th nh mt lp COM bng cch to mt gi COM c th gi c cho lp .NET . Trong ca s Solution Explorer, chn chut phi vo project Commands v chn Properties t menu ng cnh. 20. Trong hp thoi Property, chon Configuration Properties,v click vo Build. Trong khung bn phi, thay i thuc tnh Register for COM Interop thnh True. Nhn OK. 21. Trong ca s lp trnh ca lp AddDateTool, thm vo cc dng lnh khai bo lp AddDateTool, xc nh cc thuc tnh cn thit cho COM.
[ClassInterface(ClassInterfaceType.None)] [Guid("D880184E-AC81-47E5-B363-781F4DC4528F")]

22. Thm nhng dng m vo lop AddDateTool sau khi khai bo bin.on code nh ngha cc hm ng k v khng ng k lp AddDateTool vi loi thnh phn ESRI Controls Commands s dng cc loi tin ch (categories utility.)
//ng k trong loi thnh phn 'ESRI Controls Commands' #region Component Category Registration [ComRegisterFunction()] [ComVisible(false)] static void RegisterFunction(String sKey) { string fullKey = sKey.Remove(0, 18) + @"\Implemented Categories"; Microsoft.Win32.RegistryKey regKey = Microsoft.Win32.Registry.ClassesRoot.OpenSubKey(fullKey, true); if (regKey != null) { ----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 22

Nguyn Hong Minh ---------------------------------------------------------------------------------------------------------------------regKey.CreateSubKey("{B284D891-22EE-4F12-A0A9B1DDED9197F4}"); } } [ComUnregisterFunction()] [ComVisible(false)] static void UnregisterFunction(String sKey) { string fullKey = sKey.Remove(0, 18) + @"\Implemented Categories"; Microsoft.Win32.RegistryKey regKey = Microsoft.Win32.Registry.ClassesRoot.OpenSubKey(fullKey, true); if (regKey != null) { regKey.DeleteSubKey("{B284D891-22EE-4F12-A0A9-B1DDED9197F4}"); } } #endregion

23. Xy dng chng trnh. 24. Trong chng trnh VS.NET Windows Application bn to trc , thm on m lnh sau thm nhng lnh iu chnh bn :
private void Form1_Load(object sender, System.EventArgs e) { //Thm cc lnh iu khin ArcMap. //Thm cng c biu din ngy thng ngi dng t nh ngha. progID = "CSharpDotNETCommands.AddDateTool"; axToolbarControl1.AddItem(progID, -1, -1, true, 0, esriCommandStyles.esriCommandStyleIconAndText); //Thm cc cu lnh ti ToolbarMenu. }

25. Chy chng trnh v s dng AddDateTool thm cc thnh phn vn bn vo PageLayoutControl hin th ngy hin thi.

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

23

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

C nhn ha ToolbarControl Cng vi vic thm cc lnh v cng c ArcGIS Engine vo ToolbarControl trong s kin Form_Load,bn cn c th thc hin iu ny thng qua vic c nhn ha ToolbarControl v s dng hp thoi c nhn ha. lm nh th, bn s t ToolbarControl theo kiu customize v hin th hp thoi customize. 1.Thm nhng bin thnh vin sau:
public class Form1 : System.Windows.Forms.Form { private ITransformEvents_VisibleBoundsUpdatedEventHandler visBoundsUpdatedE; private ICustomizeDialog m_CustomizeDialog = new CustomizeDialogClass(); //CustomizeDialog c s dng bi ToolbarControl. private ICustomizeDialogEvents_OnStartDialogEventHandler startDialogE; private ICustomizeDialogEvents_OnCloseDialogEventHandler closeDialogE; ----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 24

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

2.To mt hm mi c tn l CreateCustomizeDialog. y l ni bn s to mt hp thoi customize bng cch thm nhng cu lnh sau trong hm:
private void CreateCustomizeDialog() startDialogE = new ICustomizeDialogEvents_OnStartDialogEventHandler(OnStartDialog); ((ICustomizeDialogEvents_Event)m_CustomizeDialog).OnStartDialog += startDialogE; closeDialogE = new ICustomizeDialogEvents_OnCloseDialogEventHandler(OnCloseDialog); ((ICustomizeDialogEvents_Event)m_CustomizeDialog).OnCloseDialog += closeDialogE; //Thit t ta m_CustomizeDialog.DialogTitle = Customize ToolbarControl Items; //Hin th nt lnh Add from file m_CustomizeDialog.ShowAddFromFile = true; //Thit t ToolbarControl c th thm cc item. m_CustomizeDialog.SetDoubleClickDestination(axToolbarControl1); }

3.Gi hm CreateCustomizeDialog t s kin Form_Load trc cu lnh gi hm CreateOverviewSymbol :

private void Form1_Load(object sender, System.EventArgs e) { //to hp thoi Customize cho ToolbarControl. CreateCustomizeDialog(); //To biu tng s dng trong ToolbarControl. }

4.Thm mt check box vo Form, t tn l chkCustomize v nhn l Customize 5.Hin th Form dng thit k v chn chkCustomize t ca s thuc tnh v hin th cc s kin ca chkCustomize. Kch p vo s kin CheckedChanged thm mt trnh x l s kin vo ca s lp trnh. 6.Thm on code sau vo s kin chkCustomize_CheckedChanged:
private void chkCustomize_CheckedChanged(object sender, System.EventArgs e) { //Hin th hay du i hp thoi customize. if (chkCustomize.Checked == false) { m_CustomizeDialog.CloseDialog(); axToolbarControl1.Customize = false; } else { ----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows 25

Nguyn Hong Minh ---------------------------------------------------------------------------------------------------------------------m_CustomizeDialog.StartDialog(axToolbarControl1.hWnd); axToolbarControl1.Customize = true; } }

7.Thm hm x l s kin OnStartDialog v OnCloseDialog. Nhng hm ny c lin kt vi cc s kin pht sinh bt c skhi no hp thoi customize m hoc ng.
private void OnStartDialog() { axToolbarControl1.Customize = true; } private void OnCloseDialog() { axToolbarControl1.Customize = false; chkCustomize.Checked = false; }

8.Xy dng v chy th chng trnh v check vo check box customize thit t ToolbarControl theo kiu c nhn ha v m hp thoi customize. 9.Trong tab Commands chn loi Graphics Element, kch p vo Select Elements thm n vo ToolbarControl. Click vo cc biu tng trn ToolbarControl, bn c th iu chnh giao din theo bn, hoc nhm cc i tng.

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

26

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

10.Tm ngng c nhn ha ng dng. S dng cng c select di chuyn dng vn bn cha ngy thng hin thi.

Trin khai ng dng

trin khai thnh cng ng dng trong mt my tnh khc, ng dng phi c c mt license. Trc ht n s kim tra xem product license c sn sng khng v sau n khi ng license ny. Nu ng k license tht bi, ng dng khng th hot ng. 1. Thm nhng bin thnh vin sau: 2. Thm nhng dng code sau vo u hm x l s kin Form_Load: 3. Hin th Form dng thit k v chn Form1 t ca s thuc tnh v hin th cc s kin ca Form. Click p vo s kin Closing thm hm x l s kin. 4. Trong s kin Form_Closing , thm nhng dng code sau: 5. Xy dng chng trnh v pht hnh ng dng. trin khai ng dng thn cng mt my khch:

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

27

Nguyn Hong Minh ----------------------------------------------------------------------------------------------------------------------

+ File chy ca chng trnh v DLL cha lnh c nhn ha cn c trin khai trn cc my khch. Cng c ng k thnh phn (RegAsm.exe) c s dng thm thng tin v cc lp c xy dng vi registry. +My khch cn phi ci t ArcGIS Engine Runtime v bn quyn ArcGIS Engine tiu chun. +My khch phi c ci t .NET Framework 1.1.

----------------------------------------------------------------------------------------------------------------Xy dng ng dng ArcGIS Engine vi cc iu khin Windows

28