2008-07-01 22:57:50 +00:00
|
|
|
/* GTK - The GIMP Toolkit
|
1997-11-24 22:37:52 +00:00
|
|
|
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
|
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
2000-07-26 11:33:08 +00:00
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
1997-11-24 22:37:52 +00:00
|
|
|
* 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
|
1998-12-15 20:31:26 +00:00
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
2000-07-26 11:33:08 +00:00
|
|
|
* Lesser General Public License for more details.
|
1997-11-24 22:37:52 +00:00
|
|
|
*
|
2000-07-26 11:33:08 +00:00
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
2012-02-27 13:01:10 +00:00
|
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
1997-11-24 22:37:52 +00:00
|
|
|
*/
|
1999-02-24 07:37:18 +00:00
|
|
|
|
|
|
|
/*
|
2000-07-26 11:33:08 +00:00
|
|
|
* Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
|
1999-02-24 07:37:18 +00:00
|
|
|
* file for a list of people on the GTK+ Team. See the ChangeLog
|
|
|
|
* files for a list of changes. These files are distributed with
|
2008-05-28 15:35:43 +00:00
|
|
|
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
|
1999-02-24 07:37:18 +00:00
|
|
|
*/
|
|
|
|
|
1997-11-24 22:37:52 +00:00
|
|
|
#ifndef __GTK_LABEL_H__
|
|
|
|
#define __GTK_LABEL_H__
|
|
|
|
|
|
|
|
|
2012-12-28 14:57:34 +00:00
|
|
|
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
|
|
|
|
#error "Only <gtk/gtk.h> can be included directly."
|
|
|
|
#endif
|
|
|
|
|
1997-11-24 22:37:52 +00:00
|
|
|
#include <gtk/gtkmisc.h>
|
2001-03-21 18:58:28 +00:00
|
|
|
#include <gtk/gtkwindow.h>
|
2001-09-19 00:49:52 +00:00
|
|
|
#include <gtk/gtkmenu.h>
|
1997-11-24 22:37:52 +00:00
|
|
|
|
2008-10-30 15:58:06 +00:00
|
|
|
|
2005-03-20 07:01:23 +00:00
|
|
|
G_BEGIN_DECLS
|
1998-12-15 20:31:26 +00:00
|
|
|
|
2000-02-13 08:16:48 +00:00
|
|
|
#define GTK_TYPE_LABEL (gtk_label_get_type ())
|
2002-10-05 23:15:39 +00:00
|
|
|
#define GTK_LABEL(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_LABEL, GtkLabel))
|
|
|
|
#define GTK_LABEL_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_LABEL, GtkLabelClass))
|
|
|
|
#define GTK_IS_LABEL(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_LABEL))
|
|
|
|
#define GTK_IS_LABEL_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_LABEL))
|
|
|
|
#define GTK_LABEL_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_LABEL, GtkLabelClass))
|
2008-05-28 15:35:43 +00:00
|
|
|
|
1997-11-24 22:37:52 +00:00
|
|
|
|
2010-08-26 17:15:37 +00:00
|
|
|
typedef struct _GtkLabel GtkLabel;
|
|
|
|
typedef struct _GtkLabelPrivate GtkLabelPrivate;
|
|
|
|
typedef struct _GtkLabelClass GtkLabelClass;
|
1997-11-24 22:37:52 +00:00
|
|
|
|
2001-02-17 00:11:03 +00:00
|
|
|
typedef struct _GtkLabelSelectionInfo GtkLabelSelectionInfo;
|
|
|
|
|
1997-11-24 22:37:52 +00:00
|
|
|
struct _GtkLabel
|
|
|
|
{
|
|
|
|
GtkMisc misc;
|
1998-12-15 20:31:26 +00:00
|
|
|
|
2001-02-17 00:11:03 +00:00
|
|
|
/*< private >*/
|
2010-08-26 17:15:37 +00:00
|
|
|
GtkLabelPrivate *priv;
|
1997-11-24 22:37:52 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
struct _GtkLabelClass
|
|
|
|
{
|
|
|
|
GtkMiscClass parent_class;
|
2001-09-19 00:49:52 +00:00
|
|
|
|
|
|
|
void (* move_cursor) (GtkLabel *label,
|
|
|
|
GtkMovementStep step,
|
|
|
|
gint count,
|
|
|
|
gboolean extend_selection);
|
|
|
|
void (* copy_clipboard) (GtkLabel *label);
|
2008-05-28 15:35:43 +00:00
|
|
|
|
2001-09-19 00:49:52 +00:00
|
|
|
/* Hook to customize right-click popup for selectable labels */
|
|
|
|
void (* populate_popup) (GtkLabel *label,
|
|
|
|
GtkMenu *menu);
|
2002-02-23 20:22:05 +00:00
|
|
|
|
2009-05-11 06:44:12 +00:00
|
|
|
gboolean (*activate_link) (GtkLabel *label,
|
|
|
|
const gchar *uri);
|
2009-05-11 05:23:13 +00:00
|
|
|
|
2002-02-23 20:22:05 +00:00
|
|
|
/* Padding for future expansion */
|
|
|
|
void (*_gtk_reserved1) (void);
|
|
|
|
void (*_gtk_reserved2) (void);
|
|
|
|
void (*_gtk_reserved3) (void);
|
2010-10-19 17:07:36 +00:00
|
|
|
void (*_gtk_reserved4) (void);
|
|
|
|
void (*_gtk_reserved5) (void);
|
|
|
|
void (*_gtk_reserved6) (void);
|
|
|
|
void (*_gtk_reserved7) (void);
|
|
|
|
void (*_gtk_reserved8) (void);
|
1997-11-24 22:37:52 +00:00
|
|
|
};
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2002-10-05 23:15:39 +00:00
|
|
|
GType gtk_label_get_type (void) G_GNUC_CONST;
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2005-06-21 05:15:06 +00:00
|
|
|
GtkWidget* gtk_label_new (const gchar *str);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2005-06-21 05:15:06 +00:00
|
|
|
GtkWidget* gtk_label_new_with_mnemonic (const gchar *str);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
void gtk_label_set_text (GtkLabel *label,
|
2005-06-21 05:15:06 +00:00
|
|
|
const gchar *str);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-06-06 18:13:44 +00:00
|
|
|
const gchar* gtk_label_get_text (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
void gtk_label_set_attributes (GtkLabel *label,
|
|
|
|
PangoAttrList *attrs);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
PangoAttrList *gtk_label_get_attributes (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
void gtk_label_set_label (GtkLabel *label,
|
|
|
|
const gchar *str);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-06-06 18:13:44 +00:00
|
|
|
const gchar * gtk_label_get_label (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
void gtk_label_set_markup (GtkLabel *label,
|
|
|
|
const gchar *str);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
void gtk_label_set_use_markup (GtkLabel *label,
|
|
|
|
gboolean setting);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
gboolean gtk_label_get_use_markup (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
void gtk_label_set_use_underline (GtkLabel *label,
|
|
|
|
gboolean setting);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
gboolean gtk_label_get_use_underline (GtkLabel *label);
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-03-22 13:44:00 +00:00
|
|
|
void gtk_label_set_markup_with_mnemonic (GtkLabel *label,
|
|
|
|
const gchar *str);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-03-22 13:44:00 +00:00
|
|
|
guint gtk_label_get_mnemonic_keyval (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-03-22 13:44:00 +00:00
|
|
|
void gtk_label_set_mnemonic_widget (GtkLabel *label,
|
|
|
|
GtkWidget *widget);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
GtkWidget *gtk_label_get_mnemonic_widget (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-03-22 13:44:00 +00:00
|
|
|
void gtk_label_set_text_with_mnemonic (GtkLabel *label,
|
2001-03-23 22:21:06 +00:00
|
|
|
const gchar *str);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-03-22 13:44:00 +00:00
|
|
|
void gtk_label_set_justify (GtkLabel *label,
|
|
|
|
GtkJustification jtype);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
GtkJustification gtk_label_get_justify (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-07-22 05:06:39 +00:00
|
|
|
void gtk_label_set_ellipsize (GtkLabel *label,
|
|
|
|
PangoEllipsizeMode mode);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-07-22 05:06:39 +00:00
|
|
|
PangoEllipsizeMode gtk_label_get_ellipsize (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
Rework of GtkFileChooserButton, some cleanups. Fixes #154388, #154390,
2004-10-25 James M. Cape <jcape@ignore-your.tv>
Rework of GtkFileChooserButton, some cleanups. Fixes #154388,
#154390, #154390, #156272.
* docs/reference/gtk/gtk-docs.sgml: Moved GtkFileChooserButton
below GtkFileChooser.
* docs/reference/gtk/gtk-sections.txt: Added
gtk_file_chooser_button_get_width_chars(),
gtk_file_chooser_button_set_width_chars(),
gtk_label_set_width_chars(), gtk_label_get_width_chars().
* docs/reference/gtk/gtk.types: Added
gtk_cell_renderer_combo_get_type,
gtk_cell_view_get_type,
gtk_text_iter_get_type.
* docs/reference/gtk/tmpl/gtkaboutdialog.sgml: Add
"logo-icon-name" property.
* docs/reference/gtk/tmpl/gtkcellview.sgml: Updates for
properties
(b/c of get_type() inclusion above).
* docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml:
* docs/reference/gtk/tmpl/gtklabel.sgml: Add "width-chars"
property,
getters/setters.
* docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml: Added.
* gtk/gtkentrycompletion.c:
(_gtk_entry_completion_popdown): Don't show if the entry isn't
mapped.
* gtk/gtkfilechooserbutton.[c,h]: (*): About 45%
rewritten, adds "width-chars" property, icons, working save
modes, volume/Home/Desktop friendly-naming support.
* gtk/gtklabel.[c,h]:
(gtk_label_class_init), (gtk_label_init),
(gtk_label_get_property), (gtk_label_set_property),
(gtk_label_get_width_chars), (gtk_label_set_width_chars),
(gtk_label_size_request): Add "width-chars" property.
* tests/testfilechooserbutton.c: Update, use 4 different buttons
for the different ACTIONs.
* gtk/.cvsignore: Ignore gtk-update-icon-cache.
* tests/.cvsignore: Ignore testimage.
2004-10-26 04:29:56 +00:00
|
|
|
void gtk_label_set_width_chars (GtkLabel *label,
|
|
|
|
gint n_chars);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
Rework of GtkFileChooserButton, some cleanups. Fixes #154388, #154390,
2004-10-25 James M. Cape <jcape@ignore-your.tv>
Rework of GtkFileChooserButton, some cleanups. Fixes #154388,
#154390, #154390, #156272.
* docs/reference/gtk/gtk-docs.sgml: Moved GtkFileChooserButton
below GtkFileChooser.
* docs/reference/gtk/gtk-sections.txt: Added
gtk_file_chooser_button_get_width_chars(),
gtk_file_chooser_button_set_width_chars(),
gtk_label_set_width_chars(), gtk_label_get_width_chars().
* docs/reference/gtk/gtk.types: Added
gtk_cell_renderer_combo_get_type,
gtk_cell_view_get_type,
gtk_text_iter_get_type.
* docs/reference/gtk/tmpl/gtkaboutdialog.sgml: Add
"logo-icon-name" property.
* docs/reference/gtk/tmpl/gtkcellview.sgml: Updates for
properties
(b/c of get_type() inclusion above).
* docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml:
* docs/reference/gtk/tmpl/gtklabel.sgml: Add "width-chars"
property,
getters/setters.
* docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml: Added.
* gtk/gtkentrycompletion.c:
(_gtk_entry_completion_popdown): Don't show if the entry isn't
mapped.
* gtk/gtkfilechooserbutton.[c,h]: (*): About 45%
rewritten, adds "width-chars" property, icons, working save
modes, volume/Home/Desktop friendly-naming support.
* gtk/gtklabel.[c,h]:
(gtk_label_class_init), (gtk_label_init),
(gtk_label_get_property), (gtk_label_set_property),
(gtk_label_get_width_chars), (gtk_label_set_width_chars),
(gtk_label_size_request): Add "width-chars" property.
* tests/testfilechooserbutton.c: Update, use 4 different buttons
for the different ACTIONs.
* gtk/.cvsignore: Ignore gtk-update-icon-cache.
* tests/.cvsignore: Ignore testimage.
2004-10-26 04:29:56 +00:00
|
|
|
gint gtk_label_get_width_chars (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-12-13 06:34:54 +00:00
|
|
|
void gtk_label_set_max_width_chars (GtkLabel *label,
|
|
|
|
gint n_chars);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-12-13 06:34:54 +00:00
|
|
|
gint gtk_label_get_max_width_chars (GtkLabel *label);
|
2013-08-23 00:29:22 +00:00
|
|
|
GDK_AVAILABLE_IN_3_10
|
|
|
|
void gtk_label_set_lines (GtkLabel *label,
|
|
|
|
gint lines);
|
|
|
|
GDK_AVAILABLE_IN_3_10
|
|
|
|
gint gtk_label_get_lines (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-03-22 13:44:00 +00:00
|
|
|
void gtk_label_set_pattern (GtkLabel *label,
|
|
|
|
const gchar *pattern);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-03-22 13:44:00 +00:00
|
|
|
void gtk_label_set_line_wrap (GtkLabel *label,
|
|
|
|
gboolean wrap);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-24 15:34:48 +00:00
|
|
|
gboolean gtk_label_get_line_wrap (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2006-06-19 14:27:50 +00:00
|
|
|
void gtk_label_set_line_wrap_mode (GtkLabel *label,
|
|
|
|
PangoWrapMode wrap_mode);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2006-06-19 14:27:50 +00:00
|
|
|
PangoWrapMode gtk_label_get_line_wrap_mode (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-03-22 13:44:00 +00:00
|
|
|
void gtk_label_set_selectable (GtkLabel *label,
|
|
|
|
gboolean setting);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-03-22 13:44:00 +00:00
|
|
|
gboolean gtk_label_get_selectable (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-11-21 16:24:01 +00:00
|
|
|
void gtk_label_set_angle (GtkLabel *label,
|
|
|
|
gdouble angle);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-11-21 16:24:01 +00:00
|
|
|
gdouble gtk_label_get_angle (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-03-22 13:44:00 +00:00
|
|
|
void gtk_label_select_region (GtkLabel *label,
|
|
|
|
gint start_offset,
|
|
|
|
gint end_offset);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-01 19:26:01 +00:00
|
|
|
gboolean gtk_label_get_selection_bounds (GtkLabel *label,
|
|
|
|
gint *start,
|
|
|
|
gint *end);
|
2001-06-09 00:12:00 +00:00
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-09 00:12:00 +00:00
|
|
|
PangoLayout *gtk_label_get_layout (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2001-06-09 00:12:00 +00:00
|
|
|
void gtk_label_get_layout_offsets (GtkLabel *label,
|
|
|
|
gint *x,
|
|
|
|
gint *y);
|
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-11-09 05:04:41 +00:00
|
|
|
void gtk_label_set_single_line_mode (GtkLabel *label,
|
|
|
|
gboolean single_line_mode);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2004-11-09 05:04:41 +00:00
|
|
|
gboolean gtk_label_get_single_line_mode (GtkLabel *label);
|
2001-06-09 00:12:00 +00:00
|
|
|
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2011-06-06 18:13:44 +00:00
|
|
|
const gchar *gtk_label_get_current_uri (GtkLabel *label);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2009-07-09 17:59:35 +00:00
|
|
|
void gtk_label_set_track_visited_links (GtkLabel *label,
|
|
|
|
gboolean track_links);
|
2013-03-20 22:17:32 +00:00
|
|
|
GDK_AVAILABLE_IN_ALL
|
2009-07-09 17:59:35 +00:00
|
|
|
gboolean gtk_label_get_track_visited_links (GtkLabel *label);
|
2009-05-11 05:23:13 +00:00
|
|
|
|
2000-04-26 22:53:01 +00:00
|
|
|
|
2009-12-20 08:04:52 +00:00
|
|
|
/* private */
|
|
|
|
|
|
|
|
void _gtk_label_mnemonics_visible_apply_recursively (GtkWidget *widget,
|
|
|
|
gboolean mnemonics_visible);
|
2011-06-24 03:30:57 +00:00
|
|
|
gint _gtk_label_get_cursor_position (GtkLabel *label);
|
|
|
|
gint _gtk_label_get_selection_bound (GtkLabel *label);
|
2009-12-20 08:04:52 +00:00
|
|
|
|
2005-03-20 07:01:23 +00:00
|
|
|
G_END_DECLS
|
1997-11-24 22:37:52 +00:00
|
|
|
|
|
|
|
#endif /* __GTK_LABEL_H__ */
|