Tab Stops

Tab Stops — Structures for storing tab stops

Synopsis

                    PangoTabArray;
#define             PANGO_TYPE_TAB_ARRAY
enum                PangoTabAlign;
#define             PANGO_TYPE_TAB_ALIGN
PangoTabArray *     pango_tab_array_new                 (gint initial_size,
                                                         gboolean positions_in_pixels);
PangoTabArray *     pango_tab_array_new_with_positions  (gint size,
                                                         gboolean positions_in_pixels,
                                                         PangoTabAlign first_alignment,
                                                         gint first_position,
                                                         ...);
PangoTabArray *     pango_tab_array_copy                (PangoTabArray *src);
void                pango_tab_array_free                (PangoTabArray *tab_array);
gint                pango_tab_array_get_size            (PangoTabArray *tab_array);
void                pango_tab_array_resize              (PangoTabArray *tab_array,
                                                         gint new_size);
void                pango_tab_array_set_tab             (PangoTabArray *tab_array,
                                                         gint tab_index,
                                                         PangoTabAlign alignment,
                                                         gint location);
void                pango_tab_array_get_tab             (PangoTabArray *tab_array,
                                                         gint tab_index,
                                                         PangoTabAlign *alignment,
                                                         gint *location);
void                pango_tab_array_get_tabs            (PangoTabArray *tab_array,
                                                         PangoTabAlign **alignments,
                                                         gint **locations);
gboolean            pango_tab_array_get_positions_in_pixels
                                                        (PangoTabArray *tab_array);

Description

Functions in this section are used to deal with PangoTabArray objects that can be used to set tab stop positions in a PangoLayout.

Details

PangoTabArray

typedef struct _PangoTabArray PangoTabArray;

A PangoTabArray struct contains an array of tab stops. Each tab stop has an alignment and a position.

PANGO_TYPE_TAB_ARRAY

#define PANGO_TYPE_TAB_ARRAY (pango_tab_array_get_type ())

The GObject type for PangoTabArray.

enum PangoTabAlign

typedef enum
{
  PANGO_TAB_LEFT

  /* These are not supported now, but may be in the
   * future.
   *
   *  PANGO_TAB_RIGHT,
   *  PANGO_TAB_CENTER,
   *  PANGO_TAB_NUMERIC
   */
} PangoTabAlign;

A PangoTabAlign specifies where a tab stop appears relative to the text.

PANGO_TAB_LEFT

the tab stop appears to the left of the text.

PANGO_TYPE_TAB_ALIGN

#define PANGO_TYPE_TAB_ALIGN (pango_tab_align_get_type())

The GObject type for PangoTabAlign.

pango_tab_array_new ()

PangoTabArray *     pango_tab_array_new                 (gint initial_size,
                                                         gboolean positions_in_pixels);

Creates an array of initial_size tab stops. Tab stops are specified in pixel units if positions_in_pixels is TRUE, otherwise in Pango units. All stops are initially at position 0.

`initial_size` :	Initial number of tab stops to allocate, can be 0
`positions_in_pixels` :	whether positions are in pixel units
Returns :	the newly allocated PangoTabArray, which should be freed with `pango_tab_array_free()`.

pango_tab_array_new_with_positions ()

PangoTabArray *     pango_tab_array_new_with_positions  (gint size,
                                                         gboolean positions_in_pixels,
                                                         PangoTabAlign first_alignment,
                                                         gint first_position,
                                                         ...);

This is a convenience function that creates a PangoTabArray and allows you to specify the alignment and position of each tab stop. You must provide an alignment and position for size tab stops.

`size` :	number of tab stops in the array
`positions_in_pixels` :	whether positions are in pixel units
`first_alignment` :	alignment of first tab stop
`first_position` :	position of first tab stop
`...` :	additional alignment/position pairs
Returns :	the newly allocated PangoTabArray, which should be freed with `pango_tab_array_free()`.

pango_tab_array_copy ()

PangoTabArray *     pango_tab_array_copy                (PangoTabArray *src);

Copies a PangoTabArray

`src` :	PangoTabArray to copy
Returns :	the newly allocated PangoTabArray, which should be freed with `pango_tab_array_free()`.

pango_tab_array_free ()

void                pango_tab_array_free                (PangoTabArray *tab_array);

Frees a tab array and associated resources.

tab_array :

a PangoTabArray

pango_tab_array_get_size ()

gint                pango_tab_array_get_size            (PangoTabArray *tab_array);

Gets the number of tab stops in tab_array.

`tab_array` :	a PangoTabArray
Returns :	the number of tab stops in the array.

pango_tab_array_resize ()

void                pango_tab_array_resize              (PangoTabArray *tab_array,
                                                         gint new_size);

Resizes a tab array. You must subsequently initialize any tabs that were added as a result of growing the array.

`tab_array` :	a PangoTabArray
`new_size` :	new size of the array

pango_tab_array_set_tab ()

void                pango_tab_array_set_tab             (PangoTabArray *tab_array,
                                                         gint tab_index,
                                                         PangoTabAlign alignment,
                                                         gint location);

Sets the alignment and location of a tab stop. alignment must always be PANGO_TAB_LEFT in the current implementation.

`tab_array` :	a PangoTabArray
`tab_index` :	the index of a tab stop
`alignment` :	tab alignment
`location` :	tab location in Pango units

pango_tab_array_get_tab ()

void                pango_tab_array_get_tab             (PangoTabArray *tab_array,
                                                         gint tab_index,
                                                         PangoTabAlign *alignment,
                                                         gint *location);

Gets the alignment and position of a tab stop.

`tab_array` :	a PangoTabArray
`tab_index` :	tab stop index
`alignment` :	location to store alignment, or `NULL`
`location` :	location to store tab position, or `NULL`

pango_tab_array_get_tabs ()

void                pango_tab_array_get_tabs            (PangoTabArray *tab_array,
                                                         PangoTabAlign **alignments,
                                                         gint **locations);

If non-NULL, alignments and locations are filled with allocated arrays of length pango_tab_array_get_size(). You must free the returned array.

`tab_array` :	a PangoTabArray
`alignments` :	location to store an array of tab stop alignments, or `NULL`
`locations` :	location to store an array of tab positions, or `NULL`

pango_tab_array_get_positions_in_pixels ()

gboolean            pango_tab_array_get_positions_in_pixels
                                                        (PangoTabArray *tab_array);

Returns TRUE if the tab positions are in pixels, FALSE if they are in Pango units.

`tab_array` :	a PangoTabArray
Returns :	whether positions are in pixels.

			Pango Reference Manual
Top \| Description