|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.zkoss.zk.ui.AbstractComponent
org.zkoss.zk.ui.HtmlBasedComponent
org.zkoss.zul.impl.XulElement
public abstract class XulElement
The fundamental class for XUL elements.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.zkoss.zk.ui.HtmlBasedComponent |
---|
org.zkoss.zk.ui.HtmlBasedComponent.ExtraCtrl |
Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent |
---|
org.zkoss.zk.ui.AbstractComponent.Children |
Field Summary |
---|
Fields inherited from class org.zkoss.zk.ui.HtmlBasedComponent |
---|
_zclass |
Fields inherited from interface org.zkoss.zk.ui.Component |
---|
APPLICATION_SCOPE, COMPONENT_SCOPE, DESKTOP_SCOPE, PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE, SPACE_SCOPE |
Fields inherited from interface org.zkoss.zk.ui.sys.ComponentCtrl |
---|
CE_BUSY_IGNORE, CE_DUPLICATE_IGNORE, CE_IMPORTANT, CE_NON_DEFERRABLE, CE_REPEAT_IGNORE |
Constructor Summary | |
---|---|
XulElement()
|
Method Summary | |
---|---|
Object |
clone()
|
String |
getContext()
Returns the ID of the popup ( Popup ) that should appear
when the user right-clicks on the element (a.k.a., context menu). |
String |
getCtrlKeys()
Returns what keystrokes to intercept. |
String |
getPopup()
Returns the ID of the popup ( Popup ) that should appear
when the user clicks on the element. |
String |
getTooltip()
Returns the ID of the popup ( Popup ) that should be used
as a tooltip window when the mouse hovers over the element for a moment. |
protected void |
renderProperties(org.zkoss.zk.ui.sys.ContentRenderer renderer)
|
void |
setContext(Popup popup)
Sets the UUID of the popup that should appear when the user right-clicks on the element (a.k.a., context menu). |
void |
setContext(String context)
Sets the ID of the popup ( Popup ) that should appear
when the user right-clicks on the element (a.k.a., context menu). |
void |
setCtrlKeys(String ctrlKeys)
Sets what keystrokes to intercept. |
void |
setPopup(Popup popup)
Sets the UUID of the popup that should appear when the user clicks on the element. |
void |
setPopup(String popup)
Sets the ID of the popup ( Popup ) that should appear
when the user clicks on the element. |
void |
setTooltip(Popup popup)
Sets the UUID of the popup that should be used as a tooltip window when the mouse hovers over the element for a moment. |
void |
setTooltip(String tooltip)
Sets the ID of the popup ( Popup ) that should be used
as a tooltip window when the mouse hovers over the element for a moment. |
Methods inherited from class org.zkoss.zk.ui.HtmlBasedComponent |
---|
focus, getAction, getDraggable, getDroppable, getExtraCtrl, getHeight, getHflex, getLeft, getRenderdefer, getSclass, getStyle, getTooltiptext, getTop, getVflex, getWidth, getZclass, getZindex, getZIndex, service, setAction, setClass, setDraggable, setDroppable, setFocus, setHeight, setHeightDirectly, setHflex, setHflexDirectly, setLeft, setLeftDirectly, setRenderdefer, setSclass, setStyle, setTooltiptext, setTop, setTopDirectly, setVflex, setWidth, setWidthDirectly, setZclass, setZindex, setZIndex, setZIndexDirectly |
Methods inherited from class org.zkoss.zk.ui.AbstractComponent |
---|
addAnnotation, addAnnotation, addClientEvent, addEventHandler, addEventListener, addEventListener, addForward, addForward, addForward, addForward, addMoved, addScopeListener, addSharedEventHandlerMap, appendChild, applyProperties, beforeChildAdded, beforeChildRemoved, beforeParentChanged, detach, didActivate, didActivate, didDeserialize, didDeserialize, disableClientUpdate, equals, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttribute, getAttributeOrFellow, getAttributes, getAttributes, getAuService, getAutag, getChildren, getClientEvents, getDefaultMold, getDefinition, getDesktop, getEventHandler, getEventHandlerNames, getEventListenerMap, getEventListeners, getFellow, getFellow, getFellowIfAny, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getNextSibling, getPage, getParent, getPreviousSibling, getRoot, getSpaceOwner, getStubonly, getTemplate, getTemplateNames, getUuid, getWidgetAttribute, getWidgetAttributeNames, getWidgetClass, getWidgetListener, getWidgetListenerNames, getWidgetOverride, getWidgetOverrideNames, hasAttribute, hasAttribute, hasAttribute, hasAttributeOrFellow, hasFellow, hasFellow, insertBefore, invalidate, isChildable, isInvalidated, isListenerAvailable, isVisible, onChildAdded, onChildRemoved, onPageAttached, onPageDetached, onWrongValue, query, queryAll, redraw, redrawChildren, removeAttribute, removeAttribute, removeAttribute, removeChild, removeEventListener, removeForward, removeForward, removeScopeListener, render, render, render, replace, response, response, response, service, sessionDidActivate, sessionWillPassivate, setAttribute, setAttribute, setAttribute, setAuService, setAutag, setDefinition, setDefinition, setId, setMold, setPage, setPageBefore, setParent, setStubonly, setStubonly, setTemplate, setVisible, setVisibleDirectly, setWidgetAttribute, setWidgetClass, setWidgetListener, setWidgetOverride, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdateWidgetListener, smartUpdateWidgetOverride, toString, updateByClient, willPassivate, willPassivate, willSerialize, willSerialize |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public XulElement()
Method Detail |
---|
public String getCtrlKeys()
Default: null.
public void setCtrlKeys(String ctrlKeys) throws org.zkoss.zk.ui.UiException
The string could be a combination of the following:
For example,
Note: it doesn't support Ctrl+Alt, Shift+Ctrl, Shift+Alt or Shift+Ctrl+Alt.
org.zkoss.zk.ui.UiException
public String getContext()
Popup
) that should appear
when the user right-clicks on the element (a.k.a., context menu).
Default: null (no context menu).
public void setContext(String context)
Popup
) that should appear
when the user right-clicks on the element (a.k.a., context menu).
An onOpen event is sent to the context menu if it is going to appear. Therefore, developers can manipulate it dynamically (perhaps based on OpenEvent.getReference) by listening to the onOpen event.
Note: To simplify the use, it not only searches its ID space, but also all ID spaces in the desktop. It first searches its own ID space, and then the other Id spaces in the same browser window (might have one or multiple desktops).
(since 3.0.2) If there are two components with the same ID (of course, in
different ID spaces), you can specify the UUID with the following
format:
uuid(comp_uuid)
Example:
<label context="some">
<label context="uuid(${some.uuid})"/>
Both reference a component whose ID is "some".
But, if there are several components with the same ID,
the first one can reference to any of them.
And, the second one reference to the component in the same ID space
(of the label component).
(since 3.6.3) the context menu can be shown by a position from Popup.open(org.zkoss.zk.ui.Component, String)
or the location of x
and y
, you can specify the following format:
id, position
id, position=before_start
id, x=15, y=20
uuid(comp_uuid), position
uuid(comp_uuid), x=15, y=20
<button label="show" context="id, start_before"/>
(since 6.5.2) the context menu can also be shown on customized location of x
and y
by adding parentheses"()", for example,
<button label="show" context="id, x=(zk.currentPointer[0] + 10), y=(zk.currentPointer[1] - 10)"/>
setContext(Popup)
public void setContext(Popup popup)
Note: it actually invokes
setContext("uuid(" + popup.getUuid() + ")")
setContext(String)
,
Popup.open(org.zkoss.zk.ui.Component, String)
public String getPopup()
Popup
) that should appear
when the user clicks on the element.
Default: null (no popup).
public void setPopup(String popup)
Popup
) that should appear
when the user clicks on the element.
An onOpen event is sent to the popup menu if it is going to appear. Therefore, developers can manipulate it dynamically (perhaps based on OpenEvent.getReference) by listening to the onOpen event.
Note: To simplify the use, it not only searches its ID space, but also all ID spaces in the desktop. It first searches its own ID space, and then the other Id spaces in the same browser window (might have one or multiple desktops).
(since 3.0.2) If there are two components with the same ID (of course, in
different ID spaces), you can specify the UUID with the following
format:
uuid(comp_uuid)
(since 3.6.3) the popup can be shown by a position from Popup.open(org.zkoss.zk.ui.Component, String)
or the location of x
and y
, you can specify the following format:
id, position
id, position=before_start
id, x=15, y=20
uuid(comp_uuid), position
uuid(comp_uuid), x=15, y=20
<button label="show" popup="id, start_before"/>
(since 6.5.2) the popup can also be shown on customized location of x
and y
by adding parentheses"()", for example,
<button label="show" context="id, x=(zk.currentPointer[0] + 10), y=(zk.currentPointer[1] - 10)"/>
setPopup(Popup)
,
Popup.open(org.zkoss.zk.ui.Component, String)
public void setPopup(Popup popup)
Note: it actually invokes
setPopup("uuid(" + popup.getUuid() + ")")
setPopup(String)
public String getTooltip()
Popup
) that should be used
as a tooltip window when the mouse hovers over the element for a moment.
The tooltip will automatically disappear when the mouse is moved away.
Default: null (no tooltip).
public void setTooltip(String tooltip)
Popup
) that should be used
as a tooltip window when the mouse hovers over the element for a moment.
An onOpen event is sent to the tooltip if it is going to appear. Therefore, developers can manipulate it dynamically (perhaps based on OpenEvent.getReference) by listening to the onOpen event.
Note: To simplify the use, it not only searches its ID space, but also all ID spaces in the desktop. It first searches its own ID space, and then the other Id spaces in the same browser window (might have one or multiple desktops).
(since 3.0.2) If there are two components with the same ID (of course, in
different ID spaces), you can specify the UUID with the following
format:
uuid(comp_uuid)
(since 3.6.3) the tooltip can be shown by a position from
Popup.open(org.zkoss.zk.ui.Component, String)
or the location of x
and y
, and can be specified
with a delay time (in millisecond), you can specify the following format:
id, position
id, position=before_start, delay=500
id, x=15, y=20
uuid(comp_uuid2), position
uuid(comp_uuid), x=15, y=20
<button label="show" tooltip="id, start_before"/>
(since 6.5.2) the tooltip can also be shown on customized location of x
and y
by adding parentheses"()", for example,
<button label="show" context="id, x=(zk.currentPointer[0] + 10), y=(zk.currentPointer[1] - 10)"/>
setTooltip(Popup)
,
Popup.open(org.zkoss.zk.ui.Component, String)
public void setTooltip(Popup popup)
Note: it actually invokes
setTooltip("uuid(" + popup.getUuid() + ")")
setTooltip(String)
protected void renderProperties(org.zkoss.zk.ui.sys.ContentRenderer renderer) throws IOException
renderProperties
in class org.zkoss.zk.ui.HtmlBasedComponent
IOException
public Object clone()
clone
in interface org.zkoss.zk.ui.Component
clone
in class org.zkoss.zk.ui.HtmlBasedComponent
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |