diff --git a/docs/reference/gtk/gtk3-sections.txt b/docs/reference/gtk/gtk3-sections.txt index be4e6321ce..748f1be6ab 100644 --- a/docs/reference/gtk/gtk3-sections.txt +++ b/docs/reference/gtk/gtk3-sections.txt @@ -6476,6 +6476,7 @@ GtkClipboardClearFunc gtk_clipboard_get gtk_clipboard_get_for_display gtk_clipboard_get_display +gtk_clipboard_get_default gtk_clipboard_set_with_data gtk_clipboard_set_with_owner gtk_clipboard_get_owner diff --git a/gtk/gtkclipboard.c b/gtk/gtkclipboard.c index 302f7f73f1..d2381beb30 100644 --- a/gtk/gtkclipboard.c +++ b/gtk/gtkclipboard.c @@ -378,6 +378,26 @@ gtk_clipboard_get (GdkAtom selection) return gtk_clipboard_get_for_display (gdk_display_get_default (), selection); } +/** + * gtk_clipboard_get_default: + * @display: the #GdkDisplay for which the clipboard is to be retrieved. + * + * Returns the default clipboard object for use with cut/copy/paste menu items + * and keyboard shortcuts. + * + * Return value: (transfer none): the default clipboard object. + * + * Since: 3.16 + **/ +GtkClipboard * +gtk_clipboard_get_default (GdkDisplay *display) +{ + g_return_val_if_fail (display != NULL, NULL); + g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL); + + return gtk_clipboard_get_for_display (display, GDK_SELECTION_CLIPBOARD); +} + static void selection_get_cb (GtkWidget *widget, GtkSelectionData *selection_data, diff --git a/gtk/gtkclipboard.h b/gtk/gtkclipboard.h index e59a45093c..5470de405b 100644 --- a/gtk/gtkclipboard.h +++ b/gtk/gtkclipboard.h @@ -189,6 +189,9 @@ GtkClipboard *gtk_clipboard_get_for_display (GdkDisplay *display, GDK_AVAILABLE_IN_ALL GtkClipboard *gtk_clipboard_get (GdkAtom selection); +GDK_AVAILABLE_IN_3_16 +GtkClipboard *gtk_clipboard_get_default (GdkDisplay *display); + GDK_AVAILABLE_IN_ALL GdkDisplay *gtk_clipboard_get_display (GtkClipboard *clipboard);