Groupbox

From Documentation
Revision as of 03:55, 27 August 2010 by Tomyeh (talk | contribs) (→‎Example)

Groupbox

Employment/Purpose

A group box is used to group components together. A border is typically drawn around the components to show that they are related. The label across the top of the group box can be created by using the caption component. It works much like the HTML legend element. Unlike windows, a group box is not an owner of the ID space. It cannot be overlapped or popup.

Example

ZKComRef Groupbox Example.png

 <groupbox width="250px">
     <caption label="Fruits"/>
     <radiogroup>
         <radio label="Apple"/>
         <radio label="Orange"/>
         <radio label="Banana"/>
     </radiogroup>
 </groupbox>

Limitation of the Default Mold

The default mold of groupbox uses HTML FIELDSET to represent a groupbox visually. It is efficient, but it has some limitations:

  1. The look might be different from one browser to another
  2. The real width and height might not be exactly the same as the specified value in some browsers, such as Firefox.

If it is an issue, you could use the 3d mold instead.

 <groupbox width="250px">
     <caption label="Fruits"/>
     <radiogroup>
         <radio label="Apple"/>
         <radio label="Orange"/>
         <radio label="Banana"/>
     </radiogroup>
 </groupbox>

Supported events

Name
Event Type
onClick
MouseEvent


Description: Denotes user has clicked the component.

onRightClick
MouseEvent


Description: Denotes user has right-clicked the component.

onDoubleClick
MouseEvent


Description: Denotes user has double-clicked the component.

onOpen
OpenEvent


Description: 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.

Supported Children

*ALL

Use cases

Version Description Example Location
 

Version History

Version Date Content
     



Last Update : 2010/08/27

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.