]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtklabel.h
filechooserbutton: New test for opening the Other item in the combo box and then...
[~andy/gtk] / gtk / gtklabel.h
index 787ffed50f7f9b14b7277b700f661f42540eb9b8..3d3c27d66e3794bd4909fa5795e8ddcbb13f73ed 100644 (file)
  * 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, write to the Free
- * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ * 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/. 
+ * 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 _GtkLabelSelectionInfo GtkLabelSelectionInfo;
 
 struct _GtkLabel
 {
   GtkMisc misc;
 
-  gchar    *label;
-  gchar    *pattern;
-
-  guint   jtype : 2;
-  guint   wrap : 1;
-  
   /*< private >*/
-  PangoLayout *layout;
-  PangoAttrList *attrs;
+  GtkLabelPrivate *priv;
 };
 
 struct _GtkLabelClass
 {
   GtkMiscClass parent_class;
-};
 
-GtkType    gtk_label_get_type       (void) G_GNUC_CONST;
-GtkWidget *gtk_label_new            (const char       *str);
-
-void                  gtk_label_set_text (GtkLabel   *label,
-                                         const char *str);
-G_CONST_RETURN gchar *gtk_label_get_text (GtkLabel   *label);
-
-void       gtk_label_set_attributes (GtkLabel         *label,
-                                     PangoAttrList    *attrs);
-
-void  gtk_label_set_markup            (GtkLabel    *label,
-                                       const gchar *str);
-guint gtk_label_set_markup_with_accel (GtkLabel    *label,
-                                       const gchar *str);
-                                            
-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 */
-
-#ifndef GTK_DISABLE_DEPRECATED
-/* Deprecated */
-void       gtk_label_get           (GtkLabel          *label,
-                                    char             **str);
-#endif /* GTK_DISABLE_DEPRECATED */
-
-#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__ */