gtkmenubutton.h 5.29 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
/* GTK - The GIMP Toolkit
 *
 * Copyright (C) 2003 Ricardo Fernandez Pascual
 * Copyright (C) 2004 Paolo Borelli
 * Copyright (C) 2012 Bastien Nocera
 *
 * 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 License, 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/>.
 */

21
22
23
#ifndef __GTK_MENU_BUTTON_H__
#define __GTK_MENU_BUTTON_H__

24
25
26
27
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif

28
#include <gtk/gtktogglebutton.h>
29
#include <gtk/gtkpopover.h>
30
31
32
33
34
35
36
37
38

G_BEGIN_DECLS

#define GTK_TYPE_MENU_BUTTON            (gtk_menu_button_get_type ())
#define GTK_MENU_BUTTON(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_MENU_BUTTON, GtkMenuButton))
#define GTK_IS_MENU_BUTTON(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_MENU_BUTTON))

typedef struct _GtkMenuButton        GtkMenuButton;

39
40
/**
 * GtkMenuButtonCreatePopupFunc:
Matthias Clasen's avatar
Matthias Clasen committed
41
 * @menu_button: the `GtkMenuButton`
42
 * @user_data: User data passed to gtk_menu_button_set_create_popup_func()
43
 *
44
45
46
47
48
49
 * User-provided callback function to create a popup for a
 * `GtkMenuButton` on demand.
 *
 * This function is called when the popup of @menu_button is shown,
 * but none has been provided via [method@Gtk.MenuButton.set_popover]
 * or [method@Gtk.MenuButton.set_menu_model].
50
51
52
53
 */
typedef void  (*GtkMenuButtonCreatePopupFunc) (GtkMenuButton *menu_button,
                                               gpointer       user_data);

Matthias Clasen's avatar
Matthias Clasen committed
54
GDK_AVAILABLE_IN_ALL
55
GType        gtk_menu_button_get_type       (void) G_GNUC_CONST;
Matthias Clasen's avatar
Matthias Clasen committed
56
GDK_AVAILABLE_IN_ALL
57
58
GtkWidget   *gtk_menu_button_new            (void);

Matthias Clasen's avatar
Matthias Clasen committed
59
GDK_AVAILABLE_IN_ALL
60
61
void         gtk_menu_button_set_popover    (GtkMenuButton *menu_button,
                                             GtkWidget     *popover);
Matthias Clasen's avatar
Matthias Clasen committed
62
GDK_AVAILABLE_IN_ALL
63
64
GtkPopover  *gtk_menu_button_get_popover    (GtkMenuButton *menu_button);

Matthias Clasen's avatar
Matthias Clasen committed
65
GDK_AVAILABLE_IN_ALL
66
67
void         gtk_menu_button_set_direction  (GtkMenuButton *menu_button,
                                             GtkArrowType   direction);
Matthias Clasen's avatar
Matthias Clasen committed
68
GDK_AVAILABLE_IN_ALL
69
70
GtkArrowType gtk_menu_button_get_direction  (GtkMenuButton *menu_button);

Matthias Clasen's avatar
Matthias Clasen committed
71
GDK_AVAILABLE_IN_ALL
72
73
void         gtk_menu_button_set_menu_model (GtkMenuButton *menu_button,
                                             GMenuModel    *menu_model);
Matthias Clasen's avatar
Matthias Clasen committed
74
GDK_AVAILABLE_IN_ALL
75
76
GMenuModel  *gtk_menu_button_get_menu_model (GtkMenuButton *menu_button);

77
78
79
80
81
82
GDK_AVAILABLE_IN_ALL
void         gtk_menu_button_set_icon_name (GtkMenuButton *menu_button,
                                            const char    *icon_name);
GDK_AVAILABLE_IN_ALL
const char * gtk_menu_button_get_icon_name (GtkMenuButton *menu_button);

83
84
85
86
87
88
GDK_AVAILABLE_IN_4_4
void         gtk_menu_button_set_always_show_arrow (GtkMenuButton *menu_button,
                                                    gboolean       always_show_arrow);
GDK_AVAILABLE_IN_4_4
gboolean     gtk_menu_button_get_always_show_arrow (GtkMenuButton *menu_button);

89
90
91
92
93
94
GDK_AVAILABLE_IN_ALL
void         gtk_menu_button_set_label (GtkMenuButton *menu_button,
                                        const char    *label);
GDK_AVAILABLE_IN_ALL
const char * gtk_menu_button_get_label (GtkMenuButton *menu_button);

95
96
97
98
99
100
GDK_AVAILABLE_IN_ALL
void         gtk_menu_button_set_use_underline (GtkMenuButton *menu_button,
                                                gboolean       use_underline);
GDK_AVAILABLE_IN_ALL
gboolean     gtk_menu_button_get_use_underline (GtkMenuButton *menu_button);

101
GDK_AVAILABLE_IN_ALL
Matthias Clasen's avatar
Matthias Clasen committed
102
103
void           gtk_menu_button_set_has_frame (GtkMenuButton  *menu_button,
                                              gboolean        has_frame);
104
GDK_AVAILABLE_IN_ALL
Matthias Clasen's avatar
Matthias Clasen committed
105
gboolean       gtk_menu_button_get_has_frame (GtkMenuButton  *menu_button);
106

107
108
109
110
111
GDK_AVAILABLE_IN_ALL
void          gtk_menu_button_popup (GtkMenuButton *menu_button);
GDK_AVAILABLE_IN_ALL
void          gtk_menu_button_popdown (GtkMenuButton *menu_button);

112
113
114
115
116
GDK_AVAILABLE_IN_ALL
void          gtk_menu_button_set_create_popup_func (GtkMenuButton                *menu_button,
                                                     GtkMenuButtonCreatePopupFunc  func,
                                                     gpointer                      user_data,
                                                     GDestroyNotify                destroy_notify);
117

118
119
120
121
122
123
GDK_AVAILABLE_IN_4_4
void          gtk_menu_button_set_primary (GtkMenuButton *menu_button,
                                           gboolean       primary);
GDK_AVAILABLE_IN_4_4
gboolean      gtk_menu_button_get_primary (GtkMenuButton *menu_button);

124
125
126
127
128
129
GDK_AVAILABLE_IN_4_6
void          gtk_menu_button_set_child   (GtkMenuButton *menu_button,
                                           GtkWidget     *child);
GDK_AVAILABLE_IN_4_6
GtkWidget *   gtk_menu_button_get_child   (GtkMenuButton *menu_button);

130
131
132
G_END_DECLS

#endif /* __GTK_MENU_BUTTON_H__ */