gtkmm
3.4.2
|
An action of which represents a list of recently used files. More...
Public Member Functions | |
virtual | ~RecentAction () |
GtkRecentAction* | gobj () |
Provides access to the underlying C GObject. | |
const GtkRecentAction* | gobj () const |
Provides access to the underlying C GObject. | |
GtkRecentAction* | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
bool | get_show_numbers () |
Returns the value set by Gtk::RecentChooserMenu::set_show_numbers(). | |
void | set_show_numbers (bool show_numbers=true) |
Sets whether a number should be added to the items shown by the widgets representing action. | |
Glib::PropertyProxy< bool > | property_show_numbers () |
Whether the items should be displayed with a number. | |
Glib::PropertyProxy_ReadOnly < bool > | property_show_numbers () const |
Whether the items should be displayed with a number. | |
![]() | |
virtual | ~Action () |
Glib::ustring | get_name () const |
Returns the name of the action. | |
bool | is_sensitive () const |
Returns whether the action is effectively sensitive. | |
bool | get_sensitive () const |
Returns whether the action itself is sensitive. | |
void | set_sensitive (bool sensitive=true) |
Sets the property_sensitive() property of the action to sensitive. | |
bool | is_visible () const |
Returns whether the action is effectively visible. | |
bool | get_visible () const |
Returns whether the action itself is visible. | |
void | set_visible (bool visible=true) |
Sets the property_visible() property of the action to visible. | |
void | activate () |
Emits the "activate" signal on the specified action, if it isn't insensitive. | |
Image* | create_icon (IconSize icon_size) |
This function is intended for use by action implementations to create icons displayed in the proxy widgets. | |
MenuItem* | create_menu_item () |
Creates a menu item widget that proxies for the given action. | |
ToolItem* | create_tool_item () |
Creates a toolbar item widget that proxies for the given action. | |
Menu* | create_menu () |
If action provides a Gtk::Menu widget as a submenu for the menu item or the toolbar item it creates, this function returns an instance of that menu. | |
std::vector< Widget* > | get_proxies () |
Returns the proxy widgets for an action. | |
std::vector< const Widget* > | get_proxies () const |
Returns the proxy widgets for an action. | |
void | connect_accelerator () |
Installs the accelerator for action if action has an accel path and group. | |
void | disconnect_accelerator () |
Undoes the effect of one call to connect_accelerator(). | |
Glib::ustring | get_accel_path () const |
Returns the accel path for this action. | |
Glib::SignalProxy0< void > | signal_activate () |
void | set_accel_path (const Glib::ustring& accel_path) |
Sets the accel path for this action. | |
void | set_accel_group (const Glib::RefPtr< AccelGroup >& accel_group) |
Sets the Gtk::AccelGroup in which the accelerator for this action will be installed. | |
void | set_label (const Glib::ustring& label) |
Sets the label of action. | |
Glib::ustring | get_label () const |
Gets the label text of action. | |
void | set_short_label (const Glib::ustring& short_label) |
Sets a shorter label text on action. | |
Glib::ustring | get_short_label () const |
Gets the short label text of action. | |
void | set_tooltip (const Glib::ustring& tooltip) |
Sets the tooltip text on action. | |
Glib::ustring | get_tooltip () const |
Gets the tooltip text of action. | |
void | set_stock_id (const StockID& stock_id) |
Sets the stock id on action. | |
StockID | get_stock_id () const |
Gets the stock id of action. | |
void | set_gicon (const Glib::RefPtr< Gio::Icon >& icon) |
Sets the icon of action. | |
Glib::RefPtr< Gio::Icon > | get_gicon () |
Gets the gicon of action. | |
Glib::RefPtr< const Gio::Icon > | get_gicon () const |
Gets the gicon of action. | |
void | set_icon_name (const Glib::ustring& icon_name) |
Sets the icon name on action. | |
Glib::ustring | get_icon_name () const |
Gets the icon name of action. | |
void | set_visible_horizontal (bool visible_horizontal=true) |
Sets whether action is visible when horizontal. | |
bool | get_visible_horizontal () const |
Checks whether action is visible when horizontal. | |
void | set_visible_vertical (bool visible_vertical=true) |
Sets whether action is visible when vertical. | |
bool | get_visible_vertical () const |
Checks whether action is visible when horizontal. | |
void | set_is_important (bool is_important=true) |
Sets whether the action is important, this attribute is used primarily by toolbar items to decide whether to show a label or not. | |
bool | get_is_important () const |
Checks whether action is important or not. | |
void | set_always_show_image (bool always_show=true) |
Sets whether action's menu item proxies will ignore the Gtk::Settings::property_gtk_menu_images() setting and always show their image, if available. | |
bool | get_always_show_image () const |
Returns whether action's menu item proxies will ignore the Gtk::Settings::property_gtk_menu_images() setting and always show their image, if available. | |
void | block_activate () |
Disable activation signals from the action. | |
void | unblock_activate () |
Reenable activation signals from the action. | |
Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_name () const |
A unique name for the action. | |
Glib::PropertyProxy < Glib::ustring > | property_label () |
The label used for menu items and buttons that activate this action. | |
Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_label () const |
The label used for menu items and buttons that activate this action. | |
Glib::PropertyProxy < Glib::ustring > | property_short_label () |
A shorter label that may be used on toolbar buttons. | |
Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_short_label () const |
A shorter label that may be used on toolbar buttons. | |
Glib::PropertyProxy < Glib::ustring > | property_tooltip () |
A tooltip for this action. | |
Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_tooltip () const |
A tooltip for this action. | |
Glib::PropertyProxy< StockID > | property_stock_id () |
The stock icon displayed in widgets representing this action. | |
Glib::PropertyProxy_ReadOnly < StockID > | property_stock_id () const |
The stock icon displayed in widgets representing this action. | |
Glib::PropertyProxy < Glib::RefPtr< Gio::Icon > > | property_gicon () |
The GIcon being displayed. | |
Glib::PropertyProxy_ReadOnly < Glib::RefPtr< Gio::Icon > > | property_gicon () const |
The GIcon being displayed. | |
Glib::PropertyProxy < Glib::ustring > | property_icon_name () |
The name of the icon from the icon theme. | |
Glib::PropertyProxy_ReadOnly < Glib::ustring > | property_icon_name () const |
The name of the icon from the icon theme. | |
Glib::PropertyProxy< bool > | property_visible_horizontal () |
Whether the toolbar item is visible when the toolbar is in a horizontal orientation. | |
Glib::PropertyProxy_ReadOnly < bool > | property_visible_horizontal () const |
Whether the toolbar item is visible when the toolbar is in a horizontal orientation. | |
Glib::PropertyProxy< bool > | property_visible_vertical () |
Whether the toolbar item is visible when the toolbar is in a vertical orientation. | |
Glib::PropertyProxy_ReadOnly < bool > | property_visible_vertical () const |
Whether the toolbar item is visible when the toolbar is in a vertical orientation. | |
Glib::PropertyProxy< bool > | property_visible_overflown () |
When TRUE, toolitem proxies for this action are represented in the toolbar overflow menu. | |
Glib::PropertyProxy_ReadOnly < bool > | property_visible_overflown () const |
When TRUE, toolitem proxies for this action are represented in the toolbar overflow menu. | |
Glib::PropertyProxy< bool > | property_is_important () |
Whether the action is considered important. | |
Glib::PropertyProxy_ReadOnly < bool > | property_is_important () const |
Whether the action is considered important. | |
Glib::PropertyProxy< bool > | property_hide_if_empty () |
When TRUE, empty menu proxies for this action are hidden. | |
Glib::PropertyProxy_ReadOnly < bool > | property_hide_if_empty () const |
When TRUE, empty menu proxies for this action are hidden. | |
Glib::PropertyProxy< bool > | property_sensitive () |
Whether the action is enabled. | |
Glib::PropertyProxy_ReadOnly < bool > | property_sensitive () const |
Whether the action is enabled. | |
Glib::PropertyProxy< bool > | property_visible () |
Whether the action is visible. | |
Glib::PropertyProxy_ReadOnly < bool > | property_visible () const |
Whether the action is visible. | |
Glib::PropertyProxy < Glib::RefPtr< ActionGroup > > | property_action_group () |
The GtkActionGroup this GtkAction is associated with, or NULL (for internal use). | |
Glib::PropertyProxy_ReadOnly < Glib::RefPtr< ActionGroup > > | property_action_group () const |
The GtkActionGroup this GtkAction is associated with, or NULL (for internal use). | |
Glib::PropertyProxy< bool > | property_always_show_image () |
Whether the image will always be shown. | |
Glib::PropertyProxy_ReadOnly < bool > | property_always_show_image () const |
Whether the image will always be shown. | |
![]() | |
void * | get_data (const QueryQuark &key) |
void | set_data (const Quark &key, void *data) |
void | set_data (const Quark &key, void *data, DestroyNotify notify) |
void | remove_data (const QueryQuark &quark) |
void * | steal_data (const QueryQuark &quark) |
void | set_property_value (const Glib::ustring &property_name, const Glib::ValueBase &value) |
void | get_property_value (const Glib::ustring &property_name, Glib::ValueBase &value) const |
void | set_property (const Glib::ustring &property_name, const PropertyType &value) |
void | get_property (const Glib::ustring &property_name, PropertyType &value) const |
void | connect_property_changed (const Glib::ustring &property_name, const sigc::slot< void > &slot) |
sigc::connection | connect_property_changed_with_return (const Glib::ustring &property_name, const sigc::slot< void > &slot) |
void | freeze_notify () |
void | thaw_notify () |
virtual void | reference () const |
virtual void | unreference () const |
GObject * | gobj_copy () const |
Glib::RefPtr< Glib::Object > | wrap (GObject *object, bool take_copy=false) |
![]() | |
virtual | ~Buildable () |
void | set_name (const Glib::ustring& name) |
Sets the name of the buildable object. | |
![]() | |
Interface (const Glib::Interface_Class &interface_class) | |
Interface (GObject *castitem) | |
virtual | ~Interface () |
void | set_property_value (const Glib::ustring &property_name, const Glib::ValueBase &value) |
void | get_property_value (const Glib::ustring &property_name, Glib::ValueBase &value) const |
void | set_property (const Glib::ustring &property_name, const PropertyType &value) |
void | get_property (const Glib::ustring &property_name, PropertyType &value) const |
void | connect_property_changed (const Glib::ustring &property_name, const sigc::slot< void > &slot) |
sigc::connection | connect_property_changed_with_return (const Glib::ustring &property_name, const sigc::slot< void > &slot) |
void | freeze_notify () |
void | thaw_notify () |
virtual void | reference () const |
virtual void | unreference () const |
GObject * | gobj_copy () const |
![]() | |
virtual | ~RecentChooser () |
void | set_show_private (bool show_private=true) |
Whether to show recently used resources marked registered as private. | |
bool | get_show_private () const |
Returns whether chooser should display recently used resources registered as private. | |
void | set_show_not_found (bool show_not_found=true) |
Sets whether chooser should display the recently used resources that it didn't find. | |
bool | get_show_not_found () const |
Retrieves whether chooser should show the recently used resources that were not found. | |
void | set_select_multiple (bool select_multiple=true) |
Sets whether chooser can select multiple items. | |
bool | get_select_multiple () const |
Gets whether chooser can select multiple items. | |
void | set_limit (int limit) |
Sets the number of items that should be returned by get_items() and get_uris(). | |
void | unset_limit () |
int | get_limit () const |
Gets the number of items returned by get_items() and get_uris(). | |
void | set_local_only (bool local_only=true) |
Sets whether only local resources, that is resources using the file:// URI scheme, should be shown in the recently used resources selector. | |
bool | get_local_only () const |
Gets whether only local resources should be shown in the recently used resources selector. | |
void | set_show_tips (bool show_tips=true) |
Sets whether to show a tooltips containing the full path of each recently used resource in a Gtk::RecentChooser widget. | |
bool | get_show_tips () const |
Gets whether chooser should display tooltips containing the full path of a recently user resource. | |
void | set_show_icons (bool show_icons=true) |
Sets whether chooser should show an icon near the resource when displaying it. | |
bool | get_show_icons () const |
Retrieves whether chooser should show an icon near the resource. | |
void | set_sort_type (RecentSortType sort_type) |
Changes the sorting order of the recently used resources list displayed by chooser. | |
RecentSortType | get_sort_type () const |
Gets the value set by set_sort_type(). | |
void | set_sort_func (const SlotCompare& slot) |
Sets the comparison function used when sorting the list of recently used resources and the sort type is RECENT_SORT_CUSTOM. | |
bool | set_current_uri (const Glib::ustring& uri) |
Sets uri as the current URI for chooser. | |
Glib::ustring | get_current_uri () const |
Gets the URI currently selected by chooser. | |
Glib::RefPtr< RecentInfo > | get_current_item () |
Gets the Gtk::RecentInfo currently selected by chooser. | |
Glib::RefPtr< const RecentInfo > | get_current_item () const |
Gets the Gtk::RecentInfo currently selected by chooser. | |
bool | select_uri (const Glib::ustring& uri) |
Selects uri inside chooser. | |
void | unselect_uri (const Glib::ustring& uri) |
Unselects uri inside chooser. | |
void | select_all () |
Selects all the items inside chooser, if the chooser supports multiple selection. | |
void | unselect_all () |
Unselects all the items inside chooser. | |
std::vector< Glib::RefPtr < RecentInfo > > | get_items () const |
Gets the list of recently used resources in form of Gtk::RecentInfo objects. | |
std::vector< Glib::ustring > | get_uris () const |
Gets the URI of the recently used resources. | |
void | add_filter (const Glib::RefPtr< RecentFilter >& filter) |
Adds filter to the list of Gtk::RecentFilter objects held by chooser. | |
void | remove_filter (const Glib::RefPtr< RecentFilter >& filter) |
Removes filter from the list of Gtk::RecentFilter objects held by chooser. | |
std::vector< Glib::RefPtr < RecentFilter > > | list_filters () |
Gets the Gtk::RecentFilter objects held by chooser. | |
std::vector< Glib::RefPtr < const RecentFilter > > | list_filters () const |
Gets the Gtk::RecentFilter objects held by chooser. | |
void | set_filter (const Glib::RefPtr< RecentFilter >& filter) |
Sets filter as the current Gtk::RecentFilter object used by chooser to affect the displayed recently used resources. | |
Glib::RefPtr< RecentFilter > | get_filter () |
Gets the Gtk::RecentFilter object currently used by chooser to affect the display of the recently used resources. | |
Glib::RefPtr< const RecentFilter > | get_filter () const |
Gets the Gtk::RecentFilter object currently used by chooser to affect the display of the recently used resources. | |
Glib::SignalProxy0< void > | signal_selection_changed () |
Glib::SignalProxy0< void > | signal_item_activated () |
Glib::PropertyProxy< bool > | property_show_private () |
Whether the private items should be displayed. | |
Glib::PropertyProxy_ReadOnly < bool > | property_show_private () const |
Whether the private items should be displayed. | |
Glib::PropertyProxy< bool > | property_show_tips () |
Whether there should be a tooltip on the item. | |
Glib::PropertyProxy_ReadOnly < bool > | property_show_tips () const |
Whether there should be a tooltip on the item. | |
Glib::PropertyProxy< bool > | property_show_icons () |
Whether there should be an icon near the item. | |
Glib::PropertyProxy_ReadOnly < bool > | property_show_icons () const |
Whether there should be an icon near the item. | |
Glib::PropertyProxy< bool > | property_show_not_found () |
Whether the items pointing to unavailable resources should be displayed. | |
Glib::PropertyProxy_ReadOnly < bool > | property_show_not_found () const |
Whether the items pointing to unavailable resources should be displayed. | |
Glib::PropertyProxy< bool > | property_select_multiple () |
Whether to allow multiple items to be selected. | |
Glib::PropertyProxy_ReadOnly < bool > | property_select_multiple () const |
Whether to allow multiple items to be selected. | |
Glib::PropertyProxy< bool > | property_local_only () |
Whether the selected resource(s) should be limited to local file: URIs. | |
Glib::PropertyProxy_ReadOnly < bool > | property_local_only () const |
Whether the selected resource(s) should be limited to local file: URIs. | |
Glib::PropertyProxy< int > | property_limit () |
The maximum number of items to be displayed. | |
Glib::PropertyProxy_ReadOnly< int > | property_limit () const |
The maximum number of items to be displayed. | |
Glib::PropertyProxy < RecentSortType > | property_sort_type () |
The sorting order of the items displayed. | |
Glib::PropertyProxy_ReadOnly < RecentSortType > | property_sort_type () const |
The sorting order of the items displayed. | |
Glib::PropertyProxy < Glib::RefPtr< RecentFilter > > | property_filter () |
The current filter for selecting which resources are displayed. | |
Glib::PropertyProxy_ReadOnly < Glib::RefPtr< RecentFilter > > | property_filter () const |
The current filter for selecting which resources are displayed. |
Static Public Member Functions | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. | |
static Glib::RefPtr< RecentAction > | create () |
static Glib::RefPtr< RecentAction > | create (const Glib::ustring& name, const Glib::ustring& label=Glib::ustring(), const Glib::ustring& tooltip=Glib::ustring()) |
Creates an action. | |
static Glib::RefPtr< RecentAction > | create (const Glib::ustring& name, const Gtk::StockID& stock_id, const Glib::ustring& label=Glib::ustring(), const Glib::ustring& tooltip=Glib::ustring()) |
Creates an action with a stock ID. | |
static Glib::RefPtr< RecentAction > | create (const Glib::ustring& name, const Gtk::StockID& stock_id, const Glib::ustring& label, const Glib::ustring& tooltip, const Glib::RefPtr< RecentManager >& recent_manager) |
![]() | |
static Glib::RefPtr< Action > | create_with_icon_name (const Glib::ustring& name, const Glib::ustring& icon_name, const Glib::ustring& label, const Glib::ustring& tooltip) |
Create an action with an icon name. | |
![]() | |
static void | add_interface (GType gtype_implementer) |
![]() | |
static void | add_interface (GType gtype_implementer) |
Protected Member Functions | |
RecentAction () | |
RecentAction (const Glib::ustring& name, const StockID& stock_id=StockID(), const Glib::ustring& label=Glib::ustring(), const Glib::ustring& tooltip=Glib::ustring()) | |
RecentAction (const Glib::ustring& name, const StockID& stock_id, const Glib::ustring& label, const Glib::ustring& tooltip, const Glib::RefPtr< RecentManager >& recent_manager) | |
![]() | |
Action () | |
Creates an empty action. | |
Action (const Glib::ustring& name, const StockID& stock_id=StockID(), const Glib::ustring& label=Glib::ustring(), const Glib::ustring& tooltip=Glib::ustring()) | |
Creates an action with a stock ID. | |
Action (const Glib::ustring& name, const Glib::ustring& icon_name, const Glib::ustring& label=Glib::ustring(), const Glib::ustring& tooltip=Glib::ustring()) | |
Creates an action with an icon name. | |
virtual Widget* | create_menu_item_vfunc () |
virtual Widget* | create_tool_item_vfunc () |
virtual void | connect_proxy_vfunc (Widget* proxy) |
virtual void | disconnect_proxy_vfunc (Widget* proxy) |
virtual void | on_activate () |
This is a default handler for the signal signal_activate(). | |
![]() | |
Object () | |
Object (const Glib::ConstructParams &construct_params) | |
Object (GObject *castitem) | |
virtual | ~Object () |
ObjectBase () | |
ObjectBase (const char *custom_type_name) | |
ObjectBase (const std::type_info &custom_type_info) | |
virtual | ~ObjectBase ()=0 |
void | initialize (GObject *castitem) |
![]() | |
Buildable () | |
You should derive from this class to use it. | |
![]() | |
ObjectBase () | |
ObjectBase (const char *custom_type_name) | |
ObjectBase (const std::type_info &custom_type_info) | |
virtual | ~ObjectBase ()=0 |
void | initialize (GObject *castitem) |
![]() | |
RecentChooser () | |
You should derive from this class to use it. | |
virtual Glib::ustring | get_current_uri_vfunc () const |
virtual void | unselect_uri_vfunc (const Glib::ustring& uri) |
virtual void | select_all_vfunc () |
virtual void | unselect_all_vfunc () |
virtual Glib::RefPtr < RecentManager > | get_recent_manager_vfunc () |
virtual void | add_filter_vfunc (const Glib::RefPtr< RecentFilter >& filter) |
virtual void | remove_filter_vfunc (const Glib::RefPtr< RecentFilter >& filter) |
virtual void | on_selection_changed () |
This is a default handler for the signal signal_selection_changed(). | |
virtual void | on_item_activated () |
This is a default handler for the signal signal_item_activated(). |
Related Functions | |
(Note that these are not member functions.) | |
Glib::RefPtr< Gtk::RecentAction > | wrap (GtkRecentAction* object, bool take_copy=false) |
A Glib::wrap() method for this object. | |
![]() | |
Glib::RefPtr< Gtk::Action > | wrap (GtkAction* object, bool take_copy=false) |
A Glib::wrap() method for this object. | |
![]() | |
Glib::RefPtr< Gtk::Buildable > | wrap (GtkBuildable* object, bool take_copy=false) |
A Glib::wrap() method for this object. | |
![]() | |
Glib::RefPtr< Gtk::RecentChooser > | wrap (GtkRecentChooser* object, bool take_copy=false) |
A Glib::wrap() method for this object. |
Additional Inherited Members | |
![]() | |
typedef sigc::slot< void > | SlotActivate |
For instance, void on_activate();. | |
![]() | |
typedef void(* | DestroyNotify )(gpointer data) |
![]() | |
typedef sigc::slot< int, const Glib::RefPtr< RecentInfo > &, const Glib::RefPtr < RecentInfo >& > | SlotCompare |
This callback should return -1 if b compares before a, 0 if they compare equal and 1 if a compares after b. |
An action of which represents a list of recently used files.
A Gtk::RecentAction represents a list of recently used files, which can be shown by widgets such as Gtk::RecentChooserDialog or Gtk::RecentChooserMenu. To construct a submenu showing recently used files, use a Gtk::RecentAction as the action for a <menuitem>. To construct a menu toolbutton showing the recently used files in the popup menu, use a Gtk::RecentAction as the action for a <toolitem> element.
See also the methods in the RecentChooser base class.
|
virtual |
|
protected |
|
explicitprotected |
|
explicitprotected |
|
static |
Reimplemented from Gtk::Action.
|
static |
Creates an action.
name | A unique name for the action. |
label | The label displayed in menu items and on buttons. |
tooltip | A tooltip for the action. |
Reimplemented from Gtk::Action.
|
static |
Creates an action with a stock ID.
The stock ID is used to set a default icon, text and accelerator for the action.
name | A unique name for the action. |
stock_id | The stock icon to display in widgets representing the action. |
label | The label displayed in menu items and on buttons. |
tooltip | A tooltip for the action. |
Reimplemented from Gtk::Action.
|
static |
bool Gtk::RecentAction::get_show_numbers | ( | ) |
Returns the value set by Gtk::RecentChooserMenu::set_show_numbers().
true
if numbers should be shown.
|
static |
Get the GType for this class, for use with the underlying GObject type system.
Reimplemented from Gtk::Action.
|
inline |
Provides access to the underlying C GObject.
Reimplemented from Gtk::Action.
|
inline |
Provides access to the underlying C GObject.
Reimplemented from Gtk::Action.
GtkRecentAction* Gtk::RecentAction::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
Reimplemented from Gtk::Action.
Glib::PropertyProxy< bool > Gtk::RecentAction::property_show_numbers | ( | ) |
Whether the items should be displayed with a number.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly< bool > Gtk::RecentAction::property_show_numbers | ( | ) | const |
Whether the items should be displayed with a number.
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
void Gtk::RecentAction::set_show_numbers | ( | bool | show_numbers = true | ) |
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.
show_numbers | true if the shown items should be numbered. |
|
related |
A Glib::wrap() method for this object.
object | The C instance. |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |