<TOOLBAR> : Tool bar

Java class : leon.view.LyToolBar

ROLE

A tool bar allows displaying a set of action buttons.
A tool bar can itself contain tool bars, which allows grouping together the action buttons into logical groups and sub-groups.

ATTRIBUTES

<!ATTLIST TOOLBAR
	  id NMTOKEN #IMPLIED
	  template NMTOKEN #IMPLIED
	  label CDATA #IMPLIED
	  controller CDATA #IMPLIED
	  image CDATA #IMPLIED
	  fill ( DEFAULT | HORIZONTAL | VERTICAL) "DEFAULT"
	  style ( DEFAULT | BORDER | MENU | SEPARATOR | EXPAND) "DEFAULT"
	  hAlign ( LEFT | RIGHT) "LEFT"
	  vAlign ( TOP | BOTTOM | MIDDLE) "TOP"
	  open ( true | false) "true"
	  font CDATA #IMPLIED
	  color CDATA #IMPLIED
	  fontColor CDATA #IMPLIED>
Attribute Mand. Description Default
id no Identifier of the tool bar.  
template no TOOLBAR.template  
label no Text of the tool bar.  
controller no Reference of the controller that manages the tool bar (i.e. handles user demands and refresh content).  
image no Image of the tool bar.  
fill no Allows specifying whether the bar is horizontal or vertical.
The DEFAULT value lets the viewer decide the way the component will be placed. A vertical fill automatically set the vAlign field to the MIDDLE value.
DEFAULT
style no Style of the tool bar.
The following styles are supported:
DEFAULT The viewer decides the style that will be attributed to the tool bar.
BORDER The tool bar is outlined by a border.
MENU The tool bar is shown under the form of a menu.
EXPAND The tool bar is shown under the form of an expand bar.
A tool bar contained in such a bar becomes then a sub-menu.
SEPARATOR The tool bar is flanked on both sides by separating lines which direction is the same as the one of the bar.
DEFAULT
hAlign no Horizontal position of the tool bar.
The following positions are supported:
LEFT The toolbar is at the left of the view.
RIGHT The toolbar is at the right of the view.
LEFT
vAlign no Vertical position
of the tool bar.
The following position are supported:
TOP The toolbar is at the top of the view. This position implies an horizontal fill for the toolbar.
BOTTOM The tool bar is at the bottom of the view. This position implies an horizontal fill for the toolbar.
MIDDLE The tool bar is on the left or the right side of the view. This position implies a vertical fill for the toolbar.
TOP
open no Indicates if the tool bar is opened or not when first displayed. true
font no TOOLBAR.font  
color no Background color of the tool bar.  
fontColor no TOOLBAR.fontColor  

ELEMENTS

<!ELEMENT TOOLBAR 
	  ((TOOL | TOOLBAR | SEP | LABEL | FIELD)*,
	   CONSTRAINT?,
	   DATA*)>
Element Mand. Mult. Description
TOOL yes no Action button contained in the bar.
TOOLBAR yes no Sub tool bar contained in the bar.
SEP yes no Separator contained in the bar.
LABEL yes no Input field of Label type.
FIELD yes no Input field displayed in toolbar.
CONSTRAINT no no Positioning constraint of the tool bar.
DATA no yes TOOLBAR.DATA

SAMPLE 1

<!-- Horizontal tool bar with a sub tool bar -->
<TOOLBAR fill="HORIZONTAL" id="TOOLBAR1" style="BORDER" image="visu_even.gif">
	<TOOL id="t1" label="LY_ACTION_CONSULT" image="LY_ACTION_CONSULT">
		<AREA id="area1" scrolling='NO'>
			<TOOLBAR fill="VERTICAL" id="TOOLBAR2" style="BORDER">
				<TOOL id="action1" label="LY_ACTION_CONSULT" image="LY_ACTION_CONSULT"/>
				<TOOL id="action5" label="LY_ACTION_PRINT" image="LY_ACTION_PRINT"/>
			</TOOLBAR>
		</AREA>
	</TOOL>
	<TOOL id="t2" label="LY_ACTION_CREATE" image="LY_ACTION_CREATE"/>
	<TOOL id="t3" label="LY_ACTION_SET" image="LY_ACTION_SET"/>
	<TOOL id="t4" label="LY_TOOL_FILTER_NEW" image="LY_TOOL_FILTER_NEW"/>
	<TOOL id="t4" label="LY_TOOL_FILTER_SET" image="LY_TOOL_FILTER_SET"/>
</TOOLBAR>


SAMPLE 2

<!-- Horizontal tool bar with an image and a outlined style -->
<TOOLBAR fill="HORIZONTAL" id="TOOLBAR" style="BORDER" image="actionBar.gif">
	<TOOL id="t1" label="LY_ACTION_CONSULT" image="LY_ACTION_CONSULT"/>
	<TOOL id="t2" label="LY_ACTION_CREATE" image="LY_ACTION_CREATE"/>
	<TOOL id="t3" label="LY_ACTION_SET" image="LY_ACTION_SET"/>
</TOOLBAR>