Window"

From Documentation
Line 46: Line 46:
 
|-
 
|-
 
| <center><tt>onMove </tt></center>
 
| <center><tt>onMove </tt></center>
| '''Event:''' [#Event org.zkoss.ui.zk.ui.event.Event]
+
| '''Event:''' <javadoc>org.zkoss.ui.zk.ui.event.Event</javadoc>
  
 
Denotes the close button is pressed by a user, and the
 
Denotes the close button is pressed by a user, and the
Line 54: Line 54:
 
|-
 
|-
 
| <center><tt>onOpen </tt></center>
 
| <center><tt>onOpen </tt></center>
| '''Event: '''[#OpenEvent org.zkoss.zk.ui.event.OpenEvent]
+
| '''Event: '''<javadoc>org.zkoss.zk.ui.event.OpenEvent</javadoc>
  
 
Denotes user has opened or closed a component.<tt> </tt>
 
Denotes user has opened or closed a component.<tt> </tt>
Line 74: Line 74:
 
|-
 
|-
 
| <center><tt>onClose </tt></center>
 
| <center><tt>onClose </tt></center>
| '''Event:''' [#Event org.zkoss.ui.zk.ui.event.Event]
+
| '''Event:''' <javadoc>org.zkoss.ui.zk.ui.event.Event</javadoc>
  
 
Denotes the close button is pressed by a user, and the
 
Denotes the close button is pressed by a user, and the
Line 82: Line 82:
 
|-
 
|-
 
| <center><tt>onOK </tt></center>
 
| <center><tt>onOK </tt></center>
| '''Event:'''<tt> [#KeyEvent org.zkoss.zk.ui.event.KeyEvent]
+
| '''Event:'''<tt> <javadoc>org.zkoss.zk.ui.event.KeyEvent</javadoc>
  
 
Denotes user has pressed the ENTER key.
 
Denotes user has pressed the ENTER key.
Line 88: Line 88:
 
|-
 
|-
 
| <center><tt>onCancel </tt></center>
 
| <center><tt>onCancel </tt></center>
| '''Event:'''<tt> [#KeyEvent org.zkoss.zk.ui.event.KeyEvent]
+
| '''Event:'''<tt> <javadoc>org.zkoss.zk.ui.event.KeyEvent</javadoc>
  
 
<tt>Denotes user has pressed the ESC key.</tt>
 
<tt>Denotes user has pressed the ESC key.</tt>
Line 94: Line 94:
 
|-
 
|-
 
| <center>onCtrlKey</center>
 
| <center>onCtrlKey</center>
| '''Event: '''[#KeyEvent org.zkoss.zk.ui.event.KeyEvent]
+
| '''Event: '''<javadoc>org.zkoss.zk.ui.event.KeyEvent</javadoc>
  
 
Denotes user has pressed a special key, such as PgUp, Home and a key combined with the Ctrl or Alt key. Refer to the ctrlKeys Property section below for details.
 
Denotes user has pressed a special key, such as PgUp, Home and a key combined with the Ctrl or Alt key. Refer to the ctrlKeys Property section below for details.

Revision as of 04:32, 20 April 2010

Template:ZK5ComponentReferencePageHeader

Window

Employement/Purpose

A window is, like HTML DIV tag, used to group components. Unlike other components, a window has the following characteristics.

  • A window is an owner of an ID space. Any component contained in a window, including itself, could be found by use of the getFellow method, if it is assigned with an identifier.
  • A window could be overlapped, popup, and embedded.
  • A window could be a modal dialog.


Example

ZK5ComRef Containers Window.PNG

<hbox>
	<window title="Embedded Style" border="normal" width="200px"> Hello,
		Embedded! </window>
	<window title="Cyan Style" sclass="wndcyan" border="normal"
		width="200px"> Hello, Cyan! </window>
	<window title="Popup Style" sclass="popup" border="normal"
		width="200px"> Hello, Popup! </window>
	<window title="Modal Style" sclass="modal" border="normal"
		width="200px"> Hello, Modal! </window>
</hbox>




Supported events

Name
Event Type
onMove
Event: Event

Denotes the close button is pressed by a user, and the

component shall detach itself.

onOpen
Event: OpenEvent

Denotes user has opened or closed a component.

Note:

Unlike onClose, this event is only a notification. The

client sends this event after opening or closing the

component.

It is useful to implement load-on-demand by listening to

the onOpen event, and creating components when the

first time the component is opened.

onClose
Event: Event

Denotes the close button is pressed by a user, and the

component shall detach itself.

onOK
Event: KeyEvent

Denotes user has pressed the ENTER key.

onCancel
Event: KeyEvent

Denotes user has pressed the ESC key.

onCtrlKey
Event: KeyEvent

Denotes user has pressed a special key, such as PgUp, Home and a key combined with the Ctrl or Alt key. Refer to the ctrlKeys Property section below for details.

Supported Children

*ALL

Use cases

Description Example Location
How to create a modal Window and communicate with it http://www.zkoss.org/forum/listComment/9785
Best practises on creating a pop-up window to display PDF reports http://www.zkoss.org/forum/listComment/9305

Version History

Version Date Content
5.0.1 4/13/2010 Initialization

Template:ZK5ComponentReferencePageFooter