ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH WINDOWS CONTROLS
When developing a standalone executable using
ArcObjects, it is the responsibility of the application
to check and configure the licensing options.
A license can be configured, using either the
LicenseControl or the coclass AoInitialize and
the IAoInitialize interface it implements, that is
designed to support license configuration. License
initialization must be performed at application
start time, before any ArcObjects functionality is
accessed. Failure to do so will result in application
errors. For more information about licensing
see Chapter 5, ‘Licensing and deployment’.
The LicenseControl will appear on a form at
design time so that it can be selected and its
property pages viewed. However, at runtime the
LicenseControl is invisible so its position on the
form is irrelevant.
LICENSE CONFIGURATION AND DEPLOYMENT
To successfully deploy this application onto another machine, the application
must configure a license. First, it must check that the product license is available,
and second, it must initialize the license. If this license configuration fails, the
application cannot run. License configuration can be performed either using the
LicenseControl or programmatically using the AoInitialize object. For the purpose
of this application, the LicenseControl will be used to handle license configuration.
1. Open the .Net form in design mode.
2. Double-click the AxLicenseControl in the Windows Forms tab of the toolbox
to add a LicenseControl onto the form.
This application can be initialized with an ArcGIS
Engine license, but you may optionally initialize
the application with a higher product license. For
example, if you check the ‘ArcGIS Engine’ license
and the ‘ArcView’ license, the LicenseControl will
initially try to initialize the application with an
ArcGIS Engine license (the lower license). If that
license is not available, the LicenseControl will
try to initialize the application with an ArcView
license (the next higher level license checked). If
no product licenses are available, then the
application will fail to initialize.
In this application the LicenseControl will handle
license initialization failure. If the application
cannot be initialized with an ArcGIS Engine
product license, a License Failure dialog box will
be displayed to the user before the application is
automatically shut down. Alternatively, a
developer can handle license initialization failure
using the ILicenseControl interface members to
obtain information on the nature of the failure
before the application is programmatically shut
down.
3. Right-click on LicenseControl and click Properties to open the LicenseControl
property pages.
4. Check the ArcGIS Engine product license and check ‘Shutdown this application
if the selected licenses are not available’. Click OK.
5. Select Form1 from the Properties window and display the Form events.
Double-click the Closing event to add an event handler to the code window.
Chapter 6 • Developer scenarios • 355