Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

autogui - Constructor

	Package	display
	Module	widgets
	Tool	autogui

Create an autogui tool

Synopsis
autogui(params, title, toplevel, map, actionlabel, autoapply, expand, widgetset)

Arguments

params		Record to define the autogui
		Allowed:	Record
title		title string if top-level frame constructed internally
		Allowed:	String
		Default:	'autogui'
toplevel		top-level parent frame
		Allowed:	frame or boolean
		Default:	F
map		map the GUI to the screen immediately?
		Allowed:	boolean
		Default:	T
actionlabel		label for action button
		Allowed:	string or boolean
		Default:	F
autoapply		Show auto-apply buttons
		Allowed:	boolean
		Default:	T
expand		Expand policy
		Allowed:	'x'|'y'|'both'|'none'
		Default:	'none'
widgetset		widgetserver tool to use to build the GUI
		Allowed:	widgetserver tool
		Default:	dws

Returns
subsequence

Description

This is the only constructor for the autogui tool. The first argument, params, contains the various parameters which will be used to generate the GUI. If a parent frame is not given in the toplevel argument, a top-level frame will be created with title as given in the title argument. If the actionlabel argument is given as a string, then a button will be placed at the bottom of the GUI with that string as its label. Pressing this button will cause the autogui tool to emit all parameters and their values via a setoptions event. If the map argument is F, then the GUI will be constructed but not shown to the user immediately, but can be shown via a call to autogui.map. The same effect can be controlled more carefully if a presently unmapped parent frame is given to toplevel. The final two arguments just provide some future flexibility with respect to widgetserver and guientry tools.