forked from AuroraMiddleware/gtk
496f0892fc
gtk_accel_group_query gtk_accel_group_from_accel_closure gtk_accel_label_get_accel_widget gtk_accessible_get_widget gtk_actionable_get_action_name gtk_app_chooser_get_app_info gtk_app_chooser_button_get_heading gtk_app_chooser_dialog_get_heading gtk_application_get_window_by_id gtk_assistant_get_nth_page gtk_binding_set_find gtk_builder_get_object gtk_builder_lookup_callback_symbol gtk_builder_get_application gtk_button_get_image gtk_cell_area_get_focus_from_sibling gtk_cell_renderer_start_editing gtk_cell_view_get_model gtk_cell_view_get_displayed_row gtk_clipboard_get_owner gtk_container_get_focus_child gtk_container_get_focus_vadjustment gtk_container_get_focus_hadjustment gtk_dialog_get_widget_for_response gtk_drag_get_source_widget gtk_drag_dest_get_target_list gtk_drag_source_get_target_list gtk_entry_completion_get_model gtk_entry_completion_compute_prefix gtk_expander_get_label_widget gtk_file_chooser_get_filename gtk_file_chooser_get_current_folder gtk_file_chooser_get_uri gtk_file_chooser_get_current_folder_uri gtk_file_chooser_get_preview_widget gtk_file_chooser_get_preview_file gtk_file_chooser_get_preview_filename gtk_file_chooser_get_preview_uri gtk_file_chooser_get_extra_widget gtk_file_chooser_get_filter gtk_file_chooser_native_get_accept_label gtk_file_chooser_native_get_cancel_label gtk_file_filter_get_name gtk_font_chooser_get_font_family gtk_font_chooser_get_font_face gtk_font_chooser_get_font gtk_font_chooser_get_font_desc gtk_font_chooser_get_font_map gtk_frame_get_label gtk_gesture_get_device gtk_gesture_get_window gtk_gl_area_get_error gtk_header_bar_get_title gtk_header_bar_get_subtitle gtk_header_bar_get_custom_title gtk_icon_info_get_filename gtk_icon_view_get_path_at_pos gtk_icon_view_get_model gtk_image_get_pixbuf gtk_image_get_animation gtk_label_get_mnemonic_widget gtk_label_get_attributes gtk_check_version gtk_menu_button_get_popup gtk_menu_button_get_menu_model gtk_menu_button_get_align_widget gtk_menu_button_get_popover gtk_menu_item_get_submenu gtk_menu_item_get_accel_path gtk_native_dialog_get_title gtk_native_dialog_get_transient_for gtk_notebook_get_nth_page gtk_notebook_get_tab_label_text gtk_notebook_get_menu_label gtk_notebook_get_menu_label_text gtk_notebook_get_group_name gtk_notebook_get_action_widget gtk_offscreen_window_get_surface gtk_offscreen_window_get_pixbuf gtk_paned_get_child1 gtk_paned_get_child2 gtk_places_sidebar_get_location gtk_places_sidebar_get_nth_bookmark gtk_plug_get_socket_window gtk_popover_get_default_widget gtk_progress_bar_get_text gtk_recent_filter_get_name gtk_recent_manager_lookup_item gtk_settings_get_default gtk_socket_get_plug_window gtk_stack_sidebar_get_stack gtk_stack_switcher_get_stack gtk_style_context_get_section gtk_style_context_get_parent gtk_style_context_get_frame_clock gtk_test_find_widget gtk_text_buffer_get_mark gtk_text_tag_table_lookup gtk_text_view_get_tabs gtk_text_view_toggle_cursor_visible gtk_text_view_get_window gtk_toolbar_get_nth_item gtk_tool_button_get_label gtk_tool_button_get_icon_name gtk_tool_button_get_label_widget gtk_tool_button_get_icon_widget gtk_tool_palette_get_drop_item gtk_tool_palette_get_drop_group gtk_tree_model_filter_convert_child_path_to_path gtk_tree_model_filter_convert_path_to_child_path gtk_tree_model_sort_convert_child_path_to_path gtk_tree_model_sort_convert_path_to_child_path gtk_tree_view_get_column gtk_tree_view_get_bin_window gtk_tree_view_column_get_widget gtk_tree_view_column_get_tree_view gtk_widget_get_frame_clock gtk_window_group_get_current_device_grab GtkTextBufferSerializeFunc
262 lines
8.4 KiB
C
262 lines
8.4 KiB
C
/*
|
||
* Copyright © 2012 Canonical Limited
|
||
*
|
||
* This library is free software: you can redistribute it and/or modify
|
||
* it under the terms of the GNU Lesser General Public License as
|
||
* published by the Free Software Foundation; either version 2 of the
|
||
* licence or (at your option) any later version.
|
||
*
|
||
* This library is distributed in the hope that it will be useful, but
|
||
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
* Lesser General Public License for more details.
|
||
*
|
||
* You should have received a copy of the GNU Lesser General Public
|
||
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
||
*
|
||
* Authors: Ryan Lortie <desrt@desrt.ca>
|
||
*/
|
||
|
||
#include "config.h"
|
||
|
||
#include "gtkactionable.h"
|
||
|
||
#include "gtkwidget.h"
|
||
#include "gtkintl.h"
|
||
|
||
/**
|
||
* SECTION:gtkactionable
|
||
* @title: GtkActionable
|
||
* @short_description: An interface for widgets that can be associated
|
||
* with actions
|
||
*
|
||
* This interface provides a convenient way of associating widgets with
|
||
* actions on a #GtkApplicationWindow or #GtkApplication.
|
||
*
|
||
* It primarily consists of two properties: #GtkActionable:action-name
|
||
* and #GtkActionable:action-target. There are also some convenience APIs
|
||
* for setting these properties.
|
||
*
|
||
* The action will be looked up in action groups that are found among
|
||
* the widgets ancestors. Most commonly, these will be the actions with
|
||
* the “win.” or “app.” prefix that are associated with the #GtkApplicationWindow
|
||
* or "GtkApplication, but other action groups that are added with
|
||
* gtk_widget_insert_action_group() will be consulted as well.
|
||
*
|
||
* Since: 3.4
|
||
**/
|
||
|
||
/**
|
||
* GtkActionable:
|
||
*
|
||
* An opaque pointer type.
|
||
**/
|
||
|
||
/**
|
||
* GtkActionableInterface:
|
||
* @get_action_name: virtual function for gtk_actionable_get_action_name()
|
||
* @set_action_name: virtual function for gtk_actionable_set_action_name()
|
||
* @get_action_target_value: virtual function for gtk_actionable_get_action_target_value()
|
||
* @set_action_target_value: virtual function for gtk_actionable_set_action_target_value()
|
||
*
|
||
* The interface vtable for #GtkActionable.
|
||
**/
|
||
|
||
G_DEFINE_INTERFACE (GtkActionable, gtk_actionable, GTK_TYPE_WIDGET)
|
||
|
||
static void
|
||
gtk_actionable_default_init (GtkActionableInterface *iface)
|
||
{
|
||
g_object_interface_install_property (iface,
|
||
g_param_spec_string ("action-name", P_("action name"),
|
||
P_("The name of the associated action, like 'app.quit'"),
|
||
NULL, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
|
||
|
||
g_object_interface_install_property (iface,
|
||
g_param_spec_variant ("action-target", P_("action target value"),
|
||
P_("The parameter for action invocations"),
|
||
G_VARIANT_TYPE_ANY, NULL, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
|
||
}
|
||
|
||
/**
|
||
* gtk_actionable_get_action_name:
|
||
* @actionable: a #GtkActionable widget
|
||
*
|
||
* Gets the action name for @actionable.
|
||
*
|
||
* See gtk_actionable_set_action_name() for more information.
|
||
*
|
||
* Returns: (nullable): the action name, or %NULL if none is set
|
||
*
|
||
* Since: 3.4
|
||
**/
|
||
const gchar *
|
||
gtk_actionable_get_action_name (GtkActionable *actionable)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_ACTIONABLE (actionable), NULL);
|
||
|
||
return GTK_ACTIONABLE_GET_IFACE (actionable)
|
||
->get_action_name (actionable);
|
||
}
|
||
|
||
/**
|
||
* gtk_actionable_set_action_name:
|
||
* @actionable: a #GtkActionable widget
|
||
* @action_name: an action name, or %NULL
|
||
*
|
||
* Specifies the name of the action with which this widget should be
|
||
* associated. If @action_name is %NULL then the widget will be
|
||
* unassociated from any previous action.
|
||
*
|
||
* Usually this function is used when the widget is located (or will be
|
||
* located) within the hierarchy of a #GtkApplicationWindow.
|
||
*
|
||
* Names are of the form “win.save” or “app.quit” for actions on the
|
||
* containing #GtkApplicationWindow or its associated #GtkApplication,
|
||
* respectively. This is the same form used for actions in the #GMenu
|
||
* associated with the window.
|
||
*
|
||
* Since: 3.4
|
||
**/
|
||
void
|
||
gtk_actionable_set_action_name (GtkActionable *actionable,
|
||
const gchar *action_name)
|
||
{
|
||
g_return_if_fail (GTK_IS_ACTIONABLE (actionable));
|
||
|
||
GTK_ACTIONABLE_GET_IFACE (actionable)
|
||
->set_action_name (actionable, action_name);
|
||
}
|
||
|
||
/**
|
||
* gtk_actionable_get_action_target_value:
|
||
* @actionable: a #GtkActionable widget
|
||
*
|
||
* Gets the current target value of @actionabe.
|
||
*
|
||
* See gtk_actionable_set_action_target_value() for more information.
|
||
*
|
||
* Returns: (transfer none): the current target value
|
||
*
|
||
* Since: 3.4
|
||
**/
|
||
GVariant *
|
||
gtk_actionable_get_action_target_value (GtkActionable *actionable)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_ACTIONABLE (actionable), NULL);
|
||
|
||
return GTK_ACTIONABLE_GET_IFACE (actionable)
|
||
->get_action_target_value (actionable);
|
||
}
|
||
|
||
/**
|
||
* gtk_actionable_set_action_target_value:
|
||
* @actionable: a #GtkActionable widget
|
||
* @target_value: a #GVariant to set as the target value, or %NULL
|
||
*
|
||
* Sets the target value of an actionable widget.
|
||
*
|
||
* If @target_value is %NULL then the target value is unset.
|
||
*
|
||
* The target value has two purposes. First, it is used as the
|
||
* parameter to activation of the action associated with the
|
||
* #GtkActionable widget. Second, it is used to determine if the widget
|
||
* should be rendered as “active” — the widget is active if the state
|
||
* is equal to the given target.
|
||
*
|
||
* Consider the example of associating a set of buttons with a #GAction
|
||
* with string state in a typical “radio button” situation. Each button
|
||
* will be associated with the same action, but with a different target
|
||
* value for that action. Clicking on a particular button will activate
|
||
* the action with the target of that button, which will typically cause
|
||
* the action’s state to change to that value. Since the action’s state
|
||
* is now equal to the target value of the button, the button will now
|
||
* be rendered as active (and the other buttons, with different targets,
|
||
* rendered inactive).
|
||
*
|
||
* Since: 3.4
|
||
**/
|
||
void
|
||
gtk_actionable_set_action_target_value (GtkActionable *actionable,
|
||
GVariant *target_value)
|
||
{
|
||
g_return_if_fail (GTK_IS_ACTIONABLE (actionable));
|
||
|
||
GTK_ACTIONABLE_GET_IFACE (actionable)
|
||
->set_action_target_value (actionable, target_value);
|
||
}
|
||
|
||
/**
|
||
* gtk_actionable_set_action_target:
|
||
* @actionable: a #GtkActionable widget
|
||
* @format_string: a GVariant format string
|
||
* @...: arguments appropriate for @format_string
|
||
*
|
||
* Sets the target of an actionable widget.
|
||
*
|
||
* This is a convenience function that calls g_variant_new() for
|
||
* @format_string and uses the result to call
|
||
* gtk_actionable_set_action_target_value().
|
||
*
|
||
* If you are setting a string-valued target and want to set the action
|
||
* name at the same time, you can use
|
||
* gtk_actionable_set_detailed_action_name ().
|
||
*
|
||
* Since: 3.4
|
||
**/
|
||
void
|
||
gtk_actionable_set_action_target (GtkActionable *actionable,
|
||
const gchar *format_string,
|
||
...)
|
||
{
|
||
va_list ap;
|
||
|
||
va_start (ap, format_string);
|
||
gtk_actionable_set_action_target_value (actionable, g_variant_new_va (format_string, NULL, &ap));
|
||
va_end (ap);
|
||
}
|
||
|
||
/**
|
||
* gtk_actionable_set_detailed_action_name:
|
||
* @actionable: a #GtkActionable widget
|
||
* @detailed_action_name: the detailed action name
|
||
*
|
||
* Sets the action-name and associated string target value of an
|
||
* actionable widget.
|
||
*
|
||
* This allows for the effect of both gtk_actionable_set_action_name()
|
||
* and gtk_actionable_set_action_target_value() in the common case that
|
||
* the target is string-valued.
|
||
*
|
||
* @detailed_action_name is a string of the form
|
||
* `"action::target"` where `action`
|
||
* is the action name and `target` is the string to use
|
||
* as the target.
|
||
*
|
||
* Since: 3.4
|
||
**/
|
||
void
|
||
gtk_actionable_set_detailed_action_name (GtkActionable *actionable,
|
||
const gchar *detailed_action_name)
|
||
{
|
||
gchar **parts;
|
||
|
||
g_return_if_fail (GTK_IS_ACTIONABLE (actionable));
|
||
|
||
if (detailed_action_name == NULL)
|
||
{
|
||
gtk_actionable_set_action_name (actionable, NULL);
|
||
gtk_actionable_set_action_target_value (actionable, NULL);
|
||
return;
|
||
}
|
||
|
||
parts = g_strsplit (detailed_action_name, "::", 2);
|
||
gtk_actionable_set_action_name (actionable, parts[0]);
|
||
if (parts[0] && parts[1])
|
||
gtk_actionable_set_action_target (actionable, "s", parts[1]);
|
||
else
|
||
gtk_actionable_set_action_target_value (actionable, NULL);
|
||
g_strfreev (parts);
|
||
}
|
||
|