ArcGIS Engine Developer Guide

WORKING WITH THE ARCGIS CONTROLS
property pages at design time, programmatically, or at runtime by the end user if
the ToolbarControl is in customize mode.
You can also extend the suite of commands provided by ArcGIS Engine by
creating their own custom commands, tools, and menus to work with the ArcGIS
controls. The HookHelper, GlobeHookHelper, and SceneHookHelper objects can be
used to simplify this development. Refer to the ‘Building applications’ scenarios
in Chapter 6, ‘Developer scenarios’, to see how to build a custom command using
the HookHelper object.
The LicenseControl is only available with the
COM (ActiveX Control) and .NET (Windows
Control) APIs.
Refer to Chapter 5 ‘Licensing and deployment’
for more details about the concepts of licensing.
LICENSECONTROL
The LicenseControl is used to initialize an application with a suitable license(s)
for it to run successfully on any machine it is deployed on to. The LicenseControl
will configure the licenses at application start time when the form or dialog box
containing the LicenseControl is loaded. Use the LicenseControl to automatically
perform license initialization within simple graphical user interface applications
using the MapControl, PageLayoutControl, TOCControl, ToolbarControl,
ReaderControl, SceneControl, or GlobeControl. If greater control is required
over license initialization, particularly when checking out and in extension licenses
(the LicenseControl will check out extension licenses for the duration of
an application’s life), use the AoInitialize object in the System library to programmatically
perform license initialization.
The LicenseControl is visible within a visual design environment but is invisible
at runtime, so unlike the other controls the LicenseControl does not provide any
user interface in an application. In design time the LicenseControl property pages
must be used to configure the application with product and extension licenses.
Products
Select at least one product license with which the application can be initialized.
By default, the LicenseControl will try to initialize the application with the
ArcGIS Engine product license. If the product you require is not licensed, you
may optionally initialize the application with a higher product license. For example,
if you select the ArcGIS Engine license and the ArcView license, the
48 • ArcGIS Engine Developer Guide