Gtk.Recent_Action

Entities

Tagged Types

• Gtk_Recent_Action_Record

Access Types

• Gtk_Recent_Action
• Gtk_Recent_Sort_Func

Constants

• Show_Numbers_Property

Subprograms

• "+"
• "+"
• "-"
• "-"
• Add_Filter
• Get_Current_Item
• Get_Current_Uri
• Get_Filter
• Get_Items
• Get_Limit
• Get_Local_Only
• Get_Select_Multiple
• Get_Show_Icons
• Get_Show_Not_Found
• Get_Show_Numbers
• Get_Show_Private
• Get_Show_Tips
• Get_Sort_Type
• Get_Type
• Gtk_New
• Gtk_New_For_Manager
• Gtk_Recent_Action_New
• Gtk_Recent_Action_New_For_Manager
• Initialize
• Initialize_For_Manager
• List_Filters
• Remove_Filter
• Select_All
• Select_Uri
• Set_Current_Uri
• Set_Filter
• Set_Limit
• Set_Local_Only
• Set_Select_Multiple
• Set_Show_Icons
• Set_Show_Not_Found
• Set_Show_Numbers
• Set_Show_Private
• Set_Show_Tips
• Set_Sort_Func
• Set_Sort_Type
• Unselect_All
• Unselect_Uri

Generic Instantiations

• Implements_Gtk_Buildable
• Implements_Gtk_Recent_Chooser

Description

A Gtk.Recent_Action.Gtk_Recent_Action represents a list of recently used files, which can be shown by widgets such as Gtk.Recent_Chooser_Dialog.Gtk_Recent_Chooser_Dialog or Gtk.Recent_Chooser_Menu.Gtk_Recent_Chooser_Menu.

To construct a submenu showing recently used files, use a Gtk.Recent_Action.Gtk_Recent_Action as the action for a <menuitem>. To construct a menu toolbutton showing the recently used files in the popup menu, use a Gtk.Recent_Action.Gtk_Recent_Action as the action for a <toolitem> element.

"+"

function "+"
  (Widget : access Gtk_Recent_Action_Record'Class)
return Gtk.Buildable.Gtk_Buildable

Parameters

Widget

Return Value

"+"

function "+"
  (Widget : access Gtk_Recent_Action_Record'Class)
return Gtk.Recent_Chooser.Gtk_Recent_Chooser

Parameters

Widget

Return Value

"-"

function "-"
  (Interf : Gtk.Buildable.Gtk_Buildable)
return Gtk_Recent_Action

Parameters

Interf

Return Value

"-"

function "-"
  (Interf : Gtk.Recent_Chooser.Gtk_Recent_Chooser)
return Gtk_Recent_Action

Parameters

Interf

Return Value

Add_Filter

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

Parameters

Chooser

Filter

Get_Current_Item

function Get_Current_Item
   (Chooser : not null access Gtk_Recent_Action_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_Action_Record)
    return UTF8_String

Parameters

Chooser

Return Value

Get_Filter

function Get_Filter
   (Chooser : not null access Gtk_Recent_Action_Record)
    return Gtk.Recent_Filter.Gtk_Recent_Filter

Parameters

Chooser

Return Value

Get_Items

function Get_Items
   (Chooser : not null access Gtk_Recent_Action_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_Action_Record) return Glib.Gint

Parameters

Chooser

Return Value

Get_Local_Only

function Get_Local_Only
   (Chooser : not null access Gtk_Recent_Action_Record) return Boolean

Parameters

Chooser

Return Value

Get_Select_Multiple

function Get_Select_Multiple
   (Chooser : not null access Gtk_Recent_Action_Record) return Boolean

Parameters

Chooser

Return Value

Get_Show_Icons

function Get_Show_Icons
   (Chooser : not null access Gtk_Recent_Action_Record) return Boolean

Parameters

Chooser

Return Value

Get_Show_Not_Found

function Get_Show_Not_Found
   (Chooser : not null access Gtk_Recent_Action_Record) return Boolean

Parameters

Chooser

Return Value

Get_Show_Numbers

function Get_Show_Numbers
   (Widget : not null access Gtk_Recent_Action_Record) return Boolean

Returns the value set by Gtk.Recent_Chooser_Menu.Set_Show_Numbers. Since: gtk+ 2.12 Deprecated since 3.10, 1

Parameters

Widget

Return Value

True if numbers should be shown.

Get_Show_Private

function Get_Show_Private
   (Chooser : not null access Gtk_Recent_Action_Record) return Boolean

Parameters

Chooser

Return Value

Get_Show_Tips

function Get_Show_Tips
   (Chooser : not null access Gtk_Recent_Action_Record) return Boolean

Parameters

Chooser

Return Value

Get_Sort_Type

function Get_Sort_Type
   (Chooser : not null access Gtk_Recent_Action_Record)
    return Gtk.Recent_Chooser.Gtk_Recent_Sort_Type

Parameters

Chooser

Return Value

Get_Type

function Get_Type return Glib.GType

Return Value

Gtk_New

procedure Gtk_New
   (Widget   : out Gtk_Recent_Action;
    Name     : UTF8_String;
    Label    : UTF8_String := "";
    Tooltip  : UTF8_String := "";
    Stock_Id : UTF8_String := "")

Creates a new Gtk.Recent_Action.Gtk_Recent_Action object. To add the action to a Gtk.Action_Group.Gtk_Action_Group and set the accelerator for the action, call Gtk.Action_Group.Add_Action_With_Accel. Since: gtk+ 2.12 Initialize does nothing if the object was already created with another call to Initialize* or G_New.

Parameters

Widget

Name

a unique name for the action

Label

the label displayed in menu items and on buttons, or null

Tooltip

a tooltip for the action, or null

Stock_Id

the stock icon to display in widgets representing the action, or null

Gtk_New_For_Manager

procedure Gtk_New_For_Manager
   (Widget   : out Gtk_Recent_Action;
    Name     : UTF8_String;
    Label    : UTF8_String := "";
    Tooltip  : UTF8_String := "";
    Stock_Id : UTF8_String := "";
    Manager  : access Gtk.Recent_Manager.Gtk_Recent_Manager_Record'Class := Gtk.Recent_Manager.Get_Default)

Creates a new Gtk.Recent_Action.Gtk_Recent_Action object. To add the action to a Gtk.Action_Group.Gtk_Action_Group and set the accelerator for the action, call Gtk.Action_Group.Add_Action_With_Accel. Since: gtk+ 2.12 Initialize_For_Manager does nothing if the object was already created with another call to Initialize* or G_New.

Parameters

Widget

Name

a unique name for the action

Label

the label displayed in menu items and on buttons, or null

Tooltip

a tooltip for the action, or null

Stock_Id

the stock icon to display in widgets representing the action, or null

Manager

a Gtk.Recent_Manager.Gtk_Recent_Manager, or null for using the default Gtk.Recent_Manager.Gtk_Recent_Manager

Gtk_Recent_Action

type Gtk_Recent_Action is access all Gtk_Recent_Action_Record'Class;

Gtk_Recent_Action_New

function Gtk_Recent_Action_New
   (Name     : UTF8_String;
    Label    : UTF8_String := "";
    Tooltip  : UTF8_String := "";
    Stock_Id : UTF8_String := "") return Gtk_Recent_Action

Creates a new Gtk.Recent_Action.Gtk_Recent_Action object. To add the action to a Gtk.Action_Group.Gtk_Action_Group and set the accelerator for the action, call Gtk.Action_Group.Add_Action_With_Accel. Since: gtk+ 2.12

Parameters

Name

a unique name for the action

Label

the label displayed in menu items and on buttons, or null

Tooltip

a tooltip for the action, or null

Stock_Id

the stock icon to display in widgets representing the action, or null

Return Value

Gtk_Recent_Action_New_For_Manager

function Gtk_Recent_Action_New_For_Manager
   (Name     : UTF8_String;
    Label    : UTF8_String := "";
    Tooltip  : UTF8_String := "";
    Stock_Id : UTF8_String := "";
    Manager  : access Gtk.Recent_Manager.Gtk_Recent_Manager_Record'Class := Gtk.Recent_Manager.Get_Default)
    return Gtk_Recent_Action

Creates a new Gtk.Recent_Action.Gtk_Recent_Action object. To add the action to a Gtk.Action_Group.Gtk_Action_Group and set the accelerator for the action, call Gtk.Action_Group.Add_Action_With_Accel. Since: gtk+ 2.12

Parameters

Name

a unique name for the action

Label

the label displayed in menu items and on buttons, or null

Tooltip

a tooltip for the action, or null

Stock_Id

the stock icon to display in widgets representing the action, or null

Manager

a Gtk.Recent_Manager.Gtk_Recent_Manager, or null for using the default Gtk.Recent_Manager.Gtk_Recent_Manager

Return Value

Gtk_Recent_Action_Record

type Gtk_Recent_Action_Record is new Gtk_Action_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_Buildable

package Implements_Gtk_Buildable is new Glib.Types.Implements
  (Gtk.Buildable.Gtk_Buildable, Gtk_Recent_Action_Record, Gtk_Recent_Action);

Implements_Gtk_Recent_Chooser

package Implements_Gtk_Recent_Chooser is new Glib.Types.Implements
  (Gtk.Recent_Chooser.Gtk_Recent_Chooser, Gtk_Recent_Action_Record, Gtk_Recent_Action);

Initialize

procedure Initialize
   (Widget   : not null access Gtk_Recent_Action_Record'Class;
    Name     : UTF8_String;
    Label    : UTF8_String := "";
    Tooltip  : UTF8_String := "";
    Stock_Id : UTF8_String := "")

Creates a new Gtk.Recent_Action.Gtk_Recent_Action object. To add the action to a Gtk.Action_Group.Gtk_Action_Group and set the accelerator for the action, call Gtk.Action_Group.Add_Action_With_Accel. Since: gtk+ 2.12 Initialize does nothing if the object was already created with another call to Initialize* or G_New.

Parameters

Widget

Name

a unique name for the action

Label

the label displayed in menu items and on buttons, or null

Tooltip

a tooltip for the action, or null

Stock_Id

the stock icon to display in widgets representing the action, or null

Initialize_For_Manager

procedure Initialize_For_Manager
   (Widget   : not null access Gtk_Recent_Action_Record'Class;
    Name     : UTF8_String;
    Label    : UTF8_String := "";
    Tooltip  : UTF8_String := "";
    Stock_Id : UTF8_String := "";
    Manager  : access Gtk.Recent_Manager.Gtk_Recent_Manager_Record'Class := Gtk.Recent_Manager.Get_Default)

Creates a new Gtk.Recent_Action.Gtk_Recent_Action object. To add the action to a Gtk.Action_Group.Gtk_Action_Group and set the accelerator for the action, call Gtk.Action_Group.Add_Action_With_Accel. Since: gtk+ 2.12 Initialize_For_Manager does nothing if the object was already created with another call to Initialize* or G_New.

Parameters

Widget

Name

a unique name for the action

Label

the label displayed in menu items and on buttons, or null

Tooltip

a tooltip for the action, or null

Stock_Id

the stock icon to display in widgets representing the action, or null

Manager

a Gtk.Recent_Manager.Gtk_Recent_Manager, or null for using the default Gtk.Recent_Manager.Gtk_Recent_Manager

List_Filters

function List_Filters
   (Chooser : not null access Gtk_Recent_Action_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_Action_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_Action_Record)

Parameters

Chooser

Select_Uri

function Select_Uri
   (Chooser : not null access Gtk_Recent_Action_Record;
    URI     : UTF8_String) return Boolean

Parameters

Chooser

URI

Return Value

Set_Current_Uri

function Set_Current_Uri
   (Chooser : not null access Gtk_Recent_Action_Record;
    URI     : UTF8_String) return Boolean

Parameters

Chooser

URI

Return Value

Set_Filter

procedure Set_Filter
   (Chooser : not null access Gtk_Recent_Action_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_Action_Record;
    Limit   : Glib.Gint)

Parameters

Chooser

Limit

Set_Local_Only

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

Parameters

Chooser

Local_Only

Set_Select_Multiple

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

Parameters

Chooser

Select_Multiple

Set_Show_Icons

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

Parameters

Chooser

Show_Icons

Set_Show_Not_Found

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

Parameters

Chooser

Show_Not_Found

Set_Show_Numbers

procedure Set_Show_Numbers
   (Widget       : not null access Gtk_Recent_Action_Record;
    Show_Numbers : Boolean)

Sets whether a number should be added to the items shown by the widgets representing Action. The numbers are shown to provide a unique character for a mnemonic to be used inside the menu item's label. Only the first ten items get a number to avoid clashes. Since: gtk+ 2.12 Deprecated since 3.10, 1

Parameters

Widget

Show_Numbers

True if the shown items should be numbered

Set_Show_Private

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

Parameters

Chooser

Show_Private

Set_Show_Tips

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

Parameters

Chooser

Show_Tips

Set_Sort_Func

procedure Set_Sort_Func
   (Chooser      : not null access Gtk_Recent_Action_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_Action_Record;
    Sort_Type : Gtk.Recent_Chooser.Gtk_Recent_Sort_Type)

Parameters

Chooser

Sort_Type

Show_Numbers_Property

Show_Numbers_Property : constant Glib.Properties.Property_Boolean;

Whether the items should be displayed with a number.

Unselect_All

procedure Unselect_All
   (Chooser : not null access Gtk_Recent_Action_Record)

Parameters

Chooser

Unselect_Uri

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

Parameters

Chooser

URI