Pileus Git - ~andy/gtk/blob - gtk/gtkentry.h

   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 Library 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  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the Free
  16  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17  */
  18 #ifndef __GTK_ENTRY_H__
  19 #define __GTK_ENTRY_H__
  20
  21
  22 #include <gdk/gdk.h>
  23 #include <gtk/gtkeditable.h>
  24
  25
  26 #ifdef __cplusplus
  27 extern "C" {
  28 #endif /* __cplusplus */
  29
  30
  31 #define GTK_ENTRY(obj)          GTK_CHECK_CAST (obj, gtk_entry_get_type (), GtkEntry)
  32 #define GTK_ENTRY_CLASS(klass)  GTK_CHECK_CLASS_CAST (klass, gtk_entry_get_type (), GtkEntryClass)
  33 #define GTK_IS_ENTRY(obj)       GTK_CHECK_TYPE (obj, gtk_entry_get_type ())
  34
  35
  36 typedef struct _GtkEntry       GtkEntry;
  37 typedef struct _GtkEntryClass  GtkEntryClass;
  38
  39 struct _GtkEntry
  40 {
  41   GtkEditable editable;
  42
  43   GdkWindow *text_area;
  44   GdkPixmap *backing_pixmap;
  45   GdkCursor *cursor;
  46   gchar *text;
  47
  48   guint16 text_size;
  49   guint16 text_length;
  50   guint16 text_max_length;
  51   gint    scroll_offset;
  52   guint   visible : 1;
  53   guint32 timer;
  54   guint   button;
  55
  56   /* The total number of characters (not bytes) in the entry */
  57   guint nchars;
  58
  59   /* The byte offset of each character
  60    *  (including the last insertion position) */
  61   guint16 *char_pos;
  62
  63   /* The x-offset of each character (including the last insertion position)
  64    * only valid when the widget is realized */
  65   gint *char_offset;
  66 };
  67
  68 struct _GtkEntryClass
  69 {
  70   GtkEditableClass parent_class;
  71 };
  72
  73 guint      gtk_entry_get_type       (void);
  74 GtkWidget* gtk_entry_new            (void);
  75 GtkWidget* gtk_entry_new_with_max_length (guint16   max);
  76 void       gtk_entry_set_text       (GtkEntry      *entry,
  77                                      const gchar   *text);
  78 void       gtk_entry_append_text    (GtkEntry      *entry,
  79                                      const gchar   *text);
  80 void       gtk_entry_prepend_text   (GtkEntry      *entry,
  81                                      const gchar   *text);
  82 void       gtk_entry_set_position   (GtkEntry      *entry,
  83                                      gint           position);
  84 gchar*     gtk_entry_get_text       (GtkEntry      *entry);
  85 void       gtk_entry_select_region  (GtkEntry      *entry,
  86                                      gint           start,
  87                                      gint           end);
  88 void       gtk_entry_set_visibility (GtkEntry      *entry,
  89                                      gboolean       visible);
  90 void       gtk_entry_set_editable   (GtkEntry      *entry,
  91                                      gboolean       editable);
  92 /* text is truncated if needed */
  93 void       gtk_entry_set_max_length (GtkEntry      *entry,
  94                                      guint16        max);
  95 #ifdef __cplusplus
  96 }
  97 #endif /* __cplusplus */
  98
  99
 100 #endif /* __GTK_ENTRY_H__ */