Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

combobox - Constructor

	Package	display
	Module	widgets
	Tool	combobox

Construct a combobox

Synopsis
combobox(parent, labeltext, items, addonreturn, entrydisabled, canclearpopup, autoinsertorder, disabled, borderwidth, exportselection, vscrollbar, hscrollbar, labelwidth, labelfont, labelrelief, labeljustify, labelbackground, labelforeground, labelanchor, entrywidth, entryfont, entryrelief, entryjustify, entrybackground, entryforeground, entryanchor, arrowbutton, arrowbackground, arrowforeground, listboxheight, help, widgetset) Most of the defaulted arguments provide fine control over the appearance of the various parts of the combobox. Most users will never need to use these arguments. The arguments most likely be changed by users are placed early in the argument list.

Arguments

parent		a frame to hold the combobox
		Allowed:	glishtk frame
labeltext		a label for the combobox
		Allowed:	string
		Default:	'label'
items		The initial contents of the combobox data. The first item will be selected. If F the contents will be empty
		Allowed:	an array of strings
		Default:	F
addonreturn		Should a return in the entry widget automatically add the entry value to the contents?
		Allowed:	T or F
		Default:	T
entrydisabled		When the entry is disabled, the user can not edit in the entry, the combobox otherwise functions normally.
		Allowed:	T or F
		Default:	F
canclearpopup		When this is true, the listbox comes with a ``Clear'' button which, when pressed, clears the contents.
		Allowed:	T or F
		Default:	F
autoinsertorder		Determines where each new item is inserted if no specific location is given.
		Allowed:	'tail','head'
		Default:	'tail'
disabled		Disable the combobox, turns off all graphical interaction.
		Allowed:	T or F
		Default:	F
borderwidth		The borderwidth of the outer combobox frame.
		Allowed:	any integer
		Default:	2
exportselection		exportselection value for entry.
		Allowed:	T or F
		Default:	T
vscrollbar		The type of vertical scrollbar that the listbox has.
		Allowed:	'ondemand','always','none'
		Default:	'ondemand'
hscrollbar		The type of horizontal scrollbar that the listbox and the entry have.
		Allowed:	'ondemand','always','none'
		Default:	'none'
labelwidth		The width, in characters, of the label.
		Allowed:	any integer
		Default:	0
labelfont		The font used in the label.
		Allowed:	any X font.
labelrelief		The relief of the label.
		Allowed:	any glishtk relief
		Default:	'flat'
labeljustify		The text justification of the label.
		Allowed:	any glishtk text justificiation
		Default:	'left'

Arguments

labelbackground		The background color of the label.
		Allowed:	any X color.
		Default:	'lightgrey'
labelforeground		The foreground color of the label.
		Allowed:	any X color.
		Default:	'black'
labelanchor		The text anchor point within the label.
		Allowed:	any glishtk anchor.
		Default:	'c'
entrywidth		The width, in characters, of the entry.
		Allowed:	any integer
		Default:	30
entryfont		The font used in the entry.
		Allowed:	any X font.
entryrelief		The relief of the entry.
		Allowed:	any glishtk relief
		Default:	'sunken'
entryjustify		The text justification of the entry.
		Allowed:	any glishtk text justificiation
		Default:	'left'
entrybackground		The background color of the entry.
		Allowed:	any X color.
		Default:	'lightgrey'
entryforeground		The foreground color of the entry.
		Allowed:	any X color.
		Default:	'black'
entryanchor		The text anchor point within the entry.
		Allowed:	any glishtk anchor.
		Default:	'c'
arrowbutton		The file containing the bitmap to use for the arrow button.
		Allowed:	any X bitmap file.
		Default:	'downarrow.xbm'
arrowbackground		The background color of the arrow button.
		Allowed:	any X color.
		Default:	'lightgrey'
arrowforeground		The foreground color of the arrow button.
		Allowed:	any X color.
		Default:	'black'
listboxheight		The height of the listbox when a horizontal scrollbar is present.
		Allowed:	any integer
		Default:	6
help		Short popup help text
		Allowed:	String
widgetset		Widget set to use
		Allowed:	A widgetserver closure tool
		Default:	dws

Returns
a combobox tool with associated functions.