org.zkoss.zk.ui.event
Class ClientInfoEvent

java.lang.Object
  org.zkoss.zk.ui.event.Event
      org.zkoss.zk.ui.event.ClientInfoEvent

All Implemented Interfaces:

java.io.Serializable

public class ClientInfoEvent
extends Event

The onClientInfo event is used to notify the client's information, such as time zone and screen resolutions.

This event is sent if and only if it is registered to a root component.

Note: the information returned by this event is not stored in the server. Thus, you might want to store in the session's attribute (Session.setAttribute(java.lang.String, java.lang.Object)).

Author:

tomyeh

See Also:

Clients, Serialized Form

Constructor Summary

ClientInfoEvent(java.lang.String name, int timeZoneOfs, int scrnwd, int scrnhgh, int colorDepth, int dtwd, int dthgh, int dtx, int dty)
Constructs an event to hold the client-info.

Method Summary

static ClientInfoEvent	getClientInfoEvent(AuRequest request) Converts an AU request to a client-info event.
int	getColorDepth() Returns the maximum number of colors the client's screen supports.
int	getDesktopHeight() Returns the pixel height of the client's desktop.
int	getDesktopWidth() Returns the pixel width of the client's desktop.
int	getDesktopXOffset() The the current horizontal pixel location of the top-left corner of the document in the window.
int	getDesktopYOffset() The the current vertical pixel location of the top-left corner of the document in the window.
int	getScreenHeight() Returns the pixel height of the client's screen.
int	getScreenWidth() Returns the pixel width of the client's screen.
java.util.TimeZone	getTimeZone() Returns the time zone of the client.

Methods inherited from class org.zkoss.zk.ui.event.Event

getData, getEvent, getName, getPage, getTarget, isPropagatable, stopPropagation, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientInfoEvent

public ClientInfoEvent(java.lang.String name,
                       int timeZoneOfs,
                       int scrnwd,
                       int scrnhgh,
                       int colorDepth,
                       int dtwd,
                       int dthgh,
                       int dtx,
                       int dty)

Constructs an event to hold the client-info.

Note: Event.getTarget() will return null. It means it is a broadcast event.

Parameters:

scrnwd - the screen's width

scrnhgh - the screen's height

dtwd - the desktop's width

dthgh - the desktop's height

dtx - the desktop's the left offset

dty - the desktop's the top offset

Method Detail

getClientInfoEvent

public static final ClientInfoEvent getClientInfoEvent(AuRequest request)

Converts an AU request to a client-info event.

Since:

5.0.0

getTimeZone

public java.util.TimeZone getTimeZone()

Returns the time zone of the client.

getScreenWidth

public int getScreenWidth()

Returns the pixel width of the client's screen.

getScreenHeight

public int getScreenHeight()

Returns the pixel height of the client's screen.

getColorDepth

public int getColorDepth()

Returns the maximum number of colors the client's screen supports.

getDesktopWidth

public int getDesktopWidth()

Returns the pixel width of the client's desktop.

getDesktopHeight

public int getDesktopHeight()

Returns the pixel height of the client's desktop.

getDesktopXOffset

public int getDesktopXOffset()

The the current horizontal pixel location of the top-left corner of the document in the window. It is changed by user when he scrolls the browser.

To change it programmingly, use Clients.scrollTo(int, int).

getDesktopYOffset

public int getDesktopYOffset()

The the current vertical pixel location of the top-left corner of the document in the window. It is changed by user when he scrolls the browser.

To change it programmingly, use Clients.scrollTo(int, int).