Guile-GNOME: Gtk version 2.15.93, updated 2 September 2007 Damon Chaplin many others This manual is for (gnome gtk) (version 2.15.93, updated 2 September 2007) Copyright 1997-2007 Damon Chaplin and others This work may be reproduced and distributed in whole or in part, in any medium, physical or electronic, so as long as this copyright notice remains intact and unchanged on all copies. Commercial redistribution is permitted and encouraged, but you may not redistribute, in whole or in part, under terms more restrictive than those under which you received it. If you redistribute a modified or translated version of this work, you must also make the source code to the modified or translated version available in electronic form without charge. However, mere aggregation as part of a larger work shall not count as a modification for this purpose. All code examples in this work are placed into the public domain, and may be used, modified and redistributed without restriction. BECAUSE THIS WORK IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE WORK, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRIT- ING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE WORK "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. SHOULD THE WORK PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY REPAIR OR CORREC- TION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE WORK AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAM- AGES ARISING OUT OF THE USE OR INABILITY TO USE THE WORK, EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. i Short Contents 1 Overview :::::::::::::::::::::::::::::::::::::::::::: 1 2 GtkDialog ::::::::::::::::::::::::::::::::::::::::::: 2 3 GtkInvisible ::::::::::::::::::::::::::::::::::::::::: 7 4 GtkMessageDialog :::::::::::::::::::::::::::::::::::: 8 5 GtkWindow ::::::::::::::::::::::::::::::::::::::::: 10 6 GtkWindowGroup ::::::::::::::::::::::::::::::::::: 36 7 GtkAboutDialog ::::::::::::::::::::::::::::::::::::: 37 8 GtkAssistant :::::::::::::::::::::::::::::::::::::::: 42 9 GtkAccelLabel :::::::::::::::::::::::::::::::::::::: 48 10 GtkImage :::::::::::::::::::::::::::::::::::::::::: 51 11 GtkLabel ::::::::::::::::::::::::::::::::::::::::::: 60 12 GtkProgressBar:::::::::::::::::::::::::::::::::::::: 72 13 GtkStatusbar ::::::::::::::::::::::::::::::::::::::: 76 14 GtkStatusIcon ::::::::::::::::::::::::::::::::::::::: 79 15 GtkButton:::::::::::::::::::::::::::::::::::::::::: 86 16 GtkCheckButton ::::::::::::::::::::::::::::::::::::: 92 17 GtkRadioButton ::::::::::::::::::::::::::::::::::::: 93 18 GtkToggleButton :::::::::::::::::::::::::::::::::::: 96 19 GtkLinkButton ::::::::::::::::::::::::::::::::::::: 100 20 GtkEntry :::::::::::::::::::::::::::::::::::::::::: 102 21 GtkEntryCompletion :::::::::::::::::::::::::::::::: 109 22 GtkHScale ::::::::::::::::::::::::::::::::::::::::: 113 23 GtkVScale ::::::::::::::::::::::::::::::::::::::::: 114 24 GtkSpinButton ::::::::::::::::::::::::::::::::::::: 115 25 GtkEditable:::::::::::::::::::::::::::::::::::::::: 122 26 GtkTextIter :::::::::::::::::::::::::::::::::::::::: 126 27 GtkTextMark :::::::::::::::::::::::::::::::::::::: 141 28 GtkTextBuffer :::::::::::::::::::::::::::::::::::::: 143 29 GtkTextTag :::::::::::::::::::::::::::::::::::::::: 159 30 GtkTextTagTable ::::::::::::::::::::::::::::::::::: 164 31 GtkTextView::::::::::::::::::::::::::::::::::::::: 166 32 GtkTreeModel :::::::::::::::::::::::::::::::::::::: 179 33 GtkTreeSelection:::::::::::::::::::::::::::::::::::: 191 34 GtkTreeViewColumn :::::::::::::::::::::::::::::::: 195 35 GtkTreeView ::::::::::::::::::::::::::::::::::::::: 203 ii 36 GtkTreeView drag-and-drop::::::::::::::::::::::::::: 222 37 GtkCellView ::::::::::::::::::::::::::::::::::::::: 224 38 GtkIconView ::::::::::::::::::::::::::::::::::::::: 227 39 GtkTreeSortable :::::::::::::::::::::::::::::::::::: 239 40 GtkTreeModelSort :::::::::::::::::::::::::::::::::: 240 41 GtkTreeModelFilter ::::::::::::::::::::::::::::::::: 243 42 GtkCellLayout:::::::::::::::::::::::::::::::::::::: 245 43 GtkCellRenderer :::::::::::::::::::::::::::::::::::: 247 44 GtkCellEditable :::::::::::::::::::::::::::::::::::: 252 45 GtkCellRendererAccel ::::::::::::::::::::::::::::::: 253 46 GtkCellRendererCombo :::::::::::::::::::::::::::::: 254 47 GtkCellRendererPixbuf :::::::::::::::::::::::::::::: 255 48 GtkCellRendererProgress ::::::::::::::::::::::::::::: 256 49 GtkCellRendererSpin :::::::::::::::::::::::::::::::: 257 50 GtkCellRendererText :::::::::::::::::::::::::::::::: 258 51 GtkCellRendererToggle::::::::::::::::::::::::::::::: 261 52 GtkListStore ::::::::::::::::::::::::::::::::::::::: 263 53 GtkTreeStore::::::::::::::::::::::::::::::::::::::: 269 54 GtkComboBox ::::::::::::::::::::::::::::::::::::: 274 55 GtkComboBoxEntry ::::::::::::::::::::::::::::::::: 282 56 GtkMenu :::::::::::::::::::::::::::::::::::::::::: 284 57 GtkMenuBar ::::::::::::::::::::::::::::::::::::::: 290 58 GtkMenuItem :::::::::::::::::::::::::::::::::::::: 291 59 GtkMenuShell :::::::::::::::::::::::::::::::::::::: 295 60 GtkImageMenuItem ::::::::::::::::::::::::::::::::: 299 61 GtkRadioMenuItem ::::::::::::::::::::::::::::::::: 301 62 GtkCheckMenuItem ::::::::::::::::::::::::::::::::: 303 63 GtkSeparatorMenuItem :::::::::::::::::::::::::::::: 305 64 GtkTearoffMenuItem :::::::::::::::::::::::::::::::: 306 65 GtkToolbar :::::::::::::::::::::::::::::::::::::::: 307 66 GtkToolItem ::::::::::::::::::::::::::::::::::::::: 312 67 GtkSeparatorToolItem ::::::::::::::::::::::::::::::: 318 68 GtkToolButton ::::::::::::::::::::::::::::::::::::: 319 69 GtkMenuToolButton :::::::::::::::::::::::::::::::: 324 70 GtkToggleToolButton :::::::::::::::::::::::::::::::: 326 71 GtkRadioToolButton :::::::::::::::::::::::::::::::: 327 72 GtkUIManager ::::::::::::::::::::::::::::::::::::: 328 73 GtkActionGroup :::::::::::::::::::::::::::::::::::: 337 iii 74 GtkAction ::::::::::::::::::::::::::::::::::::::::: 343 75 GtkToggleAction :::::::::::::::::::::::::::::::::::: 350 76 GtkRadioAction :::::::::::::::::::::::::::::::::::: 352 77 GtkColorButton :::::::::::::::::::::::::::::::::::: 355 78 GtkColorSelection ::::::::::::::::::::::::::::::::::: 358 79 GtkColorSelectionDialog ::::::::::::::::::::::::::::: 360 80 GtkFileSelection :::::::::::::::::::::::::::::::::::: 361 81 GtkFileChooser ::::::::::::::::::::::::::::::::::::: 364 82 GtkFileChooserButton ::::::::::::::::::::::::::::::: 380 83 GtkFileChooserDialog:::::::::::::::::::::::::::::::: 382 84 GtkFileChooserWidget ::::::::::::::::::::::::::::::: 385 85 GtkFileFilter ::::::::::::::::::::::::::::::::::::::: 386 86 GtkFontButton ::::::::::::::::::::::::::::::::::::: 389 87 GtkFontSelection ::::::::::::::::::::::::::::::::::: 393 88 GtkFontSelectionDialog :::::::::::::::::::::::::::::: 395 89 GtkInputDialog ::::::::::::::::::::::::::::::::::::: 396 90 GtkAlignment :::::::::::::::::::::::::::::::::::::: 397 91 GtkAspectFrame :::::::::::::::::::::::::::::::::::: 400 92 GtkHBox :::::::::::::::::::::::::::::::::::::::::: 402 93 GtkVBox :::::::::::::::::::::::::::::::::::::::::: 403 94 GtkHButtonBox :::::::::::::::::::::::::::::::::::: 404 95 GtkVButtonBox :::::::::::::::::::::::::::::::::::: 405 96 GtkFixed :::::::::::::::::::::::::::::::::::::::::: 406 97 GtkHPaned :::::::::::::::::::::::::::::::::::::::: 408 98 GtkVPaned :::::::::::::::::::::::::::::::::::::::: 409 99 GtkLayout ::::::::::::::::::::::::::::::::::::::::: 410 100 GtkNotebook::::::::::::::::::::::::::::::::::::::: 413 101 GtkTable :::::::::::::::::::::::::::::::::::::::::: 425 102 GtkExpander::::::::::::::::::::::::::::::::::::::: 429 103 GtkFrame ::::::::::::::::::::::::::::::::::::::::: 434 104 GtkHSeparator ::::::::::::::::::::::::::::::::::::: 437 105 GtkVSeparator ::::::::::::::::::::::::::::::::::::: 438 106 GtkHScrollbar :::::::::::::::::::::::::::::::::::::: 439 107 GtkVScrollbar :::::::::::::::::::::::::::::::::::::: 440 108 GtkScrolledWindow ::::::::::::::::::::::::::::::::: 441 109 GtkPrintOperation :::::::::::::::::::::::::::::::::: 446 110 GtkPrintContext :::::::::::::::::::::::::::::::::::: 455 111 GtkPrintSettings :::::::::::::::::::::::::::::::::::: 458 iv 112 GtkPageSetup :::::::::::::::::::::::::::::::::::::: 469 113 GtkPaperSize :::::::::::::::::::::::::::::::::::::: 474 114 GtkPrinter ::::::::::::::::::::::::::::::::::::::::: 477 115 GtkPrintJob ::::::::::::::::::::::::::::::::::::::: 478 116 GtkPrintUnixDialog ::::::::::::::::::::::::::::::::: 479 117 GtkPageSetupUnixDialog ::::::::::::::::::::::::::::: 480 118 GtkAdjustment ::::::::::::::::::::::::::::::::::::: 481 119 GtkArrow ::::::::::::::::::::::::::::::::::::::::: 484 120 GtkCalendar ::::::::::::::::::::::::::::::::::::::: 485 121 GtkDrawingArea :::::::::::::::::::::::::::::::::::: 488 122 GtkEventBox::::::::::::::::::::::::::::::::::::::: 490 123 GtkHandleBox ::::::::::::::::::::::::::::::::::::: 492 124 GtkIMContextSimple :::::::::::::::::::::::::::::::: 495 125 GtkIMMulticontext:::::::::::::::::::::::::::::::::: 496 126 GtkSizeGroup :::::::::::::::::::::::::::::::::::::: 497 127 GtkTooltips :::::::::::::::::::::::::::::::::::::::: 500 128 GtkViewport ::::::::::::::::::::::::::::::::::::::: 503 129 GtkAccessible :::::::::::::::::::::::::::::::::::::: 505 130 GtkBin::::::::::::::::::::::::::::::::::::::::::::