|
||||||||||
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.zhtml.impl.AbstractTag
org.zkoss.zhtml.Input
public class Input
The input tag.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.zkoss.zhtml.impl.AbstractTag |
---|
AbstractTag.ExtraCtrl |
Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent |
---|
AbstractComponent.Children |
Field Summary |
---|
Fields inherited from class org.zkoss.zhtml.impl.AbstractTag |
---|
_tagnm |
Fields inherited from class org.zkoss.zk.ui.AbstractComponent |
---|
_visible |
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 | |
---|---|
|
Input()
|
protected |
Input(java.lang.String tagnm)
|
Method Summary | |
---|---|
java.lang.String |
getValue()
Returns the value of this input. |
boolean |
isChecked()
Returns if the input is checked (type: checkbox or radio). |
void |
service(AuRequest request,
boolean everError)
Processes an AU request. |
void |
setChecked(boolean checked)
Sets if the input is checked (type: checkbox or radio). |
void |
setValue(java.lang.String value)
Sets the vallue of this input. |
protected void |
smartUpdate(java.lang.String attr,
java.lang.Object value)
Smart-updates a property of the peer widget associated with the component, running at the client, with the specified value. |
Methods inherited from class org.zkoss.zhtml.impl.AbstractTag |
---|
clone, getDynamicProperty, getSclass, getStyle, getTag, getWidgetClass, hasDynamicProperty, isChildable, newExtraCtrl, redraw, renderProperties, setDynamicProperty, setSclass, setStyle, setVisible, shallHideId, toString |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public Input()
protected Input(java.lang.String tagnm)
Method Detail |
---|
public java.lang.String getValue()
public void setValue(java.lang.String value) throws WrongValueException
WrongValueException
public boolean isChecked()
public void setChecked(boolean checked)
protected void smartUpdate(java.lang.String attr, java.lang.Object value)
AbstractComponent
The second invocation with the same property will replace the previous call. In other words, the same property will be set only once in each execution.
This method has no effect if AbstractComponent.invalidate()
is ever invoked
(in the same execution), since AbstractComponent.invalidate()
assumes
the whole content shall be redrawn and all smart updates to
this components can be ignored,
Once AbstractComponent.invalidate()
is called, all invocations to AbstractComponent.smartUpdate(java.lang.String, java.lang.Object)
will then be ignored, and AbstractComponent.redraw(java.io.Writer)
will be invoked later.
It can be called only in the request-processing and event-processing phases; excluding the redrawing phase.
There are two ways to draw a component, one is to invoke
Component.invalidate()
, and the other is AbstractComponent.smartUpdate(java.lang.String, java.lang.Object)
.
While Component.invalidate()
causes the whole content to redraw,
AbstractComponent.smartUpdate(java.lang.String, java.lang.Object)
let component developer control which part
to redraw.
smartUpdate
in class AbstractComponent
value
- the new value.
If it is DeferredValue
, the value
will be retrieved (by calling DeferredValue.getValue()
)
in the rendering phase. It is useful if the value can not be determined now.
For some old application servers (example, Webshpere 5.1),
Execution.encodeURL(java.lang.String)
cannot be called in the event processing
thread. So, the developers have to use DeferredValue
or disable the use of the event processing thread
(by use of disable-event-thread
in zk.xml).
In addition, the value can be any kind of objects that the client accepts (marshaled by JSON).
AbstractComponent.updateByClient(java.lang.String, java.lang.Object)
public void service(AuRequest request, boolean everError)
service
in interface ComponentCtrl
service
in class AbstractComponent
everError
- whether any error ever occured before
processing this request.AbstractComponent.setAuService(org.zkoss.zk.au.AuService)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |