Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkrecentchooser.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 GtkRecentChooser
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 Interface implemented by GtkRecentChooserWidget, GtkRecentChooserMenu and GtkRecentChooserDialog
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 #GtkRecentChooser is an interface that can be implemented by widgets
  10 displaying the list of recently used files.  In GTK+, the main objects
  11 that implement this interface are #GtkRecentChooserWidget,
  12 #GtkRecentChooserDialog and #GtkRecentChooserMenu.
  13 </para>
  14
  15 <para>
  16 Recently used files are supported since GTK+ 2.10.
  17 </para>
  18
  19 <!-- ##### SECTION See_Also ##### -->
  20 <para>
  21 #GtkRecentManager, #GtkRecentChooserDialog, #GtkRecentChooserWidget,
  22 #GtkRecentChooserMenu
  23 </para>
  24
  25 <!-- ##### SECTION Stability_Level ##### -->
  26
  27
  28 <!-- ##### STRUCT GtkRecentChooser ##### -->
  29 <para>
  30
  31 </para>
  32
  33
  34 <!-- ##### STRUCT GtkRecentChooserIface ##### -->
  35 <para>
  36
  37 </para>
  38
  39 @base_iface:
  40 @set_current_uri:
  41 @get_current_uri:
  42 @select_uri:
  43 @unselect_uri:
  44 @select_all:
  45 @unselect_all:
  46 @get_items:
  47 @get_recent_manager:
  48 @add_filter:
  49 @remove_filter:
  50 @list_filters:
  51 @set_sort_func:
  52 @item_activated:
  53 @selection_changed:
  54
  55 <!-- ##### MACRO GTK_RECENT_CHOOSER_ERROR ##### -->
  56 <para>
  57 Used to get the #GError quark for #GtkRecentChooser errors.
  58 </para>
  59
  60
  61
  62 <!-- ##### ENUM GtkRecentChooserError ##### -->
  63 <para>
  64 These identify the various errors that can occur while calling
  65 #GtkRecentChooser functions.
  66 </para>
  67
  68 @GTK_RECENT_CHOOSER_ERROR_NOT_FOUND: Indicates that a file does not exist
  69 @GTK_RECENT_CHOOSER_ERROR_INVALID_URI: Indicates a malformed URI
  70
  71 <!-- ##### FUNCTION gtk_recent_chooser_set_show_private ##### -->
  72 <para>
  73
  74 </para>
  75
  76 @chooser:
  77 @show_private:
  78
  79
  80 <!-- ##### FUNCTION gtk_recent_chooser_get_show_private ##### -->
  81 <para>
  82
  83 </para>
  84
  85 @chooser:
  86 @Returns:
  87
  88
  89 <!-- ##### FUNCTION gtk_recent_chooser_set_show_not_found ##### -->
  90 <para>
  91
  92 </para>
  93
  94 @chooser:
  95 @show_not_found:
  96
  97
  98 <!-- ##### FUNCTION gtk_recent_chooser_get_show_not_found ##### -->
  99 <para>
 100
 101 </para>
 102
 103 @chooser:
 104 @Returns:
 105
 106
 107 <!-- ##### FUNCTION gtk_recent_chooser_set_show_icons ##### -->
 108 <para>
 109
 110 </para>
 111
 112 @chooser:
 113 @show_icons:
 114
 115
 116 <!-- ##### FUNCTION gtk_recent_chooser_get_show_icons ##### -->
 117 <para>
 118
 119 </para>
 120
 121 @chooser:
 122 @Returns:
 123
 124
 125 <!-- ##### FUNCTION gtk_recent_chooser_set_select_multiple ##### -->
 126 <para>
 127
 128 </para>
 129
 130 @chooser:
 131 @select_multiple:
 132
 133
 134 <!-- ##### FUNCTION gtk_recent_chooser_get_select_multiple ##### -->
 135 <para>
 136
 137 </para>
 138
 139 @chooser:
 140 @Returns:
 141
 142
 143 <!-- ##### FUNCTION gtk_recent_chooser_set_local_only ##### -->
 144 <para>
 145
 146 </para>
 147
 148 @chooser:
 149 @local_only:
 150
 151
 152 <!-- ##### FUNCTION gtk_recent_chooser_get_local_only ##### -->
 153 <para>
 154
 155 </para>
 156
 157 @chooser:
 158 @Returns:
 159
 160
 161 <!-- ##### FUNCTION gtk_recent_chooser_set_limit ##### -->
 162 <para>
 163
 164 </para>
 165
 166 @chooser:
 167 @limit:
 168
 169
 170 <!-- ##### FUNCTION gtk_recent_chooser_get_limit ##### -->
 171 <para>
 172
 173 </para>
 174
 175 @chooser:
 176 @Returns:
 177
 178
 179 <!-- ##### FUNCTION gtk_recent_chooser_set_show_tips ##### -->
 180 <para>
 181
 182 </para>
 183
 184 @chooser:
 185 @show_tips:
 186
 187
 188 <!-- ##### FUNCTION gtk_recent_chooser_get_show_tips ##### -->
 189 <para>
 190
 191 </para>
 192
 193 @chooser:
 194 @Returns:
 195
 196
 197 <!-- ##### FUNCTION gtk_recent_chooser_set_show_numbers ##### -->
 198 <para>
 199
 200 </para>
 201
 202 @chooser:
 203 @show_numbers:
 204
 205
 206 <!-- ##### FUNCTION gtk_recent_chooser_get_show_numbers ##### -->
 207 <para>
 208
 209 </para>
 210
 211 @chooser:
 212 @Returns:
 213
 214
 215 <!-- ##### ENUM GtkRecentSortType ##### -->
 216 <para>
 217
 218 </para>
 219
 220 @GTK_RECENT_SORT_NONE:
 221 @GTK_RECENT_SORT_MRU:
 222 @GTK_RECENT_SORT_LRU:
 223 @GTK_RECENT_SORT_CUSTOM:
 224
 225 <!-- ##### FUNCTION gtk_recent_chooser_set_sort_type ##### -->
 226 <para>
 227
 228 </para>
 229
 230 @chooser:
 231 @sort_type:
 232
 233
 234 <!-- ##### FUNCTION gtk_recent_chooser_get_sort_type ##### -->
 235 <para>
 236
 237 </para>
 238
 239 @chooser:
 240 @Returns:
 241
 242
 243 <!-- ##### USER_FUNCTION GtkRecentSortFunc ##### -->
 244 <para>
 245
 246 </para>
 247
 248 @a:
 249 @b:
 250 @user_data:
 251 @Returns:
 252
 253
 254 <!-- ##### FUNCTION gtk_recent_chooser_set_sort_func ##### -->
 255 <para>
 256
 257 </para>
 258
 259 @chooser:
 260 @sort_func:
 261 @sort_data:
 262 @data_destroy:
 263
 264
 265 <!-- ##### FUNCTION gtk_recent_chooser_set_current_uri ##### -->
 266 <para>
 267
 268 </para>
 269
 270 @chooser:
 271 @uri:
 272 @error:
 273 @Returns:
 274
 275
 276 <!-- ##### FUNCTION gtk_recent_chooser_get_current_uri ##### -->
 277 <para>
 278
 279 </para>
 280
 281 @chooser:
 282 @Returns:
 283
 284
 285 <!-- ##### FUNCTION gtk_recent_chooser_get_current_item ##### -->
 286 <para>
 287
 288 </para>
 289
 290 @chooser:
 291 @Returns:
 292
 293
 294 <!-- ##### FUNCTION gtk_recent_chooser_select_uri ##### -->
 295 <para>
 296
 297 </para>
 298
 299 @chooser:
 300 @uri:
 301 @error:
 302 @Returns:
 303
 304
 305 <!-- ##### FUNCTION gtk_recent_chooser_unselect_uri ##### -->
 306 <para>
 307
 308 </para>
 309
 310 @chooser:
 311 @uri:
 312
 313
 314 <!-- ##### FUNCTION gtk_recent_chooser_select_all ##### -->
 315 <para>
 316
 317 </para>
 318
 319 @chooser:
 320
 321
 322 <!-- ##### FUNCTION gtk_recent_chooser_unselect_all ##### -->
 323 <para>
 324
 325 </para>
 326
 327 @chooser:
 328
 329
 330 <!-- ##### FUNCTION gtk_recent_chooser_get_items ##### -->
 331 <para>
 332
 333 </para>
 334
 335 @chooser:
 336 @Returns:
 337
 338
 339 <!-- ##### FUNCTION gtk_recent_chooser_get_uris ##### -->
 340 <para>
 341
 342 </para>
 343
 344 @chooser:
 345 @length:
 346 @Returns:
 347
 348
 349 <!-- ##### FUNCTION gtk_recent_chooser_add_filter ##### -->
 350 <para>
 351
 352 </para>
 353
 354 @chooser:
 355 @filter:
 356
 357
 358 <!-- ##### FUNCTION gtk_recent_chooser_remove_filter ##### -->
 359 <para>
 360
 361 </para>
 362
 363 @chooser:
 364 @filter:
 365
 366
 367 <!-- ##### FUNCTION gtk_recent_chooser_list_filters ##### -->
 368 <para>
 369
 370 </para>
 371
 372 @chooser:
 373 @Returns:
 374
 375
 376 <!-- ##### FUNCTION gtk_recent_chooser_set_filter ##### -->
 377 <para>
 378
 379 </para>
 380
 381 @chooser:
 382 @filter:
 383
 384
 385 <!-- ##### FUNCTION gtk_recent_chooser_get_filter ##### -->
 386 <para>
 387
 388 </para>
 389
 390 @chooser:
 391 @Returns:
 392
 393