Documentation

The Gtk+ core widget set provides a broad range of UI elements suited to most application development needs.
This slide-show provides as visual gallery of the offerings available in Gtk+ 2.14. All are supported via Builder/Glade UI XML files and creation via direct Gnocl scripting.



Non Widget Related Commands

callback Manipulate callback functions.
clipboard  Manipulate the clipboard.
configure
Change global gnocl settings.
file    

gconf 
info    
Retrieve different information.
inventory 
keyFile
 
mainLoop Enter the GTK+ event loop.
plug 
pointer
 
resourceFile 
screen 
signalStop 
socket 
sound 
stockItem 
update Process pending GTK+ events.
winfo 
  


Top Level Windows

dialog  A top level window with standard layout.
window A standard top level window.

To be displayed every widget must be a direct or indirect child of a top level window.


Container

box A widget that arranges its children horizontal or vertical.
expander  A container, which can hide its child widget.
notebook A widget that allows to interactively select which of its children is visible.
paned    A widget that allows to interactively resize two children.
scrolledWindow A window which adds scrollbars to its child.
separator A widget that groups widgets horizontal or vertical.
table A widget that arranges its children in rows and columns.
handleBox A widget that allows detachable window portions.

Container are widgets which arrange their children in certain manner. The separator widget does not have children, but helps to group widgets.


Buttons

button A widget that executes a command when clicked.
checkButton A widget that changes between two states when clicked.
comboBox   A widget with which one of several alternatives can be chosen.
radioButton   A widget from which only one of a group can be selected.
arrowButton A widget that displays an arrow.
linkButton A widget that is bound to a URL
scaleButton A widget that popups up a scale widget.
toggleButton A widget that retains its state.
volumeButton
A widget that pops up an audio volume control slider.
folderChooserButton A widget that allows a directory to be chosen.
fileChooserButton A widget that allows files to be selected.

Buttons are widgets that enables the user to initiate an action or to make a choice.

Entries

entry A widget that allows the user to input a small amount of text.
comboEntry  A widget that allows to input a small amount of text.
scale  A slider widget for selecting a value from a range.
spinButton     A widget that allows the user to input a number.
text A widget for multi line formatted text editing.

Entries are used for getting user input.


Display widgets

label A widget that shows a small amount of text.
image   A widget that shows an image.
progressBar A widget that gives the user feedback of background work.
statusBar     A widget that reports messages of minor importance to the user.
drawingArea A widget that be used for "custom user interface elements".
accelerator A widget that displays a mnemonic label to activate associated widgets.
iconView  -- TO BE IMPLEMENTED --
calendar A widget that displays a calendar and allows the user to select a date

Display widgets display information or give the user feedback.


Menu widgets

menuBar A menu container widget.
menu   A menu container widget.
menuItem A widget that gives the user feedback of background work.
menuCheckItem    A menu item which changes between two states when clicked.
menuRadioItem A menu item from which only one of a group can be selected.
menuSeparator A menu item which visually separates different items.
 menuRecentChooser  -- TO BE IMPLEMENTED --

Menu widgets are used for creating menus.


Toolbar widgets

toolBar A toolbar container widget.
item   A button like item in a toolbar.
checkItem A toolbar item which changes between two states when clicked.
radioItem    A toolbar item from which only one of a group can be selected.

Toolbar widgets are used for creating toolbars.


Special Selectors

colorButton
A button to launch a colour selection dialog.
colorSelection   A standard dialog to choose a colour.
fileChooser A standard dialog to choose a file.
fontButton  A button to launch a font selection dialog.
fontSelection A standard dialog to choose a font.

Special selectors get user input in a standardized way.


Tree and List Widgets

tree A widget that displays text or other items arranged in a tree.
list
A widget that displays text or other items arranged in rows and columns.

Misc. Widgets

eventBox A widget that catches events for its child widget.
plug  Toplevel to embed into another process
socket Container for embedding windows of other processes


Gnome Canvas Widget

canvas A widget that displays graphic objects.
bPath A canvas item which consists of line and bezier segments.
clipGroup A canvas item which implements clipping.
ellipse A canvas ellipse item.
image A canvas item which shows an image.
line A canvas line item.
polygon A canvas polygon item. 
rectangle A canvas rectangle item.
richText A canvas rich text item.
text A canvas text item.
widget
A canvas item which shows a normal widget.

The canvas widget displays graphic objects like lines, circles or text. It is available as separate library gnoclCanvas.


Gnome Gconf

gconf   Manipulate the Gnome GConf database.

The gconf command allows to store configuration information in a Gnome complient way. It is available as separate library gnoclGconf.


Gnome VFS

file Implement virtual file system commands.
mime Implement virtual file system commands.

The separate library gnoclVFS allows to retrieve MIME information and implements commands to use the Gnome virtual file system.

Syntax and semantic of these commands is not yet stable. Please mail the author if you have suggestions for improvements.


Gnome

appletFactory A command which creates a Gnome panel applet.
session A command which implements an interface to the Gnome session manager.

The separate library gnoclGnome implements different Gnome specific widgets and commands.


Deprecated

The following items have been DEPRECATED since GTK+ 2.4

 fileSelection
 A standard dialog to choose a file
 combo
 A widget that allows the user to input a small amount of text.
 optionMenu
 A widget with which one of several alternatives can be chosen.

These are commands, which are deprecated since a specific GTK+ version.


Printing

This feature has yet to be implemented.


Special Purpose Features

curve Allows direct editing of a curve
gammaCurve A subclass of GtkCurve for editing gamma curves
ruler Base class for horizontal or vertical rulers
HRuler A horizontal ruler
VRuler  A vertical ruler