| Previous | Next |
Gnome widgets are used to standardize the gnome interface. If you are building a Gnome application, it is best to use them. They also simplify a few things, in comparison to similar Gtk+ widgets, and can allow you to tie your application into standard Gnome resources and other goodies.
Note that the following is NOT an exhaustive list of widgets. There are widgets available with different libraries that aren't included in Glade. Also note that all the functions for each widget are not listed here, nor are their parameters. For these please refer to the pages linked to in the library section of this tutorial.
| Gnome | |||
|---|---|---|---|
| Image | Name | Purpose | Functions and Considerations |
| Application Window | creates a standardized gnome app window | You will have to associate handlers to the signals emitted by the elements in the menus and the toolbar. See above on menu and toolbar for specifics. |
| About Dialog | creates a gnome about dialog box | You dont have to do anything here, but fill out the data (copyright, author, etc). Even the button signal is handled automatically. |
| Gnome App bar | creates the standard gnome application bar | This is the application bar that is loaded stock into the bottom of the Gnome Application Window. In the Glade Properties window you can set if it'll show a progress bar and a status message area. This message area is useful for giving status messages to the user. The gnome_appbar_push() and gnome_appbar_pop() functions are two of those that manipulate this. There is also a 'minibuffer' aspect to the appbar, see the Gnome Reference Manual for more. |
|
Gnome Druid | creates the gnome druid series of widgets | Gnome Druid is used when an application is first started, in order to allow the user to customize the application to their liking. You'll need to specify how many pages you need, and then use the Properties window to set properties for each page, and so on. You'll need to attach to the finish, prepare, cancel, and so on, signals. As well as adding whatever entry fields you need for the standard pages in the druid widget. |
| Gnome Color Picker | creates a button which brings up the gtk color selection dialog widget | This widget is a button which shows the color that has been selected, or the default color. Use the various gnome_color_picker_get_*() and gnome_color_picker_set_*() functions to manipulate the color swatch in this widget. The signal associated with this widget is color_set. |
| Gnome Font Picker | creates a button which brings up the gtk font selection dialog widget | The button this widget creates can be clicked to bring up the font selection dialog. It displays the current font as well. Use gnome_font_picker_get_font(), gnome_font_picker_get_font_name(), etc. The signal associated with this widget is font_set. |
| Gnome Icon Entry | creates an 'icon picker' button | This widget creates a button which will display the current icon, and bring up an icon selector when clicked. You can use the gnome_icon_entry_get_filename() function, amongst others, to play with this widget. |
| Gnome Href | creates a button that links to a webpage | This widget is a button that, when clicked, will launch the user's default browser and open up a webage. You can change an manipulate the label and url with gnome_href_set_url(), gnome_href_set_label(). |
| Gnome Entry | creates a combo entry box, with drop down menu and automatically managed 'history' | This is a standard combo box, but the history of the entries added to the box is maintained and managed by Gnome resources. Use the standard combobox signals and functions to deal with this. You can also use any of the gnome_entry_*() functions. |
| Gnome File Entry | creates a combo entry box, with drop down menu, and 'browse' button for finding files | There is a browse_clicked signal, which you can use to change the fileselection dialog which opens normally. You'll also need to connect to the gtk_entry signals (when something is changed) and so on. |
| Gnome Pixmap Entry | this creates a pixmap preview and an entry widget to pick pixmaps | This widget displays a preview of the selected image, and the entry part of it can return a filename if needed (it's a simple gnome file entry widget). |
| Gnome Date Edit | creates a date and time widget for manipulation | You can connect to the date_changed and time_changed signals here. Notice that it has a popup calendar button (internally managed) and a drop down option menu of times (also internally managed). The selections here will show in the date and time entry slots. The gnome_date_edit_get_date() function will return the time entered in the widget. Remember, this is time_t, in C terms. |
| Gnome Canvas | creates a display widget for structured graphics | I'm not familiar with this widget, and the documentation on it needs to be finished. Sorry. I do know there are several widget libraries out there which interface with it, they might be worth looking into when you need this widget. |
|
Icon List | creates a new icon list widget | See the gnomeui reference manual for more. |
|
Icon Selection | creates an icon selection widget | See the gnomeui reference manual for more. |
|
Bonobo Control | Implements a Cobra control widget | See the documentation on bonoboui for more, at this spot. |
| Previous | Next |