forked from AuroraMiddleware/gtk
eab0ff8e4e
When setting the lines property, the label will be ellipsized to that many lines, with the ellipsis only appearing in the last line. This is different from how ellipsization of multi-line labels normally works in GTK+.
227 lines
8.7 KiB
C
227 lines
8.7 KiB
C
/* GTK - The GIMP Toolkit
|
|
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
|
|
*
|
|
* 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/>.
|
|
*/
|
|
|
|
/*
|
|
* Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
|
|
* file for a list of people on the GTK+ Team. See the ChangeLog
|
|
* files for a list of changes. These files are distributed with
|
|
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
|
|
*/
|
|
|
|
#ifndef __GTK_LABEL_H__
|
|
#define __GTK_LABEL_H__
|
|
|
|
|
|
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
|
|
#error "Only <gtk/gtk.h> can be included directly."
|
|
#endif
|
|
|
|
#include <gtk/gtkmisc.h>
|
|
#include <gtk/gtkwindow.h>
|
|
#include <gtk/gtkmenu.h>
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GTK_TYPE_LABEL (gtk_label_get_type ())
|
|
#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))
|
|
|
|
|
|
typedef struct _GtkLabel GtkLabel;
|
|
typedef struct _GtkLabelPrivate GtkLabelPrivate;
|
|
typedef struct _GtkLabelClass GtkLabelClass;
|
|
|
|
typedef struct _GtkLabelSelectionInfo GtkLabelSelectionInfo;
|
|
|
|
struct _GtkLabel
|
|
{
|
|
GtkMisc misc;
|
|
|
|
/*< private >*/
|
|
GtkLabelPrivate *priv;
|
|
};
|
|
|
|
struct _GtkLabelClass
|
|
{
|
|
GtkMiscClass parent_class;
|
|
|
|
void (* move_cursor) (GtkLabel *label,
|
|
GtkMovementStep step,
|
|
gint count,
|
|
gboolean extend_selection);
|
|
void (* copy_clipboard) (GtkLabel *label);
|
|
|
|
/* Hook to customize right-click popup for selectable labels */
|
|
void (* populate_popup) (GtkLabel *label,
|
|
GtkMenu *menu);
|
|
|
|
gboolean (*activate_link) (GtkLabel *label,
|
|
const gchar *uri);
|
|
|
|
/* Padding for future expansion */
|
|
void (*_gtk_reserved1) (void);
|
|
void (*_gtk_reserved2) (void);
|
|
void (*_gtk_reserved3) (void);
|
|
void (*_gtk_reserved4) (void);
|
|
void (*_gtk_reserved5) (void);
|
|
void (*_gtk_reserved6) (void);
|
|
void (*_gtk_reserved7) (void);
|
|
void (*_gtk_reserved8) (void);
|
|
};
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
GType gtk_label_get_type (void) G_GNUC_CONST;
|
|
GDK_AVAILABLE_IN_ALL
|
|
GtkWidget* gtk_label_new (const gchar *str);
|
|
GDK_AVAILABLE_IN_ALL
|
|
GtkWidget* gtk_label_new_with_mnemonic (const gchar *str);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_text (GtkLabel *label,
|
|
const gchar *str);
|
|
GDK_AVAILABLE_IN_ALL
|
|
const gchar* gtk_label_get_text (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_attributes (GtkLabel *label,
|
|
PangoAttrList *attrs);
|
|
GDK_AVAILABLE_IN_ALL
|
|
PangoAttrList *gtk_label_get_attributes (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_label (GtkLabel *label,
|
|
const gchar *str);
|
|
GDK_AVAILABLE_IN_ALL
|
|
const gchar * gtk_label_get_label (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_markup (GtkLabel *label,
|
|
const gchar *str);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_use_markup (GtkLabel *label,
|
|
gboolean setting);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gtk_label_get_use_markup (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_use_underline (GtkLabel *label,
|
|
gboolean setting);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gtk_label_get_use_underline (GtkLabel *label);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_markup_with_mnemonic (GtkLabel *label,
|
|
const gchar *str);
|
|
GDK_AVAILABLE_IN_ALL
|
|
guint gtk_label_get_mnemonic_keyval (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_mnemonic_widget (GtkLabel *label,
|
|
GtkWidget *widget);
|
|
GDK_AVAILABLE_IN_ALL
|
|
GtkWidget *gtk_label_get_mnemonic_widget (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_text_with_mnemonic (GtkLabel *label,
|
|
const gchar *str);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_justify (GtkLabel *label,
|
|
GtkJustification jtype);
|
|
GDK_AVAILABLE_IN_ALL
|
|
GtkJustification gtk_label_get_justify (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_ellipsize (GtkLabel *label,
|
|
PangoEllipsizeMode mode);
|
|
GDK_AVAILABLE_IN_ALL
|
|
PangoEllipsizeMode gtk_label_get_ellipsize (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_width_chars (GtkLabel *label,
|
|
gint n_chars);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gint gtk_label_get_width_chars (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_max_width_chars (GtkLabel *label,
|
|
gint n_chars);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gint gtk_label_get_max_width_chars (GtkLabel *label);
|
|
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);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_pattern (GtkLabel *label,
|
|
const gchar *pattern);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_line_wrap (GtkLabel *label,
|
|
gboolean wrap);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gtk_label_get_line_wrap (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_line_wrap_mode (GtkLabel *label,
|
|
PangoWrapMode wrap_mode);
|
|
GDK_AVAILABLE_IN_ALL
|
|
PangoWrapMode gtk_label_get_line_wrap_mode (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_selectable (GtkLabel *label,
|
|
gboolean setting);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gtk_label_get_selectable (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_angle (GtkLabel *label,
|
|
gdouble angle);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gdouble gtk_label_get_angle (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_select_region (GtkLabel *label,
|
|
gint start_offset,
|
|
gint end_offset);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gtk_label_get_selection_bounds (GtkLabel *label,
|
|
gint *start,
|
|
gint *end);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
PangoLayout *gtk_label_get_layout (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_get_layout_offsets (GtkLabel *label,
|
|
gint *x,
|
|
gint *y);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_single_line_mode (GtkLabel *label,
|
|
gboolean single_line_mode);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gtk_label_get_single_line_mode (GtkLabel *label);
|
|
|
|
GDK_AVAILABLE_IN_ALL
|
|
const gchar *gtk_label_get_current_uri (GtkLabel *label);
|
|
GDK_AVAILABLE_IN_ALL
|
|
void gtk_label_set_track_visited_links (GtkLabel *label,
|
|
gboolean track_links);
|
|
GDK_AVAILABLE_IN_ALL
|
|
gboolean gtk_label_get_track_visited_links (GtkLabel *label);
|
|
|
|
|
|
/* private */
|
|
|
|
void _gtk_label_mnemonics_visible_apply_recursively (GtkWidget *widget,
|
|
gboolean mnemonics_visible);
|
|
gint _gtk_label_get_cursor_position (GtkLabel *label);
|
|
gint _gtk_label_get_selection_bound (GtkLabel *label);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GTK_LABEL_H__ */
|