]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtklabel.h
stylecontext: Do invalidation on first resize container
[~andy/gtk] / gtk / gtklabel.h
index 3abc5af67ba6dd4c702afeccc60c9ae03ac1938e..3d3c27d66e3794bd4909fa5795e8ddcbb13f73ed 100644 (file)
  * 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 Library General Public
+ * 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
- * Library General Public License for more details.
+ * Lesser General Public License for more details.
  *
- * You should have received a copy of the GNU Library General Public
- * License along with this library; if not, write to the Free
- * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ * 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-1999.  See the AUTHORS
+ * 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/. 
+ * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  */
 
 #ifndef __GTK_LABEL_H__
 #define __GTK_LABEL_H__
 
 
-#include <gdk/gdk.h>
-#include <gtk/gtkmisc.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>
 
-#ifdef __cplusplus
-extern "C" {
-#endif /* __cplusplus */
 
+G_BEGIN_DECLS
 
 #define GTK_TYPE_LABEL           (gtk_label_get_type ())
-#define GTK_LABEL(obj)           (GTK_CHECK_CAST ((obj), GTK_TYPE_LABEL, GtkLabel))
-#define GTK_LABEL_CLASS(klass)   (GTK_CHECK_CLASS_CAST ((klass), GTK_TYPE_LABEL, GtkLabelClass))
-#define GTK_IS_LABEL(obj)        (GTK_CHECK_TYPE ((obj), GTK_TYPE_LABEL))
-#define GTK_IS_LABEL_CLASS(klass) (GTK_CHECK_CLASS_TYPE ((klass), GTK_TYPE_LABEL))
-#define GTK_LABEL_GET_CLASS(obj)  (GTK_CHECK_GET_CLASS ((obj), GTK_TYPE_LABEL, GtkLabelClass))
-       
+#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 _GtkLabelClass  GtkLabelClass;
+typedef struct _GtkLabel              GtkLabel;
+typedef struct _GtkLabelPrivate       GtkLabelPrivate;
+typedef struct _GtkLabelClass         GtkLabelClass;
 
-typedef struct _GtkLabelWord   GtkLabelWord;
+typedef struct _GtkLabelSelectionInfo GtkLabelSelectionInfo;
 
 struct _GtkLabel
 {
   GtkMisc misc;
 
-  gchar    *label;
-  gchar    *pattern;
-
-  guint   jtype : 2;
-  gboolean wrap : 1;
-
   /*< private >*/
-  gint rtl : 2;                        /* Base dir, cached to detect changes */
-  PangoLayout *layout;
+  GtkLabelPrivate *priv;
 };
 
 struct _GtkLabelClass
 {
   GtkMiscClass parent_class;
-};
 
-GtkType    gtk_label_get_type      (void);
-GtkWidget *gtk_label_new           (const char       *str);
-void       gtk_label_set_text      (GtkLabel         *label,
-                                   const char       *str);
-gchar *    gtk_label_get_text      (GtkLabel         *label);
-void       gtk_label_set_justify   (GtkLabel         *label,
-                                   GtkJustification  jtype);
-void       gtk_label_set_pattern   (GtkLabel         *label,
-                                   const gchar      *pattern);
-void       gtk_label_set_line_wrap (GtkLabel         *label,
-                                   gboolean          wrap);
-/* Convenience function to set the name and pattern by parsing
- * a string with embedded underscores, and return the appropriate
- * key symbol for the accelerator.
- */
-guint       gtk_label_parse_uline   (GtkLabel         *label,
-                                    const gchar      *string);
-
-#ifndef        GTK_DISABLE_COMPAT_H
-#  define gtk_label_set                                gtk_label_set_text
-#endif /* GTK_DISABLE_COMPAT_H */
-
-/* Deprecated */
-void       gtk_label_get           (GtkLabel          *label,
-                                    char             **str);
-
-#ifdef __cplusplus
-}
-#endif /* __cplusplus */
+  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);
+};
 
+GType                 gtk_label_get_type          (void) G_GNUC_CONST;
+GtkWidget*            gtk_label_new               (const gchar   *str);
+GtkWidget*            gtk_label_new_with_mnemonic (const gchar   *str);
+void                  gtk_label_set_text          (GtkLabel      *label,
+                                                  const gchar   *str);
+const gchar*          gtk_label_get_text          (GtkLabel      *label);
+void                  gtk_label_set_attributes    (GtkLabel      *label,
+                                                  PangoAttrList *attrs);
+PangoAttrList        *gtk_label_get_attributes    (GtkLabel      *label);
+void                  gtk_label_set_label         (GtkLabel      *label,
+                                                  const gchar   *str);
+const gchar *         gtk_label_get_label         (GtkLabel      *label);
+void                  gtk_label_set_markup        (GtkLabel      *label,
+                                                  const gchar   *str);
+void                  gtk_label_set_use_markup    (GtkLabel      *label,
+                                                  gboolean       setting);
+gboolean              gtk_label_get_use_markup    (GtkLabel      *label);
+void                  gtk_label_set_use_underline (GtkLabel      *label,
+                                                  gboolean       setting);
+gboolean              gtk_label_get_use_underline (GtkLabel      *label);
+
+void     gtk_label_set_markup_with_mnemonic       (GtkLabel         *label,
+                                                  const gchar      *str);
+guint    gtk_label_get_mnemonic_keyval            (GtkLabel         *label);
+void     gtk_label_set_mnemonic_widget            (GtkLabel         *label,
+                                                  GtkWidget        *widget);
+GtkWidget *gtk_label_get_mnemonic_widget          (GtkLabel         *label);
+void     gtk_label_set_text_with_mnemonic         (GtkLabel         *label,
+                                                  const gchar      *str);
+void     gtk_label_set_justify                    (GtkLabel         *label,
+                                                  GtkJustification  jtype);
+GtkJustification gtk_label_get_justify            (GtkLabel         *label);
+void     gtk_label_set_ellipsize                 (GtkLabel         *label,
+                                                  PangoEllipsizeMode mode);
+PangoEllipsizeMode gtk_label_get_ellipsize        (GtkLabel         *label);
+void     gtk_label_set_width_chars               (GtkLabel         *label,
+                                                  gint              n_chars);
+gint     gtk_label_get_width_chars                (GtkLabel         *label);
+void     gtk_label_set_max_width_chars           (GtkLabel         *label,
+                                                  gint              n_chars);
+gint     gtk_label_get_max_width_chars           (GtkLabel         *label);
+void     gtk_label_set_pattern                    (GtkLabel         *label,
+                                                  const gchar      *pattern);
+void     gtk_label_set_line_wrap                  (GtkLabel         *label,
+                                                  gboolean          wrap);
+gboolean gtk_label_get_line_wrap                  (GtkLabel         *label);
+void     gtk_label_set_line_wrap_mode             (GtkLabel         *label,
+                                                  PangoWrapMode     wrap_mode);
+PangoWrapMode gtk_label_get_line_wrap_mode        (GtkLabel         *label);
+void     gtk_label_set_selectable                 (GtkLabel         *label,
+                                                  gboolean          setting);
+gboolean gtk_label_get_selectable                 (GtkLabel         *label);
+void     gtk_label_set_angle                      (GtkLabel         *label,
+                                                  gdouble           angle);
+gdouble  gtk_label_get_angle                      (GtkLabel         *label);
+void     gtk_label_select_region                  (GtkLabel         *label,
+                                                  gint              start_offset,
+                                                  gint              end_offset);
+gboolean gtk_label_get_selection_bounds           (GtkLabel         *label,
+                                                   gint             *start,
+                                                   gint             *end);
+
+PangoLayout *gtk_label_get_layout         (GtkLabel *label);
+void         gtk_label_get_layout_offsets (GtkLabel *label,
+                                           gint     *x,
+                                           gint     *y);
+
+void         gtk_label_set_single_line_mode  (GtkLabel *label,
+                                              gboolean single_line_mode);
+gboolean     gtk_label_get_single_line_mode  (GtkLabel *label);
+
+const gchar *gtk_label_get_current_uri (GtkLabel *label);
+void         gtk_label_set_track_visited_links  (GtkLabel *label,
+                                                 gboolean  track_links);
+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__ */