com.extjs.gxt.ui.client.widget.layout
Class AnchorLayout
java.lang.Object
com.extjs.gxt.ui.client.event.BaseObservable
com.extjs.gxt.ui.client.widget.Layout
com.extjs.gxt.ui.client.widget.layout.AnchorLayout
- All Implemented Interfaces:
- Observable
- Direct Known Subclasses:
- AbsoluteLayout, FormLayout
public class AnchorLayout
- extends Layout
This is a layout that enables anchoring of contained widgets relative to the
container's dimensions. If the container is resized, all anchored items are
automatically re-rendered according to their anchor rules.
Child Widgets are:
- Sized : Yes - relative to parent container
- Positioned : No - child widgets will flow
By default, AnchorLayout will calculate anchor measurements based on the size
of the container itself. However, if anchorSize
is specified,
the layout will use it as a virtual container for the purposes of calculating
anchor measurements based on it instead, allowing the container to be sized
independently of the anchoring logic if necessary.
The items added to an AnchorLayout can also supply an anchoring-specific
layout property (see AnchorData.setAnchorSpec(String)
) which is a
string containing two values: the horizontal anchor value and the vertical
anchor value (for example, '100% 50%'). This value is what tells the layout
how the item should be anchored to the container. The following types of
anchor values are supported:
- Percentage : Any value between 1 and 100, expressed as a
percentage. The first anchor is the percentage width that the item should
take up within the container, and the second is the percentage height.
Example: '100% 50%' would render an item the complete width of the container
and 1/2 its height. If only one anchor value is supplied it is assumed to be
the width value and the height will default to auto.
- Offsets : Any positive or negative integer value. The first anchor
is the offset from the right edge of the container, and the second is the
offset from the bottom edge. Example: '-50 -100' would render an item the
complete width of the container minus 50 pixels and the complete height minus
100 pixels. If only one anchor value is supplied it is assumed to be the
right offset value and the bottom offset will default to 0.
Anchor values can also be mixed as needed. For example, '-50 75%' would
render the width offset from the container right edge by 50 pixels and 75% of
the container's height.
Methods inherited from class com.extjs.gxt.ui.client.widget.Layout |
applyMargins, applyPadding, callLayout, fly, fly, getExtraStyle, getLayoutData, getResizeDelay, getSideMargins, initTarget, isLayoutExecuted, isLayoutNeeded, isRenderHidden, isRunning, isValidParent, layout, layoutContainer, onAdd, onComponentHide, onComponentShow, onRemove, onResize, renderAll, renderComponent, setBounds, setContainer, setExtraStyle, setLayoutData, setLayoutNeeded, setLayoutOnChange, setPosition, setRenderHidden, setResizeDelay, setSize |
Methods inherited from class com.extjs.gxt.ui.client.event.BaseObservable |
addListener, callListener, fireEvent, fireEvent, getFiresEvents, getListeners, hasActiveEvent, hasListeners, hasListeners, removeAllListeners, removeListener, setFiresEvents |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
AnchorLayout
public AnchorLayout()
getAnchorSize
public Size getAnchorSize()
- Returns the anchor size.
- Returns:
- the anchor size
setAnchorSize
public void setAnchorSize(Size anchorSize)
- Sets a virtual container for the layout to use.
- Parameters:
anchorSize
- the anchor size
adjustHeightAnchor
protected int adjustHeightAnchor(int height,
Component comp)
adjustWidthAnchor
protected int adjustWidthAnchor(int width,
Component comp)
onLayout
protected void onLayout(Container<?> container,
El target)
- Overrides:
onLayout
in class Layout