gtk2 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Rakefile +2 -2
- data/ext/gtk2/extconf.rb +1 -0
- data/lib/2.2/gtk2.so +0 -0
- data/lib/2.3/gtk2.so +0 -0
- data/sample/misc/threads.rb +0 -1
- data/vendor/local/bin/gtk-demo.exe +0 -0
- data/vendor/local/bin/gtk-query-immodules-2.0.exe +0 -0
- data/vendor/local/bin/gtk-update-icon-cache.exe +0 -0
- data/vendor/local/bin/libgailutil-18.dll +0 -0
- data/vendor/local/bin/libgdk-win32-2.0-0.dll +0 -0
- data/vendor/local/bin/libgtk-win32-2.0-0.dll +0 -0
- data/vendor/local/include/gtk-2.0/gtk/gtkcontainer.h +2 -1
- data/vendor/local/include/gtk-2.0/gtk/gtkversion.h +3 -3
- data/vendor/local/lib/gtk-2.0/2.10.0/engines/libpixmap.dll +0 -0
- data/vendor/local/lib/gtk-2.0/2.10.0/engines/libpixmap.dll.a +0 -0
- data/vendor/local/lib/gtk-2.0/2.10.0/engines/libpixmap.la +2 -2
- data/vendor/local/lib/gtk-2.0/2.10.0/engines/libwimp.dll +0 -0
- data/vendor/local/lib/gtk-2.0/2.10.0/engines/libwimp.dll.a +0 -0
- data/vendor/local/lib/gtk-2.0/2.10.0/engines/libwimp.la +2 -2
- data/vendor/local/lib/gtk-2.0/2.10.0/immodules.cache +1 -1
- data/vendor/local/lib/gtk-2.0/modules/libgail.dll +0 -0
- data/vendor/local/lib/gtk-2.0/modules/libgail.dll.a +0 -0
- data/vendor/local/lib/gtk-2.0/modules/libgail.la +2 -2
- data/vendor/local/lib/libgailutil.dll.a +0 -0
- data/vendor/local/lib/libgailutil.la +2 -2
- data/vendor/local/lib/libgdk-win32-2.0.dll.a +0 -0
- data/vendor/local/lib/libgdk-win32-2.0.la +3 -3
- data/vendor/local/lib/libgtk-win32-2.0.dll.a +0 -0
- data/vendor/local/lib/libgtk-win32-2.0.la +3 -3
- data/vendor/local/lib/pkgconfig/gail.pc +1 -1
- data/vendor/local/lib/pkgconfig/gdk-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gdk-win32-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gtk+-2.0.pc +1 -1
- data/vendor/local/lib/pkgconfig/gtk+-win32-2.0.pc +1 -1
- data/vendor/local/share/aclocal/gtk-2.0.m4 +2 -13
- data/vendor/local/share/gtk-doc/html/gail-libgail-util/gail-libgail-util-GailMisc.html +38 -45
- data/vendor/local/share/gtk-doc/html/gail-libgail-util/gail-libgail-util-GailTextUtil.html +14 -20
- data/vendor/local/share/gtk-doc/html/gail-libgail-util/gail-libgail-util.devhelp2 +1 -2
- data/vendor/local/share/gtk-doc/html/gail-libgail-util/index.html +3 -4
- data/vendor/local/share/gtk-doc/html/gail-libgail-util/libgail-util-main.html +3 -4
- data/vendor/local/share/gtk-doc/html/gail-libgail-util/style.css +9 -6
- data/vendor/local/share/gtk-doc/html/gdk2/GdkDisplay.html +105 -127
- data/vendor/local/share/gtk-doc/html/gdk2/GdkDisplayManager.html +19 -21
- data/vendor/local/share/gtk-doc/html/gdk2/GdkScreen.html +123 -146
- data/vendor/local/share/gtk-doc/html/gdk2/annotation-glossary.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-10.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-12.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-14.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-16.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-18.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-2.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-20.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-22.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-4.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-6.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-8.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-deprecated.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/api-index-full.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Application-launching.html +20 -22
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Bitmaps-and-Pixmaps.html +25 -31
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Cairo-Interaction.html +24 -27
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Colormaps-and-Colors.html +54 -76
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Cursors.html +34 -43
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Drag-and-Drop.html +46 -61
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Drawing-Primitives.html +91 -103
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Event-Structures.html +34 -34
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Events.html +62 -79
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Fonts.html +62 -86
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-GdkRGB.html +33 -39
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-General.html +40 -55
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Graphics-Contexts.html +46 -52
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Images.html +50 -71
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Input-Devices.html +43 -57
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Input.html +13 -16
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Keyboard-Handling.html +56 -74
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Pango-Interaction.html +106 -116
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Pixbufs.html +25 -28
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Points-Rectangles-and-Regions.html +40 -51
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Properties-and-Atoms.html +43 -57
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Selections.html +19 -25
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Testing.html +10 -13
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Threads.html +22 -29
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Visuals.html +51 -64
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Windows.html +295 -335
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2-X-Window-System-Interaction.html +190 -264
- data/vendor/local/share/gtk-doc/html/gdk2/gdk2.devhelp2 +236 -5
- data/vendor/local/share/gtk-doc/html/gdk2/index.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/multihead.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/reference.html +2 -3
- data/vendor/local/share/gtk-doc/html/gdk2/style.css +9 -6
- data/vendor/local/share/gtk-doc/html/gtk2/AbstractObjects.html +4 -5
- data/vendor/local/share/gtk-doc/html/gtk2/Actions.html +4 -5
- data/vendor/local/share/gtk-doc/html/gtk2/Builder.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/ButtonWidgets.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/DeprecatedObjects.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/DisplayWidgets.html +6 -7
- data/vendor/local/share/gtk-doc/html/gtk2/GtkAboutDialog.html +123 -134
- data/vendor/local/share/gtk-doc/html/gtk2/GtkAccelLabel.html +4 -216
- data/vendor/local/share/gtk-doc/html/gtk2/GtkAccessible.html +6 -72
- data/vendor/local/share/gtk-doc/html/gtk2/GtkAction.html +65 -1250
- data/vendor/local/share/gtk-doc/html/gtk2/GtkActionGroup.html +62 -68
- data/vendor/local/share/gtk-doc/html/gtk2/GtkActivatable.html +16 -678
- data/vendor/local/share/gtk-doc/html/gtk2/GtkAdjustment.html +46 -54
- data/vendor/local/share/gtk-doc/html/gtk2/GtkAlignment.html +10 -199
- data/vendor/local/share/gtk-doc/html/gtk2/GtkArrow.html +4 -78
- data/vendor/local/share/gtk-doc/html/gtk2/GtkAspectFrame.html +4 -107
- data/vendor/local/share/gtk-doc/html/gtk2/GtkAssistant.html +59 -903
- data/vendor/local/share/gtk-doc/html/gtk2/GtkBin.html +4 -35
- data/vendor/local/share/gtk-doc/html/gtk2/GtkBox.html +19 -24
- data/vendor/local/share/gtk-doc/html/gtk2/GtkBuildable.html +23 -498
- data/vendor/local/share/gtk-doc/html/gtk2/GtkBuilder.html +69 -79
- data/vendor/local/share/gtk-doc/html/gtk2/GtkButton.html +62 -73
- data/vendor/local/share/gtk-doc/html/gtk2/GtkButtonBox.html +17 -21
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCList.html +160 -185
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCTree.html +95 -158
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCalendar.html +51 -60
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellEditable.html +12 -13
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellLayout.html +25 -26
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRenderer.html +58 -62
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererAccel.html +17 -19
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererCombo.html +10 -12
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererPixbuf.html +16 -18
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererProgress.html +11 -13
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererSpin.html +8 -10
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererSpinner.html +9 -37
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererText.html +34 -36
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererToggle.html +16 -21
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCellView.html +36 -44
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCheckButton.html +8 -12
- data/vendor/local/share/gtk-doc/html/gtk2/GtkColorButton.html +42 -48
- data/vendor/local/share/gtk-doc/html/gtk2/GtkColorSelection.html +53 -64
- data/vendor/local/share/gtk-doc/html/gtk2/GtkColorSelectionDialog.html +8 -10
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCombo.html +15 -17
- data/vendor/local/share/gtk-doc/html/gtk2/GtkComboBox.html +116 -134
- data/vendor/local/share/gtk-doc/html/gtk2/GtkComboBoxEntry.html +15 -20
- data/vendor/local/share/gtk-doc/html/gtk2/GtkComboBoxText.html +11 -216
- data/vendor/local/share/gtk-doc/html/gtk2/GtkContainer.html +54 -60
- data/vendor/local/share/gtk-doc/html/gtk2/GtkCurve.html +11 -13
- data/vendor/local/share/gtk-doc/html/gtk2/GtkDialog.html +48 -55
- data/vendor/local/share/gtk-doc/html/gtk2/GtkDrawingArea.html +10 -12
- data/vendor/local/share/gtk-doc/html/gtk2/GtkEditable.html +24 -29
- data/vendor/local/share/gtk-doc/html/gtk2/GtkEntry.html +247 -275
- data/vendor/local/share/gtk-doc/html/gtk2/GtkEntryBuffer.html +39 -47
- data/vendor/local/share/gtk-doc/html/gtk2/GtkEntryCompletion.html +82 -96
- data/vendor/local/share/gtk-doc/html/gtk2/GtkEventBox.html +16 -20
- data/vendor/local/share/gtk-doc/html/gtk2/GtkExpander.html +46 -55
- data/vendor/local/share/gtk-doc/html/gtk2/GtkFileChooser.html +116 -2831
- data/vendor/local/share/gtk-doc/html/gtk2/GtkFileChooserButton.html +34 -41
- data/vendor/local/share/gtk-doc/html/gtk2/GtkFileChooserDialog.html +10 -13
- data/vendor/local/share/gtk-doc/html/gtk2/GtkFileChooserWidget.html +9 -12
- data/vendor/local/share/gtk-doc/html/gtk2/GtkFileSelection.html +16 -21
- data/vendor/local/share/gtk-doc/html/gtk2/GtkFixed.html +12 -15
- data/vendor/local/share/gtk-doc/html/gtk2/GtkFontButton.html +49 -59
- data/vendor/local/share/gtk-doc/html/gtk2/GtkFontSelection.html +51 -58
- data/vendor/local/share/gtk-doc/html/gtk2/GtkFontSelectionDialog.html +30 -37
- data/vendor/local/share/gtk-doc/html/gtk2/GtkFrame.html +17 -21
- data/vendor/local/share/gtk-doc/html/gtk2/GtkGammaCurve.html +4 -6
- data/vendor/local/share/gtk-doc/html/gtk2/GtkHBox.html +4 -43
- data/vendor/local/share/gtk-doc/html/gtk2/GtkHButtonBox.html +8 -12
- data/vendor/local/share/gtk-doc/html/gtk2/GtkHPaned.html +4 -6
- data/vendor/local/share/gtk-doc/html/gtk2/GtkHRuler.html +4 -6
- data/vendor/local/share/gtk-doc/html/gtk2/GtkHSV.html +22 -25
- data/vendor/local/share/gtk-doc/html/gtk2/GtkHScale.html +7 -10
- data/vendor/local/share/gtk-doc/html/gtk2/GtkHScrollbar.html +5 -7
- data/vendor/local/share/gtk-doc/html/gtk2/GtkHSeparator.html +4 -6
- data/vendor/local/share/gtk-doc/html/gtk2/GtkHandleBox.html +18 -24
- data/vendor/local/share/gtk-doc/html/gtk2/GtkIMContext.html +33 -39
- data/vendor/local/share/gtk-doc/html/gtk2/GtkIMContextSimple.html +5 -7
- data/vendor/local/share/gtk-doc/html/gtk2/GtkIMMulticontext.html +10 -13
- data/vendor/local/share/gtk-doc/html/gtk2/GtkIconTheme.html +107 -122
- data/vendor/local/share/gtk-doc/html/gtk2/GtkIconView.html +188 -215
- data/vendor/local/share/gtk-doc/html/gtk2/GtkImage.html +77 -1174
- data/vendor/local/share/gtk-doc/html/gtk2/GtkImageMenuItem.html +28 -35
- data/vendor/local/share/gtk-doc/html/gtk2/GtkInfoBar.html +27 -499
- data/vendor/local/share/gtk-doc/html/gtk2/GtkInputDialog.html +11 -13
- data/vendor/local/share/gtk-doc/html/gtk2/GtkInvisible.html +23 -26
- data/vendor/local/share/gtk-doc/html/gtk2/GtkItem.html +9 -10
- data/vendor/local/share/gtk-doc/html/gtk2/GtkItemFactory.html +39 -45
- data/vendor/local/share/gtk-doc/html/gtk2/GtkLabel.html +137 -159
- data/vendor/local/share/gtk-doc/html/gtk2/GtkLayout.html +24 -26
- data/vendor/local/share/gtk-doc/html/gtk2/GtkLinkButton.html +25 -30
- data/vendor/local/share/gtk-doc/html/gtk2/GtkList.html +32 -36
- data/vendor/local/share/gtk-doc/html/gtk2/GtkListItem.html +18 -21
- data/vendor/local/share/gtk-doc/html/gtk2/GtkListStore.html +42 -46
- data/vendor/local/share/gtk-doc/html/gtk2/GtkMenu.html +67 -74
- data/vendor/local/share/gtk-doc/html/gtk2/GtkMenuBar.html +20 -24
- data/vendor/local/share/gtk-doc/html/gtk2/GtkMenuItem.html +46 -54
- data/vendor/local/share/gtk-doc/html/gtk2/GtkMenuShell.html +33 -36
- data/vendor/local/share/gtk-doc/html/gtk2/GtkMenuToolButton.html +22 -25
- data/vendor/local/share/gtk-doc/html/gtk2/GtkMessageDialog.html +49 -486
- data/vendor/local/share/gtk-doc/html/gtk2/GtkMisc.html +7 -8
- data/vendor/local/share/gtk-doc/html/gtk2/GtkNotebook.html +127 -166
- data/vendor/local/share/gtk-doc/html/gtk2/GtkObject.html +43 -49
- data/vendor/local/share/gtk-doc/html/gtk2/GtkOffscreenWindow.html +11 -88
- data/vendor/local/share/gtk-doc/html/gtk2/GtkOldEditable.html +18 -21
- data/vendor/local/share/gtk-doc/html/gtk2/GtkOptionMenu.html +12 -16
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPageSetup.html +70 -87
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPageSetupUnixDialog.html +16 -18
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPaned.html +40 -42
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPaperSize.html +62 -80
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPixmap.html +22 -24
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPlug.html +23 -245
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPreview.html +29 -34
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPrintContext.html +51 -57
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPrintJob.html +34 -40
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPrintSettings.html +197 -237
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPrintUnixDialog.html +51 -60
- data/vendor/local/share/gtk-doc/html/gtk2/GtkPrinter.html +76 -97
- data/vendor/local/share/gtk-doc/html/gtk2/GtkProgress.html +21 -27
- data/vendor/local/share/gtk-doc/html/gtk2/GtkProgressBar.html +44 -51
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRadioAction.html +21 -24
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRadioButton.html +23 -25
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRadioMenuItem.html +24 -27
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRadioToolButton.html +22 -25
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRange.html +81 -94
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentAction.html +14 -18
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentChooser.html +102 -120
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentChooserDialog.html +10 -13
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentChooserMenu.html +14 -18
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentChooserWidget.html +8 -11
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentFilter.html +34 -40
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentManager.html +124 -154
- data/vendor/local/share/gtk-doc/html/gtk2/GtkRuler.html +9 -11
- data/vendor/local/share/gtk-doc/html/gtk2/GtkScale.html +30 -35
- data/vendor/local/share/gtk-doc/html/gtk2/GtkScaleButton.html +41 -45
- data/vendor/local/share/gtk-doc/html/gtk2/GtkScrollbar.html +4 -4
- data/vendor/local/share/gtk-doc/html/gtk2/GtkScrolledWindow.html +34 -38
- data/vendor/local/share/gtk-doc/html/gtk2/GtkSeparator.html +4 -4
- data/vendor/local/share/gtk-doc/html/gtk2/GtkSeparatorMenuItem.html +4 -6
- data/vendor/local/share/gtk-doc/html/gtk2/GtkSeparatorToolItem.html +11 -14
- data/vendor/local/share/gtk-doc/html/gtk2/GtkSettings.html +49 -55
- data/vendor/local/share/gtk-doc/html/gtk2/GtkSizeGroup.html +21 -25
- data/vendor/local/share/gtk-doc/html/gtk2/GtkSocket.html +11 -259
- data/vendor/local/share/gtk-doc/html/gtk2/GtkSpinButton.html +51 -67
- data/vendor/local/share/gtk-doc/html/gtk2/GtkSpinner.html +11 -63
- data/vendor/local/share/gtk-doc/html/gtk2/GtkStatusIcon.html +162 -187
- data/vendor/local/share/gtk-doc/html/gtk2/GtkStatusbar.html +21 -26
- data/vendor/local/share/gtk-doc/html/gtk2/GtkStyle.html +227 -239
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTable.html +25 -32
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTearoffMenuItem.html +4 -6
- data/vendor/local/share/gtk-doc/html/gtk2/GtkText.html +28 -34
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTextBuffer.html +184 -203
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTextIter.html +195 -275
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTextMark.html +17 -23
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTextTag.html +57 -65
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTextTagTable.html +15 -18
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTextView.html +161 -192
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTipsQuery.html +14 -17
- data/vendor/local/share/gtk-doc/html/gtk2/GtkToggleAction.html +20 -24
- data/vendor/local/share/gtk-doc/html/gtk2/GtkToggleButton.html +20 -27
- data/vendor/local/share/gtk-doc/html/gtk2/GtkToggleToolButton.html +15 -19
- data/vendor/local/share/gtk-doc/html/gtk2/GtkToolButton.html +42 -49
- data/vendor/local/share/gtk-doc/html/gtk2/GtkToolItem.html +85 -101
- data/vendor/local/share/gtk-doc/html/gtk2/GtkToolItemGroup.html +26 -482
- data/vendor/local/share/gtk-doc/html/gtk2/GtkToolPalette.html +43 -749
- data/vendor/local/share/gtk-doc/html/gtk2/GtkToolShell.html +15 -290
- data/vendor/local/share/gtk-doc/html/gtk2/GtkToolbar.html +74 -93
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTooltip.html +30 -31
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTooltips.html +15 -19
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTree.html +25 -28
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeItem.html +5 -14
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeModel.html +120 -156
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeModelFilter.html +33 -38
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeModelSort.html +21 -26
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeSelection.html +42 -49
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeSortable.html +15 -19
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeStore.html +43 -49
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeView.html +231 -302
- data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeViewColumn.html +87 -109
- data/vendor/local/share/gtk-doc/html/gtk2/GtkUIManager.html +62 -69
- data/vendor/local/share/gtk-doc/html/gtk2/GtkVBox.html +4 -43
- data/vendor/local/share/gtk-doc/html/gtk2/GtkVButtonBox.html +4 -78
- data/vendor/local/share/gtk-doc/html/gtk2/GtkVPaned.html +4 -17
- data/vendor/local/share/gtk-doc/html/gtk2/GtkVRuler.html +4 -28
- data/vendor/local/share/gtk-doc/html/gtk2/GtkVScale.html +4 -78
- data/vendor/local/share/gtk-doc/html/gtk2/GtkVScrollbar.html +4 -38
- data/vendor/local/share/gtk-doc/html/gtk2/GtkVSeparator.html +4 -20
- data/vendor/local/share/gtk-doc/html/gtk2/GtkViewport.html +10 -262
- data/vendor/local/share/gtk-doc/html/gtk2/GtkVolumeButton.html +5 -19
- data/vendor/local/share/gtk-doc/html/gtk2/GtkWidget.html +265 -8803
- data/vendor/local/share/gtk-doc/html/gtk2/GtkWindow.html +251 -291
- data/vendor/local/share/gtk-doc/html/gtk2/GtkWindowGroup.html +10 -16
- data/vendor/local/share/gtk-doc/html/gtk2/LayoutContainers.html +8 -9
- data/vendor/local/share/gtk-doc/html/gtk2/MenusAndCombos.html +6 -7
- data/vendor/local/share/gtk-doc/html/gtk2/MiscObjects.html +5 -6
- data/vendor/local/share/gtk-doc/html/gtk2/NumericEntry.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/Ornaments.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/PlugSocket.html +4 -5
- data/vendor/local/share/gtk-doc/html/gtk2/Printing.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/RecentDocuments.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/ScrollingWidgets.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/SelectorWidgets.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/SpecialObjects.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/TextWidget.html +5 -6
- data/vendor/local/share/gtk-doc/html/gtk2/TextWidgetObjects.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/TreeWidget.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/TreeWidgetObjects.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/WindowWidgets.html +5 -7
- data/vendor/local/share/gtk-doc/html/gtk2/annotation-glossary.html +9 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-10.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-12.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-14.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-16.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-18.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-2.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-20.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-22.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-24.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-4.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-6.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-8.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-deprecated.html +2 -7
- data/vendor/local/share/gtk-doc/html/gtk2/api-index-full.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/ch01.html +6 -7
- data/vendor/local/share/gtk-doc/html/gtk2/ch02.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/chap-drawing-model.html +6 -7
- data/vendor/local/share/gtk-doc/html/gtk2/checklist-gdkeventexpose-region.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/checklist-modifiers.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/checklist-named-icons.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/decorating-the-assistant-pages.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/glossary.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-builder-convert.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-building.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-changes-1-2.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-changes-2-0.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-compiling.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-directfb.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-ClientSideWindows.html +12 -13
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkAboutDialog.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkAction.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkAssistant.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkBuilder.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkColorButton.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkComboBox.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkFileChooser.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkIconView.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkLinkButton.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkRecentChooser.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-checklist.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-entry-icons.html +4 -5
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-label-links.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-tooltips.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-osx.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-query-immodules-2.0.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-question-index.html +31 -32
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-resources.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-running.html +3 -4
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-update-icon-cache.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-windows.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk-x11.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Accelerator-Maps.html +28 -32
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Bindings.html +41 -48
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Clipboards.html +118 -129
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Drag-and-Drop.html +106 -109
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Feature-Test-Macros.html +8 -10
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Filesystem-utilities.html +20 -223
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-General.html +124 -149
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Graphics-Contexts.html +26 -28
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-GtkTreeView-drag-and-drop.html +17 -25
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-High-level-Printing-API.html +149 -162
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Keyboard-Accelerators.html +135 -134
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Orientable.html +10 -12
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Resource-Files.html +50 -68
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Selections.html +149 -173
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Signals.html +46 -58
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Standard-Enumerations.html +44 -44
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Stock-Items.html +39 -485
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Testing.html +21 -534
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Themeable-Stock-Images.html +79 -98
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Types.html +97 -110
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-gtkcheckmenuitem.html +22 -29
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2-gtkfilefilter.html +28 -34
- data/vendor/local/share/gtk-doc/html/gtk2/gtk2.devhelp2 +137 -87
- data/vendor/local/share/gtk-doc/html/gtk2/gtkbase.html +5 -6
- data/vendor/local/share/gtk-doc/html/gtk2/gtkfilechooser-installing-extra-widgets.html +4 -5
- data/vendor/local/share/gtk-doc/html/gtk2/gtkfilechooser-installing-preview.html +4 -5
- data/vendor/local/share/gtk-doc/html/gtk2/gtkfilechooser-new-features.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtkfilechooser-selection-modes.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtkobjects.html +36 -38
- data/vendor/local/share/gtk-doc/html/gtk2/gtkrecent-advanced.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/gtkrecent-chooser.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/index.html +39 -41
- data/vendor/local/share/gtk-doc/html/gtk2/migrating-GtkCombo.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/migrating-gnomeuiinfo.html +13 -14
- data/vendor/local/share/gtk-doc/html/gtk2/migrating.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/new-features-GtkComboBox.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/pt05.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/setting-the-page-flow.html +2 -3
- data/vendor/local/share/gtk-doc/html/gtk2/style.css +9 -6
- data/vendor/local/share/gtk-doc/html/gtk2/ui-manager.html +2 -3
- data/vendor/local/share/locale/af/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/am/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/am/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ang/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ang/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ar/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/as/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/as/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ast/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ast/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/az/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/az/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/az_IR/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/az_IR/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/be/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/be@latin/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/be@latin/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/bg/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/bg/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/bn/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/bn/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/bn_IN/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/bn_IN/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/br/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/br/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/bs/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/bs/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ca/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ca/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/crh/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/crh/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/da/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/da/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/de/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/dz/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/dz/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/el/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/en_CA/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/en_CA/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/eo/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/eo/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/es/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/et/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/et/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/eu/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/eu/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/fa/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/fa/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/fi/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/fi/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/fr/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/fr/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ga/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ga/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/gu/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/gu/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/he/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/hi/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/hi/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/hr/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/hr/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/hu/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/hu/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/hy/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/hy/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ia/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/id/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/id/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/io/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/io/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/is/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/is/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ja/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ja/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ka/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ka/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/kk/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/kn/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/kn/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ko/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ko/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ku/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ku/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/li/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/li/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/lv/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/lv/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/mai/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/mai/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/mi/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/mi/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/mk/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/mk/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ml/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ml/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/mn/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/mn/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/mr/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/mr/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ms/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ms/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/my/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/my/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/nb/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/nds/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/nds/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ne/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ne/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/nl/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/nn/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/nn/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/nso/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/nso/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/oc/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/oc/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/or/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/or/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/pa/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/pa/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ps/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ps/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/pt/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/pt/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ru/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ru/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/rw/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/rw/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/si/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/si/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/sk/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/sk/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/sl/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/sl/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/sq/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/sq/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/sr/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/sr/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/sr@ije/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/sr@ije/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/sv/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/sv/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ta/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ta/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/te/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/te/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/th/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/th/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/tk/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/tk/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/tr/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/tr/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/tt/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/tt/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ug/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ug/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/uk/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/uk/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/ur/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/ur/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/uz/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/uz/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/uz@cyrillic/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/uz@cyrillic/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/vi/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/vi/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/wa/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/wa/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/xh/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/xh/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/yi/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/yi/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gtk20-properties.mo +0 -0
- data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gtk20.mo +0 -0
- data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gtk20-properties.mo +0 -0
- metadata +10 -14
- data/lib/2.0/gtk2.so +0 -0
- data/lib/2.1/gtk2.so +0 -0
- data/vendor/local/share/gtk-doc/html/gail-libgail-util/index.sgml +0 -30
- data/vendor/local/share/gtk-doc/html/gdk2/index.sgml +0 -1534
- data/vendor/local/share/gtk-doc/html/gtk2/index.sgml +0 -8851
@@ -8,7 +8,7 @@
|
|
8
8
|
<link rel="up" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
|
9
9
|
<link rel="prev" href="GtkHSV.html" title="GtkHSV">
|
10
10
|
<link rel="next" href="GtkFileChooserButton.html" title="GtkFileChooserButton">
|
11
|
-
<meta name="generator" content="GTK-Doc V1.
|
11
|
+
<meta name="generator" content="GTK-Doc V1.24.1 (XML mode)">
|
12
12
|
<link rel="stylesheet" href="style.css" type="text/css">
|
13
13
|
</head>
|
14
14
|
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
@@ -32,7 +32,7 @@
|
|
32
32
|
<div class="refnamediv"><table width="100%"><tr>
|
33
33
|
<td valign="top">
|
34
34
|
<h2><span class="refentrytitle"><a name="GtkFileChooser.top_of_page"></a>GtkFileChooser</span></h2>
|
35
|
-
<p>GtkFileChooser
|
35
|
+
<p>GtkFileChooser</p>
|
36
36
|
</td>
|
37
37
|
<td class="gallery_image" valign="top" align="right"></td>
|
38
38
|
</tr></table></div>
|
@@ -45,10 +45,6 @@
|
|
45
45
|
</colgroup>
|
46
46
|
<tbody>
|
47
47
|
<tr>
|
48
|
-
<td class="define_keyword">#define</td>
|
49
|
-
<td class="function_name"><a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ERROR:CAPS" title="GTK_FILE_CHOOSER_ERROR">GTK_FILE_CHOOSER_ERROR</a></td>
|
50
|
-
</tr>
|
51
|
-
<tr>
|
52
48
|
<td class="function_type">
|
53
49
|
<span class="returnvalue">void</span>
|
54
50
|
</td>
|
@@ -362,7 +358,7 @@
|
|
362
358
|
</tr>
|
363
359
|
<tr>
|
364
360
|
<td class="function_type">
|
365
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
|
361
|
+
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
|
366
362
|
</td>
|
367
363
|
<td class="function_name">
|
368
364
|
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder-file" title="gtk_file_chooser_get_current_folder_file ()">gtk_file_chooser_get_current_folder_file</a> <span class="c_punctuation">()</span>
|
@@ -370,7 +366,7 @@
|
|
370
366
|
</tr>
|
371
367
|
<tr>
|
372
368
|
<td class="function_type">
|
373
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
|
369
|
+
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
|
374
370
|
</td>
|
375
371
|
<td class="function_name">
|
376
372
|
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-file" title="gtk_file_chooser_get_file ()">gtk_file_chooser_get_file</a> <span class="c_punctuation">()</span>
|
@@ -386,7 +382,7 @@
|
|
386
382
|
</tr>
|
387
383
|
<tr>
|
388
384
|
<td class="function_type">
|
389
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
|
385
|
+
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
|
390
386
|
</td>
|
391
387
|
<td class="function_name">
|
392
388
|
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-file" title="gtk_file_chooser_get_preview_file ()">gtk_file_chooser_get_preview_file</a> <span class="c_punctuation">()</span>
|
@@ -561,6 +557,10 @@
|
|
561
557
|
<td class="function_name"><a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation">GtkFileChooserConfirmation</a></td>
|
562
558
|
</tr>
|
563
559
|
<tr>
|
560
|
+
<td class="define_keyword">#define</td>
|
561
|
+
<td class="function_name"><a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ERROR:CAPS" title="GTK_FILE_CHOOSER_ERROR">GTK_FILE_CHOOSER_ERROR</a></td>
|
562
|
+
</tr>
|
563
|
+
<tr>
|
564
564
|
<td class="datatype_keyword">enum</td>
|
565
565
|
<td class="function_name"><a class="link" href="GtkFileChooser.html#GtkFileChooserError" title="enum GtkFileChooserError">GtkFileChooserError</a></td>
|
566
566
|
</tr>
|
@@ -613,7 +613,7 @@
|
|
613
613
|
</div>
|
614
614
|
<div class="refsect1">
|
615
615
|
<a name="GtkFileChooser.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
616
|
-
<pre class="screen"> GInterface
|
616
|
+
<pre class="screen"> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
|
617
617
|
<span class="lineart">╰──</span> GtkFileChooser
|
618
618
|
</pre>
|
619
619
|
</div>
|
@@ -636,740 +636,22 @@ GtkFileChooser is implemented by
|
|
636
636
|
</div>
|
637
637
|
<div class="refsect1">
|
638
638
|
<a name="GtkFileChooser.description"></a><h2>Description</h2>
|
639
|
-
<p><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> is an interface that can be implemented by file
|
640
|
-
selection widgets. In GTK+, the main objects that implement this
|
641
|
-
interface are <a class="link" href="GtkFileChooserWidget.html" title="GtkFileChooserWidget"><span class="type">GtkFileChooserWidget</span></a>, <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a>, and
|
642
|
-
<a class="link" href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a>. You do not need to write an object that
|
643
|
-
implements the <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> interface unless you are trying to
|
644
|
-
adapt an existing file selector to expose a standard programming
|
645
|
-
interface.</p>
|
646
|
-
<p><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> allows for shortcuts to various places in the filesystem.
|
647
|
-
In the default implementation these are displayed in the left pane. It
|
648
|
-
may be a bit confusing at first that these shortcuts come from various
|
649
|
-
sources and in various flavours, so lets explain the terminology here:</p>
|
650
|
-
<div class="variablelist"><table border="0" class="variablelist">
|
651
|
-
<colgroup>
|
652
|
-
<col align="left" valign="top">
|
653
|
-
<col>
|
654
|
-
</colgroup>
|
655
|
-
<tbody>
|
656
|
-
<tr>
|
657
|
-
<td><p><span class="term">Bookmarks</span></p></td>
|
658
|
-
<td>
|
659
|
-
are created by the user, by dragging folders from the
|
660
|
-
right pane to the left pane, or by using the "Add". Bookmarks
|
661
|
-
can be renamed and deleted by the user.
|
662
|
-
</td>
|
663
|
-
</tr>
|
664
|
-
<tr>
|
665
|
-
<td><p><span class="term">Shortcuts</span></p></td>
|
666
|
-
<td>
|
667
|
-
can be provided by the application or by the underlying filesystem
|
668
|
-
abstraction (e.g. both the gnome-vfs and the Windows filesystems
|
669
|
-
provide "Desktop" shortcuts). Shortcuts cannot be modified by the
|
670
|
-
user.
|
671
|
-
</td>
|
672
|
-
</tr>
|
673
|
-
<tr>
|
674
|
-
<td><p><span class="term">Volumes</span></p></td>
|
675
|
-
<td>
|
676
|
-
are provided by the underlying filesystem abstraction. They are
|
677
|
-
the "roots" of the filesystem.
|
678
|
-
</td>
|
679
|
-
</tr>
|
680
|
-
</tbody>
|
681
|
-
</table></div>
|
682
|
-
<div class="refsect2">
|
683
|
-
<a name="gtkfilechooser-encodings"></a><h3>File Names and Encodings</h3>
|
684
|
-
When the user is finished selecting files in a
|
685
|
-
<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>, your program can get the selected names
|
686
|
-
either as filenames or as URIs. For URIs, the normal escaping
|
687
|
-
rules are applied if the URI contains non-ASCII characters.
|
688
|
-
However, filenames are <span class="emphasis"><em>always</em></span> returned in
|
689
|
-
the character set specified by the
|
690
|
-
<code class="envar">G_FILENAME_ENCODING</code> environment variable.
|
691
|
-
Please see the Glib documentation for more details about this
|
692
|
-
variable.
|
693
|
-
<div class="note">
|
694
|
-
This means that while you can pass the result of
|
695
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename"><code class="function">gtk_file_chooser_get_filename()</code></a> to
|
696
|
-
<code class="function">open(2)</code> or
|
697
|
-
<code class="function">fopen(3)</code>, you may not be able to
|
698
|
-
directly set it as the text of a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget unless you
|
699
|
-
convert it first to UTF-8, which all GTK+ widgets expect.
|
700
|
-
You should use <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> to convert filenames
|
701
|
-
into strings that can be passed to GTK+ widgets.
|
702
|
-
</div>
|
703
|
-
</div>
|
704
|
-
<hr>
|
705
|
-
<div class="refsect2">
|
706
|
-
<a name="gtkfilechooser-preview"></a><h3>Adding a Preview Widget</h3>
|
707
|
-
<p>
|
708
|
-
You can add a custom preview widget to a file chooser and then
|
709
|
-
get notification about when the preview needs to be updated.
|
710
|
-
To install a preview widget, use
|
711
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a>. Then, connect to the
|
712
|
-
<a class="link" href="GtkFileChooser.html#GtkFileChooser-update-preview" title="The “update-preview” signal"><span class="type">“update-preview”</span></a> signal to get notified when
|
713
|
-
you need to update the contents of the preview.
|
714
|
-
</p>
|
715
|
-
<p>
|
716
|
-
Your callback should use
|
717
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename"><code class="function">gtk_file_chooser_get_preview_filename()</code></a> to see what needs
|
718
|
-
previewing. Once you have generated the preview for the
|
719
|
-
corresponding file, you must call
|
720
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active" title="gtk_file_chooser_set_preview_widget_active ()"><code class="function">gtk_file_chooser_set_preview_widget_active()</code></a> with a boolean
|
721
|
-
flag that indicates whether your callback could successfully
|
722
|
-
generate a preview.
|
723
|
-
</p>
|
724
|
-
<div class="example">
|
725
|
-
<a name="example-gtkfilechooser-preview"></a><p class="title"><b>Example 40. Sample Usage</b></p>
|
726
|
-
<div class="example-contents">
|
727
|
-
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
728
|
-
<tbody>
|
729
|
-
<tr>
|
730
|
-
<td class="listing_lines" align="right"><pre>1
|
731
|
-
2
|
732
|
-
3
|
733
|
-
4
|
734
|
-
5
|
735
|
-
6
|
736
|
-
7
|
737
|
-
8
|
738
|
-
9
|
739
|
-
10
|
740
|
-
11
|
741
|
-
12
|
742
|
-
13
|
743
|
-
14
|
744
|
-
15
|
745
|
-
16
|
746
|
-
17
|
747
|
-
18
|
748
|
-
19
|
749
|
-
20
|
750
|
-
21
|
751
|
-
22
|
752
|
-
23
|
753
|
-
24
|
754
|
-
25
|
755
|
-
26
|
756
|
-
27
|
757
|
-
28
|
758
|
-
29
|
759
|
-
30
|
760
|
-
31
|
761
|
-
32
|
762
|
-
33</pre></td>
|
763
|
-
<td class="listing_code"><pre class="programlisting"><span class="cbracket">{</span>
|
764
|
-
<span class="normal"> </span><span class="usertype">GtkImage</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">preview</span><span class="symbol">;</span>
|
765
|
-
|
766
|
-
<span class="normal"> </span><span class="symbol">...</span>
|
767
|
-
|
768
|
-
<span class="normal"> preview </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkImage.html#gtk-image-new">gtk_image_new</a></span><span class="normal"> </span><span class="symbol">();</span>
|
769
|
-
|
770
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget">gtk_file_chooser_set_preview_widget</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_file_chooser</span><span class="symbol">,</span><span class="normal"> preview</span><span class="symbol">);</span>
|
771
|
-
<span class="normal"> </span><span class="function"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_file_chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"update-preview"</span><span class="symbol">,</span>
|
772
|
-
<span class="normal"> </span><span class="function"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update_preview_cb</span><span class="symbol">),</span><span class="normal"> preview</span><span class="symbol">);</span>
|
773
|
-
<span class="cbracket">}</span>
|
774
|
-
|
775
|
-
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
|
776
|
-
<span class="function">update_preview_cb</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkFileChooser</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">file_chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
|
777
|
-
<span class="cbracket">{</span>
|
778
|
-
<span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">preview</span><span class="symbol">;</span>
|
779
|
-
<span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">filename</span><span class="symbol">;</span>
|
780
|
-
<span class="normal"> </span><span class="usertype">GdkPixbuf</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">pixbuf</span><span class="symbol">;</span>
|
781
|
-
<span class="normal"> </span><span class="usertype">gboolean</span><span class="normal"> have_preview</span><span class="symbol">;</span>
|
782
|
-
|
783
|
-
<span class="normal"> preview </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GTK_WIDGET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">);</span>
|
784
|
-
<span class="normal"> filename </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename">gtk_file_chooser_get_preview_filename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_chooser</span><span class="symbol">);</span>
|
785
|
-
|
786
|
-
<span class="normal"> pixbuf </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-size">gdk_pixbuf_new_from_file_at_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">,</span><span class="normal"> </span><span class="number">128</span><span class="symbol">,</span><span class="normal"> </span><span class="number">128</span><span class="symbol">,</span><span class="normal"> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
|
787
|
-
<span class="normal"> have_preview </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf </span><span class="symbol">!=</span><span class="normal"> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
|
788
|
-
<span class="normal"> </span><span class="function"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">);</span>
|
789
|
-
|
790
|
-
<span class="normal"> </span><span class="function"><a href="GtkImage.html#gtk-image-set-from-pixbuf">gtk_image_set_from_pixbuf</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_IMAGE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">preview</span><span class="symbol">),</span><span class="normal"> pixbuf</span><span class="symbol">);</span>
|
791
|
-
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">)</span>
|
792
|
-
<span class="normal"> </span><span class="function"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">);</span>
|
793
|
-
|
794
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active">gtk_file_chooser_set_preview_widget_active</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_chooser</span><span class="symbol">,</span><span class="normal"> have_preview</span><span class="symbol">);</span>
|
795
|
-
<span class="cbracket">}</span></pre></td>
|
796
|
-
</tr>
|
797
|
-
</tbody>
|
798
|
-
</table>
|
799
|
-
</div>
|
800
|
-
|
801
|
-
</div>
|
802
|
-
<br class="example-break">
|
803
|
-
</div>
|
804
|
-
<hr>
|
805
|
-
<div class="refsect2">
|
806
|
-
<a name="gtkfilechooser-extra"></a><h3>Adding Extra Widgets</h3>
|
807
|
-
<p>
|
808
|
-
You can add extra widgets to a file chooser to provide options
|
809
|
-
that are not present in the default design. For example, you
|
810
|
-
can add a toggle button to give the user the option to open a
|
811
|
-
file in read-only mode. You can use
|
812
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-extra-widget" title="gtk_file_chooser_set_extra_widget ()"><code class="function">gtk_file_chooser_set_extra_widget()</code></a> to insert additional
|
813
|
-
widgets in a file chooser.
|
814
|
-
</p>
|
815
|
-
<div class="example">
|
816
|
-
<a name="example-gtkfilechooser-extra"></a><p class="title"><b>Example 41. Sample Usage</b></p>
|
817
|
-
<div class="example-contents">
|
818
|
-
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
819
|
-
<tbody>
|
820
|
-
<tr>
|
821
|
-
<td class="listing_lines" align="right"><pre>1
|
822
|
-
2
|
823
|
-
3
|
824
|
-
4
|
825
|
-
5
|
826
|
-
6
|
827
|
-
7
|
828
|
-
8</pre></td>
|
829
|
-
<td class="listing_code"><pre class="programlisting"><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">toggle</span><span class="symbol">;</span>
|
830
|
-
|
831
|
-
<span class="symbol">...</span>
|
832
|
-
|
833
|
-
<span class="normal">toggle </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkCheckButton.html#gtk-check-button-new-with-label">gtk_check_button_new_with_label</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Open file read-only"</span><span class="symbol">);</span>
|
834
|
-
<span class="function"><a href="GtkWidget.html#gtk-widget-show">gtk_widget_show</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">toggle</span><span class="symbol">);</span>
|
835
|
-
<span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-extra-widget">gtk_file_chooser_set_extra_widget</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_file_chooser</span><span class="symbol">,</span><span class="normal"> toggle</span><span class="symbol">);</span>
|
836
|
-
<span class="cbracket">}</span></pre></td>
|
837
|
-
</tr>
|
838
|
-
</tbody>
|
839
|
-
</table>
|
840
|
-
</div>
|
841
|
-
|
842
|
-
</div>
|
843
|
-
<br class="example-break"><div class="note">
|
844
|
-
If you want to set more than one extra widget in the file
|
845
|
-
chooser, you can a container such as a <a class="link" href="GtkVBox.html" title="GtkVBox"><span class="type">GtkVBox</span></a> or a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>
|
846
|
-
and include your widgets in it. Then, set the container as
|
847
|
-
the whole extra widget.
|
848
|
-
</div>
|
849
|
-
</div>
|
850
|
-
<hr>
|
851
|
-
<div class="refsect2">
|
852
|
-
<a name="gtkfilechooser-key-bindings"></a><h3>Key Bindings</h3>
|
853
|
-
<p>
|
854
|
-
Internally, GTK+ implements a file chooser's graphical user
|
855
|
-
interface with the private
|
856
|
-
<code class="classname">GtkFileChooserDefaultClass</code>. This
|
857
|
-
widget has several <GTKDOCLINK HREF="gtk-Bindings">key
|
858
|
-
bindings</GTKDOCLINK> and their associated signals. This section
|
859
|
-
describes the available key binding signals.
|
860
|
-
</p>
|
861
|
-
<div class="example">
|
862
|
-
<a name="gtkfilechooser-key-binding-example"></a><p class="title"><b>Example 42. GtkFileChooser key binding example</b></p>
|
863
|
-
<div class="example-contents">
|
864
|
-
<p>
|
865
|
-
The default keys that activate the key-binding signals in
|
866
|
-
<code class="classname">GtkFileChooserDefaultClass</code> are as
|
867
|
-
follows:
|
868
|
-
</p>
|
869
|
-
<div class="informaltable"><table border="1">
|
870
|
-
<colgroup>
|
871
|
-
<col>
|
872
|
-
<col>
|
873
|
-
</colgroup>
|
874
|
-
<tbody>
|
875
|
-
<tr>
|
876
|
-
<td>Signal name</td>
|
877
|
-
<td>Default key combinations</td>
|
878
|
-
</tr>
|
879
|
-
<tr>
|
880
|
-
<td>location-popup</td>
|
881
|
-
<td>
|
882
|
-
<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>L</strong></span> (empty path);
|
883
|
-
<span class="keycap"><strong>/</strong></span> (path of "/")
|
884
|
-
<a href="#ftn.id-1.4.12.6.11.8.3.3.1.1.2.2.3" class="footnote" name="id-1.4.12.6.11.8.3.3.1.1.2.2.3"><sup class="footnote">[a]</sup></a>;
|
885
|
-
<span class="keycap"><strong>~</strong></span> (path of "~")
|
886
|
-
</td>
|
887
|
-
</tr>
|
888
|
-
<tr>
|
889
|
-
<td>up-folder</td>
|
890
|
-
<td>
|
891
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Up</strong></span>;
|
892
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Up</strong></span>
|
893
|
-
<a href="#ftn.id-1.4.12.6.11.8.3.3.1.1.3.2.3" class="footnote" name="id-1.4.12.6.11.8.3.3.1.1.3.2.3"><sup class="footnote">[b]</sup></a>;
|
894
|
-
<span class="keycap"><strong>Backspace</strong></span>
|
895
|
-
</td>
|
896
|
-
</tr>
|
897
|
-
<tr>
|
898
|
-
<td>down-folder</td>
|
899
|
-
<td>
|
900
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Down</strong></span>;
|
901
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Down</strong></span>
|
902
|
-
<a href="#ftn.id-1.4.12.6.11.8.3.3.1.1.4.2.3" class="footnote" name="id-1.4.12.6.11.8.3.3.1.1.4.2.3"><sup class="footnote">[c]</sup></a>
|
903
|
-
</td>
|
904
|
-
</tr>
|
905
|
-
<tr>
|
906
|
-
<td>home-folder</td>
|
907
|
-
<td>
|
908
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Home</strong></span>
|
909
|
-
</td>
|
910
|
-
</tr>
|
911
|
-
<tr>
|
912
|
-
<td>desktop-folder</td>
|
913
|
-
<td>
|
914
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>D</strong></span>
|
915
|
-
</td>
|
916
|
-
</tr>
|
917
|
-
<tr>
|
918
|
-
<td>quick-bookmark</td>
|
919
|
-
<td>
|
920
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>1</strong></span> through <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>0</strong></span>
|
921
|
-
</td>
|
922
|
-
</tr>
|
923
|
-
</tbody>
|
924
|
-
<tbody class="footnotes"><tr><td colspan="2">
|
925
|
-
<div id="ftn.id-1.4.12.6.11.8.3.3.1.1.2.2.3" class="footnote"><span class="keycap"><strong><a href="#id-1.4.12.6.11.8.3.3.1.1.2.2.3" class="keycap"><sup>[a] </sup></a>/</strong></span></div>
|
926
|
-
<div id="ftn.id-1.4.12.6.11.8.3.3.1.1.3.2.3" class="footnote"></div>
|
927
|
-
<div id="ftn.id-1.4.12.6.11.8.3.3.1.1.4.2.3" class="footnote"></div>
|
928
|
-
</td></tr></tbody>
|
929
|
-
</table></div>
|
930
|
-
<p>
|
931
|
-
You can change these defaults to something else. For
|
932
|
-
example, to add a <span class="keycap"><strong>Shift</strong></span> modifier to a few
|
933
|
-
of the default bindings, you can include the following
|
934
|
-
fragment in your <code class="filename">.gtkrc-3.0</code> file:
|
935
|
-
</p>
|
936
|
-
<pre class="programlisting">
|
937
|
-
binding "my-own-gtkfilechooser-bindings" {
|
938
|
-
bind "<Alt><Shift>Up" {
|
939
|
-
"up-folder" ()
|
940
|
-
}
|
941
|
-
bind "<Alt><Shift>Down" {
|
942
|
-
"down-folder" ()
|
943
|
-
}
|
944
|
-
bind "<Alt><Shift>Home" {
|
945
|
-
"home-folder" ()
|
946
|
-
}
|
947
|
-
}
|
948
|
-
|
949
|
-
class "GtkFileChooserDefault" binding "my-own-gtkfilechooser-bindings"
|
950
|
-
</pre>
|
951
|
-
</div>
|
952
|
-
</div>
|
953
|
-
<br class="example-break"><div class="refsect3">
|
954
|
-
<a name="GtkFileChooserDefault-location-popup"></a><h4>The "GtkFileChooserDefault::location-popup" signal</h4>
|
955
|
-
<pre class="programlisting">
|
956
|
-
void user_function (GtkFileChooserDefault *chooser,
|
957
|
-
const char *path,
|
958
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
|
959
|
-
</pre>
|
960
|
-
<p>
|
961
|
-
This is used to make the file chooser show a "Location"
|
962
|
-
dialog which the user can use to manually type the name of
|
963
|
-
the file he wishes to select. The
|
964
|
-
<em class="parameter"><code>path</code></em> argument is a string that gets
|
965
|
-
put in the text entry for the file name. By default this is bound to
|
966
|
-
<span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>L</strong></span>
|
967
|
-
with a <em class="parameter"><code>path</code></em> string of "" (the empty
|
968
|
-
string). It is also bound to <span class="keycap"><strong>/</strong></span> with a
|
969
|
-
<em class="parameter"><code>path</code></em> string of "<code class="literal">/</code>"
|
970
|
-
(a slash): this lets you type <span class="keycap"><strong>/</strong></span> and
|
971
|
-
immediately type a path name. On Unix systems, this is bound to
|
972
|
-
<span class="keycap"><strong>~</strong></span> (tilde) with a <em class="parameter"><code>path</code></em> string
|
973
|
-
of "~" itself for access to home directories.
|
974
|
-
</p>
|
975
|
-
<div class="variablelist"><table border="0" class="variablelist">
|
976
|
-
<colgroup>
|
977
|
-
<col align="left" valign="top">
|
978
|
-
<col>
|
979
|
-
</colgroup>
|
980
|
-
<tbody>
|
981
|
-
<tr>
|
982
|
-
<td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
|
983
|
-
<td>
|
984
|
-
the object which received the signal.
|
985
|
-
</td>
|
986
|
-
</tr>
|
987
|
-
<tr>
|
988
|
-
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
|
989
|
-
<td>
|
990
|
-
default contents for the text entry for the file name
|
991
|
-
</td>
|
992
|
-
</tr>
|
993
|
-
<tr>
|
994
|
-
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
995
|
-
<td>
|
996
|
-
user data set when the signal handler was connected.
|
997
|
-
</td>
|
998
|
-
</tr>
|
999
|
-
</tbody>
|
1000
|
-
</table></div>
|
1001
|
-
<div class="note">
|
1002
|
-
You can create your own bindings for the
|
1003
|
-
<a class="link" href="GtkFileChooser.html#GtkFileChooserDefault-location-popup" title='The "GtkFileChooserDefault::location-popup" signal'><span class="type">“location-popup”</span></a> signal with custom
|
1004
|
-
<em class="parameter"><code>path</code></em> strings, and have a crude form
|
1005
|
-
of easily-to-type bookmarks. For example, say you access
|
1006
|
-
the path <code class="filename">/home/username/misc</code> very
|
1007
|
-
frequently. You could then create an <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>M</strong></span>
|
1008
|
-
shortcut by including the following in your
|
1009
|
-
<code class="filename">.gtkrc-3.0</code>:
|
1010
|
-
<pre class="programlisting">
|
1011
|
-
binding "misc-shortcut" {
|
1012
|
-
bind "<Alt>M" {
|
1013
|
-
"location-popup" ("/home/username/misc")
|
1014
|
-
}
|
1015
|
-
}
|
1016
|
-
|
1017
|
-
class "GtkFileChooserDefault" binding "misc-shortcut"
|
1018
|
-
</pre>
|
1019
|
-
</div>
|
1020
|
-
</div>
|
1021
|
-
<div class="refsect3">
|
1022
|
-
<a name="GtkFileChooserDefault-up-folder"></a><h4>The "GtkFileChooserDefault::up-folder" signal</h4>
|
1023
|
-
<pre class="programlisting">
|
1024
|
-
void user_function (GtkFileChooserDefault *chooser,
|
1025
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
|
1026
|
-
</pre>
|
1027
|
-
<p>
|
1028
|
-
This is used to make the file chooser go to the parent of
|
1029
|
-
the current folder in the file hierarchy. By default this
|
1030
|
-
is bound to <span class="keycap"><strong>Backspace</strong></span> and
|
1031
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Up</strong></span>
|
1032
|
-
(the Up key in the numeric keypad also works).
|
1033
|
-
</p>
|
1034
|
-
<div class="variablelist"><table border="0" class="variablelist">
|
1035
|
-
<colgroup>
|
1036
|
-
<col align="left" valign="top">
|
1037
|
-
<col>
|
1038
|
-
</colgroup>
|
1039
|
-
<tbody>
|
1040
|
-
<tr>
|
1041
|
-
<td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
|
1042
|
-
<td>
|
1043
|
-
the object which received the signal.
|
1044
|
-
</td>
|
1045
|
-
</tr>
|
1046
|
-
<tr>
|
1047
|
-
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1048
|
-
<td>
|
1049
|
-
user data set when the signal handler was connected.
|
1050
|
-
</td>
|
1051
|
-
</tr>
|
1052
|
-
</tbody>
|
1053
|
-
</table></div>
|
1054
|
-
</div>
|
1055
|
-
<div class="refsect3">
|
1056
|
-
<a name="GtkFileChooserDefault-down-folder"></a><h4>The "GtkFileChooserDefault::down-folder" signal</h4>
|
1057
|
-
<pre class="programlisting">
|
1058
|
-
void user_function (GtkFileChooserDefault *chooser,
|
1059
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
|
1060
|
-
</pre>
|
1061
|
-
<p>
|
1062
|
-
This is used to make the file chooser go to a child of the
|
1063
|
-
current folder in the file hierarchy. The subfolder that
|
1064
|
-
will be used is displayed in the path bar widget of the file
|
1065
|
-
chooser. For example, if the path bar is showing
|
1066
|
-
"/foo/<span class="emphasis"><em>bar/</em></span>baz", then this will cause
|
1067
|
-
the file chooser to switch to the "baz" subfolder. By
|
1068
|
-
default this is bound to
|
1069
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Down</strong></span>
|
1070
|
-
(the Down key in the numeric keypad also works).
|
1071
|
-
</p>
|
1072
|
-
<div class="variablelist"><table border="0" class="variablelist">
|
1073
|
-
<colgroup>
|
1074
|
-
<col align="left" valign="top">
|
1075
|
-
<col>
|
1076
|
-
</colgroup>
|
1077
|
-
<tbody>
|
1078
|
-
<tr>
|
1079
|
-
<td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
|
1080
|
-
<td>
|
1081
|
-
the object which received the signal.
|
1082
|
-
</td>
|
1083
|
-
</tr>
|
1084
|
-
<tr>
|
1085
|
-
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1086
|
-
<td>
|
1087
|
-
user data set when the signal handler was connected.
|
1088
|
-
</td>
|
1089
|
-
</tr>
|
1090
|
-
</tbody>
|
1091
|
-
</table></div>
|
1092
|
-
</div>
|
1093
|
-
<div class="refsect3">
|
1094
|
-
<a name="GtkFileChooserDefault-home-folder"></a><h4>The "GtkFileChooserDefault::home-folder" signal</h4>
|
1095
|
-
<pre class="programlisting">
|
1096
|
-
void user_function (GtkFileChooserDefault *chooser,
|
1097
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
|
1098
|
-
</pre>
|
1099
|
-
<p>
|
1100
|
-
This is used to make the file chooser show the user's home
|
1101
|
-
folder in the file list. By default this is bound to
|
1102
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Home</strong></span>
|
1103
|
-
(the Home key in the numeric keypad also works).
|
1104
|
-
</p>
|
1105
|
-
<div class="variablelist"><table border="0" class="variablelist">
|
1106
|
-
<colgroup>
|
1107
|
-
<col align="left" valign="top">
|
1108
|
-
<col>
|
1109
|
-
</colgroup>
|
1110
|
-
<tbody>
|
1111
|
-
<tr>
|
1112
|
-
<td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
|
1113
|
-
<td>
|
1114
|
-
the object which received the signal.
|
1115
|
-
</td>
|
1116
|
-
</tr>
|
1117
|
-
<tr>
|
1118
|
-
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1119
|
-
<td>
|
1120
|
-
user data set when the signal handler was connected.
|
1121
|
-
</td>
|
1122
|
-
</tr>
|
1123
|
-
</tbody>
|
1124
|
-
</table></div>
|
1125
|
-
</div>
|
1126
|
-
<div class="refsect3">
|
1127
|
-
<a name="GtkFileChooserDefault-desktop-folder"></a><h4>The "GtkFileChooserDefault::desktop-folder" signal</h4>
|
1128
|
-
<pre class="programlisting">
|
1129
|
-
void user_function (GtkFileChooserDefault *chooser,
|
1130
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
|
1131
|
-
</pre>
|
1132
|
-
<p>
|
1133
|
-
This is used to make the file chooser show the user's Desktop
|
1134
|
-
folder in the file list. By default this is bound to
|
1135
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>D</strong></span>.
|
1136
|
-
</p>
|
1137
|
-
<div class="variablelist"><table border="0" class="variablelist">
|
1138
|
-
<colgroup>
|
1139
|
-
<col align="left" valign="top">
|
1140
|
-
<col>
|
1141
|
-
</colgroup>
|
1142
|
-
<tbody>
|
1143
|
-
<tr>
|
1144
|
-
<td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
|
1145
|
-
<td>
|
1146
|
-
the object which received the signal.
|
1147
|
-
</td>
|
1148
|
-
</tr>
|
1149
|
-
<tr>
|
1150
|
-
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1151
|
-
<td>
|
1152
|
-
user data set when the signal handler was connected.
|
1153
|
-
</td>
|
1154
|
-
</tr>
|
1155
|
-
</tbody>
|
1156
|
-
</table></div>
|
1157
|
-
</div>
|
1158
|
-
<div class="refsect3">
|
1159
|
-
<a name="GtkFileChooserDefault-quick-bookmark"></a><h4>The "GtkFileChooserDefault::quick-bookmark" signal</h4>
|
1160
|
-
<pre class="programlisting">
|
1161
|
-
void user_function (GtkFileChooserDefault *chooser,
|
1162
|
-
gint bookmark_index,
|
1163
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
|
1164
|
-
</pre>
|
1165
|
-
<p>
|
1166
|
-
This is used to make the file chooser switch to the bookmark
|
1167
|
-
specified in the <em class="parameter"><code>bookmark_index</code></em> parameter.
|
1168
|
-
For example, if you have three bookmarks, you can pass 0, 1, 2 to
|
1169
|
-
this signal to switch to each of them, respectively. By default this is bound to
|
1170
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>1</strong></span>,
|
1171
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>2</strong></span>,
|
1172
|
-
etc. until
|
1173
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>0</strong></span>. Note
|
1174
|
-
that in the default binding,
|
1175
|
-
that <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>1</strong></span> is
|
1176
|
-
actually defined to switch to the bookmark at index 0, and so on
|
1177
|
-
successively;
|
1178
|
-
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>0</strong></span> is
|
1179
|
-
defined to switch to the bookmark at index 10.
|
1180
|
-
</p>
|
1181
|
-
<div class="variablelist"><table border="0" class="variablelist">
|
1182
|
-
<colgroup>
|
1183
|
-
<col align="left" valign="top">
|
1184
|
-
<col>
|
1185
|
-
</colgroup>
|
1186
|
-
<tbody>
|
1187
|
-
<tr>
|
1188
|
-
<td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
|
1189
|
-
<td>
|
1190
|
-
the object which received the signal.
|
1191
|
-
</td>
|
1192
|
-
</tr>
|
1193
|
-
<tr>
|
1194
|
-
<td><p><span class="term"><em class="parameter"><code>bookmark_indes</code></em> :</span></p></td>
|
1195
|
-
<td>
|
1196
|
-
index of the bookmark to switch to; the indices start at 0.
|
1197
|
-
</td>
|
1198
|
-
</tr>
|
1199
|
-
<tr>
|
1200
|
-
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
1201
|
-
<td>
|
1202
|
-
user data set when the signal handler was connected.
|
1203
|
-
</td>
|
1204
|
-
</tr>
|
1205
|
-
</tbody>
|
1206
|
-
</table></div>
|
1207
|
-
</div>
|
1208
|
-
</div>
|
1209
|
-
<hr>
|
1210
|
-
<div class="refsect2">
|
1211
|
-
<a name="gtkfilechooser-configuration-options"></a><h3>Configuration Options</h3>
|
1212
|
-
<p>
|
1213
|
-
In GTK+ 2.x, the file chooser saves its state and configuration options in a
|
1214
|
-
<code class="filename">gtk-2.0/gtkfilechooser.ini</code> file under the directory that
|
1215
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-get-user-config-dir"><code class="function">g_get_user_config_dir()</code></a> returns. (On Unix, this usually resolves to
|
1216
|
-
<code class="filename">$HOME/username/.config/gtk-2.0/gtkfilechooser.ini</code>.) While some of
|
1217
|
-
the available options can be changed directly through the file chooser's user
|
1218
|
-
interface, a couple are only editable by hand or by third-party tools (such
|
1219
|
-
as <a class="ulink" href="https://wiki.gnome.org/action/show/Apps/GnomeTweakTool" target="_top">gnome-tweak-tool</a>).
|
1220
|
-
This section describes the available options.
|
1221
|
-
</p>
|
1222
|
-
<p>
|
1223
|
-
This is a sample of the contents of a <code class="filename">gtkfilechooser.ini</code>
|
1224
|
-
file. Note that all the following options go under a
|
1225
|
-
<code class="literal">[Filechooser Settings]</code> heading.
|
1226
|
-
</p>
|
1227
|
-
<pre class="programlisting">
|
1228
|
-
[Filechooser Settings]
|
1229
|
-
LocationMode=filename-entry
|
1230
|
-
ShowHidden=false
|
1231
|
-
ExpandFolders=true
|
1232
|
-
GeometryX=570
|
1233
|
-
GeometryY=273
|
1234
|
-
GeometryWidth=780
|
1235
|
-
GeometryHeight=585
|
1236
|
-
ShowSizeColumn=true
|
1237
|
-
SortColumn=name
|
1238
|
-
SortOrder=ascending
|
1239
|
-
StartupMode=recent
|
1240
|
-
</pre>
|
1241
|
-
<div class="refsect3">
|
1242
|
-
<a name="gtkfilechooser-settings-location-mode"></a><h4>LocationMode key</h4>
|
1243
|
-
<p>
|
1244
|
-
The <code class="literal">LocationMode</code> key controls whether the file chooser
|
1245
|
-
shows just a path bar, or a visible entry for the filename as well, for the
|
1246
|
-
benefit of typing-oriented users. The possible string values for these modes
|
1247
|
-
are <code class="literal">path-bar</code> and <code class="literal">filename-entry</code>,
|
1248
|
-
respectively.
|
1249
|
-
</p>
|
1250
|
-
</div>
|
1251
|
-
<div class="refsect3">
|
1252
|
-
<a name="gtkfilechooser-settings-show-hidden"></a><h4>ShowHidden key</h4>
|
1253
|
-
<p>
|
1254
|
-
The <code class="literal">ShowHidden</code> key controls whether the file chooser shows
|
1255
|
-
hidden files or not. The value can be be <code class="literal">true</code> or
|
1256
|
-
<code class="literal">false</code>.
|
1257
|
-
</p>
|
1258
|
-
</div>
|
1259
|
-
<div class="refsect3">
|
1260
|
-
<a name="gtkfilechooser-settings-show-size-column"></a><h4>ShowSizeColumn key</h4>
|
1261
|
-
<p>
|
1262
|
-
The <code class="literal">ShowSize</code> key controls whether the file chooser shows
|
1263
|
-
a column with file sizes. The value can be be <code class="literal">true</code> or
|
1264
|
-
<code class="literal">false</code>.
|
1265
|
-
</p>
|
1266
|
-
</div>
|
1267
|
-
<div class="refsect3">
|
1268
|
-
<a name="gtkfilechooser-settings-geometry-keys"></a><h4>Geometry keys</h4>
|
1269
|
-
<p>
|
1270
|
-
The four keys <code class="literal">GeometryX</code>, <code class="literal">GeometryY</code>,
|
1271
|
-
<code class="literal">GeometryWidth</code>, <code class="literal">GeometryHeight</code> save the
|
1272
|
-
position and dimensions of the <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a>'s window.
|
1273
|
-
</p>
|
1274
|
-
</div>
|
1275
|
-
<div class="refsect3">
|
1276
|
-
<a name="gtkfilechooser-settings-sort-column"></a><h4>SortColumn key</h4>
|
1277
|
-
<p>
|
1278
|
-
The <code class="literal">SortColumn</code> key can be one of the strings
|
1279
|
-
<code class="literal">name</code>, <code class="literal">modified</code>, or
|
1280
|
-
<code class="literal">size</code>. It controls which of the columns in the file
|
1281
|
-
chooser is used for sorting the list of files.
|
1282
|
-
</p>
|
1283
|
-
</div>
|
1284
|
-
<div class="refsect3">
|
1285
|
-
<a name="gtkfilechooser-settings-sort-order"></a><h4>SortOrder key</h4>
|
1286
|
-
<p>
|
1287
|
-
The <code class="literal">SortOrder</code> key can be one of the strings
|
1288
|
-
<code class="literal">ascending</code> or <code class="literal">descending</code>.
|
1289
|
-
</p>
|
1290
|
-
</div>
|
1291
|
-
<div class="refsect3">
|
1292
|
-
<a name="gtkfilechooser-settings-startup-mode"></a><h4>StartupMode key</h4>
|
1293
|
-
<p>
|
1294
|
-
The <code class="literal">StartupMode</code> key controls whether the file chooser
|
1295
|
-
starts up showing the list of recently-used files, or the contents of the
|
1296
|
-
current working directory. Respectively, the values can be
|
1297
|
-
<code class="literal">recent</code> or <code class="literal">cwd</code>.
|
1298
|
-
</p>
|
1299
|
-
</div>
|
1300
|
-
</div>
|
1301
639
|
</div>
|
1302
640
|
<div class="refsect1">
|
1303
641
|
<a name="GtkFileChooser.functions_details"></a><h2>Functions</h2>
|
1304
642
|
<div class="refsect2">
|
1305
|
-
<a name="GTK-FILE-CHOOSER-ERROR:CAPS"></a><h3>GTK_FILE_CHOOSER_ERROR</h3>
|
1306
|
-
<pre class="programlisting">#define GTK_FILE_CHOOSER_ERROR (gtk_file_chooser_error_quark ())
|
1307
|
-
</pre>
|
1308
|
-
<p>Used to get the <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> quark for <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> errors.</p>
|
1309
|
-
</div>
|
1310
|
-
<hr>
|
1311
|
-
<div class="refsect2">
|
1312
643
|
<a name="gtk-file-chooser-set-action"></a><h3>gtk_file_chooser_set_action ()</h3>
|
1313
644
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
1314
645
|
gtk_file_chooser_set_action (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
1315
646
|
<em class="parameter"><code><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> action</code></em>);</pre>
|
1316
|
-
<p>
|
1317
|
-
user interface is adapted to suit the selected action. For example,
|
1318
|
-
an option to create a new folder might be shown if the action is
|
1319
|
-
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> but not if the action is
|
1320
|
-
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a>.</p>
|
1321
|
-
<div class="refsect3">
|
1322
|
-
<a name="id-1.4.12.6.12.3.5"></a><h4>Parameters</h4>
|
1323
|
-
<div class="informaltable"><table width="100%" border="0">
|
1324
|
-
<colgroup>
|
1325
|
-
<col width="150px" class="parameters_name">
|
1326
|
-
<col class="parameters_description">
|
1327
|
-
<col width="200px" class="parameters_annotations">
|
1328
|
-
</colgroup>
|
1329
|
-
<tbody>
|
1330
|
-
<tr>
|
1331
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1332
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1333
|
-
<td class="parameter_annotations"> </td>
|
1334
|
-
</tr>
|
1335
|
-
<tr>
|
1336
|
-
<td class="parameter_name"><p>action</p></td>
|
1337
|
-
<td class="parameter_description"><p>the action that the file selector is performing</p></td>
|
1338
|
-
<td class="parameter_annotations"> </td>
|
1339
|
-
</tr>
|
1340
|
-
</tbody>
|
1341
|
-
</table></div>
|
1342
|
-
</div>
|
1343
|
-
<p class="since">Since 2.4</p>
|
647
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1344
648
|
</div>
|
1345
649
|
<hr>
|
1346
650
|
<div class="refsect2">
|
1347
651
|
<a name="gtk-file-chooser-get-action"></a><h3>gtk_file_chooser_get_action ()</h3>
|
1348
652
|
<pre class="programlisting"><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="returnvalue">GtkFileChooserAction</span></a>
|
1349
653
|
gtk_file_chooser_get_action (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
1350
|
-
<p>
|
1351
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-action" title="gtk_file_chooser_set_action ()"><code class="function">gtk_file_chooser_set_action()</code></a>.</p>
|
1352
|
-
<div class="refsect3">
|
1353
|
-
<a name="id-1.4.12.6.12.4.5"></a><h4>Parameters</h4>
|
1354
|
-
<div class="informaltable"><table width="100%" border="0">
|
1355
|
-
<colgroup>
|
1356
|
-
<col width="150px" class="parameters_name">
|
1357
|
-
<col class="parameters_description">
|
1358
|
-
<col width="200px" class="parameters_annotations">
|
1359
|
-
</colgroup>
|
1360
|
-
<tbody><tr>
|
1361
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1362
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1363
|
-
<td class="parameter_annotations"> </td>
|
1364
|
-
</tr></tbody>
|
1365
|
-
</table></div>
|
1366
|
-
</div>
|
1367
|
-
<div class="refsect3">
|
1368
|
-
<a name="id-1.4.12.6.12.4.6"></a><h4>Returns</h4>
|
1369
|
-
<p> the action that the file selector is performing</p>
|
1370
|
-
<p></p>
|
1371
|
-
</div>
|
1372
|
-
<p class="since">Since 2.4</p>
|
654
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1373
655
|
</div>
|
1374
656
|
<hr>
|
1375
657
|
<div class="refsect2">
|
@@ -1377,71 +659,14 @@ gtk_file_chooser_get_action (<em class="parameter"><code><a class="link" href="G
|
|
1377
659
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
1378
660
|
gtk_file_chooser_set_local_only (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
1379
661
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_only</code></em>);</pre>
|
1380
|
-
<p>
|
1381
|
-
file selector. If <em class="parameter"><code>local_only</code></em>
|
1382
|
-
is <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> (the default),
|
1383
|
-
then the selected file are files are guaranteed to be
|
1384
|
-
accessible through the operating systems native file
|
1385
|
-
file system and therefore the application only
|
1386
|
-
needs to worry about the filename functions in
|
1387
|
-
<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>, like <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename"><code class="function">gtk_file_chooser_get_filename()</code></a>,
|
1388
|
-
rather than the URI functions like
|
1389
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a>,</p>
|
1390
|
-
<p>On some systems non-native files may still be
|
1391
|
-
available using the native filesystem via a userspace
|
1392
|
-
filesystem (FUSE).</p>
|
1393
|
-
<div class="refsect3">
|
1394
|
-
<a name="id-1.4.12.6.12.5.6"></a><h4>Parameters</h4>
|
1395
|
-
<div class="informaltable"><table width="100%" border="0">
|
1396
|
-
<colgroup>
|
1397
|
-
<col width="150px" class="parameters_name">
|
1398
|
-
<col class="parameters_description">
|
1399
|
-
<col width="200px" class="parameters_annotations">
|
1400
|
-
</colgroup>
|
1401
|
-
<tbody>
|
1402
|
-
<tr>
|
1403
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1404
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1405
|
-
<td class="parameter_annotations"> </td>
|
1406
|
-
</tr>
|
1407
|
-
<tr>
|
1408
|
-
<td class="parameter_name"><p>local_only</p></td>
|
1409
|
-
<td class="parameter_description"><p><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if only local files can be selected</p></td>
|
1410
|
-
<td class="parameter_annotations"> </td>
|
1411
|
-
</tr>
|
1412
|
-
</tbody>
|
1413
|
-
</table></div>
|
1414
|
-
</div>
|
1415
|
-
<p class="since">Since 2.4</p>
|
662
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1416
663
|
</div>
|
1417
664
|
<hr>
|
1418
665
|
<div class="refsect2">
|
1419
666
|
<a name="gtk-file-chooser-get-local-only"></a><h3>gtk_file_chooser_get_local_only ()</h3>
|
1420
667
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
1421
668
|
gtk_file_chooser_get_local_only (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
1422
|
-
<p>
|
1423
|
-
file selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-local-only" title="gtk_file_chooser_set_local_only ()"><code class="function">gtk_file_chooser_set_local_only()</code></a></p>
|
1424
|
-
<div class="refsect3">
|
1425
|
-
<a name="id-1.4.12.6.12.6.5"></a><h4>Parameters</h4>
|
1426
|
-
<div class="informaltable"><table width="100%" border="0">
|
1427
|
-
<colgroup>
|
1428
|
-
<col width="150px" class="parameters_name">
|
1429
|
-
<col class="parameters_description">
|
1430
|
-
<col width="200px" class="parameters_annotations">
|
1431
|
-
</colgroup>
|
1432
|
-
<tbody><tr>
|
1433
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1434
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1435
|
-
<td class="parameter_annotations"> </td>
|
1436
|
-
</tr></tbody>
|
1437
|
-
</table></div>
|
1438
|
-
</div>
|
1439
|
-
<div class="refsect3">
|
1440
|
-
<a name="id-1.4.12.6.12.6.6"></a><h4>Returns</h4>
|
1441
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if only local files can be selected.</p>
|
1442
|
-
<p></p>
|
1443
|
-
</div>
|
1444
|
-
<p class="since">Since 2.4</p>
|
669
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1445
670
|
</div>
|
1446
671
|
<hr>
|
1447
672
|
<div class="refsect2">
|
@@ -1449,61 +674,14 @@ file selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-se
|
|
1449
674
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
1450
675
|
gtk_file_chooser_set_select_multiple (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
1451
676
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> select_multiple</code></em>);</pre>
|
1452
|
-
<p>
|
1453
|
-
only relevant if the action is set to be <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a> or
|
1454
|
-
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a>.</p>
|
1455
|
-
<div class="refsect3">
|
1456
|
-
<a name="id-1.4.12.6.12.7.5"></a><h4>Parameters</h4>
|
1457
|
-
<div class="informaltable"><table width="100%" border="0">
|
1458
|
-
<colgroup>
|
1459
|
-
<col width="150px" class="parameters_name">
|
1460
|
-
<col class="parameters_description">
|
1461
|
-
<col width="200px" class="parameters_annotations">
|
1462
|
-
</colgroup>
|
1463
|
-
<tbody>
|
1464
|
-
<tr>
|
1465
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1466
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1467
|
-
<td class="parameter_annotations"> </td>
|
1468
|
-
</tr>
|
1469
|
-
<tr>
|
1470
|
-
<td class="parameter_name"><p>select_multiple</p></td>
|
1471
|
-
<td class="parameter_description"><p><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if multiple files can be selected.</p></td>
|
1472
|
-
<td class="parameter_annotations"> </td>
|
1473
|
-
</tr>
|
1474
|
-
</tbody>
|
1475
|
-
</table></div>
|
1476
|
-
</div>
|
1477
|
-
<p class="since">Since 2.4</p>
|
677
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1478
678
|
</div>
|
1479
679
|
<hr>
|
1480
680
|
<div class="refsect2">
|
1481
681
|
<a name="gtk-file-chooser-get-select-multiple"></a><h3>gtk_file_chooser_get_select_multiple ()</h3>
|
1482
682
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
1483
683
|
gtk_file_chooser_get_select_multiple (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
1484
|
-
<p>
|
1485
|
-
selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-select-multiple" title="gtk_file_chooser_set_select_multiple ()"><code class="function">gtk_file_chooser_set_select_multiple()</code></a>.</p>
|
1486
|
-
<div class="refsect3">
|
1487
|
-
<a name="id-1.4.12.6.12.8.5"></a><h4>Parameters</h4>
|
1488
|
-
<div class="informaltable"><table width="100%" border="0">
|
1489
|
-
<colgroup>
|
1490
|
-
<col width="150px" class="parameters_name">
|
1491
|
-
<col class="parameters_description">
|
1492
|
-
<col width="200px" class="parameters_annotations">
|
1493
|
-
</colgroup>
|
1494
|
-
<tbody><tr>
|
1495
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1496
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1497
|
-
<td class="parameter_annotations"> </td>
|
1498
|
-
</tr></tbody>
|
1499
|
-
</table></div>
|
1500
|
-
</div>
|
1501
|
-
<div class="refsect3">
|
1502
|
-
<a name="id-1.4.12.6.12.8.6"></a><h4>Returns</h4>
|
1503
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if multiple files can be selected.</p>
|
1504
|
-
<p></p>
|
1505
|
-
</div>
|
1506
|
-
<p class="since">Since 2.4</p>
|
684
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1507
685
|
</div>
|
1508
686
|
<hr>
|
1509
687
|
<div class="refsect2">
|
@@ -1511,59 +689,14 @@ selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-sel
|
|
1511
689
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
1512
690
|
gtk_file_chooser_set_show_hidden (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
1513
691
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_hidden</code></em>);</pre>
|
1514
|
-
<p>
|
1515
|
-
<div class="refsect3">
|
1516
|
-
<a name="id-1.4.12.6.12.9.5"></a><h4>Parameters</h4>
|
1517
|
-
<div class="informaltable"><table width="100%" border="0">
|
1518
|
-
<colgroup>
|
1519
|
-
<col width="150px" class="parameters_name">
|
1520
|
-
<col class="parameters_description">
|
1521
|
-
<col width="200px" class="parameters_annotations">
|
1522
|
-
</colgroup>
|
1523
|
-
<tbody>
|
1524
|
-
<tr>
|
1525
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1526
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1527
|
-
<td class="parameter_annotations"> </td>
|
1528
|
-
</tr>
|
1529
|
-
<tr>
|
1530
|
-
<td class="parameter_name"><p>show_hidden</p></td>
|
1531
|
-
<td class="parameter_description"><p><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden files and folders should be displayed.</p></td>
|
1532
|
-
<td class="parameter_annotations"> </td>
|
1533
|
-
</tr>
|
1534
|
-
</tbody>
|
1535
|
-
</table></div>
|
1536
|
-
</div>
|
1537
|
-
<p class="since">Since 2.6</p>
|
692
|
+
<p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
|
1538
693
|
</div>
|
1539
694
|
<hr>
|
1540
695
|
<div class="refsect2">
|
1541
696
|
<a name="gtk-file-chooser-get-show-hidden"></a><h3>gtk_file_chooser_get_show_hidden ()</h3>
|
1542
697
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
1543
698
|
gtk_file_chooser_get_show_hidden (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
1544
|
-
<p>
|
1545
|
-
See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-show-hidden" title="gtk_file_chooser_set_show_hidden ()"><code class="function">gtk_file_chooser_set_show_hidden()</code></a>.</p>
|
1546
|
-
<div class="refsect3">
|
1547
|
-
<a name="id-1.4.12.6.12.10.5"></a><h4>Parameters</h4>
|
1548
|
-
<div class="informaltable"><table width="100%" border="0">
|
1549
|
-
<colgroup>
|
1550
|
-
<col width="150px" class="parameters_name">
|
1551
|
-
<col class="parameters_description">
|
1552
|
-
<col width="200px" class="parameters_annotations">
|
1553
|
-
</colgroup>
|
1554
|
-
<tbody><tr>
|
1555
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1556
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1557
|
-
<td class="parameter_annotations"> </td>
|
1558
|
-
</tr></tbody>
|
1559
|
-
</table></div>
|
1560
|
-
</div>
|
1561
|
-
<div class="refsect3">
|
1562
|
-
<a name="id-1.4.12.6.12.10.6"></a><h4>Returns</h4>
|
1563
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden files and folders are displayed.</p>
|
1564
|
-
<p></p>
|
1565
|
-
</div>
|
1566
|
-
<p class="since">Since 2.6</p>
|
699
|
+
<p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
|
1567
700
|
</div>
|
1568
701
|
<hr>
|
1569
702
|
<div class="refsect2">
|
@@ -1572,39 +705,7 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-show-hidden"
|
|
1572
705
|
gtk_file_chooser_set_do_overwrite_confirmation
|
1573
706
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
1574
707
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> do_overwrite_confirmation</code></em>);</pre>
|
1575
|
-
<p>
|
1576
|
-
a confirmation dialog if the user types a file name that already exists. This
|
1577
|
-
is <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> by default.</p>
|
1578
|
-
<p>Regardless of this setting, the <em class="parameter"><code>chooser</code></em>
|
1579
|
-
will emit the
|
1580
|
-
<a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal"><span class="type">“confirm-overwrite”</span></a> signal when appropriate.</p>
|
1581
|
-
<p>If all you need is the stock confirmation dialog, set this property to <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
|
1582
|
-
You can override the way confirmation is done by actually handling the
|
1583
|
-
<a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal"><span class="type">“confirm-overwrite”</span></a> signal; please refer to its documentation
|
1584
|
-
for the details.</p>
|
1585
|
-
<div class="refsect3">
|
1586
|
-
<a name="id-1.4.12.6.12.11.7"></a><h4>Parameters</h4>
|
1587
|
-
<div class="informaltable"><table width="100%" border="0">
|
1588
|
-
<colgroup>
|
1589
|
-
<col width="150px" class="parameters_name">
|
1590
|
-
<col class="parameters_description">
|
1591
|
-
<col width="200px" class="parameters_annotations">
|
1592
|
-
</colgroup>
|
1593
|
-
<tbody>
|
1594
|
-
<tr>
|
1595
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1596
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1597
|
-
<td class="parameter_annotations"> </td>
|
1598
|
-
</tr>
|
1599
|
-
<tr>
|
1600
|
-
<td class="parameter_name"><p>do_overwrite_confirmation</p></td>
|
1601
|
-
<td class="parameter_description"><p>whether to confirm overwriting in save mode</p></td>
|
1602
|
-
<td class="parameter_annotations"> </td>
|
1603
|
-
</tr>
|
1604
|
-
</tbody>
|
1605
|
-
</table></div>
|
1606
|
-
</div>
|
1607
|
-
<p class="since">Since 2.8</p>
|
708
|
+
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
|
1608
709
|
</div>
|
1609
710
|
<hr>
|
1610
711
|
<div class="refsect2">
|
@@ -1612,30 +713,7 @@ for the details.</p>
|
|
1612
713
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
1613
714
|
gtk_file_chooser_get_do_overwrite_confirmation
|
1614
715
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
1615
|
-
<p>
|
1616
|
-
types a file name that already exists.</p>
|
1617
|
-
<div class="refsect3">
|
1618
|
-
<a name="id-1.4.12.6.12.12.5"></a><h4>Parameters</h4>
|
1619
|
-
<div class="informaltable"><table width="100%" border="0">
|
1620
|
-
<colgroup>
|
1621
|
-
<col width="150px" class="parameters_name">
|
1622
|
-
<col class="parameters_description">
|
1623
|
-
<col width="200px" class="parameters_annotations">
|
1624
|
-
</colgroup>
|
1625
|
-
<tbody><tr>
|
1626
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1627
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1628
|
-
<td class="parameter_annotations"> </td>
|
1629
|
-
</tr></tbody>
|
1630
|
-
</table></div>
|
1631
|
-
</div>
|
1632
|
-
<div class="refsect3">
|
1633
|
-
<a name="id-1.4.12.6.12.12.6"></a><h4>Returns</h4>
|
1634
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file chooser will present a confirmation dialog;
|
1635
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
1636
|
-
<p></p>
|
1637
|
-
</div>
|
1638
|
-
<p class="since">Since 2.8</p>
|
716
|
+
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
|
1639
717
|
</div>
|
1640
718
|
<hr>
|
1641
719
|
<div class="refsect2">
|
@@ -1643,61 +721,14 @@ types a file name that already exists.</p>
|
|
1643
721
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
1644
722
|
gtk_file_chooser_set_create_folders (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
1645
723
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> create_folders</code></em>);</pre>
|
1646
|
-
<p>
|
1647
|
-
This is only relevant if the action is not set to be
|
1648
|
-
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a>.</p>
|
1649
|
-
<div class="refsect3">
|
1650
|
-
<a name="id-1.4.12.6.12.13.5"></a><h4>Parameters</h4>
|
1651
|
-
<div class="informaltable"><table width="100%" border="0">
|
1652
|
-
<colgroup>
|
1653
|
-
<col width="150px" class="parameters_name">
|
1654
|
-
<col class="parameters_description">
|
1655
|
-
<col width="200px" class="parameters_annotations">
|
1656
|
-
</colgroup>
|
1657
|
-
<tbody>
|
1658
|
-
<tr>
|
1659
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1660
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1661
|
-
<td class="parameter_annotations"> </td>
|
1662
|
-
</tr>
|
1663
|
-
<tr>
|
1664
|
-
<td class="parameter_name"><p>create_folders</p></td>
|
1665
|
-
<td class="parameter_description"><p><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the New Folder button should be displayed</p></td>
|
1666
|
-
<td class="parameter_annotations"> </td>
|
1667
|
-
</tr>
|
1668
|
-
</tbody>
|
1669
|
-
</table></div>
|
1670
|
-
</div>
|
1671
|
-
<p class="since">Since 2.18</p>
|
724
|
+
<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
|
1672
725
|
</div>
|
1673
726
|
<hr>
|
1674
727
|
<div class="refsect2">
|
1675
728
|
<a name="gtk-file-chooser-get-create-folders"></a><h3>gtk_file_chooser_get_create_folders ()</h3>
|
1676
729
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
1677
730
|
gtk_file_chooser_get_create_folders (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
1678
|
-
<p>
|
1679
|
-
See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-create-folders" title="gtk_file_chooser_set_create_folders ()"><code class="function">gtk_file_chooser_set_create_folders()</code></a>.</p>
|
1680
|
-
<div class="refsect3">
|
1681
|
-
<a name="id-1.4.12.6.12.14.5"></a><h4>Parameters</h4>
|
1682
|
-
<div class="informaltable"><table width="100%" border="0">
|
1683
|
-
<colgroup>
|
1684
|
-
<col width="150px" class="parameters_name">
|
1685
|
-
<col class="parameters_description">
|
1686
|
-
<col width="200px" class="parameters_annotations">
|
1687
|
-
</colgroup>
|
1688
|
-
<tbody><tr>
|
1689
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1690
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1691
|
-
<td class="parameter_annotations"> </td>
|
1692
|
-
</tr></tbody>
|
1693
|
-
</table></div>
|
1694
|
-
</div>
|
1695
|
-
<div class="refsect3">
|
1696
|
-
<a name="id-1.4.12.6.12.14.6"></a><h4>Returns</h4>
|
1697
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the New Folder button should be displayed.</p>
|
1698
|
-
<p></p>
|
1699
|
-
</div>
|
1700
|
-
<p class="since">Since 2.18</p>
|
731
|
+
<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
|
1701
732
|
</div>
|
1702
733
|
<hr>
|
1703
734
|
<div class="refsect2">
|
@@ -1705,118 +736,28 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-create-folder
|
|
1705
736
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
1706
737
|
gtk_file_chooser_set_current_name (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
1707
738
|
<em class="parameter"><code>const <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
|
1708
|
-
<p>
|
1709
|
-
by the user. Note that the name passed in here is a UTF-8
|
1710
|
-
string rather than a filename. This function is meant for
|
1711
|
-
such uses as a suggested name in a "Save As..." dialog.</p>
|
1712
|
-
<p>If you want to preselect a particular existing file, you should use
|
1713
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-filename" title="gtk_file_chooser_set_filename"><code class="function">gtk_file_chooser_set_filename()</code></a> or <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-uri" title="gtk_file_chooser_set_uri ()"><code class="function">gtk_file_chooser_set_uri()</code></a> instead.
|
1714
|
-
Please see the documentation for those functions for an example of using
|
1715
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-name" title="gtk_file_chooser_set_current_name ()"><code class="function">gtk_file_chooser_set_current_name()</code></a> as well.</p>
|
1716
|
-
<div class="refsect3">
|
1717
|
-
<a name="id-1.4.12.6.12.15.6"></a><h4>Parameters</h4>
|
1718
|
-
<div class="informaltable"><table width="100%" border="0">
|
1719
|
-
<colgroup>
|
1720
|
-
<col width="150px" class="parameters_name">
|
1721
|
-
<col class="parameters_description">
|
1722
|
-
<col width="200px" class="parameters_annotations">
|
1723
|
-
</colgroup>
|
1724
|
-
<tbody>
|
1725
|
-
<tr>
|
1726
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1727
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1728
|
-
<td class="parameter_annotations"> </td>
|
1729
|
-
</tr>
|
1730
|
-
<tr>
|
1731
|
-
<td class="parameter_name"><p>name</p></td>
|
1732
|
-
<td class="parameter_description"><p> the filename to use, as a UTF-8 string. </p></td>
|
1733
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
1734
|
-
</tr>
|
1735
|
-
</tbody>
|
1736
|
-
</table></div>
|
1737
|
-
</div>
|
1738
|
-
<p class="since">Since 2.4</p>
|
739
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1739
740
|
</div>
|
1740
741
|
<hr>
|
1741
742
|
<div class="refsect2">
|
1742
743
|
<a name="gtk-file-chooser-select-all"></a><h3>gtk_file_chooser_select_all ()</h3>
|
1743
744
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
1744
745
|
gtk_file_chooser_select_all (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
1745
|
-
<p>
|
1746
|
-
<div class="refsect3">
|
1747
|
-
<a name="id-1.4.12.6.12.16.5"></a><h4>Parameters</h4>
|
1748
|
-
<div class="informaltable"><table width="100%" border="0">
|
1749
|
-
<colgroup>
|
1750
|
-
<col width="150px" class="parameters_name">
|
1751
|
-
<col class="parameters_description">
|
1752
|
-
<col width="200px" class="parameters_annotations">
|
1753
|
-
</colgroup>
|
1754
|
-
<tbody><tr>
|
1755
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1756
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1757
|
-
<td class="parameter_annotations"> </td>
|
1758
|
-
</tr></tbody>
|
1759
|
-
</table></div>
|
1760
|
-
</div>
|
1761
|
-
<p class="since">Since 2.4</p>
|
746
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1762
747
|
</div>
|
1763
748
|
<hr>
|
1764
749
|
<div class="refsect2">
|
1765
750
|
<a name="gtk-file-chooser-unselect-all"></a><h3>gtk_file_chooser_unselect_all ()</h3>
|
1766
751
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
1767
752
|
gtk_file_chooser_unselect_all (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
1768
|
-
<p>
|
1769
|
-
<div class="refsect3">
|
1770
|
-
<a name="id-1.4.12.6.12.17.5"></a><h4>Parameters</h4>
|
1771
|
-
<div class="informaltable"><table width="100%" border="0">
|
1772
|
-
<colgroup>
|
1773
|
-
<col width="150px" class="parameters_name">
|
1774
|
-
<col class="parameters_description">
|
1775
|
-
<col width="200px" class="parameters_annotations">
|
1776
|
-
</colgroup>
|
1777
|
-
<tbody><tr>
|
1778
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1779
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1780
|
-
<td class="parameter_annotations"> </td>
|
1781
|
-
</tr></tbody>
|
1782
|
-
</table></div>
|
1783
|
-
</div>
|
1784
|
-
<p class="since">Since 2.4</p>
|
753
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1785
754
|
</div>
|
1786
755
|
<hr>
|
1787
756
|
<div class="refsect2">
|
1788
757
|
<a name="gtk-file-chooser-get-uri"></a><h3>gtk_file_chooser_get_uri ()</h3>
|
1789
758
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
|
1790
759
|
gtk_file_chooser_get_uri (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
1791
|
-
<p>
|
1792
|
-
the file selector. If multiple files are selected,
|
1793
|
-
one of the filenames will be returned at random.</p>
|
1794
|
-
<p>If the file chooser is in folder mode, this function returns the selected
|
1795
|
-
folder.</p>
|
1796
|
-
<div class="refsect3">
|
1797
|
-
<a name="id-1.4.12.6.12.18.6"></a><h4>Parameters</h4>
|
1798
|
-
<div class="informaltable"><table width="100%" border="0">
|
1799
|
-
<colgroup>
|
1800
|
-
<col width="150px" class="parameters_name">
|
1801
|
-
<col class="parameters_description">
|
1802
|
-
<col width="200px" class="parameters_annotations">
|
1803
|
-
</colgroup>
|
1804
|
-
<tbody><tr>
|
1805
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1806
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1807
|
-
<td class="parameter_annotations"> </td>
|
1808
|
-
</tr></tbody>
|
1809
|
-
</table></div>
|
1810
|
-
</div>
|
1811
|
-
<div class="refsect3">
|
1812
|
-
<a name="id-1.4.12.6.12.18.7"></a><h4>Returns</h4>
|
1813
|
-
<p> The currently selected URI, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
|
1814
|
-
if no file is selected. If <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-local-only" title="gtk_file_chooser_set_local_only ()"><code class="function">gtk_file_chooser_set_local_only()</code></a> is set to <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
|
1815
|
-
(the default) a local URI will be returned for any FUSE locations.
|
1816
|
-
Free with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a></p>
|
1817
|
-
<p></p>
|
1818
|
-
</div>
|
1819
|
-
<p class="since">Since 2.4</p>
|
760
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1820
761
|
</div>
|
1821
762
|
<hr>
|
1822
763
|
<div class="refsect2">
|
@@ -1824,89 +765,7 @@ Free with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-
|
|
1824
765
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
1825
766
|
gtk_file_chooser_set_uri (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
1826
767
|
<em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
|
1827
|
-
<p>
|
1828
|
-
as the current file for the file chooser,
|
1829
|
-
by changing to the URI's parent folder and actually selecting the URI in the
|
1830
|
-
list. If the <em class="parameter"><code>chooser</code></em>
|
1831
|
-
is <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the URI's base
|
1832
|
-
name will also appear in the dialog's file name entry.</p>
|
1833
|
-
<p>If the URI isn't in the current folder of <em class="parameter"><code>chooser</code></em>
|
1834
|
-
, then the current folder
|
1835
|
-
of <em class="parameter"><code>chooser</code></em>
|
1836
|
-
will be changed to the folder containing <em class="parameter"><code>uri</code></em>
|
1837
|
-
. This is equivalent
|
1838
|
-
to a sequence of <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-all" title="gtk_file_chooser_unselect_all ()"><code class="function">gtk_file_chooser_unselect_all()</code></a> followed by
|
1839
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-uri" title="gtk_file_chooser_select_uri ()"><code class="function">gtk_file_chooser_select_uri()</code></a>.</p>
|
1840
|
-
<p>Note that the URI must exist, or nothing will be done except for the
|
1841
|
-
directory change.
|
1842
|
-
If you are implementing a <span class="guimenuitem">File/Save As...</span> dialog,
|
1843
|
-
you should use this function if you already have a file name to which the
|
1844
|
-
user may save; for example, when the user opens an existing file and then
|
1845
|
-
does <span class="guimenuitem">File/Save As...</span> on it. If you don't have
|
1846
|
-
a file name already — for example, if the user just created a new
|
1847
|
-
file and is saving it for the first time, do not call this function.
|
1848
|
-
Instead, use something similar to this:</p>
|
1849
|
-
<div class="informalexample">
|
1850
|
-
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
1851
|
-
<tbody>
|
1852
|
-
<tr>
|
1853
|
-
<td class="listing_lines" align="right"><pre>1
|
1854
|
-
2
|
1855
|
-
3
|
1856
|
-
4
|
1857
|
-
5
|
1858
|
-
6
|
1859
|
-
7
|
1860
|
-
8
|
1861
|
-
9
|
1862
|
-
10
|
1863
|
-
11</pre></td>
|
1864
|
-
<td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">document_is_new</span><span class="symbol">)</span>
|
1865
|
-
<span class="normal"> </span><span class="cbracket">{</span>
|
1866
|
-
<span class="normal"> </span><span class="comment">/* the user just created a new document */</span>
|
1867
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri">gtk_file_chooser_set_current_folder_uri</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> default_folder_for_saving</span><span class="symbol">);</span>
|
1868
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-name">gtk_file_chooser_set_current_name</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Untitled document"</span><span class="symbol">);</span>
|
1869
|
-
<span class="normal"> </span><span class="cbracket">}</span>
|
1870
|
-
<span class="keyword">else</span>
|
1871
|
-
<span class="normal"> </span><span class="cbracket">{</span>
|
1872
|
-
<span class="normal"> </span><span class="comment">/* the user edited an existing document */</span><span class="normal"> </span>
|
1873
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-uri">gtk_file_chooser_set_uri</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> existing_uri</span><span class="symbol">);</span>
|
1874
|
-
<span class="normal"> </span><span class="cbracket">}</span></pre></td>
|
1875
|
-
</tr>
|
1876
|
-
</tbody>
|
1877
|
-
</table>
|
1878
|
-
</div>
|
1879
|
-
|
1880
|
-
<p></p>
|
1881
|
-
<div class="refsect3">
|
1882
|
-
<a name="id-1.4.12.6.12.19.9"></a><h4>Parameters</h4>
|
1883
|
-
<div class="informaltable"><table width="100%" border="0">
|
1884
|
-
<colgroup>
|
1885
|
-
<col width="150px" class="parameters_name">
|
1886
|
-
<col class="parameters_description">
|
1887
|
-
<col width="200px" class="parameters_annotations">
|
1888
|
-
</colgroup>
|
1889
|
-
<tbody>
|
1890
|
-
<tr>
|
1891
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1892
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1893
|
-
<td class="parameter_annotations"> </td>
|
1894
|
-
</tr>
|
1895
|
-
<tr>
|
1896
|
-
<td class="parameter_name"><p>uri</p></td>
|
1897
|
-
<td class="parameter_description"><p>the URI to set as current</p></td>
|
1898
|
-
<td class="parameter_annotations"> </td>
|
1899
|
-
</tr>
|
1900
|
-
</tbody>
|
1901
|
-
</table></div>
|
1902
|
-
</div>
|
1903
|
-
<div class="refsect3">
|
1904
|
-
<a name="id-1.4.12.6.12.19.10"></a><h4>Returns</h4>
|
1905
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the URI was
|
1906
|
-
selected successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
1907
|
-
<p></p>
|
1908
|
-
</div>
|
1909
|
-
<p class="since">Since 2.4</p>
|
768
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1910
769
|
</div>
|
1911
770
|
<hr>
|
1912
771
|
<div class="refsect2">
|
@@ -1914,42 +773,7 @@ selected successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/loc
|
|
1914
773
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
1915
774
|
gtk_file_chooser_select_uri (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
1916
775
|
<em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
|
1917
|
-
<p>
|
1918
|
-
. If the URI doesn't refer to a
|
1919
|
-
file in the current folder of <em class="parameter"><code>chooser</code></em>
|
1920
|
-
, then the current folder of
|
1921
|
-
<em class="parameter"><code>chooser</code></em>
|
1922
|
-
will be changed to the folder containing <em class="parameter"><code>filename</code></em>
|
1923
|
-
.</p>
|
1924
|
-
<div class="refsect3">
|
1925
|
-
<a name="id-1.4.12.6.12.20.5"></a><h4>Parameters</h4>
|
1926
|
-
<div class="informaltable"><table width="100%" border="0">
|
1927
|
-
<colgroup>
|
1928
|
-
<col width="150px" class="parameters_name">
|
1929
|
-
<col class="parameters_description">
|
1930
|
-
<col width="200px" class="parameters_annotations">
|
1931
|
-
</colgroup>
|
1932
|
-
<tbody>
|
1933
|
-
<tr>
|
1934
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1935
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1936
|
-
<td class="parameter_annotations"> </td>
|
1937
|
-
</tr>
|
1938
|
-
<tr>
|
1939
|
-
<td class="parameter_name"><p>uri</p></td>
|
1940
|
-
<td class="parameter_description"><p>the URI to select</p></td>
|
1941
|
-
<td class="parameter_annotations"> </td>
|
1942
|
-
</tr>
|
1943
|
-
</tbody>
|
1944
|
-
</table></div>
|
1945
|
-
</div>
|
1946
|
-
<div class="refsect3">
|
1947
|
-
<a name="id-1.4.12.6.12.20.6"></a><h4>Returns</h4>
|
1948
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the URI was
|
1949
|
-
selected successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
1950
|
-
<p></p>
|
1951
|
-
</div>
|
1952
|
-
<p class="since">Since 2.4</p>
|
776
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1953
777
|
</div>
|
1954
778
|
<hr>
|
1955
779
|
<div class="refsect2">
|
@@ -1957,65 +781,14 @@ selected successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/loc
|
|
1957
781
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
1958
782
|
gtk_file_chooser_unselect_uri (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
1959
783
|
<em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
|
1960
|
-
<p>
|
1961
|
-
. If the file
|
1962
|
-
is not in the current directory, does not exist, or
|
1963
|
-
is otherwise not currently selected, does nothing.</p>
|
1964
|
-
<div class="refsect3">
|
1965
|
-
<a name="id-1.4.12.6.12.21.5"></a><h4>Parameters</h4>
|
1966
|
-
<div class="informaltable"><table width="100%" border="0">
|
1967
|
-
<colgroup>
|
1968
|
-
<col width="150px" class="parameters_name">
|
1969
|
-
<col class="parameters_description">
|
1970
|
-
<col width="200px" class="parameters_annotations">
|
1971
|
-
</colgroup>
|
1972
|
-
<tbody>
|
1973
|
-
<tr>
|
1974
|
-
<td class="parameter_name"><p>chooser</p></td>
|
1975
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
1976
|
-
<td class="parameter_annotations"> </td>
|
1977
|
-
</tr>
|
1978
|
-
<tr>
|
1979
|
-
<td class="parameter_name"><p>uri</p></td>
|
1980
|
-
<td class="parameter_description"><p>the URI to unselect</p></td>
|
1981
|
-
<td class="parameter_annotations"> </td>
|
1982
|
-
</tr>
|
1983
|
-
</tbody>
|
1984
|
-
</table></div>
|
1985
|
-
</div>
|
1986
|
-
<p class="since">Since 2.4</p>
|
784
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
1987
785
|
</div>
|
1988
786
|
<hr>
|
1989
787
|
<div class="refsect2">
|
1990
788
|
<a name="gtk-file-chooser-get-uris"></a><h3>gtk_file_chooser_get_uris ()</h3>
|
1991
789
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
|
1992
790
|
gtk_file_chooser_get_uris (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
1993
|
-
<p>
|
1994
|
-
<em class="parameter"><code>chooser</code></em>
|
1995
|
-
. The returned names are full absolute URIs.</p>
|
1996
|
-
<div class="refsect3">
|
1997
|
-
<a name="id-1.4.12.6.12.22.5"></a><h4>Parameters</h4>
|
1998
|
-
<div class="informaltable"><table width="100%" border="0">
|
1999
|
-
<colgroup>
|
2000
|
-
<col width="150px" class="parameters_name">
|
2001
|
-
<col class="parameters_description">
|
2002
|
-
<col width="200px" class="parameters_annotations">
|
2003
|
-
</colgroup>
|
2004
|
-
<tbody><tr>
|
2005
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2006
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2007
|
-
<td class="parameter_annotations"> </td>
|
2008
|
-
</tr></tbody>
|
2009
|
-
</table></div>
|
2010
|
-
</div>
|
2011
|
-
<div class="refsect3">
|
2012
|
-
<a name="id-1.4.12.6.12.22.6"></a><h4>Returns</h4>
|
2013
|
-
<p> a <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the URIs of all selected
|
2014
|
-
files and subfolders in the current folder. Free the returned list
|
2015
|
-
with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
|
2016
|
-
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
2017
|
-
</div>
|
2018
|
-
<p class="since">Since 2.4</p>
|
791
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2019
792
|
</div>
|
2020
793
|
<hr>
|
2021
794
|
<div class="refsect2">
|
@@ -2024,39 +797,7 @@ with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/h
|
|
2024
797
|
gtk_file_chooser_set_current_folder_uri
|
2025
798
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2026
799
|
<em class="parameter"><code>const <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>);</pre>
|
2027
|
-
<p>
|
2028
|
-
from an URI.
|
2029
|
-
The user will be shown the full contents of the current folder,
|
2030
|
-
plus user interface elements for navigating to other folders.</p>
|
2031
|
-
<div class="refsect3">
|
2032
|
-
<a name="id-1.4.12.6.12.23.5"></a><h4>Parameters</h4>
|
2033
|
-
<div class="informaltable"><table width="100%" border="0">
|
2034
|
-
<colgroup>
|
2035
|
-
<col width="150px" class="parameters_name">
|
2036
|
-
<col class="parameters_description">
|
2037
|
-
<col width="200px" class="parameters_annotations">
|
2038
|
-
</colgroup>
|
2039
|
-
<tbody>
|
2040
|
-
<tr>
|
2041
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2042
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2043
|
-
<td class="parameter_annotations"> </td>
|
2044
|
-
</tr>
|
2045
|
-
<tr>
|
2046
|
-
<td class="parameter_name"><p>uri</p></td>
|
2047
|
-
<td class="parameter_description"><p>the URI for the new current folder</p></td>
|
2048
|
-
<td class="parameter_annotations"> </td>
|
2049
|
-
</tr>
|
2050
|
-
</tbody>
|
2051
|
-
</table></div>
|
2052
|
-
</div>
|
2053
|
-
<div class="refsect3">
|
2054
|
-
<a name="id-1.4.12.6.12.23.6"></a><h4>Returns</h4>
|
2055
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
|
2056
|
-
otherwise.</p>
|
2057
|
-
<p></p>
|
2058
|
-
</div>
|
2059
|
-
<p class="since">Since 2.4</p>
|
800
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2060
801
|
</div>
|
2061
802
|
<hr>
|
2062
803
|
<div class="refsect2">
|
@@ -2064,40 +805,7 @@ otherwise.</p>
|
|
2064
805
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
|
2065
806
|
gtk_file_chooser_get_current_folder_uri
|
2066
807
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2067
|
-
<p>
|
2068
|
-
as an URI.
|
2069
|
-
See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()"><code class="function">gtk_file_chooser_set_current_folder_uri()</code></a>.</p>
|
2070
|
-
<p>Note that this is the folder that the file chooser is currently displaying
|
2071
|
-
(e.g. "file:///home/username/Documents"), which is <span class="emphasis"><em>not the same</em></span>
|
2072
|
-
as the currently-selected folder if the chooser is in
|
2073
|
-
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a> mode
|
2074
|
-
(e.g. "file:///home/username/Documents/selected-folder/". To get the
|
2075
|
-
currently-selected folder in that mode, use <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a> as the
|
2076
|
-
usual way to get the selection.</p>
|
2077
|
-
<div class="refsect3">
|
2078
|
-
<a name="id-1.4.12.6.12.24.6"></a><h4>Parameters</h4>
|
2079
|
-
<div class="informaltable"><table width="100%" border="0">
|
2080
|
-
<colgroup>
|
2081
|
-
<col width="150px" class="parameters_name">
|
2082
|
-
<col class="parameters_description">
|
2083
|
-
<col width="200px" class="parameters_annotations">
|
2084
|
-
</colgroup>
|
2085
|
-
<tbody><tr>
|
2086
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2087
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2088
|
-
<td class="parameter_annotations"> </td>
|
2089
|
-
</tr></tbody>
|
2090
|
-
</table></div>
|
2091
|
-
</div>
|
2092
|
-
<div class="refsect3">
|
2093
|
-
<a name="id-1.4.12.6.12.24.7"></a><h4>Returns</h4>
|
2094
|
-
<p> the URI for the current folder. Free with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. This
|
2095
|
-
function will also return <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the file chooser was unable to load the
|
2096
|
-
last folder that was requested from it; for example, as would be for calling
|
2097
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()"><code class="function">gtk_file_chooser_set_current_folder_uri()</code></a> on a nonexistent folder.</p>
|
2098
|
-
<p></p>
|
2099
|
-
</div>
|
2100
|
-
<p class="since">Since 2.4</p>
|
808
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2101
809
|
</div>
|
2102
810
|
<hr>
|
2103
811
|
<div class="refsect2">
|
@@ -2105,70 +813,14 @@ last folder that was requested from it; for example, as would be for calling
|
|
2105
813
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2106
814
|
gtk_file_chooser_set_preview_widget (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2107
815
|
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *preview_widget</code></em>);</pre>
|
2108
|
-
<p>
|
2109
|
-
of the currently selected file. To implement a preview, after setting the
|
2110
|
-
preview widget, you connect to the <a class="link" href="GtkFileChooser.html#GtkFileChooser-update-preview" title="The “update-preview” signal"><span class="type">“update-preview”</span></a>
|
2111
|
-
signal, and call <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename"><code class="function">gtk_file_chooser_get_preview_filename()</code></a> or
|
2112
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-uri" title="gtk_file_chooser_get_preview_uri ()"><code class="function">gtk_file_chooser_get_preview_uri()</code></a> on each change. If you can
|
2113
|
-
display a preview of the new file, update your widget and
|
2114
|
-
set the preview active using <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active" title="gtk_file_chooser_set_preview_widget_active ()"><code class="function">gtk_file_chooser_set_preview_widget_active()</code></a>.
|
2115
|
-
Otherwise, set the preview inactive.</p>
|
2116
|
-
<p>When there is no application-supplied preview widget, or the
|
2117
|
-
application-supplied preview widget is not active, the file chooser
|
2118
|
-
may display an internally generated preview of the current file or
|
2119
|
-
it may display no preview at all.</p>
|
2120
|
-
<div class="refsect3">
|
2121
|
-
<a name="id-1.4.12.6.12.25.6"></a><h4>Parameters</h4>
|
2122
|
-
<div class="informaltable"><table width="100%" border="0">
|
2123
|
-
<colgroup>
|
2124
|
-
<col width="150px" class="parameters_name">
|
2125
|
-
<col class="parameters_description">
|
2126
|
-
<col width="200px" class="parameters_annotations">
|
2127
|
-
</colgroup>
|
2128
|
-
<tbody>
|
2129
|
-
<tr>
|
2130
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2131
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2132
|
-
<td class="parameter_annotations"> </td>
|
2133
|
-
</tr>
|
2134
|
-
<tr>
|
2135
|
-
<td class="parameter_name"><p>preview_widget</p></td>
|
2136
|
-
<td class="parameter_description"><p>widget for displaying preview.</p></td>
|
2137
|
-
<td class="parameter_annotations"> </td>
|
2138
|
-
</tr>
|
2139
|
-
</tbody>
|
2140
|
-
</table></div>
|
2141
|
-
</div>
|
2142
|
-
<p class="since">Since 2.4</p>
|
816
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2143
817
|
</div>
|
2144
818
|
<hr>
|
2145
819
|
<div class="refsect2">
|
2146
820
|
<a name="gtk-file-chooser-get-preview-widget"></a><h3>gtk_file_chooser_get_preview_widget ()</h3>
|
2147
821
|
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
2148
822
|
gtk_file_chooser_get_preview_widget (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2149
|
-
<p>
|
2150
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a>.</p>
|
2151
|
-
<div class="refsect3">
|
2152
|
-
<a name="id-1.4.12.6.12.26.5"></a><h4>Parameters</h4>
|
2153
|
-
<div class="informaltable"><table width="100%" border="0">
|
2154
|
-
<colgroup>
|
2155
|
-
<col width="150px" class="parameters_name">
|
2156
|
-
<col class="parameters_description">
|
2157
|
-
<col width="200px" class="parameters_annotations">
|
2158
|
-
</colgroup>
|
2159
|
-
<tbody><tr>
|
2160
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2161
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2162
|
-
<td class="parameter_annotations"> </td>
|
2163
|
-
</tr></tbody>
|
2164
|
-
</table></div>
|
2165
|
-
</div>
|
2166
|
-
<div class="refsect3">
|
2167
|
-
<a name="id-1.4.12.6.12.26.6"></a><h4>Returns</h4>
|
2168
|
-
<p> the current preview widget, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
|
2169
|
-
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
2170
|
-
</div>
|
2171
|
-
<p class="since">Since 2.4</p>
|
823
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2172
824
|
</div>
|
2173
825
|
<hr>
|
2174
826
|
<div class="refsect2">
|
@@ -2177,36 +829,7 @@ gtk_file_chooser_get_preview_widget (<em class="parameter"><code><a class="link"
|
|
2177
829
|
gtk_file_chooser_set_preview_widget_active
|
2178
830
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2179
831
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> active</code></em>);</pre>
|
2180
|
-
<p>
|
2181
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a> should be shown for the
|
2182
|
-
current filename. When <em class="parameter"><code>active</code></em>
|
2183
|
-
is set to false, the file chooser
|
2184
|
-
may display an internally generated preview of the current file
|
2185
|
-
or it may display no preview at all. See
|
2186
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a> for more details.</p>
|
2187
|
-
<div class="refsect3">
|
2188
|
-
<a name="id-1.4.12.6.12.27.5"></a><h4>Parameters</h4>
|
2189
|
-
<div class="informaltable"><table width="100%" border="0">
|
2190
|
-
<colgroup>
|
2191
|
-
<col width="150px" class="parameters_name">
|
2192
|
-
<col class="parameters_description">
|
2193
|
-
<col width="200px" class="parameters_annotations">
|
2194
|
-
</colgroup>
|
2195
|
-
<tbody>
|
2196
|
-
<tr>
|
2197
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2198
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2199
|
-
<td class="parameter_annotations"> </td>
|
2200
|
-
</tr>
|
2201
|
-
<tr>
|
2202
|
-
<td class="parameter_name"><p>active</p></td>
|
2203
|
-
<td class="parameter_description"><p>whether to display the user-specified preview widget</p></td>
|
2204
|
-
<td class="parameter_annotations"> </td>
|
2205
|
-
</tr>
|
2206
|
-
</tbody>
|
2207
|
-
</table></div>
|
2208
|
-
</div>
|
2209
|
-
<p class="since">Since 2.4</p>
|
832
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2210
833
|
</div>
|
2211
834
|
<hr>
|
2212
835
|
<div class="refsect2">
|
@@ -2214,30 +837,7 @@ or it may display no preview at all. See
|
|
2214
837
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2215
838
|
gtk_file_chooser_get_preview_widget_active
|
2216
839
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2217
|
-
<p>
|
2218
|
-
should be shown for the current filename. See
|
2219
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active" title="gtk_file_chooser_set_preview_widget_active ()"><code class="function">gtk_file_chooser_set_preview_widget_active()</code></a>.</p>
|
2220
|
-
<div class="refsect3">
|
2221
|
-
<a name="id-1.4.12.6.12.28.5"></a><h4>Parameters</h4>
|
2222
|
-
<div class="informaltable"><table width="100%" border="0">
|
2223
|
-
<colgroup>
|
2224
|
-
<col width="150px" class="parameters_name">
|
2225
|
-
<col class="parameters_description">
|
2226
|
-
<col width="200px" class="parameters_annotations">
|
2227
|
-
</colgroup>
|
2228
|
-
<tbody><tr>
|
2229
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2230
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2231
|
-
<td class="parameter_annotations"> </td>
|
2232
|
-
</tr></tbody>
|
2233
|
-
</table></div>
|
2234
|
-
</div>
|
2235
|
-
<div class="refsect3">
|
2236
|
-
<a name="id-1.4.12.6.12.28.6"></a><h4>Returns</h4>
|
2237
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the preview widget is active for the current filename.</p>
|
2238
|
-
<p></p>
|
2239
|
-
</div>
|
2240
|
-
<p class="since">Since 2.4</p>
|
840
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2241
841
|
</div>
|
2242
842
|
<hr>
|
2243
843
|
<div class="refsect2">
|
@@ -2246,34 +846,7 @@ should be shown for the current filename. See
|
|
2246
846
|
gtk_file_chooser_set_use_preview_label
|
2247
847
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2248
848
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_label</code></em>);</pre>
|
2249
|
-
<p>
|
2250
|
-
the file that is being previewed; the default is <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. Applications that
|
2251
|
-
want to draw the whole preview area themselves should set this to <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and
|
2252
|
-
display the name themselves in their preview widget.</p>
|
2253
|
-
<p>See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a></p>
|
2254
|
-
<div class="refsect3">
|
2255
|
-
<a name="id-1.4.12.6.12.29.6"></a><h4>Parameters</h4>
|
2256
|
-
<div class="informaltable"><table width="100%" border="0">
|
2257
|
-
<colgroup>
|
2258
|
-
<col width="150px" class="parameters_name">
|
2259
|
-
<col class="parameters_description">
|
2260
|
-
<col width="200px" class="parameters_annotations">
|
2261
|
-
</colgroup>
|
2262
|
-
<tbody>
|
2263
|
-
<tr>
|
2264
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2265
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2266
|
-
<td class="parameter_annotations"> </td>
|
2267
|
-
</tr>
|
2268
|
-
<tr>
|
2269
|
-
<td class="parameter_name"><p>use_label</p></td>
|
2270
|
-
<td class="parameter_description"><p>whether to display a stock label with the name of the previewed file</p></td>
|
2271
|
-
<td class="parameter_annotations"> </td>
|
2272
|
-
</tr>
|
2273
|
-
</tbody>
|
2274
|
-
</table></div>
|
2275
|
-
</div>
|
2276
|
-
<p class="since">Since 2.4</p>
|
849
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2277
850
|
</div>
|
2278
851
|
<hr>
|
2279
852
|
<div class="refsect2">
|
@@ -2281,59 +854,13 @@ display the name themselves in their preview widget.</p>
|
|
2281
854
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2282
855
|
gtk_file_chooser_get_use_preview_label
|
2283
856
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2284
|
-
<p>Gets whether a stock label should be drawn with the name of the previewed
|
2285
|
-
file. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-use-preview-label" title="gtk_file_chooser_set_use_preview_label ()"><code class="function">gtk_file_chooser_set_use_preview_label()</code></a>.</p>
|
2286
|
-
<div class="refsect3">
|
2287
|
-
<a name="id-1.4.12.6.12.30.5"></a><h4>Parameters</h4>
|
2288
|
-
<div class="informaltable"><table width="100%" border="0">
|
2289
|
-
<colgroup>
|
2290
|
-
<col width="150px" class="parameters_name">
|
2291
|
-
<col class="parameters_description">
|
2292
|
-
<col width="200px" class="parameters_annotations">
|
2293
|
-
</colgroup>
|
2294
|
-
<tbody><tr>
|
2295
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2296
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2297
|
-
<td class="parameter_annotations"> </td>
|
2298
|
-
</tr></tbody>
|
2299
|
-
</table></div>
|
2300
|
-
</div>
|
2301
|
-
<div class="refsect3">
|
2302
|
-
<a name="id-1.4.12.6.12.30.6"></a><h4>Returns</h4>
|
2303
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file chooser is set to display a label with the
|
2304
|
-
name of the previewed file, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
2305
|
-
<p></p>
|
2306
|
-
</div>
|
2307
857
|
</div>
|
2308
858
|
<hr>
|
2309
859
|
<div class="refsect2">
|
2310
860
|
<a name="gtk-file-chooser-get-preview-uri"></a><h3>gtk_file_chooser_get_preview_uri ()</h3>
|
2311
861
|
<pre class="programlisting"><span class="returnvalue">char</span> *
|
2312
862
|
gtk_file_chooser_get_preview_uri (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2313
|
-
<p>
|
2314
|
-
widget. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a>.</p>
|
2315
|
-
<div class="refsect3">
|
2316
|
-
<a name="id-1.4.12.6.12.31.5"></a><h4>Parameters</h4>
|
2317
|
-
<div class="informaltable"><table width="100%" border="0">
|
2318
|
-
<colgroup>
|
2319
|
-
<col width="150px" class="parameters_name">
|
2320
|
-
<col class="parameters_description">
|
2321
|
-
<col width="200px" class="parameters_annotations">
|
2322
|
-
</colgroup>
|
2323
|
-
<tbody><tr>
|
2324
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2325
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2326
|
-
<td class="parameter_annotations"> </td>
|
2327
|
-
</tr></tbody>
|
2328
|
-
</table></div>
|
2329
|
-
</div>
|
2330
|
-
<div class="refsect3">
|
2331
|
-
<a name="id-1.4.12.6.12.31.6"></a><h4>Returns</h4>
|
2332
|
-
<p> the URI for the file to preview, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is
|
2333
|
-
selected. Free with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
|
2334
|
-
<p></p>
|
2335
|
-
</div>
|
2336
|
-
<p class="since">Since 2.4</p>
|
863
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2337
864
|
</div>
|
2338
865
|
<hr>
|
2339
866
|
<div class="refsect2">
|
@@ -2341,59 +868,14 @@ selected. Free with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/
|
|
2341
868
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2342
869
|
gtk_file_chooser_set_extra_widget (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2343
870
|
<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *extra_widget</code></em>);</pre>
|
2344
|
-
<p>
|
2345
|
-
<div class="refsect3">
|
2346
|
-
<a name="id-1.4.12.6.12.32.5"></a><h4>Parameters</h4>
|
2347
|
-
<div class="informaltable"><table width="100%" border="0">
|
2348
|
-
<colgroup>
|
2349
|
-
<col width="150px" class="parameters_name">
|
2350
|
-
<col class="parameters_description">
|
2351
|
-
<col width="200px" class="parameters_annotations">
|
2352
|
-
</colgroup>
|
2353
|
-
<tbody>
|
2354
|
-
<tr>
|
2355
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2356
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2357
|
-
<td class="parameter_annotations"> </td>
|
2358
|
-
</tr>
|
2359
|
-
<tr>
|
2360
|
-
<td class="parameter_name"><p>extra_widget</p></td>
|
2361
|
-
<td class="parameter_description"><p>widget for extra options</p></td>
|
2362
|
-
<td class="parameter_annotations"> </td>
|
2363
|
-
</tr>
|
2364
|
-
</tbody>
|
2365
|
-
</table></div>
|
2366
|
-
</div>
|
2367
|
-
<p class="since">Since 2.4</p>
|
871
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2368
872
|
</div>
|
2369
873
|
<hr>
|
2370
874
|
<div class="refsect2">
|
2371
875
|
<a name="gtk-file-chooser-get-extra-widget"></a><h3>gtk_file_chooser_get_extra_widget ()</h3>
|
2372
876
|
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
2373
877
|
gtk_file_chooser_get_extra_widget (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2374
|
-
<p>
|
2375
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-extra-widget" title="gtk_file_chooser_set_extra_widget ()"><code class="function">gtk_file_chooser_set_extra_widget()</code></a>.</p>
|
2376
|
-
<div class="refsect3">
|
2377
|
-
<a name="id-1.4.12.6.12.33.5"></a><h4>Parameters</h4>
|
2378
|
-
<div class="informaltable"><table width="100%" border="0">
|
2379
|
-
<colgroup>
|
2380
|
-
<col width="150px" class="parameters_name">
|
2381
|
-
<col class="parameters_description">
|
2382
|
-
<col width="200px" class="parameters_annotations">
|
2383
|
-
</colgroup>
|
2384
|
-
<tbody><tr>
|
2385
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2386
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2387
|
-
<td class="parameter_annotations"> </td>
|
2388
|
-
</tr></tbody>
|
2389
|
-
</table></div>
|
2390
|
-
</div>
|
2391
|
-
<div class="refsect3">
|
2392
|
-
<a name="id-1.4.12.6.12.33.6"></a><h4>Returns</h4>
|
2393
|
-
<p> the current extra widget, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
|
2394
|
-
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
2395
|
-
</div>
|
2396
|
-
<p class="since">Since 2.4</p>
|
878
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2397
879
|
</div>
|
2398
880
|
<hr>
|
2399
881
|
<div class="refsect2">
|
@@ -2401,36 +883,7 @@ gtk_file_chooser_get_extra_widget (<em class="parameter"><code><a class="link" h
|
|
2401
883
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2402
884
|
gtk_file_chooser_add_filter (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2403
885
|
<em class="parameter"><code><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);</pre>
|
2404
|
-
<p>
|
2405
|
-
to the list of filters that the user can select between.
|
2406
|
-
When a filter is selected, only files that are passed by that
|
2407
|
-
filter are displayed. </p>
|
2408
|
-
<p>Note that the <em class="parameter"><code>chooser</code></em>
|
2409
|
-
takes ownership of the filter, so you have to
|
2410
|
-
ref and sink it if you want to keep a reference.</p>
|
2411
|
-
<div class="refsect3">
|
2412
|
-
<a name="id-1.4.12.6.12.34.6"></a><h4>Parameters</h4>
|
2413
|
-
<div class="informaltable"><table width="100%" border="0">
|
2414
|
-
<colgroup>
|
2415
|
-
<col width="150px" class="parameters_name">
|
2416
|
-
<col class="parameters_description">
|
2417
|
-
<col width="200px" class="parameters_annotations">
|
2418
|
-
</colgroup>
|
2419
|
-
<tbody>
|
2420
|
-
<tr>
|
2421
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2422
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2423
|
-
<td class="parameter_annotations"> </td>
|
2424
|
-
</tr>
|
2425
|
-
<tr>
|
2426
|
-
<td class="parameter_name"><p>filter</p></td>
|
2427
|
-
<td class="parameter_description"><p>a <a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a></p></td>
|
2428
|
-
<td class="parameter_annotations"> </td>
|
2429
|
-
</tr>
|
2430
|
-
</tbody>
|
2431
|
-
</table></div>
|
2432
|
-
</div>
|
2433
|
-
<p class="since">Since 2.4</p>
|
886
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2434
887
|
</div>
|
2435
888
|
<hr>
|
2436
889
|
<div class="refsect2">
|
@@ -2438,63 +891,14 @@ ref and sink it if you want to keep a reference.</p>
|
|
2438
891
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2439
892
|
gtk_file_chooser_remove_filter (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2440
893
|
<em class="parameter"><code><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);</pre>
|
2441
|
-
<p>
|
2442
|
-
from the list of filters that the user can select between.</p>
|
2443
|
-
<div class="refsect3">
|
2444
|
-
<a name="id-1.4.12.6.12.35.5"></a><h4>Parameters</h4>
|
2445
|
-
<div class="informaltable"><table width="100%" border="0">
|
2446
|
-
<colgroup>
|
2447
|
-
<col width="150px" class="parameters_name">
|
2448
|
-
<col class="parameters_description">
|
2449
|
-
<col width="200px" class="parameters_annotations">
|
2450
|
-
</colgroup>
|
2451
|
-
<tbody>
|
2452
|
-
<tr>
|
2453
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2454
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2455
|
-
<td class="parameter_annotations"> </td>
|
2456
|
-
</tr>
|
2457
|
-
<tr>
|
2458
|
-
<td class="parameter_name"><p>filter</p></td>
|
2459
|
-
<td class="parameter_description"><p>a <a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a></p></td>
|
2460
|
-
<td class="parameter_annotations"> </td>
|
2461
|
-
</tr>
|
2462
|
-
</tbody>
|
2463
|
-
</table></div>
|
2464
|
-
</div>
|
2465
|
-
<p class="since">Since 2.4</p>
|
894
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2466
895
|
</div>
|
2467
896
|
<hr>
|
2468
897
|
<div class="refsect2">
|
2469
898
|
<a name="gtk-file-chooser-list-filters"></a><h3>gtk_file_chooser_list_filters ()</h3>
|
2470
899
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
|
2471
900
|
gtk_file_chooser_list_filters (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2472
|
-
<p>
|
2473
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-filter" title="gtk_file_chooser_add_filter ()"><code class="function">gtk_file_chooser_add_filter()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-remove-filter" title="gtk_file_chooser_remove_filter ()"><code class="function">gtk_file_chooser_remove_filter()</code></a>.</p>
|
2474
|
-
<div class="refsect3">
|
2475
|
-
<a name="id-1.4.12.6.12.36.5"></a><h4>Parameters</h4>
|
2476
|
-
<div class="informaltable"><table width="100%" border="0">
|
2477
|
-
<colgroup>
|
2478
|
-
<col width="150px" class="parameters_name">
|
2479
|
-
<col class="parameters_description">
|
2480
|
-
<col width="200px" class="parameters_annotations">
|
2481
|
-
</colgroup>
|
2482
|
-
<tbody><tr>
|
2483
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2484
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2485
|
-
<td class="parameter_annotations"> </td>
|
2486
|
-
</tr></tbody>
|
2487
|
-
</table></div>
|
2488
|
-
</div>
|
2489
|
-
<div class="refsect3">
|
2490
|
-
<a name="id-1.4.12.6.12.36.6"></a><h4>Returns</h4>
|
2491
|
-
<p> a
|
2492
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the current set of user selectable filters. The
|
2493
|
-
contents of the list are owned by GTK+, but you must free the list
|
2494
|
-
itself with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> when you are done with it. </p>
|
2495
|
-
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkFileFilter][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
|
2496
|
-
</div>
|
2497
|
-
<p class="since">Since 2.4</p>
|
901
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2498
902
|
</div>
|
2499
903
|
<hr>
|
2500
904
|
<div class="refsect2">
|
@@ -2502,63 +906,14 @@ itself with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gt
|
|
2502
906
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
2503
907
|
gtk_file_chooser_set_filter (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2504
908
|
<em class="parameter"><code><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);</pre>
|
2505
|
-
<p>
|
2506
|
-
filter will be displayed. If the user-selectable list of filters
|
2507
|
-
is non-empty, then the filter should be one of the filters
|
2508
|
-
in that list. Setting the current filter when the list of
|
2509
|
-
filters is empty is useful if you want to restrict the displayed
|
2510
|
-
set of files without letting the user change it.</p>
|
2511
|
-
<div class="refsect3">
|
2512
|
-
<a name="id-1.4.12.6.12.37.5"></a><h4>Parameters</h4>
|
2513
|
-
<div class="informaltable"><table width="100%" border="0">
|
2514
|
-
<colgroup>
|
2515
|
-
<col width="150px" class="parameters_name">
|
2516
|
-
<col class="parameters_description">
|
2517
|
-
<col width="200px" class="parameters_annotations">
|
2518
|
-
</colgroup>
|
2519
|
-
<tbody>
|
2520
|
-
<tr>
|
2521
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2522
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2523
|
-
<td class="parameter_annotations"> </td>
|
2524
|
-
</tr>
|
2525
|
-
<tr>
|
2526
|
-
<td class="parameter_name"><p>filter</p></td>
|
2527
|
-
<td class="parameter_description"><p>a <a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a></p></td>
|
2528
|
-
<td class="parameter_annotations"> </td>
|
2529
|
-
</tr>
|
2530
|
-
</tbody>
|
2531
|
-
</table></div>
|
2532
|
-
</div>
|
2533
|
-
<p class="since">Since 2.4</p>
|
909
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2534
910
|
</div>
|
2535
911
|
<hr>
|
2536
912
|
<div class="refsect2">
|
2537
913
|
<a name="gtk-file-chooser-get-filter"></a><h3>gtk_file_chooser_get_filter ()</h3>
|
2538
914
|
<pre class="programlisting"><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="returnvalue">GtkFileFilter</span></a> *
|
2539
915
|
gtk_file_chooser_get_filter (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2540
|
-
<p>
|
2541
|
-
<div class="refsect3">
|
2542
|
-
<a name="id-1.4.12.6.12.38.5"></a><h4>Parameters</h4>
|
2543
|
-
<div class="informaltable"><table width="100%" border="0">
|
2544
|
-
<colgroup>
|
2545
|
-
<col width="150px" class="parameters_name">
|
2546
|
-
<col class="parameters_description">
|
2547
|
-
<col width="200px" class="parameters_annotations">
|
2548
|
-
</colgroup>
|
2549
|
-
<tbody><tr>
|
2550
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2551
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2552
|
-
<td class="parameter_annotations"> </td>
|
2553
|
-
</tr></tbody>
|
2554
|
-
</table></div>
|
2555
|
-
</div>
|
2556
|
-
<div class="refsect3">
|
2557
|
-
<a name="id-1.4.12.6.12.38.6"></a><h4>Returns</h4>
|
2558
|
-
<p> the current filter, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
|
2559
|
-
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
2560
|
-
</div>
|
2561
|
-
<p class="since">Since 2.4</p>
|
916
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2562
917
|
</div>
|
2563
918
|
<hr>
|
2564
919
|
<div class="refsect2">
|
@@ -2568,45 +923,7 @@ gtk_file_chooser_add_shortcut_folder_uri
|
|
2568
923
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2569
924
|
<em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
|
2570
925
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2571
|
-
<p>
|
2572
|
-
chooser. Note that shortcut folders do not get saved, as they are provided
|
2573
|
-
by the application. For example, you can use this to add a
|
2574
|
-
"file:///usr/share/mydrawprogram/Clipart" folder to the volume list.</p>
|
2575
|
-
<div class="refsect3">
|
2576
|
-
<a name="id-1.4.12.6.12.39.5"></a><h4>Parameters</h4>
|
2577
|
-
<div class="informaltable"><table width="100%" border="0">
|
2578
|
-
<colgroup>
|
2579
|
-
<col width="150px" class="parameters_name">
|
2580
|
-
<col class="parameters_description">
|
2581
|
-
<col width="200px" class="parameters_annotations">
|
2582
|
-
</colgroup>
|
2583
|
-
<tbody>
|
2584
|
-
<tr>
|
2585
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2586
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2587
|
-
<td class="parameter_annotations"> </td>
|
2588
|
-
</tr>
|
2589
|
-
<tr>
|
2590
|
-
<td class="parameter_name"><p>uri</p></td>
|
2591
|
-
<td class="parameter_description"><p>URI of the folder to add</p></td>
|
2592
|
-
<td class="parameter_annotations"> </td>
|
2593
|
-
</tr>
|
2594
|
-
<tr>
|
2595
|
-
<td class="parameter_name"><p>error</p></td>
|
2596
|
-
<td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
2597
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
2598
|
-
</tr>
|
2599
|
-
</tbody>
|
2600
|
-
</table></div>
|
2601
|
-
</div>
|
2602
|
-
<div class="refsect3">
|
2603
|
-
<a name="id-1.4.12.6.12.39.6"></a><h4>Returns</h4>
|
2604
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be added successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
|
2605
|
-
otherwise. In the latter case, the <em class="parameter"><code>error</code></em>
|
2606
|
-
will be set as appropriate.</p>
|
2607
|
-
<p></p>
|
2608
|
-
</div>
|
2609
|
-
<p class="since">Since 2.4</p>
|
926
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2610
927
|
</div>
|
2611
928
|
<hr>
|
2612
929
|
<div class="refsect2">
|
@@ -2616,43 +933,7 @@ gtk_file_chooser_remove_shortcut_folder_uri
|
|
2616
933
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2617
934
|
<em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
|
2618
935
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2619
|
-
<p>
|
2620
|
-
<div class="refsect3">
|
2621
|
-
<a name="id-1.4.12.6.12.40.5"></a><h4>Parameters</h4>
|
2622
|
-
<div class="informaltable"><table width="100%" border="0">
|
2623
|
-
<colgroup>
|
2624
|
-
<col width="150px" class="parameters_name">
|
2625
|
-
<col class="parameters_description">
|
2626
|
-
<col width="200px" class="parameters_annotations">
|
2627
|
-
</colgroup>
|
2628
|
-
<tbody>
|
2629
|
-
<tr>
|
2630
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2631
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2632
|
-
<td class="parameter_annotations"> </td>
|
2633
|
-
</tr>
|
2634
|
-
<tr>
|
2635
|
-
<td class="parameter_name"><p>uri</p></td>
|
2636
|
-
<td class="parameter_description"><p>URI of the folder to remove</p></td>
|
2637
|
-
<td class="parameter_annotations"> </td>
|
2638
|
-
</tr>
|
2639
|
-
<tr>
|
2640
|
-
<td class="parameter_name"><p>error</p></td>
|
2641
|
-
<td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
2642
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
2643
|
-
</tr>
|
2644
|
-
</tbody>
|
2645
|
-
</table></div>
|
2646
|
-
</div>
|
2647
|
-
<div class="refsect3">
|
2648
|
-
<a name="id-1.4.12.6.12.40.6"></a><h4>Returns</h4>
|
2649
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeds, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
|
2650
|
-
In the latter case, the <em class="parameter"><code>error</code></em>
|
2651
|
-
will be set as appropriate.</p>
|
2652
|
-
<p>See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder-uri" title="gtk_file_chooser_add_shortcut_folder_uri ()"><code class="function">gtk_file_chooser_add_shortcut_folder_uri()</code></a></p>
|
2653
|
-
<p></p>
|
2654
|
-
</div>
|
2655
|
-
<p class="since">Since 2.4</p>
|
936
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2656
937
|
</div>
|
2657
938
|
<hr>
|
2658
939
|
<div class="refsect2">
|
@@ -2660,203 +941,45 @@ will be set as appropriate.</p>
|
|
2660
941
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
|
2661
942
|
gtk_file_chooser_list_shortcut_folder_uris
|
2662
943
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2663
|
-
<p>
|
2664
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder-uri" title="gtk_file_chooser_add_shortcut_folder_uri ()"><code class="function">gtk_file_chooser_add_shortcut_folder_uri()</code></a>.</p>
|
2665
|
-
<div class="refsect3">
|
2666
|
-
<a name="id-1.4.12.6.12.41.5"></a><h4>Parameters</h4>
|
2667
|
-
<div class="informaltable"><table width="100%" border="0">
|
2668
|
-
<colgroup>
|
2669
|
-
<col width="150px" class="parameters_name">
|
2670
|
-
<col class="parameters_description">
|
2671
|
-
<col width="200px" class="parameters_annotations">
|
2672
|
-
</colgroup>
|
2673
|
-
<tbody><tr>
|
2674
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2675
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2676
|
-
<td class="parameter_annotations"> </td>
|
2677
|
-
</tr></tbody>
|
2678
|
-
</table></div>
|
2679
|
-
</div>
|
2680
|
-
<div class="refsect3">
|
2681
|
-
<a name="id-1.4.12.6.12.41.6"></a><h4>Returns</h4>
|
2682
|
-
<p> A list of folder
|
2683
|
-
URIs, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut folders. Free the returned
|
2684
|
-
list with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the URIs with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
|
2685
|
-
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
2686
|
-
</div>
|
2687
|
-
<p class="since">Since 2.4</p>
|
944
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
2688
945
|
</div>
|
2689
946
|
<hr>
|
2690
947
|
<div class="refsect2">
|
2691
948
|
<a name="gtk-file-chooser-get-current-folder-file"></a><h3>gtk_file_chooser_get_current_folder_file ()</h3>
|
2692
|
-
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
|
949
|
+
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
|
2693
950
|
gtk_file_chooser_get_current_folder_file
|
2694
951
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2695
|
-
<p>
|
2696
|
-
as <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>.
|
2697
|
-
See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder-uri" title="gtk_file_chooser_get_current_folder_uri ()"><code class="function">gtk_file_chooser_get_current_folder_uri()</code></a>.</p>
|
2698
|
-
<div class="refsect3">
|
2699
|
-
<a name="id-1.4.12.6.12.42.5"></a><h4>Parameters</h4>
|
2700
|
-
<div class="informaltable"><table width="100%" border="0">
|
2701
|
-
<colgroup>
|
2702
|
-
<col width="150px" class="parameters_name">
|
2703
|
-
<col class="parameters_description">
|
2704
|
-
<col width="200px" class="parameters_annotations">
|
2705
|
-
</colgroup>
|
2706
|
-
<tbody><tr>
|
2707
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2708
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2709
|
-
<td class="parameter_annotations"> </td>
|
2710
|
-
</tr></tbody>
|
2711
|
-
</table></div>
|
2712
|
-
</div>
|
2713
|
-
<div class="refsect3">
|
2714
|
-
<a name="id-1.4.12.6.12.42.6"></a><h4>Returns</h4>
|
2715
|
-
<p> the <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> for the current folder. </p>
|
2716
|
-
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
2717
|
-
</div>
|
2718
|
-
<p class="since">Since 2.14</p>
|
952
|
+
<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
|
2719
953
|
</div>
|
2720
954
|
<hr>
|
2721
955
|
<div class="refsect2">
|
2722
956
|
<a name="gtk-file-chooser-get-file"></a><h3>gtk_file_chooser_get_file ()</h3>
|
2723
|
-
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
|
957
|
+
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
|
2724
958
|
gtk_file_chooser_get_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2725
|
-
<p>
|
2726
|
-
the file selector. If multiple files are selected,
|
2727
|
-
one of the files will be returned at random.</p>
|
2728
|
-
<p>If the file chooser is in folder mode, this function returns the selected
|
2729
|
-
folder.</p>
|
2730
|
-
<div class="refsect3">
|
2731
|
-
<a name="id-1.4.12.6.12.43.6"></a><h4>Parameters</h4>
|
2732
|
-
<div class="informaltable"><table width="100%" border="0">
|
2733
|
-
<colgroup>
|
2734
|
-
<col width="150px" class="parameters_name">
|
2735
|
-
<col class="parameters_description">
|
2736
|
-
<col width="200px" class="parameters_annotations">
|
2737
|
-
</colgroup>
|
2738
|
-
<tbody><tr>
|
2739
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2740
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2741
|
-
<td class="parameter_annotations"> </td>
|
2742
|
-
</tr></tbody>
|
2743
|
-
</table></div>
|
2744
|
-
</div>
|
2745
|
-
<div class="refsect3">
|
2746
|
-
<a name="id-1.4.12.6.12.43.7"></a><h4>Returns</h4>
|
2747
|
-
<p> a selected <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>. You own the returned file;
|
2748
|
-
use <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release it. </p>
|
2749
|
-
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
2750
|
-
</div>
|
2751
|
-
<p class="since">Since 2.14</p>
|
959
|
+
<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
|
2752
960
|
</div>
|
2753
961
|
<hr>
|
2754
962
|
<div class="refsect2">
|
2755
963
|
<a name="gtk-file-chooser-get-files"></a><h3>gtk_file_chooser_get_files ()</h3>
|
2756
964
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
|
2757
965
|
gtk_file_chooser_get_files (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2758
|
-
<p>
|
2759
|
-
|
2760
|
-
as <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>. An internal function, see <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uris" title="gtk_file_chooser_get_uris ()"><code class="function">gtk_file_chooser_get_uris()</code></a>.</p>
|
2761
|
-
<div class="refsect3">
|
2762
|
-
<a name="id-1.4.12.6.12.44.5"></a><h4>Parameters</h4>
|
2763
|
-
<div class="informaltable"><table width="100%" border="0">
|
2764
|
-
<colgroup>
|
2765
|
-
<col width="150px" class="parameters_name">
|
2766
|
-
<col class="parameters_description">
|
2767
|
-
<col width="200px" class="parameters_annotations">
|
2768
|
-
</colgroup>
|
2769
|
-
<tbody><tr>
|
2770
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2771
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2772
|
-
<td class="parameter_annotations"> </td>
|
2773
|
-
</tr></tbody>
|
2774
|
-
</table></div>
|
2775
|
-
</div>
|
2776
|
-
<div class="refsect3">
|
2777
|
-
<a name="id-1.4.12.6.12.44.6"></a><h4>Returns</h4>
|
2778
|
-
<p> a <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
|
2779
|
-
containing a <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> for each selected file and subfolder in the
|
2780
|
-
current folder. Free the returned list with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and
|
2781
|
-
the files with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
|
2782
|
-
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GFile][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
2783
|
-
</div>
|
2784
|
-
<p class="since">Since 2.14</p>
|
966
|
+
<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
|
2785
967
|
</div>
|
2786
968
|
<hr>
|
2787
969
|
<div class="refsect2">
|
2788
970
|
<a name="gtk-file-chooser-get-preview-file"></a><h3>gtk_file_chooser_get_preview_file ()</h3>
|
2789
|
-
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
|
971
|
+
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
|
2790
972
|
gtk_file_chooser_get_preview_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
|
2791
|
-
<p>
|
2792
|
-
Internal function, see <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-uri" title="gtk_file_chooser_get_preview_uri ()"><code class="function">gtk_file_chooser_get_preview_uri()</code></a>.</p>
|
2793
|
-
<div class="refsect3">
|
2794
|
-
<a name="id-1.4.12.6.12.45.5"></a><h4>Parameters</h4>
|
2795
|
-
<div class="informaltable"><table width="100%" border="0">
|
2796
|
-
<colgroup>
|
2797
|
-
<col width="150px" class="parameters_name">
|
2798
|
-
<col class="parameters_description">
|
2799
|
-
<col width="200px" class="parameters_annotations">
|
2800
|
-
</colgroup>
|
2801
|
-
<tbody><tr>
|
2802
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2803
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2804
|
-
<td class="parameter_annotations"> </td>
|
2805
|
-
</tr></tbody>
|
2806
|
-
</table></div>
|
2807
|
-
</div>
|
2808
|
-
<div class="refsect3">
|
2809
|
-
<a name="id-1.4.12.6.12.45.6"></a><h4>Returns</h4>
|
2810
|
-
<p> the <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> for the file to preview,
|
2811
|
-
or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is selected. Free with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
|
2812
|
-
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
2813
|
-
</div>
|
2814
|
-
<p class="since">Since 2.14</p>
|
973
|
+
<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
|
2815
974
|
</div>
|
2816
975
|
<hr>
|
2817
976
|
<div class="refsect2">
|
2818
|
-
<a name="gtk-file-chooser-select-file"></a><h3>gtk_file_chooser_select_file ()</h3>
|
2819
|
-
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2820
|
-
gtk_file_chooser_select_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2821
|
-
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
|
2822
|
-
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2823
|
-
<p>
|
2824
|
-
. An internal function. See
|
2825
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-uri" title="gtk_file_chooser_select_uri ()"><code class="function">_gtk_file_chooser_select_uri()</code></a>.</p>
|
2826
|
-
<div class="refsect3">
|
2827
|
-
<a name="id-1.4.12.6.12.46.5"></a><h4>Parameters</h4>
|
2828
|
-
<div class="informaltable"><table width="100%" border="0">
|
2829
|
-
<colgroup>
|
2830
|
-
<col width="150px" class="parameters_name">
|
2831
|
-
<col class="parameters_description">
|
2832
|
-
<col width="200px" class="parameters_annotations">
|
2833
|
-
</colgroup>
|
2834
|
-
<tbody>
|
2835
|
-
<tr>
|
2836
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2837
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2838
|
-
<td class="parameter_annotations"> </td>
|
2839
|
-
</tr>
|
2840
|
-
<tr>
|
2841
|
-
<td class="parameter_name"><p>file</p></td>
|
2842
|
-
<td class="parameter_description"><p>the file to select</p></td>
|
2843
|
-
<td class="parameter_annotations"> </td>
|
2844
|
-
</tr>
|
2845
|
-
<tr>
|
2846
|
-
<td class="parameter_name"><p>error</p></td>
|
2847
|
-
<td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
2848
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
2849
|
-
</tr>
|
2850
|
-
</tbody>
|
2851
|
-
</table></div>
|
2852
|
-
</div>
|
2853
|
-
<div class="refsect3">
|
2854
|
-
<a name="id-1.4.12.6.12.46.6"></a><h4>Returns</h4>
|
2855
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the path was
|
2856
|
-
selected successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
2857
|
-
<p></p>
|
2858
|
-
</div>
|
2859
|
-
<p class="since">Since 2.14</p>
|
977
|
+
<a name="gtk-file-chooser-select-file"></a><h3>gtk_file_chooser_select_file ()</h3>
|
978
|
+
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
979
|
+
gtk_file_chooser_select_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
980
|
+
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>,
|
981
|
+
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
982
|
+
<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
|
2860
983
|
</div>
|
2861
984
|
<hr>
|
2862
985
|
<div class="refsect2">
|
@@ -2864,174 +987,26 @@ selected successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/loc
|
|
2864
987
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2865
988
|
gtk_file_chooser_set_current_folder_file
|
2866
989
|
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2867
|
-
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
|
990
|
+
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>,
|
2868
991
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2869
|
-
<p>
|
2870
|
-
from a <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>.
|
2871
|
-
Internal function, see <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()"><code class="function">gtk_file_chooser_set_current_folder_uri()</code></a>.</p>
|
2872
|
-
<div class="refsect3">
|
2873
|
-
<a name="id-1.4.12.6.12.47.5"></a><h4>Parameters</h4>
|
2874
|
-
<div class="informaltable"><table width="100%" border="0">
|
2875
|
-
<colgroup>
|
2876
|
-
<col width="150px" class="parameters_name">
|
2877
|
-
<col class="parameters_description">
|
2878
|
-
<col width="200px" class="parameters_annotations">
|
2879
|
-
</colgroup>
|
2880
|
-
<tbody>
|
2881
|
-
<tr>
|
2882
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2883
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2884
|
-
<td class="parameter_annotations"> </td>
|
2885
|
-
</tr>
|
2886
|
-
<tr>
|
2887
|
-
<td class="parameter_name"><p>file</p></td>
|
2888
|
-
<td class="parameter_description"><p>the <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> for the new folder</p></td>
|
2889
|
-
<td class="parameter_annotations"> </td>
|
2890
|
-
</tr>
|
2891
|
-
<tr>
|
2892
|
-
<td class="parameter_name"><p>error</p></td>
|
2893
|
-
<td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
2894
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
2895
|
-
</tr>
|
2896
|
-
</tbody>
|
2897
|
-
</table></div>
|
2898
|
-
</div>
|
2899
|
-
<div class="refsect3">
|
2900
|
-
<a name="id-1.4.12.6.12.47.6"></a><h4>Returns</h4>
|
2901
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
|
2902
|
-
otherwise.</p>
|
2903
|
-
<p></p>
|
2904
|
-
</div>
|
2905
|
-
<p class="since">Since 2.14</p>
|
992
|
+
<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
|
2906
993
|
</div>
|
2907
994
|
<hr>
|
2908
995
|
<div class="refsect2">
|
2909
996
|
<a name="gtk-file-chooser-set-file"></a><h3>gtk_file_chooser_set_file ()</h3>
|
2910
997
|
<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
|
2911
998
|
gtk_file_chooser_set_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
2912
|
-
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
|
999
|
+
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>,
|
2913
1000
|
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
|
2914
|
-
<p>
|
2915
|
-
as the current filename for the file chooser, by changing
|
2916
|
-
to the file's parent folder and actually selecting the file in list. If
|
2917
|
-
the <em class="parameter"><code>chooser</code></em>
|
2918
|
-
is in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the file's base name
|
2919
|
-
will also appear in the dialog's file name entry.</p>
|
2920
|
-
<p>If the file name isn't in the current folder of <em class="parameter"><code>chooser</code></em>
|
2921
|
-
, then the current
|
2922
|
-
folder of <em class="parameter"><code>chooser</code></em>
|
2923
|
-
will be changed to the folder containing <em class="parameter"><code>filename</code></em>
|
2924
|
-
. This
|
2925
|
-
is equivalent to a sequence of <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-all" title="gtk_file_chooser_unselect_all ()"><code class="function">gtk_file_chooser_unselect_all()</code></a> followed by
|
2926
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename"><code class="function">gtk_file_chooser_select_filename()</code></a>.</p>
|
2927
|
-
<p>Note that the file must exist, or nothing will be done except
|
2928
|
-
for the directory change.</p>
|
2929
|
-
<p>If you are implementing a <span class="guimenuitem">File/Save As...</span> dialog,
|
2930
|
-
you should use this function if you already have a file name to which the
|
2931
|
-
user may save; for example, when the user opens an existing file and then
|
2932
|
-
does <span class="guimenuitem">File/Save As...</span> on it. If you don't have
|
2933
|
-
a file name already — for example, if the user just created a new
|
2934
|
-
file and is saving it for the first time, do not call this function.
|
2935
|
-
Instead, use something similar to this:</p>
|
2936
|
-
<div class="informalexample">
|
2937
|
-
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
2938
|
-
<tbody>
|
2939
|
-
<tr>
|
2940
|
-
<td class="listing_lines" align="right"><pre>1
|
2941
|
-
2
|
2942
|
-
3
|
2943
|
-
4
|
2944
|
-
5
|
2945
|
-
6
|
2946
|
-
7
|
2947
|
-
8
|
2948
|
-
9
|
2949
|
-
10
|
2950
|
-
11</pre></td>
|
2951
|
-
<td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">document_is_new</span><span class="symbol">)</span>
|
2952
|
-
<span class="normal"> </span><span class="cbracket">{</span>
|
2953
|
-
<span class="normal"> </span><span class="comment">/* the user just created a new document */</span>
|
2954
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-file">gtk_file_chooser_set_current_folder_file</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> default_file_for_saving</span><span class="symbol">);</span>
|
2955
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-name">gtk_file_chooser_set_current_name</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Untitled document"</span><span class="symbol">);</span>
|
2956
|
-
<span class="normal"> </span><span class="cbracket">}</span>
|
2957
|
-
<span class="keyword">else</span>
|
2958
|
-
<span class="normal"> </span><span class="cbracket">{</span>
|
2959
|
-
<span class="normal"> </span><span class="comment">/* the user edited an existing document */</span>
|
2960
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-file">gtk_file_chooser_set_file</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> existing_file</span><span class="symbol">);</span>
|
2961
|
-
<span class="normal"> </span><span class="cbracket">}</span></pre></td>
|
2962
|
-
</tr>
|
2963
|
-
</tbody>
|
2964
|
-
</table>
|
2965
|
-
</div>
|
2966
|
-
|
2967
|
-
<p></p>
|
2968
|
-
<div class="refsect3">
|
2969
|
-
<a name="id-1.4.12.6.12.48.10"></a><h4>Parameters</h4>
|
2970
|
-
<div class="informaltable"><table width="100%" border="0">
|
2971
|
-
<colgroup>
|
2972
|
-
<col width="150px" class="parameters_name">
|
2973
|
-
<col class="parameters_description">
|
2974
|
-
<col width="200px" class="parameters_annotations">
|
2975
|
-
</colgroup>
|
2976
|
-
<tbody>
|
2977
|
-
<tr>
|
2978
|
-
<td class="parameter_name"><p>chooser</p></td>
|
2979
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
2980
|
-
<td class="parameter_annotations"> </td>
|
2981
|
-
</tr>
|
2982
|
-
<tr>
|
2983
|
-
<td class="parameter_name"><p>file</p></td>
|
2984
|
-
<td class="parameter_description"><p>the <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> to set as current</p></td>
|
2985
|
-
<td class="parameter_annotations"> </td>
|
2986
|
-
</tr>
|
2987
|
-
<tr>
|
2988
|
-
<td class="parameter_name"><p>error</p></td>
|
2989
|
-
<td class="parameter_description"><p> location to store the error, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors. </p></td>
|
2990
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
2991
|
-
</tr>
|
2992
|
-
</tbody>
|
2993
|
-
</table></div>
|
2994
|
-
</div>
|
2995
|
-
<div class="refsect3">
|
2996
|
-
<a name="id-1.4.12.6.12.48.11"></a><h4>Returns</h4>
|
2997
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
|
2998
|
-
selected successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
2999
|
-
<p></p>
|
3000
|
-
</div>
|
3001
|
-
<p class="since">Since 2.14</p>
|
1001
|
+
<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
|
3002
1002
|
</div>
|
3003
1003
|
<hr>
|
3004
1004
|
<div class="refsect2">
|
3005
1005
|
<a name="gtk-file-chooser-unselect-file"></a><h3>gtk_file_chooser_unselect_file ()</h3>
|
3006
1006
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
3007
1007
|
gtk_file_chooser_unselect_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
|
3008
|
-
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *file</code></em>);</pre>
|
3009
|
-
<p>
|
3010
|
-
. If the file is not in the current
|
3011
|
-
directory, does not exist, or is otherwise not currently selected, does nothing.</p>
|
3012
|
-
<div class="refsect3">
|
3013
|
-
<a name="id-1.4.12.6.12.49.5"></a><h4>Parameters</h4>
|
3014
|
-
<div class="informaltable"><table width="100%" border="0">
|
3015
|
-
<colgroup>
|
3016
|
-
<col width="150px" class="parameters_name">
|
3017
|
-
<col class="parameters_description">
|
3018
|
-
<col width="200px" class="parameters_annotations">
|
3019
|
-
</colgroup>
|
3020
|
-
<tbody>
|
3021
|
-
<tr>
|
3022
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3023
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3024
|
-
<td class="parameter_annotations"> </td>
|
3025
|
-
</tr>
|
3026
|
-
<tr>
|
3027
|
-
<td class="parameter_name"><p>file</p></td>
|
3028
|
-
<td class="parameter_description"><p>a <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a></p></td>
|
3029
|
-
<td class="parameter_annotations"> </td>
|
3030
|
-
</tr>
|
3031
|
-
</tbody>
|
3032
|
-
</table></div>
|
3033
|
-
</div>
|
3034
|
-
<p class="since">Since 2.14</p>
|
1008
|
+
<em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>);</pre>
|
1009
|
+
<p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
|
3035
1010
|
</div>
|
3036
1011
|
</div>
|
3037
1012
|
<div class="refsect1">
|
@@ -3039,16 +1014,12 @@ directory, does not exist, or is otherwise not currently selected, does nothing.
|
|
3039
1014
|
<div class="refsect2">
|
3040
1015
|
<a name="GtkFileChooser-struct"></a><h3>GtkFileChooser</h3>
|
3041
1016
|
<pre class="programlisting">typedef struct _GtkFileChooser GtkFileChooser;</pre>
|
3042
|
-
<p>
|
3043
|
-
</p>
|
3044
1017
|
</div>
|
3045
1018
|
<hr>
|
3046
1019
|
<div class="refsect2">
|
3047
1020
|
<a name="GtkFileChooserAction"></a><h3>enum GtkFileChooserAction</h3>
|
3048
|
-
<p>Describes whether a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> is being used to open existing files
|
3049
|
-
or to save to a possibly new file.</p>
|
3050
1021
|
<div class="refsect3">
|
3051
|
-
<a name="
|
1022
|
+
<a name="GtkFileChooserAction.members"></a><h4>Members</h4>
|
3052
1023
|
<div class="informaltable"><table width="100%" border="0">
|
3053
1024
|
<colgroup>
|
3054
1025
|
<col width="300px" class="enum_members_name">
|
@@ -3058,38 +1029,23 @@ or to save to a possibly new file.</p>
|
|
3058
1029
|
<tbody>
|
3059
1030
|
<tr>
|
3060
1031
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"></a>GTK_FILE_CHOOSER_ACTION_OPEN</p></td>
|
3061
|
-
<td
|
3062
|
-
<
|
3063
|
-
will only let the user pick an existing file.</p>
|
3064
|
-
</td>
|
3065
|
-
<td class="enum_member_annotations"> </td>
|
1032
|
+
<td> </td>
|
1033
|
+
<td> </td>
|
3066
1034
|
</tr>
|
3067
1035
|
<tr>
|
3068
1036
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"></a>GTK_FILE_CHOOSER_ACTION_SAVE</p></td>
|
3069
|
-
<td
|
3070
|
-
<
|
3071
|
-
will let the user pick an existing file, or type in a new
|
3072
|
-
filename.</p>
|
3073
|
-
</td>
|
3074
|
-
<td class="enum_member_annotations"> </td>
|
1037
|
+
<td> </td>
|
1038
|
+
<td> </td>
|
3075
1039
|
</tr>
|
3076
1040
|
<tr>
|
3077
1041
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"></a>GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</p></td>
|
3078
|
-
<td
|
3079
|
-
<
|
3080
|
-
selecting folders. The file chooser will let the user pick an
|
3081
|
-
existing folder.</p>
|
3082
|
-
</td>
|
3083
|
-
<td class="enum_member_annotations"> </td>
|
1042
|
+
<td> </td>
|
1043
|
+
<td> </td>
|
3084
1044
|
</tr>
|
3085
1045
|
<tr>
|
3086
1046
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-CREATE-FOLDER:CAPS"></a>GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER</p></td>
|
3087
|
-
<td
|
3088
|
-
<
|
3089
|
-
new folder. The file chooser will let the user name an existing or
|
3090
|
-
new folder.</p>
|
3091
|
-
</td>
|
3092
|
-
<td class="enum_member_annotations"> </td>
|
1047
|
+
<td> </td>
|
1048
|
+
<td> </td>
|
3093
1049
|
</tr>
|
3094
1050
|
</tbody>
|
3095
1051
|
</table></div>
|
@@ -3098,13 +1054,8 @@ or to save to a possibly new file.</p>
|
|
3098
1054
|
<hr>
|
3099
1055
|
<div class="refsect2">
|
3100
1056
|
<a name="GtkFileChooserConfirmation"></a><h3>enum GtkFileChooserConfirmation</h3>
|
3101
|
-
<p>Used as a return value of handlers for the
|
3102
|
-
<a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal"><span class="type">“confirm-overwrite”</span></a> signal of a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>. This
|
3103
|
-
value determines whether the file chooser will present the stock
|
3104
|
-
confirmation dialog, accept the user's choice of a filename, or
|
3105
|
-
let the user choose another filename.</p>
|
3106
1057
|
<div class="refsect3">
|
3107
|
-
<a name="
|
1058
|
+
<a name="GtkFileChooserConfirmation.members"></a><h4>Members</h4>
|
3108
1059
|
<div class="informaltable"><table width="100%" border="0">
|
3109
1060
|
<colgroup>
|
3110
1061
|
<col width="300px" class="enum_members_name">
|
@@ -3114,40 +1065,35 @@ let the user choose another filename.</p>
|
|
3114
1065
|
<tbody>
|
3115
1066
|
<tr>
|
3116
1067
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-CONFIRMATION-CONFIRM:CAPS"></a>GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM</p></td>
|
3117
|
-
<td
|
3118
|
-
<
|
3119
|
-
its stock dialog to confirm about overwriting an existing file.</p>
|
3120
|
-
</td>
|
3121
|
-
<td class="enum_member_annotations"> </td>
|
1068
|
+
<td> </td>
|
1069
|
+
<td> </td>
|
3122
1070
|
</tr>
|
3123
1071
|
<tr>
|
3124
1072
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-CONFIRMATION-ACCEPT-FILENAME:CAPS"></a>GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME</p></td>
|
3125
|
-
<td
|
3126
|
-
<
|
3127
|
-
terminate and accept the user's choice of a file name.</p>
|
3128
|
-
</td>
|
3129
|
-
<td class="enum_member_annotations"> </td>
|
1073
|
+
<td> </td>
|
1074
|
+
<td> </td>
|
3130
1075
|
</tr>
|
3131
1076
|
<tr>
|
3132
1077
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-CONFIRMATION-SELECT-AGAIN:CAPS"></a>GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN</p></td>
|
3133
|
-
<td
|
3134
|
-
<
|
3135
|
-
continue running, so as to let the user select another file name.</p>
|
3136
|
-
</td>
|
3137
|
-
<td class="enum_member_annotations"> </td>
|
1078
|
+
<td> </td>
|
1079
|
+
<td> </td>
|
3138
1080
|
</tr>
|
3139
1081
|
</tbody>
|
3140
1082
|
</table></div>
|
3141
1083
|
</div>
|
3142
|
-
<p class="since">Since 2.8</p>
|
1084
|
+
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
|
1085
|
+
</div>
|
1086
|
+
<hr>
|
1087
|
+
<div class="refsect2">
|
1088
|
+
<a name="GTK-FILE-CHOOSER-ERROR:CAPS"></a><h3>GTK_FILE_CHOOSER_ERROR</h3>
|
1089
|
+
<pre class="programlisting">#define GTK_FILE_CHOOSER_ERROR (gtk_file_chooser_error_quark ())
|
1090
|
+
</pre>
|
3143
1091
|
</div>
|
3144
1092
|
<hr>
|
3145
1093
|
<div class="refsect2">
|
3146
1094
|
<a name="GtkFileChooserError"></a><h3>enum GtkFileChooserError</h3>
|
3147
|
-
<p>These identify the various errors that can occur while calling
|
3148
|
-
<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> functions.</p>
|
3149
1095
|
<div class="refsect3">
|
3150
|
-
<a name="
|
1096
|
+
<a name="GtkFileChooserError.members"></a><h4>Members</h4>
|
3151
1097
|
<div class="informaltable"><table width="100%" border="0">
|
3152
1098
|
<colgroup>
|
3153
1099
|
<col width="300px" class="enum_members_name">
|
@@ -3157,32 +1103,23 @@ let the user choose another filename.</p>
|
|
3157
1103
|
<tbody>
|
3158
1104
|
<tr>
|
3159
1105
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-NONEXISTENT:CAPS"></a>GTK_FILE_CHOOSER_ERROR_NONEXISTENT</p></td>
|
3160
|
-
<td
|
3161
|
-
<
|
3162
|
-
</td>
|
3163
|
-
<td class="enum_member_annotations"> </td>
|
1106
|
+
<td> </td>
|
1107
|
+
<td> </td>
|
3164
1108
|
</tr>
|
3165
1109
|
<tr>
|
3166
1110
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-BAD-FILENAME:CAPS"></a>GTK_FILE_CHOOSER_ERROR_BAD_FILENAME</p></td>
|
3167
|
-
<td
|
3168
|
-
<
|
3169
|
-
</td>
|
3170
|
-
<td class="enum_member_annotations"> </td>
|
1111
|
+
<td> </td>
|
1112
|
+
<td> </td>
|
3171
1113
|
</tr>
|
3172
1114
|
<tr>
|
3173
1115
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-ALREADY-EXISTS:CAPS"></a>GTK_FILE_CHOOSER_ERROR_ALREADY_EXISTS</p></td>
|
3174
|
-
<td
|
3175
|
-
<
|
3176
|
-
adding a bookmark).</p>
|
3177
|
-
</td>
|
3178
|
-
<td class="enum_member_annotations"> </td>
|
1116
|
+
<td> </td>
|
1117
|
+
<td> </td>
|
3179
1118
|
</tr>
|
3180
1119
|
<tr>
|
3181
1120
|
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-INCOMPLETE-HOSTNAME:CAPS"></a>GTK_FILE_CHOOSER_ERROR_INCOMPLETE_HOSTNAME</p></td>
|
3182
|
-
<td
|
3183
|
-
<
|
3184
|
-
</td>
|
3185
|
-
<td class="enum_member_annotations"> </td>
|
1121
|
+
<td> </td>
|
1122
|
+
<td> </td>
|
3186
1123
|
</tr>
|
3187
1124
|
</tbody>
|
3188
1125
|
</table></div>
|
@@ -3193,463 +1130,77 @@ let the user choose another filename.</p>
|
|
3193
1130
|
<a name="gtk-file-chooser-get-filename"></a><h3>gtk_file_chooser_get_filename</h3>
|
3194
1131
|
<pre class="programlisting">#define gtk_file_chooser_get_filename gtk_file_chooser_get_filename_utf8
|
3195
1132
|
</pre>
|
3196
|
-
<p>
|
3197
|
-
the file selector. If multiple files are selected,
|
3198
|
-
one of the filenames will be returned at random.</p>
|
3199
|
-
<p>If the file chooser is in folder mode, this function returns the selected
|
3200
|
-
folder.</p>
|
3201
|
-
<div class="refsect3">
|
3202
|
-
<a name="id-1.4.12.6.13.6.6"></a><h4>Parameters</h4>
|
3203
|
-
<div class="informaltable"><table width="100%" border="0">
|
3204
|
-
<colgroup>
|
3205
|
-
<col width="150px" class="parameters_name">
|
3206
|
-
<col class="parameters_description">
|
3207
|
-
<col width="200px" class="parameters_annotations">
|
3208
|
-
</colgroup>
|
3209
|
-
<tbody><tr>
|
3210
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3211
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3212
|
-
<td class="parameter_annotations"> </td>
|
3213
|
-
</tr></tbody>
|
3214
|
-
</table></div>
|
3215
|
-
</div>
|
3216
|
-
<div class="refsect3">
|
3217
|
-
<a name="id-1.4.12.6.13.6.7"></a><h4>Returns</h4>
|
3218
|
-
<p> The currently selected filename, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
|
3219
|
-
if no file is selected, or the selected file can't
|
3220
|
-
be represented with a local filename. Free with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
|
3221
|
-
<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p>
|
3222
|
-
</div>
|
3223
|
-
<p class="since">Since 2.4</p>
|
1133
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3224
1134
|
</div>
|
3225
1135
|
<hr>
|
3226
1136
|
<div class="refsect2">
|
3227
1137
|
<a name="gtk-file-chooser-set-filename"></a><h3>gtk_file_chooser_set_filename</h3>
|
3228
1138
|
<pre class="programlisting">#define gtk_file_chooser_set_filename gtk_file_chooser_set_filename_utf8
|
3229
1139
|
</pre>
|
3230
|
-
<p>
|
3231
|
-
as the current filename for the file chooser, by changing
|
3232
|
-
to the file's parent folder and actually selecting the file in list. If
|
3233
|
-
the <em class="parameter"><code>chooser</code></em>
|
3234
|
-
is in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the file's base name
|
3235
|
-
will also appear in the dialog's file name entry.</p>
|
3236
|
-
<p>If the file name isn't in the current folder of <em class="parameter"><code>chooser</code></em>
|
3237
|
-
, then the current
|
3238
|
-
folder of <em class="parameter"><code>chooser</code></em>
|
3239
|
-
will be changed to the folder containing <em class="parameter"><code>filename</code></em>
|
3240
|
-
. This
|
3241
|
-
is equivalent to a sequence of <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-all" title="gtk_file_chooser_unselect_all ()"><code class="function">gtk_file_chooser_unselect_all()</code></a> followed by
|
3242
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename"><code class="function">gtk_file_chooser_select_filename()</code></a>.</p>
|
3243
|
-
<p>Note that the file must exist, or nothing will be done except
|
3244
|
-
for the directory change.</p>
|
3245
|
-
<p>If you are implementing a <span class="guimenuitem">File/Save As...</span> dialog,
|
3246
|
-
you should use this function if you already have a file name to which the
|
3247
|
-
user may save; for example, when the user opens an existing file and then
|
3248
|
-
does <span class="guimenuitem">File/Save As...</span> on it. If you don't have
|
3249
|
-
a file name already — for example, if the user just created a new
|
3250
|
-
file and is saving it for the first time, do not call this function.
|
3251
|
-
Instead, use something similar to this:</p>
|
3252
|
-
<div class="informalexample">
|
3253
|
-
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
3254
|
-
<tbody>
|
3255
|
-
<tr>
|
3256
|
-
<td class="listing_lines" align="right"><pre>1
|
3257
|
-
2
|
3258
|
-
3
|
3259
|
-
4
|
3260
|
-
5
|
3261
|
-
6
|
3262
|
-
7
|
3263
|
-
8
|
3264
|
-
9
|
3265
|
-
10
|
3266
|
-
11</pre></td>
|
3267
|
-
<td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">document_is_new</span><span class="symbol">)</span>
|
3268
|
-
<span class="normal"> </span><span class="cbracket">{</span>
|
3269
|
-
<span class="normal"> </span><span class="comment">/* the user just created a new document */</span>
|
3270
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-folder">gtk_file_chooser_set_current_folder</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> default_folder_for_saving</span><span class="symbol">);</span>
|
3271
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-name">gtk_file_chooser_set_current_name</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Untitled document"</span><span class="symbol">);</span>
|
3272
|
-
<span class="normal"> </span><span class="cbracket">}</span>
|
3273
|
-
<span class="keyword">else</span>
|
3274
|
-
<span class="normal"> </span><span class="cbracket">{</span>
|
3275
|
-
<span class="normal"> </span><span class="comment">/* the user edited an existing document */</span><span class="normal"> </span>
|
3276
|
-
<span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-filename">gtk_file_chooser_set_filename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> existing_filename</span><span class="symbol">);</span>
|
3277
|
-
<span class="normal"> </span><span class="cbracket">}</span></pre></td>
|
3278
|
-
</tr>
|
3279
|
-
</tbody>
|
3280
|
-
</table>
|
3281
|
-
</div>
|
3282
|
-
|
3283
|
-
<p></p>
|
3284
|
-
<div class="refsect3">
|
3285
|
-
<a name="id-1.4.12.6.13.7.10"></a><h4>Parameters</h4>
|
3286
|
-
<div class="informaltable"><table width="100%" border="0">
|
3287
|
-
<colgroup>
|
3288
|
-
<col width="150px" class="parameters_name">
|
3289
|
-
<col class="parameters_description">
|
3290
|
-
<col width="200px" class="parameters_annotations">
|
3291
|
-
</colgroup>
|
3292
|
-
<tbody>
|
3293
|
-
<tr>
|
3294
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3295
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3296
|
-
<td class="parameter_annotations"> </td>
|
3297
|
-
</tr>
|
3298
|
-
<tr>
|
3299
|
-
<td class="parameter_name"><p>filename</p></td>
|
3300
|
-
<td class="parameter_description"><p> the filename to set as current. </p></td>
|
3301
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
3302
|
-
</tr>
|
3303
|
-
</tbody>
|
3304
|
-
</table></div>
|
3305
|
-
</div>
|
3306
|
-
<div class="refsect3">
|
3307
|
-
<a name="id-1.4.12.6.13.7.11"></a><h4>Returns</h4>
|
3308
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
|
3309
|
-
selected successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
3310
|
-
<p></p>
|
3311
|
-
</div>
|
3312
|
-
<p class="since">Since 2.4</p>
|
1140
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3313
1141
|
</div>
|
3314
1142
|
<hr>
|
3315
1143
|
<div class="refsect2">
|
3316
1144
|
<a name="gtk-file-chooser-select-filename"></a><h3>gtk_file_chooser_select_filename</h3>
|
3317
1145
|
<pre class="programlisting">#define gtk_file_chooser_select_filename gtk_file_chooser_select_filename_utf8
|
3318
1146
|
</pre>
|
3319
|
-
<p>
|
3320
|
-
folder of <em class="parameter"><code>chooser</code></em>
|
3321
|
-
, then the current folder of <em class="parameter"><code>chooser</code></em>
|
3322
|
-
will
|
3323
|
-
be changed to the folder containing <em class="parameter"><code>filename</code></em>
|
3324
|
-
.</p>
|
3325
|
-
<div class="refsect3">
|
3326
|
-
<a name="id-1.4.12.6.13.8.5"></a><h4>Parameters</h4>
|
3327
|
-
<div class="informaltable"><table width="100%" border="0">
|
3328
|
-
<colgroup>
|
3329
|
-
<col width="150px" class="parameters_name">
|
3330
|
-
<col class="parameters_description">
|
3331
|
-
<col width="200px" class="parameters_annotations">
|
3332
|
-
</colgroup>
|
3333
|
-
<tbody>
|
3334
|
-
<tr>
|
3335
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3336
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3337
|
-
<td class="parameter_annotations"> </td>
|
3338
|
-
</tr>
|
3339
|
-
<tr>
|
3340
|
-
<td class="parameter_name"><p>filename</p></td>
|
3341
|
-
<td class="parameter_description"><p> the filename to select. </p></td>
|
3342
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
3343
|
-
</tr>
|
3344
|
-
</tbody>
|
3345
|
-
</table></div>
|
3346
|
-
</div>
|
3347
|
-
<div class="refsect3">
|
3348
|
-
<a name="id-1.4.12.6.13.8.6"></a><h4>Returns</h4>
|
3349
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
|
3350
|
-
selected successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
|
3351
|
-
<p></p>
|
3352
|
-
</div>
|
3353
|
-
<p class="since">Since 2.4</p>
|
1147
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3354
1148
|
</div>
|
3355
1149
|
<hr>
|
3356
1150
|
<div class="refsect2">
|
3357
1151
|
<a name="gtk-file-chooser-unselect-filename"></a><h3>gtk_file_chooser_unselect_filename</h3>
|
3358
1152
|
<pre class="programlisting">#define gtk_file_chooser_unselect_filename gtk_file_chooser_unselect_filename_utf8
|
3359
1153
|
</pre>
|
3360
|
-
<p>
|
3361
|
-
is not in the current directory, does not exist, or
|
3362
|
-
is otherwise not currently selected, does nothing.</p>
|
3363
|
-
<div class="refsect3">
|
3364
|
-
<a name="id-1.4.12.6.13.9.5"></a><h4>Parameters</h4>
|
3365
|
-
<div class="informaltable"><table width="100%" border="0">
|
3366
|
-
<colgroup>
|
3367
|
-
<col width="150px" class="parameters_name">
|
3368
|
-
<col class="parameters_description">
|
3369
|
-
<col width="200px" class="parameters_annotations">
|
3370
|
-
</colgroup>
|
3371
|
-
<tbody>
|
3372
|
-
<tr>
|
3373
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3374
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3375
|
-
<td class="parameter_annotations"> </td>
|
3376
|
-
</tr>
|
3377
|
-
<tr>
|
3378
|
-
<td class="parameter_name"><p>filename</p></td>
|
3379
|
-
<td class="parameter_description"><p> the filename to unselect. </p></td>
|
3380
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
3381
|
-
</tr>
|
3382
|
-
</tbody>
|
3383
|
-
</table></div>
|
3384
|
-
</div>
|
3385
|
-
<p class="since">Since 2.4</p>
|
1154
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3386
1155
|
</div>
|
3387
1156
|
<hr>
|
3388
1157
|
<div class="refsect2">
|
3389
1158
|
<a name="gtk-file-chooser-get-filenames"></a><h3>gtk_file_chooser_get_filenames</h3>
|
3390
1159
|
<pre class="programlisting">#define gtk_file_chooser_get_filenames gtk_file_chooser_get_filenames_utf8
|
3391
1160
|
</pre>
|
3392
|
-
<p>
|
3393
|
-
<em class="parameter"><code>chooser</code></em>
|
3394
|
-
. The returned names are full absolute paths. If files in the current
|
3395
|
-
folder cannot be represented as local filenames they will be ignored. (See
|
3396
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uris" title="gtk_file_chooser_get_uris ()"><code class="function">gtk_file_chooser_get_uris()</code></a>)</p>
|
3397
|
-
<div class="refsect3">
|
3398
|
-
<a name="id-1.4.12.6.13.10.5"></a><h4>Parameters</h4>
|
3399
|
-
<div class="informaltable"><table width="100%" border="0">
|
3400
|
-
<colgroup>
|
3401
|
-
<col width="150px" class="parameters_name">
|
3402
|
-
<col class="parameters_description">
|
3403
|
-
<col width="200px" class="parameters_annotations">
|
3404
|
-
</colgroup>
|
3405
|
-
<tbody><tr>
|
3406
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3407
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3408
|
-
<td class="parameter_annotations"> </td>
|
3409
|
-
</tr></tbody>
|
3410
|
-
</table></div>
|
3411
|
-
</div>
|
3412
|
-
<div class="refsect3">
|
3413
|
-
<a name="id-1.4.12.6.13.10.6"></a><h4>Returns</h4>
|
3414
|
-
<p> a <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
|
3415
|
-
containing the filenames of all selected files and subfolders in
|
3416
|
-
the current folder. Free the returned list with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>,
|
3417
|
-
and the filenames with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
|
3418
|
-
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
3419
|
-
</div>
|
3420
|
-
<p class="since">Since 2.4</p>
|
1161
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3421
1162
|
</div>
|
3422
1163
|
<hr>
|
3423
1164
|
<div class="refsect2">
|
3424
1165
|
<a name="gtk-file-chooser-set-current-folder"></a><h3>gtk_file_chooser_set_current_folder</h3>
|
3425
1166
|
<pre class="programlisting">#define gtk_file_chooser_set_current_folder gtk_file_chooser_set_current_folder_utf8
|
3426
1167
|
</pre>
|
3427
|
-
<p>
|
3428
|
-
from a local filename.
|
3429
|
-
The user will be shown the full contents of the current folder,
|
3430
|
-
plus user interface elements for navigating to other folders.</p>
|
3431
|
-
<div class="refsect3">
|
3432
|
-
<a name="id-1.4.12.6.13.11.5"></a><h4>Parameters</h4>
|
3433
|
-
<div class="informaltable"><table width="100%" border="0">
|
3434
|
-
<colgroup>
|
3435
|
-
<col width="150px" class="parameters_name">
|
3436
|
-
<col class="parameters_description">
|
3437
|
-
<col width="200px" class="parameters_annotations">
|
3438
|
-
</colgroup>
|
3439
|
-
<tbody>
|
3440
|
-
<tr>
|
3441
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3442
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3443
|
-
<td class="parameter_annotations"> </td>
|
3444
|
-
</tr>
|
3445
|
-
<tr>
|
3446
|
-
<td class="parameter_name"><p>filename</p></td>
|
3447
|
-
<td class="parameter_description"><p> the full path of the new current folder. </p></td>
|
3448
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
3449
|
-
</tr>
|
3450
|
-
</tbody>
|
3451
|
-
</table></div>
|
3452
|
-
</div>
|
3453
|
-
<div class="refsect3">
|
3454
|
-
<a name="id-1.4.12.6.13.11.6"></a><h4>Returns</h4>
|
3455
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
|
3456
|
-
otherwise.</p>
|
3457
|
-
<p></p>
|
3458
|
-
</div>
|
3459
|
-
<p class="since">Since 2.4</p>
|
1168
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3460
1169
|
</div>
|
3461
1170
|
<hr>
|
3462
1171
|
<div class="refsect2">
|
3463
1172
|
<a name="gtk-file-chooser-get-current-folder"></a><h3>gtk_file_chooser_get_current_folder</h3>
|
3464
1173
|
<pre class="programlisting">#define gtk_file_chooser_get_current_folder gtk_file_chooser_get_current_folder_utf8
|
3465
1174
|
</pre>
|
3466
|
-
<p>
|
3467
|
-
as a local filename.
|
3468
|
-
See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder"><code class="function">gtk_file_chooser_set_current_folder()</code></a>.</p>
|
3469
|
-
<p>Note that this is the folder that the file chooser is currently displaying
|
3470
|
-
(e.g. "/home/username/Documents"), which is <span class="emphasis"><em>not the same</em></span>
|
3471
|
-
as the currently-selected folder if the chooser is in
|
3472
|
-
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a> mode
|
3473
|
-
(e.g. "/home/username/Documents/selected-folder/". To get the
|
3474
|
-
currently-selected folder in that mode, use <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a> as the
|
3475
|
-
usual way to get the selection.</p>
|
3476
|
-
<div class="refsect3">
|
3477
|
-
<a name="id-1.4.12.6.13.12.6"></a><h4>Parameters</h4>
|
3478
|
-
<div class="informaltable"><table width="100%" border="0">
|
3479
|
-
<colgroup>
|
3480
|
-
<col width="150px" class="parameters_name">
|
3481
|
-
<col class="parameters_description">
|
3482
|
-
<col width="200px" class="parameters_annotations">
|
3483
|
-
</colgroup>
|
3484
|
-
<tbody><tr>
|
3485
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3486
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3487
|
-
<td class="parameter_annotations"> </td>
|
3488
|
-
</tr></tbody>
|
3489
|
-
</table></div>
|
3490
|
-
</div>
|
3491
|
-
<div class="refsect3">
|
3492
|
-
<a name="id-1.4.12.6.13.12.7"></a><h4>Returns</h4>
|
3493
|
-
<p> the full path of the current folder,
|
3494
|
-
or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the current path cannot be represented as a local
|
3495
|
-
filename. Free with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. This function will also return
|
3496
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the file chooser was unable to load the last folder that
|
3497
|
-
was requested from it; for example, as would be for calling
|
3498
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder"><code class="function">gtk_file_chooser_set_current_folder()</code></a> on a nonexistent folder. </p>
|
3499
|
-
<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p>
|
3500
|
-
</div>
|
3501
|
-
<p class="since">Since 2.4</p>
|
1175
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3502
1176
|
</div>
|
3503
1177
|
<hr>
|
3504
1178
|
<div class="refsect2">
|
3505
1179
|
<a name="gtk-file-chooser-get-preview-filename"></a><h3>gtk_file_chooser_get_preview_filename</h3>
|
3506
1180
|
<pre class="programlisting">#define gtk_file_chooser_get_preview_filename gtk_file_chooser_get_preview_filename_utf8
|
3507
1181
|
</pre>
|
3508
|
-
<p>
|
3509
|
-
widget. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a>.</p>
|
3510
|
-
<div class="refsect3">
|
3511
|
-
<a name="id-1.4.12.6.13.13.5"></a><h4>Parameters</h4>
|
3512
|
-
<div class="informaltable"><table width="100%" border="0">
|
3513
|
-
<colgroup>
|
3514
|
-
<col width="150px" class="parameters_name">
|
3515
|
-
<col class="parameters_description">
|
3516
|
-
<col width="200px" class="parameters_annotations">
|
3517
|
-
</colgroup>
|
3518
|
-
<tbody><tr>
|
3519
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3520
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3521
|
-
<td class="parameter_annotations"> </td>
|
3522
|
-
</tr></tbody>
|
3523
|
-
</table></div>
|
3524
|
-
</div>
|
3525
|
-
<div class="refsect3">
|
3526
|
-
<a name="id-1.4.12.6.13.13.6"></a><h4>Returns</h4>
|
3527
|
-
<p> the filename to preview, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
|
3528
|
-
no file is selected, or if the selected file cannot be represented
|
3529
|
-
as a local filename. Free with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
|
3530
|
-
<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p>
|
3531
|
-
</div>
|
3532
|
-
<p class="since">Since 2.4</p>
|
1182
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3533
1183
|
</div>
|
3534
1184
|
<hr>
|
3535
1185
|
<div class="refsect2">
|
3536
1186
|
<a name="gtk-file-chooser-add-shortcut-folder"></a><h3>gtk_file_chooser_add_shortcut_folder</h3>
|
3537
1187
|
<pre class="programlisting">#define gtk_file_chooser_add_shortcut_folder gtk_file_chooser_add_shortcut_folder_utf8
|
3538
1188
|
</pre>
|
3539
|
-
<p>
|
3540
|
-
Note that shortcut folders do not get saved, as they are provided by the
|
3541
|
-
application. For example, you can use this to add a
|
3542
|
-
"/usr/share/mydrawprogram/Clipart" folder to the volume list.</p>
|
3543
|
-
<div class="refsect3">
|
3544
|
-
<a name="id-1.4.12.6.13.14.5"></a><h4>Parameters</h4>
|
3545
|
-
<div class="informaltable"><table width="100%" border="0">
|
3546
|
-
<colgroup>
|
3547
|
-
<col width="150px" class="parameters_name">
|
3548
|
-
<col class="parameters_description">
|
3549
|
-
<col width="200px" class="parameters_annotations">
|
3550
|
-
</colgroup>
|
3551
|
-
<tbody>
|
3552
|
-
<tr>
|
3553
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3554
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3555
|
-
<td class="parameter_annotations"> </td>
|
3556
|
-
</tr>
|
3557
|
-
<tr>
|
3558
|
-
<td class="parameter_name"><p>folder</p></td>
|
3559
|
-
<td class="parameter_description"><p> filename of the folder to add. </p></td>
|
3560
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
3561
|
-
</tr>
|
3562
|
-
<tr>
|
3563
|
-
<td class="parameter_name"><p>error</p></td>
|
3564
|
-
<td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
3565
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
3566
|
-
</tr>
|
3567
|
-
</tbody>
|
3568
|
-
</table></div>
|
3569
|
-
</div>
|
3570
|
-
<div class="refsect3">
|
3571
|
-
<a name="id-1.4.12.6.13.14.6"></a><h4>Returns</h4>
|
3572
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be added successfully, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
|
3573
|
-
otherwise. In the latter case, the <em class="parameter"><code>error</code></em>
|
3574
|
-
will be set as appropriate.</p>
|
3575
|
-
<p></p>
|
3576
|
-
</div>
|
3577
|
-
<p class="since">Since 2.4</p>
|
1189
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3578
1190
|
</div>
|
3579
1191
|
<hr>
|
3580
1192
|
<div class="refsect2">
|
3581
1193
|
<a name="gtk-file-chooser-remove-shortcut-folder"></a><h3>gtk_file_chooser_remove_shortcut_folder</h3>
|
3582
1194
|
<pre class="programlisting">#define gtk_file_chooser_remove_shortcut_folder gtk_file_chooser_remove_shortcut_folder_utf8
|
3583
1195
|
</pre>
|
3584
|
-
<p>
|
3585
|
-
<div class="refsect3">
|
3586
|
-
<a name="id-1.4.12.6.13.15.5"></a><h4>Parameters</h4>
|
3587
|
-
<div class="informaltable"><table width="100%" border="0">
|
3588
|
-
<colgroup>
|
3589
|
-
<col width="150px" class="parameters_name">
|
3590
|
-
<col class="parameters_description">
|
3591
|
-
<col width="200px" class="parameters_annotations">
|
3592
|
-
</colgroup>
|
3593
|
-
<tbody>
|
3594
|
-
<tr>
|
3595
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3596
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3597
|
-
<td class="parameter_annotations"> </td>
|
3598
|
-
</tr>
|
3599
|
-
<tr>
|
3600
|
-
<td class="parameter_name"><p>folder</p></td>
|
3601
|
-
<td class="parameter_description"><p> filename of the folder to remove. </p></td>
|
3602
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
|
3603
|
-
</tr>
|
3604
|
-
<tr>
|
3605
|
-
<td class="parameter_name"><p>error</p></td>
|
3606
|
-
<td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
|
3607
|
-
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
3608
|
-
</tr>
|
3609
|
-
</tbody>
|
3610
|
-
</table></div>
|
3611
|
-
</div>
|
3612
|
-
<div class="refsect3">
|
3613
|
-
<a name="id-1.4.12.6.13.15.6"></a><h4>Returns</h4>
|
3614
|
-
<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeds, <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
|
3615
|
-
In the latter case, the <em class="parameter"><code>error</code></em>
|
3616
|
-
will be set as appropriate.</p>
|
3617
|
-
<p>See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder" title="gtk_file_chooser_add_shortcut_folder"><code class="function">gtk_file_chooser_add_shortcut_folder()</code></a></p>
|
3618
|
-
<p></p>
|
3619
|
-
</div>
|
3620
|
-
<p class="since">Since 2.4</p>
|
1196
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3621
1197
|
</div>
|
3622
1198
|
<hr>
|
3623
1199
|
<div class="refsect2">
|
3624
1200
|
<a name="gtk-file-chooser-list-shortcut-folders"></a><h3>gtk_file_chooser_list_shortcut_folders</h3>
|
3625
1201
|
<pre class="programlisting">#define gtk_file_chooser_list_shortcut_folders gtk_file_chooser_list_shortcut_folders_utf8
|
3626
1202
|
</pre>
|
3627
|
-
<p>
|
3628
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder" title="gtk_file_chooser_add_shortcut_folder"><code class="function">gtk_file_chooser_add_shortcut_folder()</code></a>.</p>
|
3629
|
-
<div class="refsect3">
|
3630
|
-
<a name="id-1.4.12.6.13.16.5"></a><h4>Parameters</h4>
|
3631
|
-
<div class="informaltable"><table width="100%" border="0">
|
3632
|
-
<colgroup>
|
3633
|
-
<col width="150px" class="parameters_name">
|
3634
|
-
<col class="parameters_description">
|
3635
|
-
<col width="200px" class="parameters_annotations">
|
3636
|
-
</colgroup>
|
3637
|
-
<tbody><tr>
|
3638
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3639
|
-
<td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
|
3640
|
-
<td class="parameter_annotations"> </td>
|
3641
|
-
</tr></tbody>
|
3642
|
-
</table></div>
|
3643
|
-
</div>
|
3644
|
-
<div class="refsect3">
|
3645
|
-
<a name="id-1.4.12.6.13.16.6"></a><h4>Returns</h4>
|
3646
|
-
<p> A list of
|
3647
|
-
folder filenames, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut folders. Free
|
3648
|
-
the returned list with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with
|
3649
|
-
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
|
3650
|
-
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
3651
|
-
</div>
|
3652
|
-
<p class="since">Since 2.4</p>
|
1203
|
+
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
|
3653
1204
|
</div>
|
3654
1205
|
</div>
|
3655
1206
|
<div class="refsect1">
|
@@ -3665,22 +1216,19 @@ the returned list with <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/loc
|
|
3665
1216
|
<div class="refsect2">
|
3666
1217
|
<a name="GtkFileChooser--create-folders"></a><h3>The <code class="literal">“create-folders”</code> property</h3>
|
3667
1218
|
<pre class="programlisting"> “create-folders” <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
|
3668
|
-
<p>Whether a file chooser not in
|
3669
|
-
will offer the user to create new folders.</p>
|
1219
|
+
<p>Whether a file chooser not in open mode will offer the user to create new folders.</p>
|
3670
1220
|
<p>Flags: Read / Write</p>
|
3671
1221
|
<p>Default value: TRUE</p>
|
3672
|
-
<p class="since">Since 2.18</p>
|
1222
|
+
<p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
|
3673
1223
|
</div>
|
3674
1224
|
<hr>
|
3675
1225
|
<div class="refsect2">
|
3676
1226
|
<a name="GtkFileChooser--do-overwrite-confirmation"></a><h3>The <code class="literal">“do-overwrite-confirmation”</code> property</h3>
|
3677
1227
|
<pre class="programlisting"> “do-overwrite-confirmation” <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
|
3678
|
-
<p>Whether a file chooser in
|
3679
|
-
will present an overwrite confirmation dialog if the user
|
3680
|
-
selects a file name that already exists.</p>
|
1228
|
+
<p>Whether a file chooser in save mode will present an overwrite confirmation dialog if necessary.</p>
|
3681
1229
|
<p>Flags: Read / Write</p>
|
3682
1230
|
<p>Default value: FALSE</p>
|
3683
|
-
<p class="since">Since 2.8</p>
|
1231
|
+
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
|
3684
1232
|
</div>
|
3685
1233
|
<hr>
|
3686
1234
|
<div class="refsect2">
|
@@ -3759,128 +1307,8 @@ selects a file name that already exists.</p>
|
|
3759
1307
|
<pre class="programlisting"><a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="returnvalue">GtkFileChooserConfirmation</span></a>
|
3760
1308
|
user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
|
3761
1309
|
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
|
3762
|
-
<p>This signal gets emitted whenever it is appropriate to present a
|
3763
|
-
confirmation dialog when the user has selected a file name that
|
3764
|
-
already exists. The signal only gets emitted when the file
|
3765
|
-
chooser is in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode.</p>
|
3766
|
-
<p>Most applications just need to turn on the
|
3767
|
-
<a class="link" href="GtkFileChooser.html#GtkFileChooser--do-overwrite-confirmation" title="The “do-overwrite-confirmation” property"><span class="type">“do-overwrite-confirmation”</span></a> property (or call the
|
3768
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-do-overwrite-confirmation" title="gtk_file_chooser_set_do_overwrite_confirmation ()"><code class="function">gtk_file_chooser_set_do_overwrite_confirmation()</code></a> function), and
|
3769
|
-
they will automatically get a stock confirmation dialog.
|
3770
|
-
Applications which need to customize this behavior should do
|
3771
|
-
that, and also connect to the <a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal"><span class="type">“confirm-overwrite”</span></a>
|
3772
|
-
signal.</p>
|
3773
|
-
<p>A signal handler for this signal must return a
|
3774
|
-
<a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="type">GtkFileChooserConfirmation</span></a> value, which indicates the action to
|
3775
|
-
take. If the handler determines that the user wants to select a
|
3776
|
-
different filename, it should return
|
3777
|
-
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-SELECT-AGAIN:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN</code></a>. If it determines
|
3778
|
-
that the user is satisfied with his choice of file name, it
|
3779
|
-
should return <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-ACCEPT-FILENAME:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME</code></a>.
|
3780
|
-
On the other hand, if it determines that the stock confirmation
|
3781
|
-
dialog should be used, it should return
|
3782
|
-
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-CONFIRM:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM</code></a>. The following example
|
3783
|
-
illustrates this.</p>
|
3784
|
-
<div class="example">
|
3785
|
-
<a name="gtkfilechooser-confirmation"></a><p class="title"><b>Example 43. Custom confirmation</b></p>
|
3786
|
-
<div class="example-contents">
|
3787
|
-
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
3788
|
-
<tbody>
|
3789
|
-
<tr>
|
3790
|
-
<td class="listing_lines" align="right"><pre>1
|
3791
|
-
2
|
3792
|
-
3
|
3793
|
-
4
|
3794
|
-
5
|
3795
|
-
6
|
3796
|
-
7
|
3797
|
-
8
|
3798
|
-
9
|
3799
|
-
10
|
3800
|
-
11
|
3801
|
-
12
|
3802
|
-
13
|
3803
|
-
14
|
3804
|
-
15
|
3805
|
-
16
|
3806
|
-
17
|
3807
|
-
18
|
3808
|
-
19
|
3809
|
-
20
|
3810
|
-
21
|
3811
|
-
22
|
3812
|
-
23
|
3813
|
-
24
|
3814
|
-
25
|
3815
|
-
26
|
3816
|
-
27
|
3817
|
-
28
|
3818
|
-
29</pre></td>
|
3819
|
-
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> <a href="GtkFileChooser.html#GtkFileChooserConfirmation">GtkFileChooserConfirmation</a></span>
|
3820
|
-
<span class="function">confirm_overwrite_callback</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkFileChooser</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
|
3821
|
-
<span class="cbracket">{</span>
|
3822
|
-
<span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">uri</span><span class="symbol">;</span>
|
3823
|
-
|
3824
|
-
<span class="normal"> uri </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-get-uri">gtk_file_chooser_get_uri</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">);</span>
|
3825
|
-
|
3826
|
-
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function">is_uri_read_only</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">uri</span><span class="symbol">))</span>
|
3827
|
-
<span class="normal"> </span><span class="cbracket">{</span>
|
3828
|
-
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function">user_wants_to_replace_read_only_file</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">uri</span><span class="symbol">))</span>
|
3829
|
-
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-ACCEPT-FILENAME:CAPS">GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME</a></span><span class="symbol">;</span>
|
3830
|
-
<span class="normal"> </span><span class="keyword">else</span>
|
3831
|
-
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-SELECT-AGAIN:CAPS">GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN</a></span><span class="symbol">;</span>
|
3832
|
-
<span class="normal"> </span><span class="cbracket">}</span><span class="normal"> </span><span class="keyword">else</span>
|
3833
|
-
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-CONFIRM:CAPS">GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM</a></span><span class="symbol">;</span><span class="normal"> </span><span class="comment">// fall back to the default dialog</span>
|
3834
|
-
<span class="cbracket">}</span>
|
3835
|
-
|
3836
|
-
<span class="symbol">...</span>
|
3837
|
-
|
3838
|
-
<span class="normal">chooser </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkFileChooserDialog.html#gtk-file-chooser-dialog-new">gtk_file_chooser_dialog_new</a></span><span class="normal"> </span><span class="symbol">(...);</span>
|
3839
|
-
|
3840
|
-
<span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-do-overwrite-confirmation">gtk_file_chooser_set_do_overwrite_confirmation</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_CHOOSER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">),</span><span class="normal"> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span>
|
3841
|
-
<span class="function"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"confirm-overwrite"</span><span class="symbol">,</span>
|
3842
|
-
<span class="normal"> </span><span class="function"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">confirm_overwrite_callback</span><span class="symbol">),</span><span class="normal"> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
|
3843
|
-
|
3844
|
-
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkDialog.html#gtk-dialog-run">gtk_dialog_run</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">==</span><span class="normal"> <a href="GtkDialog.html#GTK-RESPONSE-ACCEPT:CAPS">GTK_RESPONSE_ACCEPT</a></span><span class="symbol">)</span>
|
3845
|
-
<span class="normal"> </span><span class="function">save_to_file</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-get-filename">gtk_file_chooser_get_filename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_CHOOSER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">));</span>
|
3846
|
-
|
3847
|
-
<span class="function"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">);</span></pre></td>
|
3848
|
-
</tr>
|
3849
|
-
</tbody>
|
3850
|
-
</table>
|
3851
|
-
</div>
|
3852
|
-
|
3853
|
-
</div>
|
3854
|
-
<br class="example-break"><div class="refsect3">
|
3855
|
-
<a name="id-1.4.12.6.15.2.8"></a><h4>Parameters</h4>
|
3856
|
-
<div class="informaltable"><table width="100%" border="0">
|
3857
|
-
<colgroup>
|
3858
|
-
<col width="150px" class="parameters_name">
|
3859
|
-
<col class="parameters_description">
|
3860
|
-
<col width="200px" class="parameters_annotations">
|
3861
|
-
</colgroup>
|
3862
|
-
<tbody>
|
3863
|
-
<tr>
|
3864
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3865
|
-
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
3866
|
-
<td class="parameter_annotations"> </td>
|
3867
|
-
</tr>
|
3868
|
-
<tr>
|
3869
|
-
<td class="parameter_name"><p>user_data</p></td>
|
3870
|
-
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
3871
|
-
<td class="parameter_annotations"> </td>
|
3872
|
-
</tr>
|
3873
|
-
</tbody>
|
3874
|
-
</table></div>
|
3875
|
-
</div>
|
3876
|
-
<div class="refsect3">
|
3877
|
-
<a name="id-1.4.12.6.15.2.9"></a><h4>Returns</h4>
|
3878
|
-
<p> a <a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="type">GtkFileChooserConfirmation</span></a> value that indicates which
|
3879
|
-
action to take after emitting the signal.</p>
|
3880
|
-
<p></p>
|
3881
|
-
</div>
|
3882
1310
|
<p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
|
3883
|
-
<p class="since">Since 2.8</p>
|
1311
|
+
<p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
|
3884
1312
|
</div>
|
3885
1313
|
<hr>
|
3886
1314
|
<div class="refsect2">
|
@@ -3888,39 +1316,6 @@ action to take after emitting the signal.</p>
|
|
3888
1316
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
3889
1317
|
user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
|
3890
1318
|
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
|
3891
|
-
<p>This signal is emitted when the current folder in a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>
|
3892
|
-
changes. This can happen due to the user performing some action that
|
3893
|
-
changes folders, such as selecting a bookmark or visiting a folder on the
|
3894
|
-
file list. It can also happen as a result of calling a function to
|
3895
|
-
explicitly change the current folder in a file chooser.</p>
|
3896
|
-
<p>Normally you do not need to connect to this signal, unless you need to keep
|
3897
|
-
track of which folder a file chooser is showing.</p>
|
3898
|
-
<p>See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder"><code class="function">gtk_file_chooser_set_current_folder()</code></a>,
|
3899
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder" title="gtk_file_chooser_get_current_folder"><code class="function">gtk_file_chooser_get_current_folder()</code></a>,
|
3900
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()"><code class="function">gtk_file_chooser_set_current_folder_uri()</code></a>,
|
3901
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder-uri" title="gtk_file_chooser_get_current_folder_uri ()"><code class="function">gtk_file_chooser_get_current_folder_uri()</code></a>.</p>
|
3902
|
-
<div class="refsect3">
|
3903
|
-
<a name="id-1.4.12.6.15.3.7"></a><h4>Parameters</h4>
|
3904
|
-
<div class="informaltable"><table width="100%" border="0">
|
3905
|
-
<colgroup>
|
3906
|
-
<col width="150px" class="parameters_name">
|
3907
|
-
<col class="parameters_description">
|
3908
|
-
<col width="200px" class="parameters_annotations">
|
3909
|
-
</colgroup>
|
3910
|
-
<tbody>
|
3911
|
-
<tr>
|
3912
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3913
|
-
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
3914
|
-
<td class="parameter_annotations"> </td>
|
3915
|
-
</tr>
|
3916
|
-
<tr>
|
3917
|
-
<td class="parameter_name"><p>user_data</p></td>
|
3918
|
-
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
3919
|
-
<td class="parameter_annotations"> </td>
|
3920
|
-
</tr>
|
3921
|
-
</tbody>
|
3922
|
-
</table></div>
|
3923
|
-
</div>
|
3924
1319
|
<p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
|
3925
1320
|
</div>
|
3926
1321
|
<hr>
|
@@ -3929,37 +1324,6 @@ track of which folder a file chooser is showing.</p>
|
|
3929
1324
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
3930
1325
|
user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
|
3931
1326
|
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
|
3932
|
-
<p>This signal is emitted when the user "activates" a file in the file
|
3933
|
-
chooser. This can happen by double-clicking on a file in the file list, or
|
3934
|
-
by pressing <span class="keycap"><strong>Enter</strong></span>.</p>
|
3935
|
-
<p>Normally you do not need to connect to this signal. It is used internally
|
3936
|
-
by <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a> to know when to activate the default button in the
|
3937
|
-
dialog.</p>
|
3938
|
-
<p>See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename"><code class="function">gtk_file_chooser_get_filename()</code></a>,
|
3939
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenames" title="gtk_file_chooser_get_filenames"><code class="function">gtk_file_chooser_get_filenames()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a>,
|
3940
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uris" title="gtk_file_chooser_get_uris ()"><code class="function">gtk_file_chooser_get_uris()</code></a>.</p>
|
3941
|
-
<div class="refsect3">
|
3942
|
-
<a name="id-1.4.12.6.15.4.7"></a><h4>Parameters</h4>
|
3943
|
-
<div class="informaltable"><table width="100%" border="0">
|
3944
|
-
<colgroup>
|
3945
|
-
<col width="150px" class="parameters_name">
|
3946
|
-
<col class="parameters_description">
|
3947
|
-
<col width="200px" class="parameters_annotations">
|
3948
|
-
</colgroup>
|
3949
|
-
<tbody>
|
3950
|
-
<tr>
|
3951
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3952
|
-
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
3953
|
-
<td class="parameter_annotations"> </td>
|
3954
|
-
</tr>
|
3955
|
-
<tr>
|
3956
|
-
<td class="parameter_name"><p>user_data</p></td>
|
3957
|
-
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
3958
|
-
<td class="parameter_annotations"> </td>
|
3959
|
-
</tr>
|
3960
|
-
</tbody>
|
3961
|
-
</table></div>
|
3962
|
-
</div>
|
3963
1327
|
<p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
|
3964
1328
|
</div>
|
3965
1329
|
<hr>
|
@@ -3968,40 +1332,6 @@ dialog.</p>
|
|
3968
1332
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
3969
1333
|
user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
|
3970
1334
|
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
|
3971
|
-
<p>This signal is emitted when there is a change in the set of selected files
|
3972
|
-
in a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>. This can happen when the user modifies the selection
|
3973
|
-
with the mouse or the keyboard, or when explicitly calling functions to
|
3974
|
-
change the selection.</p>
|
3975
|
-
<p>Normally you do not need to connect to this signal, as it is easier to wait
|
3976
|
-
for the file chooser to finish running, and then to get the list of
|
3977
|
-
selected files using the functions mentioned below.</p>
|
3978
|
-
<p>See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename"><code class="function">gtk_file_chooser_select_filename()</code></a>,
|
3979
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-filename" title="gtk_file_chooser_unselect_filename"><code class="function">gtk_file_chooser_unselect_filename()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename"><code class="function">gtk_file_chooser_get_filename()</code></a>,
|
3980
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenames" title="gtk_file_chooser_get_filenames"><code class="function">gtk_file_chooser_get_filenames()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-uri" title="gtk_file_chooser_select_uri ()"><code class="function">gtk_file_chooser_select_uri()</code></a>,
|
3981
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-uri" title="gtk_file_chooser_unselect_uri ()"><code class="function">gtk_file_chooser_unselect_uri()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a>,
|
3982
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uris" title="gtk_file_chooser_get_uris ()"><code class="function">gtk_file_chooser_get_uris()</code></a>.</p>
|
3983
|
-
<div class="refsect3">
|
3984
|
-
<a name="id-1.4.12.6.15.5.7"></a><h4>Parameters</h4>
|
3985
|
-
<div class="informaltable"><table width="100%" border="0">
|
3986
|
-
<colgroup>
|
3987
|
-
<col width="150px" class="parameters_name">
|
3988
|
-
<col class="parameters_description">
|
3989
|
-
<col width="200px" class="parameters_annotations">
|
3990
|
-
</colgroup>
|
3991
|
-
<tbody>
|
3992
|
-
<tr>
|
3993
|
-
<td class="parameter_name"><p>chooser</p></td>
|
3994
|
-
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
3995
|
-
<td class="parameter_annotations"> </td>
|
3996
|
-
</tr>
|
3997
|
-
<tr>
|
3998
|
-
<td class="parameter_name"><p>user_data</p></td>
|
3999
|
-
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
4000
|
-
<td class="parameter_annotations"> </td>
|
4001
|
-
</tr>
|
4002
|
-
</tbody>
|
4003
|
-
</table></div>
|
4004
|
-
</div>
|
4005
1335
|
<p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
|
4006
1336
|
</div>
|
4007
1337
|
<hr>
|
@@ -4010,56 +1340,11 @@ selected files using the functions mentioned below.</p>
|
|
4010
1340
|
<pre class="programlisting"><span class="returnvalue">void</span>
|
4011
1341
|
user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
|
4012
1342
|
<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
|
4013
|
-
<p>This signal is emitted when the preview in a file chooser should be
|
4014
|
-
regenerated. For example, this can happen when the currently selected file
|
4015
|
-
changes. You should use this signal if you want your file chooser to have
|
4016
|
-
a preview widget.</p>
|
4017
|
-
<p>Once you have installed a preview widget with
|
4018
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a>, you should update it when this
|
4019
|
-
signal is emitted. You can use the functions
|
4020
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename"><code class="function">gtk_file_chooser_get_preview_filename()</code></a> or
|
4021
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-uri" title="gtk_file_chooser_get_preview_uri ()"><code class="function">gtk_file_chooser_get_preview_uri()</code></a> to get the name of the file to preview.
|
4022
|
-
Your widget may not be able to preview all kinds of files; your callback
|
4023
|
-
must call <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active" title="gtk_file_chooser_set_preview_widget_active ()"><code class="function">gtk_file_chooser_set_preview_widget_active()</code></a> to inform the file
|
4024
|
-
chooser about whether the preview was generated successfully or not.</p>
|
4025
|
-
<p>Please see the example code in <a class="xref" href="GtkFileChooser.html#gtkfilechooser-preview" title="Adding a Preview Widget">the section called “Adding a Preview Widget”</a>.</p>
|
4026
|
-
<p>See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a>,
|
4027
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active" title="gtk_file_chooser_set_preview_widget_active ()"><code class="function">gtk_file_chooser_set_preview_widget_active()</code></a>,
|
4028
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-use-preview-label" title="gtk_file_chooser_set_use_preview_label ()"><code class="function">gtk_file_chooser_set_use_preview_label()</code></a>,
|
4029
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename"><code class="function">gtk_file_chooser_get_preview_filename()</code></a>,
|
4030
|
-
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-uri" title="gtk_file_chooser_get_preview_uri ()"><code class="function">gtk_file_chooser_get_preview_uri()</code></a>.</p>
|
4031
|
-
<div class="refsect3">
|
4032
|
-
<a name="id-1.4.12.6.15.6.8"></a><h4>Parameters</h4>
|
4033
|
-
<div class="informaltable"><table width="100%" border="0">
|
4034
|
-
<colgroup>
|
4035
|
-
<col width="150px" class="parameters_name">
|
4036
|
-
<col class="parameters_description">
|
4037
|
-
<col width="200px" class="parameters_annotations">
|
4038
|
-
</colgroup>
|
4039
|
-
<tbody>
|
4040
|
-
<tr>
|
4041
|
-
<td class="parameter_name"><p>chooser</p></td>
|
4042
|
-
<td class="parameter_description"><p>the object which received the signal.</p></td>
|
4043
|
-
<td class="parameter_annotations"> </td>
|
4044
|
-
</tr>
|
4045
|
-
<tr>
|
4046
|
-
<td class="parameter_name"><p>user_data</p></td>
|
4047
|
-
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
4048
|
-
<td class="parameter_annotations"> </td>
|
4049
|
-
</tr>
|
4050
|
-
</tbody>
|
4051
|
-
</table></div>
|
4052
|
-
</div>
|
4053
1343
|
<p>Flags: <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
|
4054
1344
|
</div>
|
4055
1345
|
</div>
|
4056
|
-
<div class="refsect1">
|
4057
|
-
<a name="GtkFileChooser.see-also"></a><h2>See Also</h2>
|
4058
|
-
<p><a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a>, <a class="link" href="GtkFileChooserWidget.html" title="GtkFileChooserWidget"><span class="type">GtkFileChooserWidget</span></a>, <a class="link" href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a></p>
|
4059
|
-
</div>
|
4060
1346
|
</div>
|
4061
1347
|
<div class="footer">
|
4062
|
-
<hr>
|
4063
|
-
Generated by GTK-Doc V1.21.1</div>
|
1348
|
+
<hr>Generated by GTK-Doc V1.24.1</div>
|
4064
1349
|
</body>
|
4065
1350
|
</html>
|