How to get started with the MapControl property pages

In this topic

• Getting started with the MapControl property pages
  • Adding controls to the form

Getting started with the MapControl property pages

Adding controls to the form

1. Click the MapControl icon in the toolbox. On the form, click and drag from one corner to the opposite corner to place the MapControl. Alternatively, double-click the MapControl icon in the toolbox to automatically place the MapControl on the form. Follow the same procedure to add the TOCControl, ToolbarControl, and LicenseControl icons to the form. Rearrange the control positions and resize the controls to look similar to the following:
   
    
   
2. Right-click the MapControl and click Properties. The Properties dialog box opens.
3. Click the General tab, and click the Open folder button next to the Map Document field. See the following screen shot:
   

4. Navigate to a folder containing the map document, select the map document, and click Open.
5. On the Properties dialog box, click Apply to link the map document to the MapControl, then click OK to close the Properties dialog box.
6. Right-click the TOCControl and click Properties. The TOCControl Properties dialog box opens.
7. Click the General tab, select AxMapControl1 from the Buddy Control drop-down list, and click Apply. See the following screen shot:
   
   
8. Click OK to close the TOCControl Properties dialog box.
9. Right-click the ToolbarControl and click Properties. The ToolbarControl Properties dialog box opens.
10. Click the General tab, select AxMapControl1 from the Buddy Control drop-down list, and click Apply.
11. Click the Items tab on the ToolbarControl Properties dialog box and click Add. The Control Commands dialog box pens.
12. Click the Toolsets tab, and either double-click the Map Navigation toolset, or drag and drop the toolset onto the Properties dialog box with the Items tab selected. Repeat to add any other commands, toolsets, menus, or palettes, then click Close. See the following screen shot:
    
    
13. With the Items tab still selected in the ToolbarControl Properties dialog box, click to choose an item. Drag and drop the selected item to a new position on the ToolbarControl (selection is indicated by the black outline around the item), or drag and drop an item off the ToolbarControl to remove it. Right-click an item to delete it or set its style, group, or group spacing, then click Apply. See the following screen shot:
    
    
    
14. Click OK to close the ToolbarControl Properties dialog box.
15. Load the appropriate version of ArcGIS Engine for Windows at the entry point to your application. See the following code example:

using ESRI.ArcGIS;
...[STAThread] static void Main()
{
    if (!RuntimeManager.Bind(ProductCode.Engine))
    {
        MessageBox.Show(
            "Unable to bind to ArcGIS runtime. Application will be shut down.");
        return ;
    }

    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    Application.Run(new MainForm());
}

Imports ESRI.ArcGIS
...

Private Sub MyApplication_Startup(ByVal sender As Object, _
                                  ByVal e As Microsoft.VisualBasic.ApplicationServices.StartupEventArgs) _
                                  Handles Me.Startup
    If Not ESRI.ArcGIS.RuntimeManager.Bind(ESRI.ArcGIS.ProductCode.Engine) Then
        MessageBox.Show("Unable to bind to ArcGIS runtime. Application will be shut down.")
        e.Cancel=True 'Abort application start up
    End If
End Sub

See Also:

• ESRI.ArcGIS.Version (ESRI.ArcGIS)