II. GUI Basics

Chapter 8. Prefabricated Widgets

Window Control

Window Widget Window consists of the following widgets: Widget, Drag, Button, Resize.

XML Element Name Structure

<Drag>

</Drag>

</Widget>

Example

01<?xml version="1.0"?>
02<Widget setSize="500,250">
03<Widget setAnchor="true,true,false,false" setName="window" setShape="0,0,200,200" 
04setBorder="roundraised" markAsContainer="true">
05	<Drag setAlign="left" setFontStyle="bold" setForeground="white" 
06	setLabel="Window" setHighlight="false" setShape="3,3,200,17" 
07	setGradient="0137C2,6D92EA,false,1" setInsets="4,2,2,2" 
08	addImage="images/windows.gif,16,12" setBorder="none">
09		<Button setName="max" setShape="163,1,16,16" setVisible="false" 
10		setOpaque="false" setFocusTraversable="false" setHighlight="false" 
11		setBorder="none" addImage="images/min.gif,13,13" 
12		setImageRollover="images/maxrollover.gif" 
13		setImageDown="images/maxdown.gif" 
14		setImageDisabled="images/disabled.gif" 
15		setInsets="0,0,0,0" addActionTarget="window,action,setLocation='10%2c40',
16		window,action,setSize='200%2c200',max,action,setVisible='false',
17		min,action,setVisible='true',cls,action,setVisible='true'"/>
18		<Button setName="min" setShape="163,1,16,16" setOpaque="false" 
19		setFocusTraversable="false" setHighlight="false" 
20		setBorder="none" addImage="images/min.gif,13,13" 
21		setImageRollover="images/minrollover.gif" 
22		setImageDown="images/mindown.gif" 
23		setImageDisabled="images/disabled.gif" setInsets="0,0,0,0" 
24		addActionTarget="window,action,setLocation='3%2c223',
25		window,action,setSize='200%2c23',cls,action,setVisible='false',
26		min,action,setVisible='false',max,action,setVisible='true'"/>
27		<Button setName="cls" setShape="179,1,16,16" setOpaque="false" 
28		setFocusTraversable="false" setHighlight="false" setBorder="none" 
29		addImage="images/close.gif,13,13" 
30		setImageRollover="images/closerollover.gif" 
31		setImageDown="images/closedown.gif" 
32		setImageDisabled="images/disabled.gif" 
33		setInsets="0,0,0,0" addActionTarget="window,action,
34		setLocation='-200%2c-200'"/>
35	</Drag>
36</Widget>
37</Widget>

Line 02 Widget-container in which Window will be placed.
Line 03 Widget-container - it is frame for the window. The attributes are discribed in the Widgets Attributes, Chapter 10.
Line 05 Drag widget discribed in Widgets, Chapter 7.<9>. Drag is used as a header in the window. It allows to drag a window, set a title for a window and place any widget inside, like in this case we have placed three buttons: maximize, minimize and close window.
Line 09 Button widget is used to create a maximize (max) button, which appears only on minimized window like it is displayed in the image:

setVisible for 'max' button is set 'false', so the 'max' button will appear only when the user clicks on the 'min' button (setVisible for 'max' button is set 'true' in line 26).
Lines 15-17 When the user clicks on the 'max' button, number of events occur: window is relocated to the coordinates: 10,40; window size is changed to: 200,200; 'max' button appears invisible while 'min' and 'cls' buttons appears visible.
Line 18 Button wibget is used to create a minimize (min) button.
Lines 24-26 When the user clicks on the 'min' button, the number of events occur: window is relocated to the coordinates: 3,223; window's size is changed to: 200,23; 'min' button appears invisible, and 'max' button appears visible.
Line 27 Button wibget is used to create a close (cls) button.
Lines 33-34 When the user clicks on the 'cls' button, only one event is triggured: window is placed in location with coordinates '-200' and '-200' to make it out of visible range.

Window attributes

Window control consists of the following widgets: widget, button, and drag. All basic widget's attributes apply to these widgets. Basic set of methods that applies to all widgets is described in the Chapter 9 for widgets styles, and Chapter 10 for widgets attributes. For event handling methods please refer to Chapter 12.

Back Next