How to set PageLayoutControl properties

This topic shows how the various properties of the PageLayoutControl can be set by clicking a button. Use the Java Property Editor for the PageLayoutControl to set the control properties and initialize the map document during design time.

Setting PageLayoutControl properties

Do the following to set PageLayoutControl properties:

  1. Create an ArcGIS Engine project in the Eclipse integrated development environment (IDE) using the PageLayoutControl. For more information, see How to build an application in Eclipse using visual beans. The following screen shot shows an example JFrame in design mode: 

  2. Right-click the PageLayoutControl and click Customize Java Bean. The Java Property Editor dialog box appears. The visual properties of the PageLayoutControl, such as border style, appearance, background color, and mouse pointer can be set using the Java Property Editor. See the following screen shot:

  3. On the Java Property Editor dialog box, click the General tab. The following table explains the other areas that can be selected under the General tab:

PageLayoutControl methods
Default value
Indicates whether the PageLayoutControl can respond to user generated events.
Enable OLD Drop Event
Indicates if the PageLayoutControl fires events when data is dragged over the control's window.
Arrow Key Intercept
A property that specifies interception of key strokes that are normally handled by the container. When intercepted, the OnKeyDown and OnKeyUp events will be called.
Map Document
The file name of the last map document loaded into the control.
  1. Do the following to set the Map Document Property on the Java Property Editor dialog box for the PageLayoutControl:
    1. Click the Open folder icon. The Open dialog box appears.
    2. On the Open dialog box, browse to the folder containing the map document.
    3. Select the applicable map document, then click Open. The file path of your selected document shows in the Map Document text field.

      Alternatively, the properties of the PageLayoutControl can also be modified using the Properties window in the Eclipse IDE. See the following screen shot:

The PageLayoutControl property editor avoids the redundant code that a developer might need to write multiple times. It presents a convenient interface for developers to initialize a simple ArcGIS Engine application.

See Also:

How to build an application in Eclipse using visual beans
Using PageLayoutControl

Development licensingDeployment licensing
Engine Developer KitEngine
ArcGIS for Desktop Basic
ArcGIS for Desktop Standard
ArcGIS for Desktop Advanced