1/* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
16 */
17
18/*
19 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
20 * file for a list of people on the GTK+ Team. See the ChangeLog
21 * files for a list of changes. These files are distributed with
22 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
23 */
24
25#ifndef __GTK_LABEL_H__
26#define __GTK_LABEL_H__
27
28#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
29#error "Only <gtk/gtk.h> can be included directly."
30#endif
31
32#include <gtk/gtkwidget.h>
33
34G_BEGIN_DECLS
35
36#define GTK_TYPE_LABEL (gtk_label_get_type ())
37#define GTK_LABEL(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_LABEL, GtkLabel))
38#define GTK_IS_LABEL(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_LABEL))
39
40typedef struct _GtkLabel GtkLabel;
41
42GDK_AVAILABLE_IN_ALL
43GType gtk_label_get_type (void) G_GNUC_CONST;
44GDK_AVAILABLE_IN_ALL
45GtkWidget* gtk_label_new (const char *str);
46GDK_AVAILABLE_IN_ALL
47GtkWidget* gtk_label_new_with_mnemonic (const char *str);
48GDK_AVAILABLE_IN_ALL
49void gtk_label_set_text (GtkLabel *self,
50 const char *str);
51GDK_AVAILABLE_IN_ALL
52const char * gtk_label_get_text (GtkLabel *self);
53GDK_AVAILABLE_IN_ALL
54void gtk_label_set_attributes (GtkLabel *self,
55 PangoAttrList *attrs);
56GDK_AVAILABLE_IN_ALL
57PangoAttrList *gtk_label_get_attributes (GtkLabel *self);
58GDK_AVAILABLE_IN_ALL
59void gtk_label_set_label (GtkLabel *self,
60 const char *str);
61GDK_AVAILABLE_IN_ALL
62const char * gtk_label_get_label (GtkLabel *self);
63GDK_AVAILABLE_IN_ALL
64void gtk_label_set_markup (GtkLabel *self,
65 const char *str);
66GDK_AVAILABLE_IN_ALL
67void gtk_label_set_use_markup (GtkLabel *self,
68 gboolean setting);
69GDK_AVAILABLE_IN_ALL
70gboolean gtk_label_get_use_markup (GtkLabel *self);
71GDK_AVAILABLE_IN_ALL
72void gtk_label_set_use_underline (GtkLabel *self,
73 gboolean setting);
74GDK_AVAILABLE_IN_ALL
75gboolean gtk_label_get_use_underline (GtkLabel *self);
76
77GDK_AVAILABLE_IN_ALL
78void gtk_label_set_markup_with_mnemonic (GtkLabel *self,
79 const char *str);
80GDK_AVAILABLE_IN_ALL
81guint gtk_label_get_mnemonic_keyval (GtkLabel *self);
82GDK_AVAILABLE_IN_ALL
83void gtk_label_set_mnemonic_widget (GtkLabel *self,
84 GtkWidget *widget);
85GDK_AVAILABLE_IN_ALL
86GtkWidget *gtk_label_get_mnemonic_widget (GtkLabel *self);
87GDK_AVAILABLE_IN_ALL
88void gtk_label_set_text_with_mnemonic (GtkLabel *self,
89 const char *str);
90GDK_AVAILABLE_IN_ALL
91void gtk_label_set_justify (GtkLabel *self,
92 GtkJustification jtype);
93GDK_AVAILABLE_IN_ALL
94GtkJustification gtk_label_get_justify (GtkLabel *self);
95GDK_AVAILABLE_IN_ALL
96void gtk_label_set_ellipsize (GtkLabel *self,
97 PangoEllipsizeMode mode);
98GDK_AVAILABLE_IN_ALL
99PangoEllipsizeMode gtk_label_get_ellipsize (GtkLabel *self);
100GDK_AVAILABLE_IN_ALL
101void gtk_label_set_width_chars (GtkLabel *self,
102 int n_chars);
103GDK_AVAILABLE_IN_ALL
104int gtk_label_get_width_chars (GtkLabel *self);
105GDK_AVAILABLE_IN_ALL
106void gtk_label_set_max_width_chars (GtkLabel *self,
107 int n_chars);
108GDK_AVAILABLE_IN_ALL
109int gtk_label_get_max_width_chars (GtkLabel *self);
110GDK_AVAILABLE_IN_ALL
111void gtk_label_set_lines (GtkLabel *self,
112 int lines);
113GDK_AVAILABLE_IN_ALL
114int gtk_label_get_lines (GtkLabel *self);
115GDK_AVAILABLE_IN_ALL
116void gtk_label_set_wrap (GtkLabel *self,
117 gboolean wrap);
118GDK_AVAILABLE_IN_ALL
119gboolean gtk_label_get_wrap (GtkLabel *self);
120GDK_AVAILABLE_IN_ALL
121void gtk_label_set_wrap_mode (GtkLabel *self,
122 PangoWrapMode wrap_mode);
123GDK_AVAILABLE_IN_ALL
124PangoWrapMode gtk_label_get_wrap_mode (GtkLabel *self);
125GDK_AVAILABLE_IN_4_6
126void gtk_label_set_natural_wrap_mode (GtkLabel *self,
127 GtkNaturalWrapMode wrap_mode);
128GDK_AVAILABLE_IN_4_6
129GtkNaturalWrapMode gtk_label_get_natural_wrap_mode(GtkLabel *self);
130GDK_AVAILABLE_IN_ALL
131void gtk_label_set_selectable (GtkLabel *self,
132 gboolean setting);
133GDK_AVAILABLE_IN_ALL
134gboolean gtk_label_get_selectable (GtkLabel *self);
135GDK_AVAILABLE_IN_ALL
136void gtk_label_select_region (GtkLabel *self,
137 int start_offset,
138 int end_offset);
139GDK_AVAILABLE_IN_ALL
140gboolean gtk_label_get_selection_bounds (GtkLabel *self,
141 int *start,
142 int *end);
143
144GDK_AVAILABLE_IN_ALL
145PangoLayout *gtk_label_get_layout (GtkLabel *self);
146GDK_AVAILABLE_IN_ALL
147void gtk_label_get_layout_offsets (GtkLabel *self,
148 int *x,
149 int *y);
150
151GDK_AVAILABLE_IN_ALL
152void gtk_label_set_single_line_mode (GtkLabel *self,
153 gboolean single_line_mode);
154GDK_AVAILABLE_IN_ALL
155gboolean gtk_label_get_single_line_mode (GtkLabel *self);
156
157GDK_AVAILABLE_IN_ALL
158const char *gtk_label_get_current_uri (GtkLabel *self);
159
160GDK_AVAILABLE_IN_ALL
161void gtk_label_set_xalign (GtkLabel *self,
162 float xalign);
163
164GDK_AVAILABLE_IN_ALL
165float gtk_label_get_xalign (GtkLabel *self);
166
167GDK_AVAILABLE_IN_ALL
168void gtk_label_set_yalign (GtkLabel *self,
169 float yalign);
170
171GDK_AVAILABLE_IN_ALL
172float gtk_label_get_yalign (GtkLabel *self);
173
174GDK_AVAILABLE_IN_ALL
175void gtk_label_set_extra_menu (GtkLabel *self,
176 GMenuModel *model);
177GDK_AVAILABLE_IN_ALL
178GMenuModel * gtk_label_get_extra_menu (GtkLabel *self);
179
180
181G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkLabel, g_object_unref)
182
183G_END_DECLS
184
185#endif /* __GTK_LABEL_H__ */
186

source code of gtk/gtk/gtklabel.h