GtkRecentChooser            package:RGtk2            R Documentation

_G_t_k_R_e_c_e_n_t_C_h_o_o_s_e_r

_D_e_s_c_r_i_p_t_i_o_n:

     Interface implemented by widgets displaying recently used files

_M_e_t_h_o_d_s _a_n_d _F_u_n_c_t_i_o_n_s:

     'gtkRecentChooserSetShowPrivate(object, show.private)'
      'gtkRecentChooserGetShowPrivate(object)'
      'gtkRecentChooserSetShowNotFound(object, show.not.found)'
      'gtkRecentChooserGetShowNotFound(object)'
      'gtkRecentChooserSetShowIcons(object, show.icons)'
      'gtkRecentChooserGetShowIcons(object)'
      'gtkRecentChooserSetSelectMultiple(object, select.multiple)'
      'gtkRecentChooserGetSelectMultiple(object)'
      'gtkRecentChooserSetLocalOnly(object, local.only)'
      'gtkRecentChooserGetLocalOnly(object)'
      'gtkRecentChooserSetLimit(object, limit)'
      'gtkRecentChooserGetLimit(object)'
      'gtkRecentChooserSetShowTips(object, show.tips)'
      'gtkRecentChooserGetShowTips(object)'
      'gtkRecentChooserSetSortType(object, sort.type)'
      'gtkRecentChooserGetSortType(object)'
      'gtkRecentChooserSetSortFunc(object, sort.func, sort.data)'
      'gtkRecentChooserSetCurrentUri(object, uri, .errwarn = TRUE)'
      'gtkRecentChooserGetCurrentUri(object)'
      'gtkRecentChooserGetCurrentItem(object)'
      'gtkRecentChooserSelectUri(object, uri, .errwarn = TRUE)'
      'gtkRecentChooserUnselectUri(object, uri)'
      'gtkRecentChooserSelectAll(object)'
      'gtkRecentChooserUnselectAll(object)'
      'gtkRecentChooserGetItems(object)'
      'gtkRecentChooserGetUris(object)'
      'gtkRecentChooserAddFilter(object, filter)'
      'gtkRecentChooserRemoveFilter(object, filter)'
      'gtkRecentChooserListFilters(object)'
      'gtkRecentChooserSetFilter(object, filter)'
      'gtkRecentChooserGetFilter(object)'

_H_i_e_r_a_r_c_h_y:

     GInterface
        +----GtkRecentChooser 

_I_m_p_l_e_m_e_n_t_a_t_i_o_n_s:

     GtkRecentChooser is implemented by 'GtkRecentChooserMenu', 
     'GtkRecentChooserDialog',  'GtkRecentChooserWidget' and 
     'GtkRecentAction'.

_D_e_t_a_i_l_e_d _D_e_s_c_r_i_p_t_i_o_n:

     'GtkRecentChooser' is an interface that can be implemented by
     widgets displaying the list of recently used files.  In GTK+, the
     main objects that implement this interface are
     'GtkRecentChooserWidget', 'GtkRecentChooserDialog' and
     'GtkRecentChooserMenu'.

     Recently used files are supported since GTK+ 2.10.

_S_t_r_u_c_t_u_r_e_s:


     '_G_t_k_R_e_c_e_n_t_C_h_o_o_s_e_r' _undocumented _


_E_n_u_m_s _a_n_d _F_l_a_g_s:


     '_G_t_k_R_e_c_e_n_t_C_h_o_o_s_e_r_E_r_r_o_r' These identify the various errors that can
          occur while calling 'GtkRecentChooser' functions.

          '_n_o_t-_f_o_u_n_d' Indicates that a file does not exist

          '_i_n_v_a_l_i_d-_u_r_i' Indicates a malformed URI


     '_G_t_k_R_e_c_e_n_t_S_o_r_t_T_y_p_e' Used to specify the sorting method to be
          applyed to the recently used resource list.  

          '_n_o_n_e' Do not sort the returned list of recently used
               resources.

          '_m_r_u' Sort the returned list with the most recently used
               items first.

          '_l_r_u' Sort the returned list with the least recently used
               items first.

          '_c_u_s_t_o_m' Sort the returned list using a custom sorting
               function passed using 'gtkRecentManagerSetSortFunc()'.


_U_s_e_r _F_u_n_c_t_i_o_n_s:


     '_G_t_k_R_e_c_e_n_t_S_o_r_t_F_u_n_c(_a, _b, _u_s_e_r._d_a_t_a)' _undocumented _

          '_a' ['GtkRecentInfo'] 

          '_b' ['GtkRecentInfo'] 

          '_u_s_e_r._d_a_t_a' [R object] 


_S_i_g_n_a_l_s:


     '_i_t_e_m-_a_c_t_i_v_a_t_e_d(_c_h_o_o_s_e_r, _u_s_e_r._d_a_t_a)' This signal is emitted when
          the user "activates" a recent item in the recent chooser. 
          This can happen by double-clicking on an item in the recently
          used resources list, or by pressing 'Enter'.  

          Since  2.10

          '_c_h_o_o_s_e_r' ['GtkRecentChooser']  the object which received the
               signal

          '_u_s_e_r._d_a_t_a' [R object] user data set when the signal handler
               was connected.


     '_s_e_l_e_c_t_i_o_n-_c_h_a_n_g_e_d(_c_h_o_o_s_e_r, _u_s_e_r._d_a_t_a)' This signal is emitted
          when there is a change in the set of selected recently used
          resources.  This can happen when a user modifies the
          selection with the mouse or the keyboard, or when explicitely
          calling functions to change the selection.  

          Since  2.10

          '_c_h_o_o_s_e_r' ['GtkRecentChooser']  the object which received the
               signal

          '_u_s_e_r._d_a_t_a' [R object] user data set when the signal handler
               was connected.


_P_r_o_p_e_r_t_i_e_s:


     '_f_i_l_t_e_r' ['_G_t_k_R_e_c_e_n_t_F_i_l_t_e_r' : _R_e_a_d / _W_r_i_t_e] The 'GtkRecentFilter'
          object to be used when displaying the recently used
          resources.  

          Since  2.10


     '_l_i_m_i_t' [_i_n_t_e_g_e_r : _R_e_a_d / _W_r_i_t_e] The maximum number of recently
          used resources to be displayed, or -1 to display all items.
          By default, the GtkSetting:gtk-recent-files-limit setting is
          respected: you can override that limit on a particular
          instance of 'GtkRecentChooser' by setting this property.  

          Allowed values: >= -1  Default value: -1  Since  2.10


     '_l_o_c_a_l-_o_n_l_y' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Whether this
          'GtkRecentChooser' should display only local (file:)
          resources.  

          Default value: TRUE  Since  2.10


     '_r_e_c_e_n_t-_m_a_n_a_g_e_r' ['_G_t_k_R_e_c_e_n_t_M_a_n_a_g_e_r' : _W_r_i_t_e / _C_o_n_s_t_r_u_c_t _O_n_l_y] The
          'GtkRecentManager' instance used by the 'GtkRecentChooser' to
          display the list of recently used resources.  

          Since  2.10


     '_s_e_l_e_c_t-_m_u_l_t_i_p_l_e' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Allow the user to
          select multiple resources.  

          Default value: FALSE  Since  2.10


     '_s_h_o_w-_i_c_o_n_s' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Whether this
          'GtkRecentChooser' should display an icon near the item.  

          Default value: TRUE  Since  2.10


     '_s_h_o_w-_n_o_t-_f_o_u_n_d' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Whether this
          'GtkRecentChooser' should display the recently used resources
          even if not present anymore. Setting this to 'FALSE' will
          perform a potentially expensive check on every local resource
          (every remote resource will always be displayed).  

          Default value: TRUE  Since  2.10


     '_s_h_o_w-_p_r_i_v_a_t_e' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Whether the private items
          should be displayed.  Default value: FALSE


     '_s_h_o_w-_t_i_p_s' [_l_o_g_i_c_a_l : _R_e_a_d / _W_r_i_t_e] Whether this
          'GtkRecentChooser' should display a tooltip containing the
          full path of the recently used resources.  

          Default value: FALSE  Since  2.10


     '_s_o_r_t-_t_y_p_e' ['_G_t_k_R_e_c_e_n_t_S_o_r_t_T_y_p_e' : _R_e_a_d / _W_r_i_t_e] Sorting order to
          be used when displaying the recently used resources.  

          Default value: GTK_RECENT_SORT_NONE  Since  2.10


_A_u_t_h_o_r(_s):

     Derived by RGtkGen from GTK+ documentation

_R_e_f_e_r_e_n_c_e_s:

     <URL:
     http://developer.gnome.org/doc/API/2.0/gtk/GtkRecentChooser.html>

_S_e_e _A_l_s_o:

     'GtkRecentManager' 'GtkRecentChooserDialog'
     'GtkRecentChooserWidget' 'GtkRecentChooserMenu'

