RubyGems - gdk3 - Versions diffs - 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32 - Mend

gdk3 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32

Files changed (939) hide show

data/vendor/local/share/gtk-doc/html/gtk3/GtkPaned.html CHANGED

@@ -2,26 +2,19 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GtkPaned</title>
+<title>GTK+ 3 Reference Manual: GtkPaned</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
 <link rel="up" href="LayoutContainers.html" title="Layout Containers">
-<link rel="prev" href="GtkFixed.html" title="GtkFixed">
+<link rel="prev" href="GtkButtonBox.html" title="GtkButtonBox">
 <link rel="next" href="GtkLayout.html" title="GtkLayout">
-<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="GtkFixed.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="LayoutContainers.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 3 Reference Manual</th>
-<td><a accesskey="n" href="GtkLayout.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#GtkPaned.synopsis" class="shortcut">Top</a>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
                    |
                   <a href="#GtkPaned.description" class="shortcut">Description</a>
                    |
@@ -36,8 +29,12 @@
                   <a href="#GtkPaned.style-properties" class="shortcut">Style Properties</a>
                    |
                   <a href="#GtkPaned.signals" class="shortcut">Signals</a>
-</td></tr>
-</table>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="LayoutContainers.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="GtkButtonBox.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="GtkLayout.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
 <div class="refentry">
 <a name="GtkPaned"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
@@ -165,7 +162,7 @@ by the user, by calling <a class="link" href="GtkPaned.html#gtk-paned-set-positi
 <p>
 </p>
 <div class="example">
-<a name="id-1.5.13.8.10.7.1"></a><p class="title"><b>Example 92. Creating a paned widget with minimum sizes.</b></p>
+<a name="id-1.3.7.12.10.7.1"></a><p class="title"><b>Example 15. Creating a paned widget with minimum sizes.</b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -789,6 +786,6 @@ The default binding is Tab.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18.1</div>
+          Generated by GTK-Doc V1.19.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gtk3/GtkPaperSize.html CHANGED

@@ -2,32 +2,29 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GtkPaperSize</title>
+<title>GTK+ 3 Reference Manual: GtkPaperSize</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
 <link rel="up" href="Printing.html" title="Printing">
 <link rel="prev" href="GtkPageSetup.html" title="GtkPageSetup">
 <link rel="next" href="GtkPrinter.html" title="GtkPrinter">
-<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="GtkPageSetup.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="Printing.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 3 Reference Manual</th>
-<td><a accesskey="n" href="GtkPrinter.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#GtkPaperSize.synopsis" class="shortcut">Top</a>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
                    |
                   <a href="#GtkPaperSize.description" class="shortcut">Description</a>
                    |
                   <a href="#GtkPaperSize.object-hierarchy" class="shortcut">Object Hierarchy</a>
-</td></tr>
-</table>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="Printing.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="GtkPageSetup.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="GtkPrinter.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
 <div class="refentry">
 <a name="GtkPaperSize"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
@@ -172,7 +169,7 @@ Printing support has been added in GTK+ 2.10.
 <pre class="programlisting">#define GTK_PAPER_NAME_A3 "iso_a3"
 </pre>
 <p>
-Name for the A4 paper size.
+Name for the A3 paper size.
 </p>
 </div>
 <hr>
@@ -900,6 +897,6 @@ This function adds the paper size from <em class="parameter"><code>size</code></
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18.1</div>
+          Generated by GTK-Doc V1.19.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gtk3/GtkPlacesSidebar.html ADDED

@@ -0,0 +1,983 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GTK+ 3 Reference Manual: GtkPlacesSidebar</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
+<link rel="up" href="SelectorWidgets.html" title="Selectors (Color/File/Font)">
+<link rel="prev" href="GtkFontChooserDialog.html" title="GtkFontChooserDialog">
+<link rel="next" href="Ornaments.html" title="Ornaments">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
+                   |
+                  <a href="#GtkPlacesSidebar.description" class="shortcut">Description</a>
+                   |
+                  <a href="#GtkPlacesSidebar.object-hierarchy" class="shortcut">Object Hierarchy</a>
+                   |
+                  <a href="#GtkPlacesSidebar.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
+                   |
+                  <a href="#GtkPlacesSidebar.properties" class="shortcut">Properties</a>
+                   |
+                  <a href="#GtkPlacesSidebar.signals" class="shortcut">Signals</a>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="SelectorWidgets.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="GtkFontChooserDialog.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="Ornaments.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="refentry">
+<a name="GtkPlacesSidebar"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="GtkPlacesSidebar.top_of_page"></a>GtkPlacesSidebar</span></h2>
+<p>GtkPlacesSidebar — Sidebar that displays frequently-used places in the file system</p>
+</td>
+<td valign="top" align="right"><img src="placessidebar.png"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="GtkPlacesSidebar.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#include &lt;gtk/gtk.h&gt;
+                    <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-struct" title="GtkPlacesSidebar">GtkPlacesSidebar</a>;
+enum                <a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags">GtkPlacesOpenFlags</a>;
+<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-new" title="gtk_places_sidebar_new ()">gtk_places_sidebar_new</a>              (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-open-flags" title="gtk_places_sidebar_set_open_flags ()">gtk_places_sidebar_set_open_flags</a>   (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a> flags</code></em>);
+<a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="returnvalue">GtkPlacesOpenFlags</span></a>  <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-open-flags" title="gtk_places_sidebar_get_open_flags ()">gtk_places_sidebar_get_open_flags</a>   (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-location" title="gtk_places_sidebar_set_location ()">gtk_places_sidebar_set_location</a>     (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *location</code></em>);
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *             <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-location" title="gtk_places_sidebar_get_location ()">gtk_places_sidebar_get_location</a>     (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-desktop" title="gtk_places_sidebar_set_show_desktop ()">gtk_places_sidebar_set_show_desktop</a> (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_desktop</code></em>);
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-show-desktop" title="gtk_places_sidebar_get_show_desktop ()">gtk_places_sidebar_get_show_desktop</a> (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-add-shortcut" title="gtk_places_sidebar_add_shortcut ()">gtk_places_sidebar_add_shortcut</a>     (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *location</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-remove-shortcut" title="gtk_places_sidebar_remove_shortcut ()">gtk_places_sidebar_remove_shortcut</a>  (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *location</code></em>);
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-list-shortcuts" title="gtk_places_sidebar_list_shortcuts ()">gtk_places_sidebar_list_shortcuts</a>   (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *             <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-nth-bookmark" title="gtk_places_sidebar_get_nth_bookmark ()">gtk_places_sidebar_get_nth_bookmark</a> (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n</code></em>);
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-show-connect-to-server" title="gtk_places_sidebar_get_show_connect_to_server ()">gtk_places_sidebar_get_show_connect_to_server</a>
+                                                        (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-connect-to-server" title="gtk_places_sidebar_set_show_connect_to_server ()">gtk_places_sidebar_set_show_connect_to_server</a>
+                                                        (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_connect_to_server</code></em>);
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkPlacesSidebar.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="synopsis">
+  <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
+   +----<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
+         +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
+               +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
+                     +----<a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
+                           +----<a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow">GtkScrolledWindow</a>
+                                 +----GtkPlacesSidebar
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkPlacesSidebar.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
+<p>
+GtkPlacesSidebar implements
+ AtkImplementorIface and  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
+</div>
+<div class="refsect1">
+<a name="GtkPlacesSidebar.properties"></a><h2>Properties</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--local-only" title='The "local-only" property'>local-only</a>"               <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--location" title='The "location" property'>location</a>"                 <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>*                : Read / Write
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--open-flags" title='The "open-flags" property'>open-flags</a>"               <a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a>    : Read / Write
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--show-connect-to-server" title='The "show-connect-to-server" property'>show-connect-to-server</a>"   <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar--show-desktop" title='The "show-desktop" property'>show-desktop</a>"             <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkPlacesSidebar.signals"></a><h2>Signals</h2>
+<pre class="synopsis">
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-drag-action-ask" title='The "drag-action-ask" signal'>drag-action-ask</a>"                                : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-drag-action-requested" title='The "drag-action-requested" signal'>drag-action-requested</a>"                          : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-drag-perform-drop" title='The "drag-perform-drop" signal'>drag-perform-drop</a>"                              : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title='The "open-location" signal'>open-location</a>"                                  : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-populate-popup" title='The "populate-popup" signal'>populate-popup</a>"                                 : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-show-connect-to-server" title='The "show-connect-to-server" signal'>show-connect-to-server</a>"                         : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
+  "<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-show-error-message" title='The "show-error-message" signal'>show-error-message</a>"                             : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a>
+</pre>
+</div>
+<div class="refsect1">
+<a name="GtkPlacesSidebar.description"></a><h2>Description</h2>
+<p>
+<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> is a widget that displays a list of frequently-used places in the
+file system:  the user's home directory, the user's bookmarks, and volumes and drives.
+This widget is used as a sidebar in <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> and may be used by file managers
+and similar programs.
+</p>
+<p>
+The places sidebar displays drives and volumes, and will automatically mount
+or unmount them when the user selects them.
+</p>
+<p>
+Applications can hook to various signals in the places sidebar to customize
+its behavior.  For example, they can add extra commands to the context menu
+of the sidebar.
+</p>
+<p>
+While bookmarks are completely in control of the user, the places sidebar also
+allows individual applications to provide extra shortcut folders that are unique
+to each application.  For example, a Paint program may want to add a shortcut
+for a Clipart folder.  You can do this with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-add-shortcut" title="gtk_places_sidebar_add_shortcut ()"><code class="function">gtk_places_sidebar_add_shortcut()</code></a>.
+</p>
+<p>
+To make use of the places sidebar, an application at least needs to connect
+to the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title='The "open-location" signal'><span class="type">"open-location"</span></a> signal.  This is emitted when the
+user selects in the sidebar a location to open.  The application should also
+call <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-location" title="gtk_places_sidebar_set_location ()"><code class="function">gtk_places_sidebar_set_location()</code></a> when it changes the currently-viewed
+location.
+</p>
+</div>
+<div class="refsect1">
+<a name="GtkPlacesSidebar.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-struct"></a><h3>GtkPlacesSidebar</h3>
+<pre class="programlisting">typedef struct _GtkPlacesSidebar GtkPlacesSidebar;</pre>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesOpenFlags"></a><h3>enum GtkPlacesOpenFlags</h3>
+<pre class="programlisting">typedef enum {
+  GTK_PLACES_OPEN_NORMAL     = 1 &lt;&lt; 0,
+  GTK_PLACES_OPEN_NEW_TAB    = 1 &lt;&lt; 1,
+  GTK_PLACES_OPEN_NEW_WINDOW = 1 &lt;&lt; 2
+} GtkPlacesOpenFlags;
+</pre>
+<p>
+These flags serve two purposes.  First, the application can call <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-open-flags" title="gtk_places_sidebar_set_open_flags ()"><code class="function">gtk_places_sidebar_set_open_flags()</code></a>
+using these flags as a bitmask.  This tells the sidebar that the application is able to open
+folders selected from the sidebar in various ways, for example, in new tabs or in new windows in
+addition to the normal mode.
+</p>
+<p>
+Second, when one of these values gets passed back to the application in the
+<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title='The "open-location" signal'><span class="type">"open-location"</span></a> signal, it means that the application should
+open the selected location in the normal way, in a new tab, or in a new
+window.  The sidebar takes care of determining the desired way to open the location,
+based on the modifier keys that the user is pressing at the time the selection is made.
+</p>
+<p>
+If the application never calls <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-open-flags" title="gtk_places_sidebar_set_open_flags ()"><code class="function">gtk_places_sidebar_set_open_flags()</code></a>, then the sidebar will only
+use <a class="link" href="GtkPlacesSidebar.html#GTK-PLACES-OPEN-NORMAL:CAPS"><span class="type">GTK_PLACES_OPEN_NORMAL</span></a> in the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title='The "open-location" signal'><span class="type">"open-location"</span></a> signal.  This is the
+default mode of operation.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><a name="GTK-PLACES-OPEN-NORMAL:CAPS"></a><span class="term"><code class="literal">GTK_PLACES_OPEN_NORMAL</code></span></p></td>
+<td>This is the default mode that <a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> uses if no other flags
+ are specified.  It indicates that the calling application should open the selected location
+ in the normal way, for example, in the folder view beside the sidebar.
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-PLACES-OPEN-NEW-TAB:CAPS"></a><span class="term"><code class="literal">GTK_PLACES_OPEN_NEW_TAB</code></span></p></td>
+<td>When passed to <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-open-flags" title="gtk_places_sidebar_set_open_flags ()"><code class="function">gtk_places_sidebar_set_open_flags()</code></a>, this indicates
+ that the application can open folders selected from the sidebar in new tabs.  This value
+ will be passed to the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title='The "open-location" signal'><span class="type">"open-location"</span></a> signal when the user selects
+ that a location be opened in a new tab instead of in the standard fashion.
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-PLACES-OPEN-NEW-WINDOW:CAPS"></a><span class="term"><code class="literal">GTK_PLACES_OPEN_NEW_WINDOW</code></span></p></td>
+<td>Similar to <em class="parameter"><code>GTK_PLACES_OPEN_NEW_TAB</code></em>, but indicates that the application
+ can open folders in new windows.
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-new"></a><h3>gtk_places_sidebar_new ()</h3>
+<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_places_sidebar_new              (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Creates a new <a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> widget.
+</p>
+<p>
+The application should connect to at least the
+<a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title='The "open-location" signal'><span class="type">"open-location"</span></a> signal to be notified
+when the user makes a selection in the sidebar.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a newly created <a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a>
+</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-set-open-flags"></a><h3>gtk_places_sidebar_set_open_flags ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_places_sidebar_set_open_flags   (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a> flags</code></em>);</pre>
+<p>
+Sets the way in which the calling application can open new locations from
+the places sidebar.  For example, some applications only open locations
+"directly" into their main view, while others may support opening locations
+in a new notebook tab or a new window.
+</p>
+<p>
+This function is used to tell the places <em class="parameter"><code>sidebar</code></em> about the ways in which the
+application can open new locations, so that the sidebar can display (or not)
+the "Open in new tab" and "Open in new window" menu items as appropriate.
+</p>
+<p>
+When the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesSidebar-open-location" title='The "open-location" signal'><span class="type">"open-location"</span></a> signal is emitted, its flags
+argument will be set to one of the <em class="parameter"><code>flags</code></em> that was passed in
+<a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-open-flags" title="gtk_places_sidebar_set_open_flags ()"><code class="function">gtk_places_sidebar_set_open_flags()</code></a>.
+</p>
+<p>
+Passing 0 for <em class="parameter"><code>flags</code></em> will cause <a class="link" href="GtkPlacesSidebar.html#GTK-PLACES-OPEN-NORMAL:CAPS"><span class="type">GTK_PLACES_OPEN_NORMAL</span></a> to always be sent
+to callbacks for the "open-location" signal.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
+<td>Bitmask of modes in which the calling application can open locations</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-get-open-flags"></a><h3>gtk_places_sidebar_get_open_flags ()</h3>
+<pre class="programlisting"><a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="returnvalue">GtkPlacesOpenFlags</span></a>  gtk_places_sidebar_get_open_flags   (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
+<p>
+Gets the open flags.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the <a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a> of <em class="parameter"><code>sidebar</code></em>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-set-location"></a><h3>gtk_places_sidebar_set_location ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_places_sidebar_set_location     (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *location</code></em>);</pre>
+<p>
+Sets the location that is being shown in the widgets surrounding the
+<em class="parameter"><code>sidebar</code></em>, for example, in a folder view in a file manager.  In turn, the
+<em class="parameter"><code>sidebar</code></em> will highlight that location if it is being shown in the list of
+places, or it will unhighlight everything if the <em class="parameter"><code>location</code></em> is not among the
+places in the list.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>location</code></em> :</span></p></td>
+<td>location to select, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> for no current path. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-get-location"></a><h3>gtk_places_sidebar_get_location ()</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *             gtk_places_sidebar_get_location     (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
+<p>
+Gets the currently-selected location in the <em class="parameter"><code>sidebar</code></em>.  This can be <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> when
+nothing is selected, for example, when <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-location" title="gtk_places_sidebar_set_location ()"><code class="function">gtk_places_sidebar_set_location()</code></a> has
+been called with a location that is not among the sidebar's list of places to
+show.
+</p>
+<p>
+You can use this function to get the selection in the <em class="parameter"><code>sidebar</code></em>.  Also, if you
+connect to the <span class="type">"popup-menu"</span> signal, you can use this
+function to get the location that is being referred to during the callbacks
+for your menu items.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a GFile with the selected location, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> if nothing is visually
+selected. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-set-show-desktop"></a><h3>gtk_places_sidebar_set_show_desktop ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_places_sidebar_set_show_desktop (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_desktop</code></em>);</pre>
+<p>
+Sets whether the <em class="parameter"><code>sidebar</code></em> should show an item for the Desktop folder.
+The default value for this option is determined by the desktop
+environment and the user's configuration, but this function can be
+used to override it on a per-application basis.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>show_desktop</code></em> :</span></p></td>
+<td>whether to show an item for the Desktop folder</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-get-show-desktop"></a><h3>gtk_places_sidebar_get_show_desktop ()</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_places_sidebar_get_show_desktop (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
+<p>
+Returns the value previously set with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-desktop" title="gtk_places_sidebar_set_show_desktop ()"><code class="function">gtk_places_sidebar_set_show_desktop()</code></a>
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<a href="/home/kou/work/ruby/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 sidebar will display a builtin shortcut to the desktop folder.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-add-shortcut"></a><h3>gtk_places_sidebar_add_shortcut ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_places_sidebar_add_shortcut     (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *location</code></em>);</pre>
+<p>
+Applications may want to present some folders in the places sidebar if
+they could be immediately useful to users.  For example, a drawing
+program could add a "/usr/share/clipart" location when the sidebar is
+being used in an "Insert Clipart" dialog box.
+</p>
+<p>
+This function adds the specified <em class="parameter"><code>location</code></em> to a special place for immutable
+shortcuts.  The shortcuts are application-specific; they are not shared
+across applications, and they are not persistent.  If this function
+is called multiple times with different locations, then they are added
+to the sidebar's list in the same order as the function is called.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>location</code></em> :</span></p></td>
+<td>location to add as an application-specific shortcut</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-remove-shortcut"></a><h3>gtk_places_sidebar_remove_shortcut ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_places_sidebar_remove_shortcut  (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *location</code></em>);</pre>
+<p>
+Removes an application-specific shortcut that has been previously been
+inserted with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-add-shortcut" title="gtk_places_sidebar_add_shortcut ()"><code class="function">gtk_places_sidebar_add_shortcut()</code></a>.  If the <em class="parameter"><code>location</code></em> is not a
+shortcut in the sidebar, then nothing is done.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>location</code></em> :</span></p></td>
+<td>location to remove</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-list-shortcuts"></a><h3>gtk_places_sidebar_list_shortcuts ()</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            gtk_places_sidebar_list_shortcuts   (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
+<p>
+Gets the list of shortcuts.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>A <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> of <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> of the locations that have been added as
+application-specific shortcuts with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-add-shortcut" title="gtk_places_sidebar_add_shortcut ()"><code class="function">gtk_places_sidebar_add_shortcut()</code></a>.
+To free this list, you can use
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free-full">g_slist_free_full</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">list</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a></span><span class="symbol">)</span><span class="normal"> <a href="/home/kou/work/ruby/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="symbol">);</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+. <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>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-get-nth-bookmark"></a><h3>gtk_places_sidebar_get_nth_bookmark ()</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *             gtk_places_sidebar_get_nth_bookmark (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n</code></em>);</pre>
+<p>
+This function queries the bookmarks added by the user to the places sidebar,
+and returns one of them.  This function is used by <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> to implement
+the "Alt-1", "Alt-2", etc. shortcuts, which activate the cooresponding bookmark.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
+<td>index of the bookmark to query</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>The bookmark specified by the index <em class="parameter"><code>n</code></em>, or
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> if no such index exist.  Note that the indices start at 0, even though
+the file chooser starts them with the keyboard shortcut "Alt-1". <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-get-show-connect-to-server"></a><h3>gtk_places_sidebar_get_show_connect_to_server ()</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_places_sidebar_get_show_connect_to_server
+                                                        (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>);</pre>
+<p>
+Returns the value previously set with <a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-set-show-connect-to-server" title="gtk_places_sidebar_set_show_connect_to_server ()"><code class="function">gtk_places_sidebar_set_show_connect_to_server()</code></a>
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<a href="/home/kou/work/ruby/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 sidebar will display a "Connect to Server" item.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-places-sidebar-set-show-connect-to-server"></a><h3>gtk_places_sidebar_set_show_connect_to_server ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_places_sidebar_set_show_connect_to_server
+                                                        (<em class="parameter"><code><a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_connect_to_server</code></em>);</pre>
+<p>
+Sets whether the <em class="parameter"><code>sidebar</code></em> should show an item for connecting to a network server; this is off by default.
+An application may want to turn this on if it implements a way for the user to connect
+to network servers directly.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>a places sidebar</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>show_connect_to_server</code></em> :</span></p></td>
+<td>whether to show an item for the Connect to Server command</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkPlacesSidebar.property-details"></a><h2>Property Details</h2>
+<div class="refsect2">
+<a name="GtkPlacesSidebar--local-only"></a><h3>The <code class="literal">"local-only"</code> property</h3>
+<pre class="programlisting">  "local-only"               <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
+<p>Whether the sidebar only includes local files.</p>
+<p>Default value: FALSE</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar--location"></a><h3>The <code class="literal">"location"</code> property</h3>
+<pre class="programlisting">  "location"                 <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>*                : Read / Write</pre>
+<p>The location to highlight in the sidebar.</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar--open-flags"></a><h3>The <code class="literal">"open-flags"</code> property</h3>
+<pre class="programlisting">  "open-flags"               <a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a>    : Read / Write</pre>
+<p>Modes in which the calling application can open locations selected in the sidebar.</p>
+<p>Default value: GTK_PLACES_OPEN_NORMAL</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar--show-connect-to-server"></a><h3>The <code class="literal">"show-connect-to-server"</code> property</h3>
+<pre class="programlisting">  "show-connect-to-server"   <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
+<p>Whether the sidebar includes a builtin shortcut to a 'Connect to server' dialog.</p>
+<p>Default value: FALSE</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar--show-desktop"></a><h3>The <code class="literal">"show-desktop"</code> property</h3>
+<pre class="programlisting">  "show-desktop"             <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
+<p>Whether the sidebar includes a builtin shortcut to the Desktop folder.</p>
+<p>Default value: TRUE</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkPlacesSidebar.signal-details"></a><h2>Signal Details</h2>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-drag-action-ask"></a><h3>The <code class="literal">"drag-action-ask"</code> signal</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                user_function                      (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>              actions,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)      : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
+<p>
+The places sidebar emits this signal when it needs to ask the application
+to pop up a menu to ask the user for which drag action to perform.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>the object which received the signal.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>actions</code></em> :</span></p></td>
+<td>Possible drag actions that need to be asked for.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the final drag action that the sidebar should pass to the drag side
+of the drag-and-drop operation.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-drag-action-requested"></a><h3>The <code class="literal">"drag-action-requested"</code> signal</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                user_function                      (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
+                                                        <a href="http://developer.gnome.org/gdk2/gdk3-Drag-and-Drop.html#GdkDragContext"><span class="type">GdkDragContext</span></a>   *context,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>          *dest_file,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          source_file_list,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)             : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
+<p>
+When the user starts a drag-and-drop operation and the sidebar needs
+to ask the application for which drag action to perform, then the
+sidebar will emit this signal.
+</p>
+<p>
+The application can evaluate the <em class="parameter"><code>context</code></em> for customary actions, or
+it can check the type of the files indicated by <em class="parameter"><code>source_file_list</code></em> against the
+possible actions for the destination <em class="parameter"><code>dest_file</code></em>.
+</p>
+<p>
+The drag action to use must be the return value of the signal handler.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>the object which received the signal.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
+<td>
+<a href="http://developer.gnome.org/gdk2/gdk3-Drag-and-Drop.html#GdkDragContext"><span class="type">GdkDragContext</span></a> with information about the drag operation</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>dest_file</code></em> :</span></p></td>
+<td>
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> with the tentative location that is being hovered for a drop</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source_file_list</code></em> :</span></p></td>
+<td>List of <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> that are being dragged. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GFile][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>The drag action to use, for example, <a href="http://developer.gnome.org/gdk2/gdk3-Drag-and-Drop.html#GDK-ACTION-COPY:CAPS"><span class="type">GDK_ACTION_COPY</span></a>
+or <a href="http://developer.gnome.org/gdk2/gdk3-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS"><span class="type">GDK_ACTION_MOVE</span></a>, or 0 if no action is allowed here (i.e. drops
+are not allowed in the specified <em class="parameter"><code>dest_file</code></em>).</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-drag-perform-drop"></a><h3>The <code class="literal">"drag-perform-drop"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>          *dest_file,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          source_file_list,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>              action,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)             : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
+<p>
+The places sidebar emits this signal when the user completes a
+drag-and-drop operation and one of the sidebar's items is the
+destination.  This item is in the <em class="parameter"><code>dest_file</code></em>, and the
+<em class="parameter"><code>source_file_list</code></em> has the list of files that are dropped into it and
+which should be copied/moved/etc. based on the specified <em class="parameter"><code>action</code></em>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>the object which received the signal.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>dest_file</code></em> :</span></p></td>
+<td>Destination <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>source_file_list</code></em> :</span></p></td>
+<td>
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> that got dropped. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GFile][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
+<td>Drop action to perform.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-open-location"></a><h3>The <code class="literal">"open-location"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a>  *sidebar,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>           *location,
+                                                        <a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a> open_flags,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)       : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
+<p>
+The places sidebar emits this signal when the user selects a location
+in it.  The calling application should display the contents of that
+location; for example, a file manager should show a list of files in
+the specified location.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>the object which received the signal.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>location</code></em> :</span></p></td>
+<td>
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> to which the caller should switch.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>open_flags</code></em> :</span></p></td>
+<td>a single value from <a class="link" href="GtkPlacesSidebar.html#GtkPlacesOpenFlags" title="enum GtkPlacesOpenFlags"><span class="type">GtkPlacesOpenFlags</span></a> specifying how the <em class="parameter"><code>location</code></em> should be opened.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-populate-popup"></a><h3>The <code class="literal">"populate-popup"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>          *menu,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>          *selected_item,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a>          *selected_volume,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)            : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
+<p>
+The places sidebar emits this signal when the user invokes a contextual
+menu on one of its items.  In the signal handler, the application may
+add extra items to the menu as appropriate.  For example, a file manager
+may want to add a "Properties" command to the menu.
+</p>
+<p>
+It is not necessary to store the <em class="parameter"><code>selected_item</code></em> for each menu item;
+during their GtkMenuItem::activate callbacks, the application can use
+<a class="link" href="GtkPlacesSidebar.html#gtk-places-sidebar-get-location" title="gtk_places_sidebar_get_location ()"><code class="function">gtk_places_sidebar_get_location()</code></a> to get the file to which the item
+refers.
+</p>
+<p>
+The <em class="parameter"><code>selected_item</code></em> argument may be <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> in case the selection refers to
+a volume.  In this case, <em class="parameter"><code>selected_volume</code></em> will be non-NULL.  In this case,
+the calling application will have to <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> the <em class="parameter"><code>selected_volume</code></em> and
+keep it around for the purposes of its menu item's "activate" callback.
+</p>
+<p>
+The <em class="parameter"><code>menu</code></em> and all its menu items are destroyed after the user
+dismisses the menu.  The menu is re-created (and thus, this signal is
+emitted) every time the user activates the contextual menu.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>the object which received the signal.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>menu</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>selected_item</code></em> :</span></p></td>
+<td>
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> with the item to which the menu should refer, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> in the case of a <em class="parameter"><code>selected_volume</code></em>.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>selected_volume</code></em> :</span></p></td>
+<td>
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GVolume.html"><span class="type">GVolume</span></a> if the selected item is a volume, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> if it is a file.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-show-connect-to-server"></a><h3>The <code class="literal">"show-connect-to-server"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)      : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
+<p>
+The places sidebar emits this signal when it needs the calling
+application to present an way to connect directly to a network server.
+For example, the application may bring up a dialog box asking for
+a URL like "sftp://ftp.example.com".  It is up to the application to create
+the corresponding mount by using, for example, <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#g-file-mount-enclosing-volume"><code class="function">g_file_mount_enclosing_volume()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>the object which received the signal.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GtkPlacesSidebar-show-error-message"></a><h3>The <code class="literal">"show-error-message"</code> signal</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar"><span class="type">GtkPlacesSidebar</span></a> *sidebar,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>            *primary,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>            *secondary,
+                                                        <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>          user_data)      : <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-FIRST:CAPS"><code class="literal">Run First</code></a></pre>
+<p>
+The places sidebar emits this signal when it needs the calling
+application to present an error message.  Most of these messages
+refer to mounting or unmounting media, for example, when a drive
+cannot be started for some reason.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>sidebar</code></em> :</span></p></td>
+<td>the object which received the signal.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>primary</code></em> :</span></p></td>
+<td>primary message with a summary of the error to show.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>secondary</code></em> :</span></p></td>
+<td>secondary message with details of the error to show.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
+<td>user data set when the signal handler was connected.</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="GtkPlacesSidebar.see-also"></a><h2>See Also</h2>
+<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.19.1</div>
+</body>
+</html>