Gtk.Recent_Chooser_Menu

Entities

Tagged Types

Access Types

Constants

Subprograms

Generic Instantiations

Description

Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu is a widget suitable for displaying recently used files inside a menu. It can be used to set a sub-menu of a Gtk.Menu_Item.Gtk_Menu_Item using Gtk.Menu_Item.Set_Submenu, or as the menu of a Gtk.Menu_Tool_Button.Gtk_Menu_Tool_Button.

Note that Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu does not have any methods of its own. Instead, you should use the functions that work on a Gtk.Recent_Chooser.Gtk_Recent_Chooser.

Note also that Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu does not support multiple filters, as it has no way to let the user choose between them as the Gtk.Recent_Chooser_Widget.Gtk_Recent_Chooser_Widget and Gtk.Recent_Chooser_Dialog.Gtk_Recent_Chooser_Dialog widgets do. Thus using Gtk.Recent_Chooser.Add_Filter on a Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu widget will yield the same effects as using Gtk.Recent_Chooser.Set_Filter, replacing any currently set filter with the supplied filter; Gtk.Recent_Chooser.Remove_Filter will remove any currently set Gtk.Recent_Filter.Gtk_Recent_Filter object and will unset the current filter; Gtk.Recent_Chooser.List_Filters will return a list containing a single Gtk.Recent_Filter.Gtk_Recent_Filter object.

Recently used files are supported since GTK+ 2.10.

"+"

function "+"
  (Widget : access Gtk_Recent_Chooser_Menu_Record'Class)
return Gtk.Activatable.Gtk_Activatable
Parameters
Widget
Return Value

"+"

function "+"
  (Widget : access Gtk_Recent_Chooser_Menu_Record'Class)
return Gtk.Buildable.Gtk_Buildable
Parameters
Widget
Return Value

"+"

function "+"
  (Widget : access Gtk_Recent_Chooser_Menu_Record'Class)
return Gtk.Recent_Chooser.Gtk_Recent_Chooser
Parameters
Widget
Return Value

"-"

function "-"
  (Interf : Gtk.Activatable.Gtk_Activatable)
return Gtk_Recent_Chooser_Menu
Parameters
Interf
Return Value

"-"

function "-"
  (Interf : Gtk.Buildable.Gtk_Buildable)
return Gtk_Recent_Chooser_Menu
Parameters
Interf
Return Value

"-"

function "-"
  (Interf : Gtk.Recent_Chooser.Gtk_Recent_Chooser)
return Gtk_Recent_Chooser_Menu
Parameters
Interf
Return Value

Add_Filter

procedure Add_Filter
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record;
    Filter  : not null access Gtk.Recent_Filter.Gtk_Recent_Filter_Record'Class)
Parameters
Chooser
Filter

Do_Set_Related_Action

procedure Do_Set_Related_Action
   (Self   : not null access Gtk_Recent_Chooser_Menu_Record;
    Action : not null access Gtk.Action.Gtk_Action_Record'Class)
Parameters
Self
Action

Get_Current_Item

function Get_Current_Item
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Gtk.Recent_Info.Gtk_Recent_Info
Parameters
Chooser
Return Value

Get_Current_Uri

function Get_Current_Uri
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return UTF8_String
Parameters
Chooser
Return Value

Get_Filter

function Get_Filter
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Gtk.Recent_Filter.Gtk_Recent_Filter
Parameters
Chooser
Return Value

Get_Items

function Get_Items
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Gtk.Recent_Manager.Gtk_Recent_Info_List.Glist
Parameters
Chooser
Return Value

Get_Limit

function Get_Limit
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Glib.Gint
Parameters
Chooser
Return Value

Get_Local_Only

function Get_Local_Only
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Boolean
Parameters
Chooser
Return Value

Get_Related_Action

function Get_Related_Action
   (Self : not null access Gtk_Recent_Chooser_Menu_Record)
    return Gtk.Action.Gtk_Action
Parameters
Self
Return Value

Get_Select_Multiple

function Get_Select_Multiple
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Boolean
Parameters
Chooser
Return Value

Get_Show_Icons

function Get_Show_Icons
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Boolean
Parameters
Chooser
Return Value

Get_Show_Not_Found

function Get_Show_Not_Found
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Boolean
Parameters
Chooser
Return Value

Get_Show_Numbers

function Get_Show_Numbers
   (Self : not null access Gtk_Recent_Chooser_Menu_Record) return Boolean

Returns the value set by Gtk.Recent_Chooser_Menu.Set_Show_Numbers. Since: gtk+ 2.10

Parameters
Self
Return Value

True if numbers should be shown.

Get_Show_Private

function Get_Show_Private
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Boolean
Parameters
Chooser
Return Value

Get_Show_Tips

function Get_Show_Tips
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Boolean
Parameters
Chooser
Return Value

Get_Sort_Type

function Get_Sort_Type
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Gtk.Recent_Chooser.Gtk_Recent_Sort_Type
Parameters
Chooser
Return Value

Get_Type

function Get_Type return Glib.GType
Return Value

Get_Use_Action_Appearance

function Get_Use_Action_Appearance
   (Self : not null access Gtk_Recent_Chooser_Menu_Record) return Boolean
Parameters
Self
Return Value

Gtk_New

procedure Gtk_New (Self : out Gtk_Recent_Chooser_Menu)

Creates a new Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu widget. 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. This widget implements the Gtk.Recent_Chooser.Gtk_Recent_Chooser interface. This widget creates its own Gtk.Recent_Manager.Gtk_Recent_Manager object. See the Gtk.Recent_Chooser_Menu.Gtk_New_For_Manager function to know how to create a Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu widget bound to another Gtk.Recent_Manager.Gtk_Recent_Manager object. Since: gtk+ 2.10 Initialize does nothing if the object was already created with another call to Initialize* or G_New.

Parameters
Self

Gtk_New_For_Manager

procedure Gtk_New_For_Manager
   (Self    : out Gtk_Recent_Chooser_Menu;
    Manager : not null access Gtk.Recent_Manager.Gtk_Recent_Manager_Record'Class)

Creates a new Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu widget using Manager as the underlying recently used resources manager. This is useful if you have implemented your own recent manager, or if you have a customized instance of a Gtk.Recent_Manager.Gtk_Recent_Manager object or if you wish to share a common Gtk.Recent_Manager.Gtk_Recent_Manager object among multiple Gtk.Recent_Chooser.Gtk_Recent_Chooser widgets. Since: gtk+ 2.10 Initialize_For_Manager does nothing if the object was already created with another call to Initialize* or G_New.

Parameters
Self
Manager

a Gtk.Recent_Manager.Gtk_Recent_Manager

Gtk_Recent_Chooser_Menu

type Gtk_Recent_Chooser_Menu is access all Gtk_Recent_Chooser_Menu_Record'Class;

Gtk_Recent_Chooser_Menu_New

function Gtk_Recent_Chooser_Menu_New return Gtk_Recent_Chooser_Menu

Creates a new Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu widget. 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. This widget implements the Gtk.Recent_Chooser.Gtk_Recent_Chooser interface. This widget creates its own Gtk.Recent_Manager.Gtk_Recent_Manager object. See the Gtk.Recent_Chooser_Menu.Gtk_New_For_Manager function to know how to create a Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu widget bound to another Gtk.Recent_Manager.Gtk_Recent_Manager object. Since: gtk+ 2.10

Return Value

Gtk_Recent_Chooser_Menu_New_For_Manager

function Gtk_Recent_Chooser_Menu_New_For_Manager
   (Manager : not null access Gtk.Recent_Manager.Gtk_Recent_Manager_Record'Class)
    return Gtk_Recent_Chooser_Menu

Creates a new Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu widget using Manager as the underlying recently used resources manager. This is useful if you have implemented your own recent manager, or if you have a customized instance of a Gtk.Recent_Manager.Gtk_Recent_Manager object or if you wish to share a common Gtk.Recent_Manager.Gtk_Recent_Manager object among multiple Gtk.Recent_Chooser.Gtk_Recent_Chooser widgets. Since: gtk+ 2.10

Parameters
Manager

a Gtk.Recent_Manager.Gtk_Recent_Manager

Return Value

Gtk_Recent_Chooser_Menu_Record

type Gtk_Recent_Chooser_Menu_Record is new Gtk_Menu_Record with null record;

Gtk_Recent_Sort_Func

type Gtk_Recent_Sort_Func is access function
  (A : Gtk.Recent_Info.Gtk_Recent_Info;
   B : Gtk.Recent_Info.Gtk_Recent_Info) return Glib.Gint;
Parameters
A
B
Return Value

Implements_Gtk_Activatable

package Implements_Gtk_Activatable is new Glib.Types.Implements
  (Gtk.Activatable.Gtk_Activatable, Gtk_Recent_Chooser_Menu_Record, Gtk_Recent_Chooser_Menu);

Implements_Gtk_Buildable

package Implements_Gtk_Buildable is new Glib.Types.Implements
  (Gtk.Buildable.Gtk_Buildable, Gtk_Recent_Chooser_Menu_Record, Gtk_Recent_Chooser_Menu);

Implements_Gtk_Recent_Chooser

package Implements_Gtk_Recent_Chooser is new Glib.Types.Implements
  (Gtk.Recent_Chooser.Gtk_Recent_Chooser, Gtk_Recent_Chooser_Menu_Record, Gtk_Recent_Chooser_Menu);

Initialize

procedure Initialize
   (Self : not null access Gtk_Recent_Chooser_Menu_Record'Class)

Creates a new Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu widget. 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. This widget implements the Gtk.Recent_Chooser.Gtk_Recent_Chooser interface. This widget creates its own Gtk.Recent_Manager.Gtk_Recent_Manager object. See the Gtk.Recent_Chooser_Menu.Gtk_New_For_Manager function to know how to create a Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu widget bound to another Gtk.Recent_Manager.Gtk_Recent_Manager object. Since: gtk+ 2.10 Initialize does nothing if the object was already created with another call to Initialize* or G_New.

Parameters
Self

Initialize_For_Manager

procedure Initialize_For_Manager
   (Self    : not null access Gtk_Recent_Chooser_Menu_Record'Class;
    Manager : not null access Gtk.Recent_Manager.Gtk_Recent_Manager_Record'Class)

Creates a new Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu widget using Manager as the underlying recently used resources manager. This is useful if you have implemented your own recent manager, or if you have a customized instance of a Gtk.Recent_Manager.Gtk_Recent_Manager object or if you wish to share a common Gtk.Recent_Manager.Gtk_Recent_Manager object among multiple Gtk.Recent_Chooser.Gtk_Recent_Chooser widgets. Since: gtk+ 2.10 Initialize_For_Manager does nothing if the object was already created with another call to Initialize* or G_New.

Parameters
Self
Manager

a Gtk.Recent_Manager.Gtk_Recent_Manager

List_Filters

function List_Filters
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
    return Gtk.Recent_Filter.Gtk_Recent_Filter_List.GSlist
Parameters
Chooser
Return Value

Remove_Filter

procedure Remove_Filter
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record;
    Filter  : not null access Gtk.Recent_Filter.Gtk_Recent_Filter_Record'Class)
Parameters
Chooser
Filter

Select_All

procedure Select_All
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
Parameters
Chooser

Select_Uri

function Select_Uri
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record;
    URI     : UTF8_String) return Boolean
Parameters
Chooser
URI
Return Value

Set_Current_Uri

function Set_Current_Uri
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record;
    URI     : UTF8_String) return Boolean
Parameters
Chooser
URI
Return Value

Set_Filter

procedure Set_Filter
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record;
    Filter  : access Gtk.Recent_Filter.Gtk_Recent_Filter_Record'Class)
Parameters
Chooser
Filter

Set_Limit

procedure Set_Limit
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record;
    Limit   : Glib.Gint)
Parameters
Chooser
Limit

Set_Local_Only

procedure Set_Local_Only
   (Chooser    : not null access Gtk_Recent_Chooser_Menu_Record;
    Local_Only : Boolean)
Parameters
Chooser
Local_Only

Set_Related_Action

procedure Set_Related_Action
   (Self   : not null access Gtk_Recent_Chooser_Menu_Record;
    Action : not null access Gtk.Action.Gtk_Action_Record'Class)
Parameters
Self
Action

Set_Select_Multiple

procedure Set_Select_Multiple
   (Chooser         : not null access Gtk_Recent_Chooser_Menu_Record;
    Select_Multiple : Boolean)
Parameters
Chooser
Select_Multiple

Set_Show_Icons

procedure Set_Show_Icons
   (Chooser    : not null access Gtk_Recent_Chooser_Menu_Record;
    Show_Icons : Boolean)
Parameters
Chooser
Show_Icons

Set_Show_Not_Found

procedure Set_Show_Not_Found
   (Chooser        : not null access Gtk_Recent_Chooser_Menu_Record;
    Show_Not_Found : Boolean)
Parameters
Chooser
Show_Not_Found

Set_Show_Numbers

procedure Set_Show_Numbers
   (Self         : not null access Gtk_Recent_Chooser_Menu_Record;
    Show_Numbers : Boolean)

Sets whether a number should be added to the items of Menu. The numbers are shown to provide a unique character for a mnemonic to be used inside ten menu item's label. Only the first the items get a number to avoid clashes. Since: gtk+ 2.10

Parameters
Self
Show_Numbers

whether to show numbers

Set_Show_Private

procedure Set_Show_Private
   (Chooser      : not null access Gtk_Recent_Chooser_Menu_Record;
    Show_Private : Boolean)
Parameters
Chooser
Show_Private

Set_Show_Tips

procedure Set_Show_Tips
   (Chooser   : not null access Gtk_Recent_Chooser_Menu_Record;
    Show_Tips : Boolean)
Parameters
Chooser
Show_Tips

Set_Sort_Func

procedure Set_Sort_Func
   (Chooser      : not null access Gtk_Recent_Chooser_Menu_Record;
    Sort_Func    : Gtk_Recent_Sort_Func;
    Data_Destroy : Glib.G_Destroy_Notify_Address)

Sets the comparison function used when sorting to be Sort_Func. If the Chooser has the sort type set to GTK_RECENT_SORT_CUSTOM then the chooser will sort using this function. To the comparison function will be passed two Gtk.Recent_Info.Gtk_Recent_Info structs and Sort_Data; Sort_Func should return a positive integer if the first item comes before the second, zero if the two items are equal and a negative integer if the first item comes after the second. Since: gtk+ 2.10

Parameters
Chooser
Sort_Func

the comparison function

Data_Destroy

destroy notifier for Sort_Data, or null

Set_Sort_Type

procedure Set_Sort_Type
   (Chooser   : not null access Gtk_Recent_Chooser_Menu_Record;
    Sort_Type : Gtk.Recent_Chooser.Gtk_Recent_Sort_Type)
Parameters
Chooser
Sort_Type

Set_Use_Action_Appearance

procedure Set_Use_Action_Appearance
   (Self           : not null access Gtk_Recent_Chooser_Menu_Record;
    Use_Appearance : Boolean)
Parameters
Self
Use_Appearance

Show_Numbers_Property

Show_Numbers_Property : constant Glib.Properties.Property_Boolean;

Whether the first ten items in the menu should be prepended by a number acting as a unique mnemonic.

Sync_Action_Properties

procedure Sync_Action_Properties
   (Self   : not null access Gtk_Recent_Chooser_Menu_Record;
    Action : access Gtk.Action.Gtk_Action_Record'Class)
Parameters
Self
Action

Unselect_All

procedure Unselect_All
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record)
Parameters
Chooser

Unselect_Uri

procedure Unselect_Uri
   (Chooser : not null access Gtk_Recent_Chooser_Menu_Record;
    URI     : UTF8_String)
Parameters
Chooser
URI