gtktexttag.h 9.42 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49
/* gtktexttag.c - text tag object
 *
 * Copyright (c) 1992-1994 The Regents of the University of California.
 * Copyright (c) 1994-1997 Sun Microsystems, Inc.
 * Copyright (c) 2000      Red Hat, Inc.
 * Tk -> Gtk port by Havoc Pennington <hp@redhat.com>
 *
 * This software is copyrighted by the Regents of the University of
 * California, Sun Microsystems, Inc., and other parties.  The
 * following terms apply to all files associated with the software
 * unless explicitly disclaimed in individual files.
 *
 * The authors hereby grant permission to use, copy, modify,
 * distribute, and license this software and its documentation for any
 * purpose, provided that existing copyright notices are retained in
 * all copies and that this notice is included verbatim in any
 * distributions. No written agreement, license, or royalty fee is
 * required for any of the authorized uses.  Modifications to this
 * software may be copyrighted by their authors and need not follow
 * the licensing terms described here, provided that the new terms are
 * clearly indicated on the first page of each file where they apply.
 *
 * IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY
 * PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
 * DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION,
 * OR ANY DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED
 * OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
 * NON-INFRINGEMENT.  THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
 * AND THE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE
 * MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 *
 * GOVERNMENT USE: If you are acquiring this software on behalf of the
 * U.S. government, the Government shall have only "Restricted Rights"
 * in the software and related documentation as defined in the Federal
 * Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2).  If you
 * are acquiring the software on behalf of the Department of Defense,
 * the software shall be classified as "Commercial Computer Software"
 * and the Government shall have only "Restricted Rights" as defined
 * in Clause 252.227-7013 (c) (1) of DFARs.  Notwithstanding the
 * foregoing, the authors grant the U.S. Government and others acting
 * in its behalf permission to use and distribute the software in
 * accordance with the terms specified in this license.
 *
 */

50 51 52 53
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif

54 55
#ifndef __GTK_TEXT_TAG_H__
#define __GTK_TEXT_TAG_H__
56

Manish Singh's avatar
Manish Singh committed
57
#include <glib-object.h>
58
#include <gdk/gdk.h>
Manish Singh's avatar
Manish Singh committed
59 60 61 62
#include <gtk/gtkenums.h>

/* Not needed, retained for compatibility -Yosh */
#include <gtk/gtkobject.h>
63

64
G_BEGIN_DECLS
65 66 67 68

typedef struct _GtkTextIter GtkTextIter;
typedef struct _GtkTextTagTable GtkTextTagTable;

69
typedef struct _GtkTextAttributes GtkTextAttributes;
70

71
#define GTK_TYPE_TEXT_TAG            (gtk_text_tag_get_type ())
72 73 74 75 76
#define GTK_TEXT_TAG(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_TEXT_TAG, GtkTextTag))
#define GTK_TEXT_TAG_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_TEXT_TAG, GtkTextTagClass))
#define GTK_IS_TEXT_TAG(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TEXT_TAG))
#define GTK_IS_TEXT_TAG_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_TEXT_TAG))
#define GTK_TEXT_TAG_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_TEXT_TAG, GtkTextTagClass))
77

78 79
#define GTK_TYPE_TEXT_ATTRIBUTES     (gtk_text_attributes_get_type ())

80 81 82
typedef struct _GtkTextTag GtkTextTag;
typedef struct _GtkTextTagClass GtkTextTagClass;

Havoc Pennington's avatar
Havoc Pennington committed
83 84
struct _GtkTextTag
{
85
  GObject parent_instance;
86 87

  GtkTextTagTable *table;
88 89 90 91 92 93

  char *name;                   /* Name of this tag.  This field is actually
                                 * a pointer to the key from the entry in
                                 * tkxt->tagTable, so it needn't be freed
                                 * explicitly. */
  int priority;         /* Priority of this tag within widget.  0
94 95 96 97 98 99 100 101 102 103 104
                         * means lowest priority.  Exactly one tag
                         * has each integer value between 0 and
                         * numTags-1. */
  /*
   * Information for displaying text with this tag.  The information
   * belows acts as an override on information specified by lower-priority
   * tags.  If no value is specified, then the next-lower-priority tag
   * on the text determins the value.  The text widget itself provides
   * defaults if no tag specifies an override.
   */

105
  GtkTextAttributes *values;
106
  
107 108 109
  /* Flags for whether a given value is set; if a value is unset, then
   * this tag does not affect it.
   */
110 111 112
  guint bg_color_set : 1;
  guint bg_stipple_set : 1;
  guint fg_color_set : 1;
Havoc Pennington's avatar
Havoc Pennington committed
113
  guint scale_set : 1;
114
  guint fg_stipple_set : 1;
115
  guint justification_set : 1;
116
  guint left_margin_set : 1;
117
  guint indent_set : 1;
118
  guint rise_set : 1;
119
  guint strikethrough_set : 1;
120 121 122 123
  guint right_margin_set : 1;
  guint pixels_above_lines_set : 1;
  guint pixels_below_lines_set : 1;
  guint pixels_inside_wrap_set : 1;
124
  guint tabs_set : 1;
125 126 127
  guint underline_set : 1;
  guint wrap_mode_set : 1;
  guint bg_full_height_set : 1;
128
  guint invisible_set : 1;
129
  guint editable_set : 1;
130
  guint language_set : 1;
131
  guint pg_bg_color_set : 1;
132 133 134 135

  /* Whether these margins accumulate or override */
  guint accumulative_margin : 1;

136 137 138
  guint pad1 : 1;
};

139
struct _GtkTextTagClass
140
{
141
  GObjectClass parent_class;
142

143 144 145 146
  gboolean (* event) (GtkTextTag        *tag,
                      GObject           *event_object, /* widget, canvas item, whatever */
                      GdkEvent          *event,        /* the event itself */
                      const GtkTextIter *iter);        /* location of event in buffer */
147

148 149 150 151 152
  /* Padding for future expansion */
  void (*_gtk_reserved1) (void);
  void (*_gtk_reserved2) (void);
  void (*_gtk_reserved3) (void);
  void (*_gtk_reserved4) (void);
153 154
};

155
GType        gtk_text_tag_get_type     (void) G_GNUC_CONST;
156
GtkTextTag  *gtk_text_tag_new          (const gchar       *name);
157
gint         gtk_text_tag_get_priority (GtkTextTag        *tag);
158
void         gtk_text_tag_set_priority (GtkTextTag        *tag,
159
                                        gint               priority);
160
gboolean     gtk_text_tag_event        (GtkTextTag        *tag,
161
                                        GObject           *event_object,
162 163
                                        GdkEvent          *event,
                                        const GtkTextIter *iter);
164

165 166 167 168 169 170 171 172
/*
 * Style object created by folding a set of tags together
 */

typedef struct _GtkTextAppearance GtkTextAppearance;

struct _GtkTextAppearance
{
Soren Sandmann's avatar
Soren Sandmann committed
173
  /*< public >*/
174 175 176 177 178
  GdkColor bg_color;
  GdkColor fg_color;
  GdkBitmap *bg_stipple;
  GdkBitmap *fg_stipple;

179 180
  /* super/subscript rise, can be negative */
  gint rise;
181

Soren Sandmann's avatar
Soren Sandmann committed
182
  /*< private >*/
183 184 185 186
  /* I'm not sure this can really be used without breaking some things
   * an app might do :-/
   */
  gpointer padding1;
Soren Sandmann's avatar
Soren Sandmann committed
187 188

  /*< public >*/
189
  guint underline : 4;          /* PangoUnderline */
190
  guint strikethrough : 1;
191 192 193 194

  /* Whether to use background-related values; this is irrelevant for
   * the values struct when in a tag, but is used for the composite
   * values struct; it's true if any of the tags being composited
195 196
   * had background stuff set.
   */
197
  guint draw_bg : 1;
198 199
  
  /* These are only used when we are actually laying out and rendering
200
   * a paragraph; not when a GtkTextAppearance is part of a
201
   * GtkTextAttributes.
202 203
   */
  guint inside_selection : 1;
204
  guint is_text : 1;
205

Soren Sandmann's avatar
Soren Sandmann committed
206
  /*< private >*/
207 208 209 210
  guint pad1 : 1;
  guint pad2 : 1;
  guint pad3 : 1;
  guint pad4 : 1;
211 212
};

213
struct _GtkTextAttributes
214
{
Soren Sandmann's avatar
Soren Sandmann committed
215
  /*< private >*/
216 217
  guint refcount;

Soren Sandmann's avatar
Soren Sandmann committed
218
  /*< public >*/
219
  GtkTextAppearance appearance;
220

221
  GtkJustification justification;
222
  GtkTextDirection direction;
223

224
  /* Individual chunks of this can be set/unset as a group */
225
  PangoFontDescription *font;
226

Havoc Pennington's avatar
Havoc Pennington committed
227 228
  gdouble font_scale;
  
229
  gint left_margin;
230

231
  gint indent;  
232

233 234 235 236 237 238 239 240
  gint right_margin;

  gint pixels_above_lines;

  gint pixels_below_lines;

  gint pixels_inside_wrap;

241
  PangoTabArray *tabs;
242 243 244 245

  GtkWrapMode wrap_mode;        /* How to handle wrap-around for this tag.
                                 * Must be GTK_WRAPMODE_CHAR,
                                 * GTK_WRAPMODE_NONE, GTK_WRAPMODE_WORD
246 247
                                 */

248
  PangoLanguage *language;
249

Soren Sandmann's avatar
Soren Sandmann committed
250
  /*< private >*/
251
  GdkColor *pg_bg_color;
Soren Sandmann's avatar
Soren Sandmann committed
252 253

  /*< public >*/
254 255 256 257
  /* hide the text  */
  guint invisible : 1;

  /* Background is fit to full line height rather than
258 259
   * baseline +/- ascent/descent (font height)
   */
260
  guint bg_full_height : 1;
261

262 263 264 265 266 267
  /* can edit this text */
  guint editable : 1;

  /* colors are allocated etc. */
  guint realized : 1;

Soren Sandmann's avatar
Soren Sandmann committed
268
  /*< private >*/
269 270 271 272 273 274
  guint pad1 : 1;
  guint pad2 : 1;
  guint pad3 : 1;
  guint pad4 : 1;
};

275 276 277 278 279
GtkTextAttributes* gtk_text_attributes_new         (void);
GtkTextAttributes* gtk_text_attributes_copy        (GtkTextAttributes *src);
void               gtk_text_attributes_copy_values (GtkTextAttributes *src,
                                                    GtkTextAttributes *dest);
void               gtk_text_attributes_unref       (GtkTextAttributes *values);
Matthias Clasen's avatar
Matthias Clasen committed
280
GtkTextAttributes *gtk_text_attributes_ref         (GtkTextAttributes *values);
281

Matthias Clasen's avatar
Matthias Clasen committed
282
GType              gtk_text_attributes_get_type    (void) G_GNUC_CONST;
283

284

285
G_END_DECLS
286 287 288

#endif