Package org.zkoss.zul

Class Listbox.ExtraCtrl

java.lang.Object

org.zkoss.zk.ui.HtmlBasedComponent.ExtraCtrl

org.zkoss.zul.Listbox.ExtraCtrl

All Implemented Interfaces:

Blockable, Cropper, PrologAllowed, Padding

Enclosing class:

Listbox

protected class Listbox.ExtraCtrl
extends HtmlBasedComponent.ExtraCtrl
implements Cropper, Padding, Blockable

A utility class to implement HtmlBasedComponent.getExtraCtrl(). It is used only by component developers.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ExtraCtrl()

Method Summary

Modifier and Type	Method	Description
java.util.Set<? extends Component>	getAvailableAtClient()	Returns a set of child components that are available at the client, or null if ALL available.
Component	getCropOwner()	Returns the owner of the cropping scope.
int	getHeight()	Returns the padding height in px.
boolean	isCropper()	Returns whether it is a cropper, i.e., cropping is applied.
void	setHeight(int height)	Set the padding height in px.
boolean	shallBlock(AuRequest request)	Return true if the request shall be blocked.

Methods inherited from class org.zkoss.zk.ui.HtmlBasedComponent.ExtraCtrl

setPrologContent

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExtraCtrl

protected ExtraCtrl()

Method Detail

getHeight

public int getHeight()

Description copied from interface: Padding

Returns the padding height in px.

Specified by:

getHeight in interface Padding

Returns:

the padding height in px.

setHeight

public void setHeight(int height)

Description copied from interface: Padding

Set the padding height in px.

Specified by:

setHeight in interface Padding

Parameters:

height - the padding height in px.

isCropper

public boolean isCropper()

Description copied from interface: Cropper

Returns whether it is a cropper, i.e., cropping is applied.

Note: this method is called when an child is detached, so you have to count one more for the total number of children. Example <= must be used, not <:
getChildCount() <= getPageSize()

The result of returning false is the same as not declaring with Cropper.

Specified by:

isCropper in interface Cropper

getCropOwner

public Component getCropOwner()

Description copied from interface: Cropper

Returns the owner of the cropping scope. In most cases, Cropper.getAvailableAtClient() returns only the available direct children of this component, and this method returns this component. It is so-called a single-level cropping, such as listbox and tree.

If you want to implement multi-level cropping, such as tree, you can consider the whole tree as a cropping scope. And, Cropper.getAvailableAtClient() returns all available items, not just the child of this component. In additions, this method returns the tree.

Specified by:

getCropOwner in interface Cropper

getAvailableAtClient

public java.util.Set<? extends Component> getAvailableAtClient()

Description copied from interface: Cropper

Returns a set of child components that are available at the client, or null if ALL available. The child components in the returned set must be in the same order of Component.getChildren(). In order words, you must use LinkedHashSet or similar to ensure the order in the returned set.

Note: for better performance, it is better to return null if all children are available at the client.

Note: the components in the returned set can have different parents. It is useful if you want to implement multi-level cropping, such as tree. Refer to Cropper.getCropOwner().

Specified by:

getAvailableAtClient in interface Cropper

shallBlock

public boolean shallBlock(AuRequest request)

Description copied from interface: Blockable

Return true if the request shall be blocked.

Specified by:

shallBlock in interface Blockable