public class Panel extends XulElement implements Framable
Window
, Panels can only be floated and moved inside its parent
node, which is not using zk.setVParent() function at client side. In other words,
if Panel's parent node is an relative position, the floated panel is only inside
its parent, not the whole page.
The second difference of Window
is that Panel is not an independent ID
space (by implementing IdSpace
), so the ID of each child can be used
throughout the panel.
Events:
onMove, onOpen, onZIndex, onMaximize, onMinimize, and onClose.
Default getZclass()
: z-panel.
Constructor and Description |
---|
Panel() |
Modifier and Type | Method and Description |
---|---|
boolean |
addToolbar(String name,
Toolbar toolbar)
Adds the toolbar of the panel by these names, "tbar", "bbar", and "fbar".
|
void |
beforeChildAdded(org.zkoss.zk.ui.Component newChild,
org.zkoss.zk.ui.Component refChild) |
Object |
clone() |
String |
getBorder()
Returns the border.
|
Toolbar |
getBottomToolbar()
Returns the bottom toolbar of this panel.
|
Caption |
getCaption()
Returns the caption of this panel.
|
Toolbar |
getFootToolbar()
Returns the foot toolbar of this panel.
|
int |
getMinheight()
Returns the minimum height.
|
int |
getMinwidth()
Returns the minimum width.
|
Panelchildren |
getPanelchildren()
Returns the panelchildren of this panel.
|
String |
getTitle()
Returns the title.
|
Toolbar |
getTopToolbar()
Returns the top toolbar of this panel.
|
String |
getZclass() |
boolean |
insertBefore(org.zkoss.zk.ui.Component newChild,
org.zkoss.zk.ui.Component refChild) |
boolean |
isClosable()
Returns whether to show a close button on the title bar.
|
boolean |
isCollapsible()
Returns whether to show a toggle button on the title bar.
|
boolean |
isFloatable()
Returns whether to float the panel to display it inline where it is rendered.
|
boolean |
isFramable()
Deprecated.
As of release 5.0.6, replaced with
getBorder() .
Returns whether to render the panel with custom rounded borders.
Default: false. |
boolean |
isMaximizable()
Returns whether to display the maximizing button and allow the user to maximize
the panel.
|
boolean |
isMaximized()
Returns whether the panel is maximized.
|
boolean |
isMinimizable()
Returns whether to display the minimizing button and allow the user to minimize
the panel.
|
boolean |
isMinimized()
Returns whether the panel is minimized.
|
boolean |
isMovable()
Returns whether to move the panel to display it inline where it is rendered.
|
boolean |
isOpen()
Returns whether this Panel is open.
|
boolean |
isSizable()
Returns whether the panel is sizable.
|
void |
onChildRemoved(org.zkoss.zk.ui.Component child) |
void |
onClose()
Process the onClose event sent when the close button is pressed.
|
protected void |
renderProperties(org.zkoss.zk.ui.sys.ContentRenderer renderer) |
void |
service(org.zkoss.zk.au.AuRequest request,
boolean everError)
Processes an AU request.
|
void |
setBorder(boolean border)
Enables or disables the border.
|
void |
setBorder(String border)
Sets the border.
|
void |
setClosable(boolean closable)
Sets whether to show a close button on the title bar.
|
void |
setCollapsible(boolean collapsible)
Sets whether to show a toggle button on the title bar.
|
void |
setFloatable(boolean floatable)
Sets whether to float the panel to display it inline where it is rendered.
|
void |
setFramable(boolean framable)
Deprecated.
As of release 5.0.6, replaced with
setBorder(java.lang.String) .
Sets whether to render the panel with custom rounded borders.
Default: false. |
void |
setHflex(String flex) |
void |
setMaximizable(boolean maximizable)
Sets whether to display the maximizing button and allow the user to maximize
the panel, when a panel is maximized, the button will automatically
change to a restore button with the appropriate behavior already built-in
that will restore the panel to its previous size.
|
void |
setMaximized(boolean maximized)
Sets whether the panel is maximized, and then the size of the panel will depend
on it to show a appropriate size.
|
void |
setMinheight(int minheight)
Sets the minimum height in pixels allowed for this panel.
|
void |
setMinimizable(boolean minimizable)
Sets whether to display the minimizing button and allow the user to minimize
the panel.
|
void |
setMinimized(boolean minimized)
Sets whether the panel is minimized.
|
void |
setMinwidth(int minwidth)
Sets the minimum width in pixels allowed for this panel.
|
void |
setMovable(boolean movable)
Sets whether to move the panel to display it inline where it is rendered.
|
void |
setOpen(boolean open)
Opens or closes this Panel.
|
void |
setSizable(boolean sizable)
Sets whether the panel is sizable.
|
void |
setTitle(String title)
Sets the title.
|
void |
setVflex(String flex) |
boolean |
setVisible(boolean visible) |
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, setHflex0, setHflexDirectly, setLeft, setLeftDirectly, setRenderdefer, setSclass, setStyle, setTabindex, setTabindex, setTooltiptext, setTop, setTopDirectly, 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, beforeParentChanged, 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, setVisibleDirectly, setWidgetAttribute, setWidgetClass, setWidgetListener, setWidgetOverride, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdateWidgetListener, smartUpdateWidgetOverride, toString, updateByClient, updateSubBindingAnnotationCount, willPassivate, willPassivate, willSerialize, willSerialize
public boolean isOpen()
Default: true.
public void setOpen(boolean open)
public boolean isFramable()
getBorder()
.
Returns whether to render the panel with custom rounded borders.
Default: false.
public void setFramable(boolean framable)
setBorder(java.lang.String)
.
Sets whether to render the panel with custom rounded borders.
Default: false.
public void setMovable(boolean movable)
Default: false;
Note that this method only applied when isFloatable()
is true.
public boolean isMovable()
Default: false.
public boolean isFloatable()
Default: false.
public boolean setVisible(boolean visible)
setVisible
in interface org.zkoss.zk.ui.Component
setVisible
in class org.zkoss.zk.ui.AbstractComponent
public void setFloatable(boolean floatable)
Note that by default, setting floatable to true will cause the
panel to display at default offsets, which depend on the offsets of
the embedded panel from its element to document.body -- because the panel
is absolute positioned, the position must be set explicitly by HtmlBasedComponent.setTop(String)
and HtmlBasedComponent.setLeft(String)
. Also, when floatable a panel you should always
assign a fixed width, otherwise it will be auto width and will expand to fill
to the right edge of the viewport.
public boolean isMaximized()
isMaximized
in interface Framable
public void setMaximized(boolean maximized)
isFloatable()
) or its parent node. Otherwise, its size
will be original size. Note that the maximized effect will run at client's
sizing phase not initial phase.
Default: false.
org.zkoss.zk.ui.UiException
- if isMaximizable()
is false.public boolean isMaximizable()
Default: false.
isMaximizable
in interface Framable
public void setMaximizable(boolean maximizable)
Default: false.
Note: the maximize button won't be displayed if no title or caption at all.
public boolean isMinimized()
Default: false.
public void setMinimized(boolean minimized)
Default: false.
org.zkoss.zk.ui.UiException
- if isMinimizable()
is false.public boolean isMinimizable()
Default: false.
isMinimizable
in interface Framable
public void setMinimizable(boolean minimizable)
Default: false.
Note: the maximize button won't be displayed if no title or caption at all.
MinimizeEvent
public boolean isCollapsible()
Default: false.
isCollapsible
in interface Framable
public void setCollapsible(boolean collapsible)
Default: false.
Note: the toggle button won't be displayed if no title or caption at all.
Note: onOpen event will be sent when you click the toggle button
public boolean isClosable()
isClosable
in interface Framable
public void setClosable(boolean closable)
Default: false.
You can intercept the default behavior by either overriding
onClose()
, or listening the onClose event.
Note: the close button won't be displayed if no title or caption at all.
public void setMinheight(int minheight)
Default: 100.
Note: Only applies when isSizable()
= true.
public int getMinheight()
Default: 100.
public void setMinwidth(int minwidth)
Default: 200.
Note: Only applies when isSizable()
= true.
public int getMinwidth()
Default: 200.
public void setHflex(String flex)
setHflex
in class org.zkoss.zk.ui.HtmlBasedComponent
public void setVflex(String flex)
setVflex
in class org.zkoss.zk.ui.HtmlBasedComponent
public boolean isSizable()
public void setSizable(boolean sizable)
Default: false.
public Caption getCaption()
public String getBorder()
Default: "none".
public void setBorder(String border)
none
(default), normal
,
rounded
and rounded+
.
For more information, please refer to
ZK Component Reference: Panel.border
- the border. If null, "0" or "false", "none" is assumed.
If "true", "normal" is assumed (since 5.0.8).public void setBorder(boolean border)
border
- whether to have a border. If true is specified,
it is the same as setBorder("normal")
.public String getTitle()
Caption
to define
a more sophisticated caption (a.k.a., title).
If a panel has a caption whose label (LabelElement.getLabel()
)
is not empty, then this attribute is ignored.
Default: empty.
public void setTitle(String title)
public boolean addToolbar(String name, Toolbar toolbar)
name
- "tbar", "bbar", and "fbar".public void onClose()
Default: detach itself.
public Toolbar getTopToolbar()
public Toolbar getBottomToolbar()
public Toolbar getFootToolbar()
public Panelchildren getPanelchildren()
public String getZclass()
getZclass
in class org.zkoss.zk.ui.HtmlBasedComponent
public void beforeChildAdded(org.zkoss.zk.ui.Component newChild, org.zkoss.zk.ui.Component refChild)
beforeChildAdded
in interface org.zkoss.zk.ui.sys.ComponentCtrl
beforeChildAdded
in class org.zkoss.zk.ui.AbstractComponent
public boolean insertBefore(org.zkoss.zk.ui.Component newChild, org.zkoss.zk.ui.Component refChild)
insertBefore
in interface org.zkoss.zk.ui.Component
insertBefore
in class org.zkoss.zk.ui.AbstractComponent
public void onChildRemoved(org.zkoss.zk.ui.Component child)
onChildRemoved
in interface org.zkoss.zk.ui.sys.ComponentCtrl
onChildRemoved
in class org.zkoss.zk.ui.AbstractComponent
public Object clone()
clone
in interface org.zkoss.zk.ui.Component
clone
in class XulElement
protected void renderProperties(org.zkoss.zk.ui.sys.ContentRenderer renderer) throws IOException
renderProperties
in class XulElement
IOException
public void service(org.zkoss.zk.au.AuRequest request, boolean everError)
Default: in addition to what are handled by HtmlBasedComponent.service(org.zkoss.zk.au.AuRequest, boolean)
,
it also handles onOpen.
service
in interface org.zkoss.zk.ui.sys.ComponentCtrl
service
in class org.zkoss.zk.ui.HtmlBasedComponent
Copyright © 2020. All rights reserved.