---
name: "Gtk2::RecentChooser"
section: "3pm"
platform: "linux"
package: "libgtk2-perl-doc"
version: "2:1.24992-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/Gtk2::RecentChooser"
---

# Gtk2::RecentChooser(3pm)

wrapper for GtkRecentChooser

## NAME

Gtk2::RecentChooser - wrapper for GtkRecentChooser

## HIERARCHY

```
  Glib::Interface
  +----Gtk2::RecentChooser
```

## METHODS

### $chooser-\>add\_filter ($filter)

- •

  `$filter` (Gtk2::RecentFilter)

### recentinfo = $chooser-\>get\_current\_item

### string = $chooser-\>get\_current\_uri

### $chooser-\>set\_current\_uri ($uri)

- •

  `$uri` (string)

May croak with a Glib::Error in $@ on failure.

### recentfilter = $chooser-\>get\_filter

### $chooser-\>set\_filter ($filter)

- •

  `$filter` (Gtk2::RecentFilter)

### (list) = $chooser-\>get\_items

### integer = $chooser-\>get\_limit

### $chooser-\>set\_limit ($limit)

- •

  `$limit` (integer)

### (filters) = $chooser-\>list\_filters

### boolean = $chooser-\>get\_local\_only

### $chooser-\>set\_local\_only ($local\_only)

- •

  `$local_only` (boolean)

### $chooser-\>remove\_filter ($filter)

- •

  `$filter` (Gtk2::RecentFilter)

### $chooser-\>select\_all

### boolean = $chooser-\>get\_select\_multiple

### $chooser-\>set\_select\_multiple ($select\_multiple)

- •

  `$select_multiple` (boolean)

### $chooser-\>select\_uri ($uri)

- •

  `$uri` (string)

May croak with a Glib::Error in $@ on failure.

### boolean = $chooser-\>get\_show\_icons

### $chooser-\>set\_show\_icons ($show\_icons)

- •

  `$show_icons` (boolean)

### boolean = $chooser-\>get\_show\_not\_found

### $chooser-\>set\_show\_not\_found ($show\_not\_found)

- •

  `$show_not_found` (boolean)

### boolean = $chooser-\>get\_show\_private

### $chooser-\>set\_show\_private ($show\_private)

- •

  `$show_private` (boolean)

### boolean = $chooser-\>get\_show\_tips

### $chooser-\>set\_show\_tips ($show\_tips)

- •

  `$show_tips` (boolean)

### $chooser-\>set\_sort\_func ($sort\_func, $sort\_data=undef)

- •

  `$sort_func` (scalar)

- •

  `$sort_data` (scalar)

### recentsorttype = $chooser-\>get\_sort\_type

### $chooser-\>set\_sort\_type ($sort\_type)

- •

  `$sort_type` (Gtk2::RecentSortType)

### $chooser-\>unselect\_all

### $chooser-\>unselect\_uri ($uri)

- •

  `$uri` (string)

### (list) = $chooser-\>get\_uris

## PROPERTIES

- 'filter' (Gtk2::RecentFilter : default undef : readable / writable / private)

  The current filter for selecting which resources are displayed

- 'limit' (integer : default -1 : readable / writable / private)

  The maximum number of items to be displayed

- 'local-only' (boolean : default true : readable / writable / private)

  Whether the selected resource(s) should be limited to local file: URIs

- 'recent-manager' (Gtk2::RecentManager : default undef : writable / construct-only / private)

  The RecentManager object to use

- 'select-multiple' (boolean : default false : readable / writable / private)

  Whether to allow multiple items to be selected

- 'show-icons' (boolean : default true : readable / writable / private)

  Whether there should be an icon near the item

- 'show-not-found' (boolean : default true : readable / writable / private)

  Whether the items pointing to unavailable resources should be displayed

- 'show-private' (boolean : default false : readable / writable / private)

  Whether the private items should be displayed

- 'show-tips' (boolean : default false : readable / writable / private)

  Whether there should be a tooltip on the item

- 'sort-type' (Gtk2::RecentSortType : default "none" : readable / writable / private)

  The sorting order of the items displayed

## SIGNALS

- **item-activated** (Gtk2::RecentChooser)

  - **selection-changed** (Gtk2::RecentChooser)

  ## ENUMS AND FLAGS

### enum Gtk2::RecentSortType

- •

  'none' / 'GTK\_RECENT\_SORT\_NONE'

- •

  'mru' / 'GTK\_RECENT\_SORT\_MRU'

- •

  'lru' / 'GTK\_RECENT\_SORT\_LRU'

- •

  'custom' / 'GTK\_RECENT\_SORT\_CUSTOM'

### enum GtkRecentChooserError

- •

  'not-found' / 'GTK\_RECENT\_CHOOSER\_ERROR\_NOT\_FOUND'

- •

  'invalid-uri' / 'GTK\_RECENT\_CHOOSER\_ERROR\_INVALID\_URI'

## SEE ALSO

Gtk2, Glib::Interface

## COPYRIGHT

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL.  See Gtk2 for a full notice.