org.zkoss.zul.impl

Class ListboxDataLoader

java.lang.Object

org.zkoss.zul.impl.ListboxDataLoader

All Implemented Interfaces:

org.zkoss.zk.ui.ext.render.Cropper, DataLoader

public class ListboxDataLoader
extends Object
implements DataLoader, org.zkoss.zk.ui.ext.render.Cropper

Generic Listbox data loader.

Since:

5.0.0

Author:

henrichen

Constructor Summary

Constructors

Constructor and Description
ListboxDataLoader()

Method Summary

Methods

Modifier and Type	Method and Description
void	doListDataChange(ListDataEvent event) Handle event when ListDataEvent is fired from owner component.
Set<? extends org.zkoss.zk.ui.Component>	getAvailableAtClient() Retrieves the children available at client.
protected Set<? extends org.zkoss.zk.ui.Component>	getAvailableAtClient(boolean itemOnly) Retrieves the children available at client with more control.
protected Set<? extends org.zkoss.zk.ui.Component>	getAvailableAtClient(int offset, int limit, boolean itemOnly) Retrieves the children available at the client within the given range.
org.zkoss.zk.ui.Component	getCropOwner()
int	getLimit() Returns the required visible limit size of the current loaded data chunk to be shown on the screen.
int	getOffset() Returns the requested visible offset of the current loaded data chunk.
org.zkoss.zk.ui.Component	getOwner() Returns the associated owner component of this DataLoader.
Object	getRealRenderer() Return the renderer to do rendering.
int	getTotalSize() Returns the total size of the data.
void	init(org.zkoss.zk.ui.Component owner, int offset, int limit) Callback from the owner component and give a chance to initialize things.
protected boolean	inPagingMold()
protected boolean	inSelectMold()
boolean	isCropper()
protected Listitem	newUnloadedItem(ListitemRenderer renderer, int index) Creates an new and unloaded listitem.
void	reset() Callback from the owner component and give a chance to reset things.
void	setLoadAll(boolean b) Sets whether to always load all items from ListModel.
void	syncModel(int offset, int limit) Synchronizes the owner component to be consistent with the specified model.
void	updateModelInfo() Used to update some extra control information to the client.

Methods inherited from class java.lang.Object

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

Constructor Detail

ListboxDataLoader

public ListboxDataLoader()

Method Detail

init

public void init(org.zkoss.zk.ui.Component owner,
        int offset,
        int limit)

Description copied from interface: DataLoader

Callback from the owner component and give a chance to initialize things.

Specified by:

init in interface DataLoader

Parameters:

owner - the owner component of this DataLoader.

reset

public void reset()

Description copied from interface: DataLoader

Callback from the owner component and give a chance to reset things.

Specified by:

reset in interface DataLoader

getOwner

public final org.zkoss.zk.ui.Component getOwner()

Description copied from interface: DataLoader

Returns the associated owner component of this DataLoader.

Specified by:

getOwner in interface DataLoader

getOffset

public int getOffset()

Description copied from interface: DataLoader

Returns the requested visible offset of the current loaded data chunk.

Specified by:

getOffset in interface DataLoader

Returns:

the requested visible offset of the current loaded data chunk.

getLimit

public int getLimit()

Description copied from interface: DataLoader

Returns the required visible limit size of the current loaded data chunk to be shown on the screen.

Specified by:

getLimit in interface DataLoader

Returns:

the required visible limit size of the current loaded data chunk to be shown on the screen.

getTotalSize

public int getTotalSize()

Description copied from interface: DataLoader

Returns the total size of the data.

Specified by:

getTotalSize in interface DataLoader

Returns:

the total size of the data.

doListDataChange

public void doListDataChange(ListDataEvent event)

Description copied from interface: DataLoader

Handle event when ListDataEvent is fired from owner component.

Specified by:

doListDataChange in interface DataLoader

newUnloadedItem

protected final Listitem newUnloadedItem(ListitemRenderer renderer,
                       int index)

Creates an new and unloaded listitem.

getRealRenderer

public Object getRealRenderer()

Description copied from interface: DataLoader

Return the renderer to do rendering.

Specified by:

getRealRenderer in interface DataLoader

syncModel

public void syncModel(int offset,
             int limit)

Description copied from interface: DataLoader

Synchronizes the owner component to be consistent with the specified model.

Specified by:

syncModel in interface DataLoader

Parameters:

offset - the starting index of the range to do data synchronize.

limit - the size of the range to do data synchronize. -1 means the current range.

inPagingMold

protected boolean inPagingMold()

inSelectMold

protected boolean inSelectMold()

updateModelInfo

public void updateModelInfo()

Description copied from interface: DataLoader

Used to update some extra control information to the client.

Specified by:

updateModelInfo in interface DataLoader

setLoadAll

public void setLoadAll(boolean b)

Description copied from interface: DataLoader

Sets whether to always load all items from ListModel.

Specified by:

setLoadAll in interface DataLoader

isCropper

public boolean isCropper()

Specified by:

isCropper in interface org.zkoss.zk.ui.ext.render.Cropper

getAvailableAtClient

public final Set<? extends org.zkoss.zk.ui.Component> getAvailableAtClient()

Retrieves the children available at client.

It can not be overridden. Rather, override getAvailableAtClient(boolean) instead.

Specified by:

getAvailableAtClient in interface org.zkoss.zk.ui.ext.render.Cropper

getAvailableAtClient

protected Set<? extends org.zkoss.zk.ui.Component> getAvailableAtClient(boolean itemOnly)

Retrieves the children available at client with more control.

Derived class shall override this method rather than getAvailableAtClient().

Parameters:

itemOnly - whether to return only Listitem and derives.

Since:

5.0.10

getAvailableAtClient

protected Set<? extends org.zkoss.zk.ui.Component> getAvailableAtClient(int offset,
                                                            int limit,
                                                            boolean itemOnly)

Retrieves the children available at the client within the given range.

Parameters:

itemOnly - whether to return only Listitem and derives.

Since:

5.0.10

getCropOwner

public org.zkoss.zk.ui.Component getCropOwner()

Specified by:

getCropOwner in interface org.zkoss.zk.ui.ext.render.Cropper