Class Frozen

  extended by org.zkoss.zk.ui.AbstractComponent
      extended by org.zkoss.zk.ui.HtmlBasedComponent
          extended by org.zkoss.zul.impl.XulElement
              extended by org.zkoss.zul.Frozen
All Implemented Interfaces:, java.lang.Cloneable, Component, Scope, ComponentCtrl

public class Frozen
extends XulElement

A frozen component to represent a frozen column or row in grid, like MS Excel.

Default getZclass(): z-frozen.

See Also:
Serialized Form

Nested Class Summary
Nested classes/interfaces inherited from class org.zkoss.zk.ui.HtmlBasedComponent
Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent
Field Summary
Fields inherited from class org.zkoss.zk.ui.HtmlBasedComponent
Fields inherited from interface org.zkoss.zk.ui.Component
Fields inherited from interface org.zkoss.zk.ui.sys.ComponentCtrl
Constructor Summary
Method Summary
 int getColumns()
          Returns the number of columns to freeze.
 int getRows()
          Returns the number of rows to freeze.
 int getStart()
          Returns the start position of the scrollbar.
 java.lang.String getZclass()
          Returns the ZK Cascading Style class(es) for this component.
protected  void renderProperties(ContentRenderer renderer)
          Renders the content of this component, excluding the enclosing tags and children.
 void setColumns(int columns)
          Sets the number of columns to freeze.
 void setRows(int rows)
          Sets the number of rows to freeze.
 void setStart(int start)
          Sets the start position of the scrollbar.
protected  void updateByClient(java.lang.String name, java.lang.Object value)
          Called when the widget running at the client asks the server to update a value.
Methods inherited from class org.zkoss.zul.impl.XulElement
clone, getContext, getCtrlKeys, getPopup, getTooltip, setContext, setContext, setCtrlKeys, setPopup, setPopup, setTooltip, setTooltip
Methods inherited from class org.zkoss.zk.ui.HtmlBasedComponent
focus, getAction, getDraggable, getDroppable, getExtraCtrl, getHeight, getHflex, getLeft, getRenderdefer, getSclass, getStyle, getTooltiptext, getTop, getVflex, getWidth, 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, willPassivate, willPassivate, willSerialize, willSerialize
Methods inherited from class java.lang.Object
finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail


public Frozen()
Method Detail


public void setStart(int start)
Sets the start position of the scrollbar.

Default: 0

start - the column number


public int getStart()
Returns the start position of the scrollbar.

Default: 0


public void setColumns(int columns)
Sets the number of columns to freeze.(from left to right)

columns - positive only


public int getColumns()
Returns the number of columns to freeze.

Default: 0


public void setRows(int rows)
Sets the number of rows to freeze.(from top to bottom)

Note: this feature is reserved and not yet implemented.

rows - positive only


public int getRows()
Returns the number of rows to freeze.

Default: 0


public java.lang.String getZclass()
Description copied from class: HtmlBasedComponent
Returns the ZK Cascading Style class(es) for this component. It usually depends on the implementation of the mold (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
See Also:


protected void updateByClient(java.lang.String name,
                              java.lang.Object value)
Description copied from class: AbstractComponent
Called when the widget running at the client asks the server to update a value. The update is caused by an AU request named setAttr (by invoking zk.Widget's smartUpdate at client).

By default, it does nothing but log a warning message, since it is not safe to allow the client to update a field arbitrary.

However, if you'd like to allow the update for a particular component you could do one of the following

  1. For component developers: override this method to update the field directly. For example,
    protected void updateByClient(String name, Object value) {
            if ("disabled".equals(name))
                    setDisabled(name, ((Boolean)value).booleanValue());
                    super.updateByClient(name, value);
  2. For application developers: set an attribute called org.zkoss.zk.ui.updateByClient to be true. Then, this method will use reflection to find out the setter to update the value. Nothing happens if the method is not found.
  3. Notice: this method will invoke AbstractComponent.disableClientUpdate(boolean) to disable any update to the client, when calling the setter.

    If you want to enable the client update for all instances of a given component (though not recommended for the security reason), you could refer to here.

    See also zk.Widget.smartUpdate().

    updateByClient in class AbstractComponent


protected void renderProperties(ContentRenderer renderer)
Description copied from class: HtmlBasedComponent
Renders the content of this component, excluding the enclosing tags and children.

See also ZK Client-side Reference: Property Rendering

renderProperties in class XulElement

Copyright © 2005-2011 Potix Corporation. All Rights Reserved. Logo