18 Appendix B: Implementation Design

The implementation design for the Lidskjalv framework mostly consists in selecting the widgets and gadgets for implementing the various Lidskjalv components. Below is a table, showing these correspondences for the three target platforms for Lidskjalv: Motif, Macintosh, and Windows (Win32 API).


Lidskjalv	Motif	Macintosh	Win32 API
interfaceObject	widget	superclass for menus, windows, controls, etc.
menuBar	RowColumn created as a menubar	menubar	Menubar
menu	RowColumn created as a menu	menu	Pop-up Menu
window	TopLevelShellWidgetClass	window	window
menuitem	CascadeButton/ PushButton/ ToggleButton	menuitem	menuitem
windowitem	DrawingArea	superclass for controls, texteditors, etc.	ChildWindow (except for figureItems)
canvas	simple specialization of Composite	object defining a local coordinate system with clipping	object defining a local coordinate system with clipping
scroller	ScrolledWindow	a canvas with scrollbars	a canvas with scrollbars
textEditor	ScrolledText	texteditor	MultiLine EDIT Control
control	simple specialization of Core	control (scrollbars, buttons, etc.)	CONTROL
button	simple specialization of Core	superclass for pushbutton, checkbox, etc.	Button Control
pushButton	PushButton	pushbutton	PushButton
iconButton	PushButton showing an image, but with a label	an icon with a name underneath (like the finder icons)
optionButton	OptionButton	popupmenu control	STATIC CONTROL + DROPDOWNLIST
staticText	Label	statictext item	Specialized window item
toggleButton	abstract class	superclass for checkbox and radiobutton	superclass for checkbox and radiobutton
radioButton	ToggleButton with indicatorType = ONE_OF_MANY	radiobutton	Button Control with BS_RADIOBUTTON style
checkBox	ToggleButton with indicatorType = MANY_OF_MANY	checkbox	Button Control with BS_CHECKBOX style
scrollbar	Scrollbar	scrollbar	SCROLLBAR Control
editText	Text without scrollbars configured as a singleline field	edittext item (used for dialogs)	SingleLine EDIT Control
textField	Text without scrollbars configured as a multiline field	multiline textfield with no scrollbars	MultiLine EDIT Control
scrollList	abstract class	superclass for scrolllists	LISTBOX Control
textScrollList	List	scrolllist with one scrollbar, like in the standard file dialog	LISTBOX Control
in interfaceObject:
event	callback	callback functions called when different events occurs	callback functions called when different events occurs
action	eventHandler	callback functions called when different events occurs	callback functions called when different events occurs
open	init (XtCreateWiget/ XtManageChild)	creating and displaying the object	creating and displaying the object
close	destroy (XtDestroyWidget)	removing the object from the screen	removing the object from the screen
mouseDown	buttonPress	mouseDown	WM_LBUTTOMDOWN, WM_MBUTTOMDOWN, WM_RBUTTOMDOWN
mouseUp	buttonRelease	mouseUp	WM_LBUTTOMUP, WM_MBUTTOMUP, WM_RBUTTOMUP
in menu:
name	The LabelString of the CascadeButton the menu is connected to	The name of the menu, as it appears in the menubar	The name of the menu, as it appears in the menubar
in window:
refresh	exposure	update event	WM_PAINT
target	keyBoardFocus	the object that handles the keydown events	the object that handles the keydown events
showModal	the window shown as SYSTEM_MODAL	the window used as a modal dialog	the window used as an application modal dialog
in windowitem:
position	x,y	the topleft corner of the objects bounding box	x,y
size	width,height	the width and height of the bounding box	nWidth,nHeight
bindLeft, etc.	geometry constraints in Form	resize constraints	resize constraints
show	map	show	SW_SHOW
hide	unmap	hide	SW_HIDE
in scrollbar:
scrollAmount	increment	how much the scrollbar scrolls when the arrows are pressed	how much the scrollbar scrolls when the arrows are pressed
pageScrollAmount	pageIncrement	how much the scrollbar scrolls when the page area are clicked	how much the scrollbar scrolls when the page area are clicked
in button descendants:
label	labelString	name	Text of Control
textStyle	fontList	font,face,size of the name	font,face,size of the TEXT Control
in toggleButton descendants:
state	set	state	check state

Lidskjalv: User Interface Framework - Reference Manual

[Modified: Wednesday October 4^th 2000 at 23:35]