• About using the ArcGIS samples
• Opening solution files
• Compiling samples
• Debugging samples
• Debugging DLLs
• Running samples
• Running EXEs
• Running DLLs
• Adding commands or tools to a toolbar
• Unregistering DLLs

• Opening solution files
• Compiling samples

• Debugging samples (optional step)
• No special steps required for executables (EXEs)
• Sets up the external application to debug class library DLLs
• Running samples
• Running EXEs
• Running DLLs (class libraries and components)
• Adding commands or tools to a toolbar, if necessary
• Unregistering DLLs
• When you are done using a sample's DLL, you can unregister it.

 

• ArcGIS Desktop SDK—If the sample creates a DLL that only works with ArcMap, ArcCatalog, ArcGlobe, or ArcScene, set the external application to the ArcGIS application where the custom class is used. Browse to the location of the .exe for that application, located in <your ArcGIS install location>/Bin (for example, <your ArcGIS install location>/Bin/ArcMap.exe).
• ArcGIS Engine SDK—If the sample creates a .dll that works in a controls application, browse to the location of the controls application to use. If you do not have one, refer to the help topics under the following nodes in the ArcGIS Engine SDK: Building solutions with ArcGIS Engine using .NET, Working with ArcGIS components, ArcGIS Engine controls.
• If the sample is a command or tool that needs to be added to a toolbar linked to a MapControl, use the Allow run time customization of the ToolbarControl sample (only applies to ArcGIS Engine). This application lets you add the command at run time.
• If you are working with a sample command or tool that can be added to ArcMap or a controls application, use the previous ArcGIS Desktop SDK or ArcGIS Engine SDK option, depending on the one you have installed.

• An ArcGIS Desktop application (ArcMap, ArcCatalog, ArcGlobe, or ArcScene):
1. Run the application the tool or command works with.
2. Click the Tools menu and choose Customize to open the Customize dialog box.
3. Click the Commands tab.
4. Click the command or tool in the Categories pane.
5. In the Commands pane, click the command or tool. Drag and drop the command or tool and place it on the toolbar.
• An ArcGIS Engine controls application (on the ToolbarControl):
• With the ArcGIS Engine controls applications—unless the toolbar is set up to allow customization at run time—you need to add the command or tool to the application at design time. To add it at design time, you have the following options:
1. Add the command or tool programmatically:
1. Once the ToolbarControl is created, initialized, and buddied, call AddItem on the ToolbarControl. See the following code example:

                             string progID = "esriControls.ControlsMapFullExtentCommand";
                             axToolbarControl1.AddItem(progID,-1,-1,false,0,esriCommandStyles.esriCommandStyleIconOnly);

                              Dim sProgID As String
                              sProgID ="esriControls.ControlsMapFullExtentCommand"
                              ToolbarControl1.AddItem sProgID

2. Add the command or tool through the ToolbarControl property pages:
1. In the design view of the application, right-click the ToolbarControl.
2. On the property page, click the Items tab, then click the Add button to open the Control Commands dialog box.
3. Click the command or tool category in the Categories pane.
4. In the Commands pane, click the command or tool. Double-click the command or tool, or drag and drop it on the toolbar on the Items tab of the property page. 
• If you are using an application that is set up to allow customization of the ToolbarControl at run time, follow that application's steps for adding a command or tool to the ToolbarControl.

• For one of the ArcGIS Desktop applications or a controls application—depending on what you have installed on your machine—follow the previous steps for ArcGIS Desktop or ArcGIS Engine.

See Also: