<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Graphics.UI.Gtk.Recent.RecentChooserMenu</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[ window.onload = function () {pageLoad();setSynopsis("mini_Graphics-UI-Gtk-Recent-RecentChooserMenu.html");}; //]]> </script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="src/Graphics-UI-Gtk-Recent-RecentChooserMenu.html">Source</a></li><li><a href="index.html">Contents</a></li><li><a href="doc-index.html">Index</a></li></ul><p class="caption">gtk-0.12.0: Binding to the Gtk+ graphical user interface library.</p></div><div id="content"><div id="module-header"><table class="info"><tr><th>Portability</th><td>portable (depends on GHC)</td></tr><tr><th>Stability</th><td>provisional</td></tr><tr><th>Maintainer</th><td>gtk2hs-users@lists.sourceforge.net</td></tr></table><p class="caption">Graphics.UI.Gtk.Recent.RecentChooserMenu</p></div><div id="table-of-contents"><p class="caption">Contents</p><ul><li><a href="#g:1">Detail </a></li><li><a href="#g:2">Class Hierarchy </a></li><li><a href="#g:3">Types </a></li><li><a href="#g:4">Constructors </a></li><li><a href="#g:5">Attributes </a></li></ul></div><div id="description"><p class="caption">Description</p><div class="doc"><p>Displays recently used files in a menu </p><ul><li> Module available since Gtk+ version 2.10 </li></ul></div></div><div id="synopsis"><p id="control.syn" class="caption expander" onclick="toggleSection('syn')">Synopsis</p><ul id="section.syn" class="hide" onclick="toggleSection('syn')"><li class="src short"><span class="keyword">data</span> <a href="#t:RecentChooserMenu">RecentChooserMenu</a> </li><li class="src short"><span class="keyword">class</span> <a href="Graphics-UI-Gtk-MenuComboToolbar-Menu.html#t:MenuClass">MenuClass</a> o => <a href="#t:RecentChooserMenuClass">RecentChooserMenuClass</a> o </li><li class="src short"><a href="#v:castToRecentChooserMenu">castToRecentChooserMenu</a> :: <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObjectClass">GObjectClass</a> obj => obj -> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></li><li class="src short"><a href="#v:toRecentChooserMenu">toRecentChooserMenu</a> :: <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenuClass">RecentChooserMenuClass</a> o => o -> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></li><li class="src short"><a href="#v:recentChooserMenuNew">recentChooserMenuNew</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></li><li class="src short"><a href="#v:recentChooserMenuNewForManager">recentChooserMenuNewForManager</a> :: <a href="Graphics-UI-Gtk-Recent-RecentManager.html#t:RecentManagerClass">RecentManagerClass</a> manager => manager -> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></li><li class="src short"><a href="#v:recentChooserMenuShowNumbers">recentChooserMenuShowNumbers</a> :: <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenuClass">RecentChooserMenuClass</a> self => <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-Attributes.html#t:Attr">Attr</a> self <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Bool.html#t:Bool">Bool</a></li></ul></div><div id="interface"><h1 id="g:1">Detail </h1><div class="doc"><p><code><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></code> is a widget suitable for displaying recently used files inside a menu. It can be used to set a sub-menu of a <code><a href="Graphics-UI-Gtk-MenuComboToolbar-MenuItem.html#t:MenuItem">MenuItem</a></code> using <code>menuItemSetSubmenu</code>, or as the menu of a <code><a href="Graphics-UI-Gtk-MenuComboToolbar-MenuToolButton.html#t:MenuToolButton">MenuToolButton</a></code>. </p><p>Note that <code><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></code> does not have any methods of its own. Instead, you should use the functions that work on a <code><a href="Graphics-UI-Gtk-Recent-RecentChooser.html#t:RecentChooser">RecentChooser</a></code>. </p><p>Note also that <code><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></code> does not support multiple filters, as it has no way to let the user choose between them as the <code><a href="Graphics-UI-Gtk-Recent-RecentChooserWidget.html#t:RecentChooserWidget">RecentChooserWidget</a></code> and <code>RecentChooserDialog</code> widgets do. Thus using <code>recentChooserAddFilter</code> on a <code><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></code> widget will yield the same effects as using <code>recentChooserSetFilter</code>, replacing any currently set filter with the supplied filter; <code>recentChooserRemoveFilter</code> will remove any currently set <code><a href="Graphics-UI-Gtk-Recent-RecentFilter.html#t:RecentFilter">RecentFilter</a></code> object and will unset the current filter; <code>recentChooserListFilters</code> will return a list containing a single <code><a href="Graphics-UI-Gtk-Recent-RecentFilter.html#t:RecentFilter">RecentFilter</a></code> object. </p><p>Recently used files are supported since Gtk+ 2.10. </p></div><h1 id="g:2">Class Hierarchy </h1><div class="doc"><pre> | <code><a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObject">GObject</a></code> | +----<code><a href="Graphics-UI-Gtk-Abstract-Object.html#t:Object">Object</a></code> | +----<code><a href="Graphics-UI-Gtk-Abstract-Widget.html#t:Widget">Widget</a></code> | +----<code><a href="Graphics-UI-Gtk-Abstract-Container.html#t:Container">Container</a></code> | +----<code><a href="Graphics-UI-Gtk-MenuComboToolbar-MenuShell.html#t:MenuShell">MenuShell</a></code> | +----<code><a href="Graphics-UI-Gtk-MenuComboToolbar-Menu.html#t:Menu">Menu</a></code> | +----RecentChooserMenu </pre></div><h1 id="g:3">Types </h1><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:RecentChooserMenu" class="def">RecentChooserMenu</a> <a href="src/Graphics-UI-Gtk-Types.html#RecentChooserMenu" class="link">Source</a></p><div class="subs instances"><p id="control.i:RecentChooserMenu" class="caption collapser" onclick="toggleSection('i:RecentChooserMenu')">Instances</p><div id="section.i:RecentChooserMenu" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Eq.html#t:Eq">Eq</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Ord.html#t:Ord">Ord</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObjectClass">GObjectClass</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenuClass">RecentChooserMenuClass</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-MenuComboToolbar-Menu.html#t:MenuClass">MenuClass</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-MenuComboToolbar-MenuShell.html#t:MenuShellClass">MenuShellClass</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Abstract-Container.html#t:ContainerClass">ContainerClass</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Abstract-Widget.html#t:WidgetClass">WidgetClass</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Abstract-Object.html#t:ObjectClass">ObjectClass</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">class</span> <a href="Graphics-UI-Gtk-MenuComboToolbar-Menu.html#t:MenuClass">MenuClass</a> o => <a name="t:RecentChooserMenuClass" class="def">RecentChooserMenuClass</a> o <a href="src/Graphics-UI-Gtk-Types.html#RecentChooserMenuClass" class="link">Source</a></p><div class="subs instances"><p id="control.i:RecentChooserMenuClass" class="caption collapser" onclick="toggleSection('i:RecentChooserMenuClass')">Instances</p><div id="section.i:RecentChooserMenuClass" class="show"><table><tr><td class="src"><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenuClass">RecentChooserMenuClass</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><a name="v:castToRecentChooserMenu" class="def">castToRecentChooserMenu</a> :: <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObjectClass">GObjectClass</a> obj => obj -> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a><a href="src/Graphics-UI-Gtk-Types.html#castToRecentChooserMenu" class="link">Source</a></p></div><div class="top"><p class="src"><a name="v:toRecentChooserMenu" class="def">toRecentChooserMenu</a> :: <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenuClass">RecentChooserMenuClass</a> o => o -> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a><a href="src/Graphics-UI-Gtk-Types.html#toRecentChooserMenu" class="link">Source</a></p></div><h1 id="g:4">Constructors </h1><div class="top"><p class="src"><a name="v:recentChooserMenuNew" class="def">recentChooserMenuNew</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a><a href="src/Graphics-UI-Gtk-Recent-RecentChooserMenu.html#recentChooserMenuNew" class="link">Source</a></p><div class="doc"><p>Creates a new <code><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></code> widget. </p><p>This kind of widget shows the list of recently used resources as a menu, each item as a menu item. Each item inside the menu might have an icon, representing its MIME type, and a number, for mnemonic access. </p><p>This widget implements the <code><a href="Graphics-UI-Gtk-Recent-RecentChooser.html#t:RecentChooser">RecentChooser</a></code> interface. </p><p>This widget creates its own <code><a href="Graphics-UI-Gtk-Recent-RecentManager.html#t:RecentManager">RecentManager</a></code> object. See the <code><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#v:recentChooserMenuNewForManager">recentChooserMenuNewForManager</a></code> function to know how to create a <code><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></code> widget bound to another <code><a href="Graphics-UI-Gtk-Recent-RecentManager.html#t:RecentManager">RecentManager</a></code> object. </p><ul><li> Available since Gtk+ version 2.10 </li></ul></div></div><div class="top"><p class="src"><a name="v:recentChooserMenuNewForManager" class="def">recentChooserMenuNewForManager</a><a href="src/Graphics-UI-Gtk-Recent-RecentChooserMenu.html#recentChooserMenuNewForManager" class="link">Source</a></p><div class="subs arguments"><p class="caption">Arguments</p><table><tr><td class="src">:: <a href="Graphics-UI-Gtk-Recent-RecentManager.html#t:RecentManagerClass">RecentManagerClass</a> manager</td><td class="doc empty"> </td></tr><tr><td class="src">=> manager</td><td class="doc"><p><code>manager</code> - a <code><a href="Graphics-UI-Gtk-Recent-RecentManager.html#t:RecentManager">RecentManager</a></code> </p></td></tr><tr><td class="src">-> <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></td><td class="doc"><p>returns a new <code><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></code>, bound to manager. </p></td></tr></table></div><div class="doc"><p>Creates a new <code><a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenu">RecentChooserMenu</a></code> widget using <code>manager</code> as the underlying recently used resources manager. </p><p>This is useful if you have implemented your own recent manager, or if you have a customized instance of a <code><a href="Graphics-UI-Gtk-Recent-RecentManager.html#t:RecentManager">RecentManager</a></code> object or if you wish to share a common <code><a href="Graphics-UI-Gtk-Recent-RecentManager.html#t:RecentManager">RecentManager</a></code> object among multiple <code><a href="Graphics-UI-Gtk-Recent-RecentChooser.html#t:RecentChooser">RecentChooser</a></code> widgets. </p><ul><li> Available since Gtk+ version 2.10 </li></ul></div></div><h1 id="g:5">Attributes </h1><div class="top"><p class="src"><a name="v:recentChooserMenuShowNumbers" class="def">recentChooserMenuShowNumbers</a> :: <a href="Graphics-UI-Gtk-Recent-RecentChooserMenu.html#t:RecentChooserMenuClass">RecentChooserMenuClass</a> self => <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-Attributes.html#t:Attr">Attr</a> self <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Bool.html#t:Bool">Bool</a><a href="src/Graphics-UI-Gtk-Recent-RecentChooserMenu.html#recentChooserMenuShowNumbers" class="link">Source</a></p><div class="doc"><p>Whether the first ten items in the menu should be prepended by a number acting as a unique mnemonic. </p><p>Default value: <code><a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Bool.html#v:False">False</a></code> </p><ul><li> Available since Gtk+ version 2.10 </li></ul></div></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.9.2</p></div></body></html>