public abstract class LayoutRegion extends XulElement
Events:
onOpen, onSize.
HtmlBasedComponent.ExtraCtrl
AbstractComponent.Children
_zclass
APPLICATION_SCOPE, COMPONENT_SCOPE, DESKTOP_SCOPE, PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE, SPACE_SCOPE
AFTER_CHILD_ADDED, AFTER_CHILD_REMOVED, AFTER_PAGE_ATTACHED, AFTER_PAGE_DETACHED, CE_BUSY_IGNORE, CE_DUPLICATE_IGNORE, CE_IMPORTANT, CE_NON_DEFERRABLE, CE_REPEAT_IGNORE
Constructor and Description |
---|
LayoutRegion() |
Modifier and Type | Method and Description |
---|---|
void |
beforeChildAdded(Component child,
Component refChild)
Default: does nothing.
|
void |
beforeParentChanged(Component parent)
Default: does nothing.
|
java.lang.Object |
clone()
Clones the component.
|
java.lang.String |
getBorder()
Returns the border.
|
Caption |
getCaption()
Returns the caption of this region.
|
java.lang.String |
getCmargins()
Returns the collapsed margins, which is a list of numbers separated by comma.
|
protected abstract int[] |
getDefaultCmargins()
Returns the default collapsed margin.
|
java.lang.String |
getMargins()
Returns the margins, which is a list of numbers separated by comma.
|
int |
getMaxsize()
Returns the maximum size of the resizing element.
|
int |
getMinsize()
Returns the minimum size of the resizing element.
|
abstract java.lang.String |
getPosition()
Returns this regions position (north/south/east/west/center).
|
abstract java.lang.String |
getSize()
Returns the size of this region.
|
java.lang.String |
getTitle()
Returns the title.
|
java.lang.String |
getZclass()
Returns the ZK Cascading Style class(es) for this component.
|
boolean |
insertBefore(Component child,
Component refChild)
Inserts a child before the reference child.
|
boolean |
isAutoscroll()
Returns whether enable overflow scrolling.
|
boolean |
isCollapsible()
Returns whether set the initial display to collapse.
|
boolean |
isFlex()
Deprecated.
As of release 6.0.2, use
HtmlBasedComponent.getHflex() and HtmlBasedComponent.getVflex() on child component instead
Default: false. |
boolean |
isOpen()
Returns whether it is open (i.e., not collapsed.
|
boolean |
isSlide() |
boolean |
isSplittable()
Returns whether enable the split functionality.
|
void |
onChildRemoved(Component child)
Default: handles special event listeners.
|
protected void |
renderProperties(ContentRenderer renderer)
Renders the content of this component, excluding the enclosing
tags and children.
|
void |
service(AuRequest request,
boolean everError)
Processes an AU request.
|
void |
setAutoscroll(boolean autoscroll)
Sets whether enable overflow scrolling.
|
void |
setBorder(java.lang.String border)
Sets the border (either none or normal).
|
void |
setCmargins(java.lang.String cmargins)
Sets the collapsed margins for the element "0,1,2,3" that direction is
"top,left,right,bottom"
Default: "3,3,3,3" for center, "0,3,3,0" for east and west,
and "3,0,0,3" for north and south.
|
void |
setCollapsible(boolean collapsible)
Sets whether set the initial display to collapse.
|
void |
setFlex(boolean flex)
Deprecated.
As of release 6.0.2, use
HtmlBasedComponent.setHflex(String) and HtmlBasedComponent.setVflex(String) on child component instead |
void |
setMargins(java.lang.String margins)
Sets margins for the element "0,1,2,3" that direction is
"top,left,right,bottom"
|
void |
setMaxsize(int maxsize)
Sets the maximum size of the resizing element.
|
void |
setMinsize(int minsize)
Sets the minimum size of the resizing element.
|
void |
setOpen(boolean open)
Opens or collapses the splitter.
|
abstract void |
setSize(java.lang.String size)
Sets the size of this region.
|
void |
setSlide(boolean slide) |
void |
setSplittable(boolean splittable)
Sets whether enable the split functionality.
|
void |
setTitle(java.lang.String title)
Sets the title.
|
getContext, getCtrlKeys, getPopup, getPropertyAccess, getTooltip, setContext, setContext, setContextAttributes, setCtrlKeys, setPopup, setPopup, setPopupAttributes, setTooltip, setTooltip, setTooltipAttributes
focus, getAction, getDraggable, getDroppable, getExtraCtrl, getHeight, getHflex, getLeft, getRenderdefer, getSclass, getStyle, getTabindex, getTabindexInteger, getTooltiptext, getTop, getVflex, getWidth, getZindex, getZIndex, setAction, setClass, setDraggable, setDroppable, setFocus, setHeight, setHeight0, setHeightDirectly, setHflex, setHflex0, setHflexDirectly, setLeft, setLeftDirectly, setRenderdefer, setSclass, setStyle, setTabindex, setTabindex, setTooltiptext, setTop, setTopDirectly, setVflex, setVflex0, setVflexDirectly, setWidth, setWidth0, setWidthDirectly, setZclass, setZindex, setZIndex, setZIndexDirectly
addAnnotation, addAnnotation, addCallback, addClientEvent, addEventHandler, addEventListener, addEventListener, addForward, addForward, addForward, addForward, addMoved, addRedrawCallback, addScopeListener, addShadowRoot, addShadowRootBefore, addSharedEventHandlerMap, appendChild, applyProperties, beforeChildRemoved, detach, didActivate, didActivate, didDeserialize, didDeserialize, disableBindingAnnotation, disableClientUpdate, enableBindingAnnotation, equals, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttribute, getAttributeOrFellow, getAttributes, getAttributes, getAuService, getAutag, getCallback, getChildren, getClientAttribute, getClientDataAttribute, getClientEvents, getDefaultMold, getDefinition, getDesktop, getEventHandler, getEventHandlerNames, getEventListenerMap, getEventListeners, getFellow, getFellow, getFellowIfAny, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getNextSibling, getPage, getParent, getPreviousSibling, getRedrawCallback, getRoot, getShadowFellowIfAny, getShadowRoots, getShadowVariable, getShadowVariable, getShadowVariable0, getSpaceOwner, getSpecialRendererOutput, getStubonly, getSubBindingAnnotationCount, getTemplate, getTemplateNames, getUuid, getWidgetAttribute, getWidgetAttributeNames, getWidgetClass, getWidgetListener, getWidgetListenerNames, getWidgetOverride, getWidgetOverrideNames, hasAttribute, hasAttribute, hasAttribute, hasAttributeOrFellow, hasBindingAnnotation, hasFellow, hasFellow, hasSubBindingAnnotation, invalidate, isChildable, isInvalidated, isListenerAvailable, isVisible, onChildAdded, onPageAttached, onPageDetached, onWrongValue, query, queryAll, redraw, redrawChildren, removeAttribute, removeAttribute, removeAttribute, removeCallback, removeChild, removeEventListener, removeForward, removeForward, removeRedrawCallback, removeScopeListener, removeShadowRoot, render, render, render, replace, response, response, response, service, sessionDidActivate, sessionWillPassivate, setAttribute, setAttribute, setAttribute, setAuService, setAutag, setClientAttribute, setClientDataAttribute, setDefinition, setDefinition, setId, setMold, setPage, setPageBefore, setParent, setStubonly, setStubonly, setSubBindingAnnotationCount, setTemplate, setVisible, setVisibleDirectly, setWidgetAttribute, setWidgetClass, setWidgetListener, setWidgetOverride, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdateWidgetListener, smartUpdateWidgetOverride, toString, updateByClient, updateSubBindingAnnotationCount, willPassivate, willPassivate, willSerialize, willSerialize
public Caption getCaption()
public java.lang.String getBorder()
The border actually controls what CSS class to use: If border is null, it implies "none".
If you also specify the CSS class (HtmlBasedComponent.setClass(java.lang.String)
), it overwrites
whatever border you specify here.
Default: "normal".
public void setBorder(java.lang.String border)
border
- the border. If null or "0", "none" is assumed.public boolean isFlex()
HtmlBasedComponent.getHflex()
and HtmlBasedComponent.getVflex()
on child component instead
Default: false.
public void setFlex(boolean flex)
HtmlBasedComponent.setHflex(String)
and HtmlBasedComponent.setVflex(String)
on child component insteadpublic java.lang.String getMargins()
Default: "0,0,0,0".
public void setMargins(java.lang.String margins)
public boolean isAutoscroll()
Default: false.
public void setAutoscroll(boolean autoscroll)
public abstract java.lang.String getPosition()
public abstract void setSize(java.lang.String size)
HtmlBasedComponent.setHeight(String)
and HtmlBasedComponent.setWidth(String)
. If this region
is North
or South
, this method will invoke
HtmlBasedComponent.setHeight(String)
. If this region is West
or
East
, this method will invoke HtmlBasedComponent.setWidth(String)
.
Otherwise it will throw a UnsupportedOperationException
.public abstract java.lang.String getSize()
HtmlBasedComponent.getHeight()
and HtmlBasedComponent.getWidth()
. If this region is
North
or South
, this method will invoke
HtmlBasedComponent.getHeight()
. If this region is West
or East
,
this method will invoke HtmlBasedComponent.getWidth()
. Otherwise it will throw a
UnsupportedOperationException
.public java.lang.String getTitle()
Default: null.
public void setTitle(java.lang.String title)
public boolean isSplittable()
Default: false.
public void setSplittable(boolean splittable)
public void setMaxsize(int maxsize)
public int getMaxsize()
Default: 2000.
public void setMinsize(int minsize)
public int getMinsize()
Default: 0.
public java.lang.String getCmargins()
public void setCmargins(java.lang.String cmargins)
Default: "3,3,3,3" for center, "0,3,3,0" for east and west, and "3,0,0,3" for north and south.
getCmargins()
,
getDefaultCmargins()
protected abstract int[] getDefaultCmargins()
public boolean isCollapsible()
It only applied when getTitle()
is not null. (since 3.5.0)
Default: false.
public void setCollapsible(boolean collapsible)
It only applied when getTitle()
is not null. (since 3.5.0)
public boolean isOpen()
isCollapsible()
is not false.
Default: true.
public void setOpen(boolean open)
isCollapsible()
is not false.public boolean isSlide()
public void setSlide(boolean slide)
public java.lang.String getZclass()
HtmlBasedComponent
AbstractComponent.getMold()
).
Default: null (the default value depends on element).
HtmlBasedComponent.setZclass(java.lang.String)
) will completely replace the default style
of a component. In other words, the default style of a component
is associated with the default value of HtmlBasedComponent.getZclass()
.
Once it is changed, the default style won't be applied at all.
If you want to perform small adjustments, use HtmlBasedComponent.setSclass(java.lang.String)
instead.
getZclass
in class HtmlBasedComponent
HtmlBasedComponent.getSclass()
public void beforeChildAdded(Component child, Component refChild)
AbstractComponent
beforeChildAdded
in interface ComponentCtrl
beforeChildAdded
in class AbstractComponent
child
- the child to be added (never null).refChild
- another child component that the new child
will be inserted before it. If null, the new child will be the
last child.ComponentCtrl.beforeChildAdded(org.zkoss.zk.ui.Component, org.zkoss.zk.ui.Component)
public void beforeParentChanged(Component parent)
AbstractComponent
beforeParentChanged
in interface ComponentCtrl
beforeParentChanged
in class AbstractComponent
parent
- the new parent. If null, it means detachment.ComponentCtrl.beforeParentChanged(org.zkoss.zk.ui.Component)
public boolean insertBefore(Component child, Component refChild)
Component
You could use Component.setParent(org.zkoss.zk.ui.Component)
or Component.appendChild(org.zkoss.zk.ui.Component)
instead of this method, unless
you want to control where to put the child.
Note: Component.setParent(org.zkoss.zk.ui.Component)
always calls back Component.insertBefore(org.zkoss.zk.ui.Component, org.zkoss.zk.ui.Component)
and/or Component.removeChild(org.zkoss.zk.ui.Component)
,
while Component.insertBefore(org.zkoss.zk.ui.Component, org.zkoss.zk.ui.Component)
and Component.removeChild(org.zkoss.zk.ui.Component)
always calls back Component.setParent(org.zkoss.zk.ui.Component)
,
if the parent is changed. Thus, you don't need to override
both Component.insertBefore(org.zkoss.zk.ui.Component, org.zkoss.zk.ui.Component)
and Component.setParent(org.zkoss.zk.ui.Component)
, if you want
to customize the behavior.
If you would like to monitor if a component is attached or detached
from a page, you could register a desktop listener implementing
UiLifeCycle
.
insertBefore
in interface Component
insertBefore
in class AbstractComponent
child
- the new child to be inserted.refChild
- the child before which you want the new child
being inserted. If null, the new child is append to the end.public void onChildRemoved(Component child)
AbstractComponent
onChildRemoved
in interface ComponentCtrl
onChildRemoved
in class AbstractComponent
ComponentCtrl.onChildRemoved(org.zkoss.zk.ui.Component)
protected void renderProperties(ContentRenderer renderer) throws java.io.IOException
HtmlBasedComponent
renderProperties
in class XulElement
java.io.IOException
public void service(AuRequest request, boolean everError)
Default: in addition to what are handled by service(org.zkoss.zk.au.AuRequest, boolean)
,
it also handles onOpen.
service
in interface ComponentCtrl
service
in class HtmlBasedComponent
everError
- whether any error ever occurred before
processing this request.AbstractComponent.setAuService(org.zkoss.zk.au.AuService)
public java.lang.Object clone()
Component
clone
in interface Component
clone
in class XulElement
Copyright © 2005-2018 Potix Corporation. All Rights Reserved.