The Place property enables or disables the automatic
graph layout manager. This functionality allows you to automatically
setup the spacing of various elements of a graph. Prior to drawing
a graph, certain methods may be set depending on what the automatic
graph layout manager determines the optimum graph to be.
Syntax:
setPlace(boolean);
boolean = getPlace();
where:
- boolean
Can be one of the following:
true enables
automatic graph layout manager.
false disables
automatic graph layout manager. This value is the default.
When setPlace (true) is used, you can use the following methods
to further control automatic placement of graph elements:
- setPlaceAlign();
For any text object, allow or disallow horizontal alignment. By default,
horizontal alignment is allowed.
- setPlaceMargin();
Define the margin to draw around the entire graph. The default value
is default new Rectangle (-15500, -15500, 31000, 31000).
- setPlaceMaxNumWordWrapLines();
For any text object, define the maximum number of lines that can
be wrapped when setPlaceWordWrap() is enabled. The default value
is 2.
- setPlaceMinFontSize();
For any text object, define the minimum font size that can be used
by the automatic graph layout manager to resize a text object. The
default value is 4 point.
- setPlacePosition();
Define how the automatic graph layout manager can position objects.
In the current implementation, only the legend object can be repositioned.
The default value is zero.
- setPlaceRect();
Set the rectangle to be used for initial placement of objects. In
the current implementation, only object IDs return by getPlaceVertO1LabelsTitle()
or getPlaceHorzO1LabelsTitle() can be used.
- setPlaceResize();
For any graph object, allow or disallow the automatic graph layout manager
to move or resize the object. By default, resizing of all graph
objects is allowed.
- setPlaceRotate();
For any text object, allow or disallow the automatic graph layout manager
to rotate the object. By default, rotation is allowed for all text
objects.
- setPlaceSkip();
For primary ordinal axis (O1) labels, allow or disallow the automatic graph
layout manager to skip labels. By default, label skipping is allowed.
- setPlaceTruncateCount();
For any text object, set the number of characters that can be truncated.
- setPlaceWordWrap();
For any text object, allow or disallow word wrapping. By default,
word wrapping is allowed.
Note:
- This property
is automatically set to false after the graph layout manager has been
activated. If you want to use the graph layout manager when a container
is resized, your container resize routine should include setPlace(true).
- In most cases,
setPlace(true) is all that is required for the graph layout manager
to produce an acceptable graph layout. The setPlace...() methods
can be used if setPlace(true) alone does not produce acceptable
results.
- In the current
implementation, this property and the corresponding setPlace...() methods
only work with O1-Axis labels and title and the legend area in horizontal
and vertical bar, line, and area graphs. See the individual setPlace()
methods for more detailed information.
See All get/setPlace... methods in Methods and getPlaceVertO1LabelsTitle()
and getPlaceHorzO1LabelsTitle() objects in Methods That Return an Object ID.