GtkSourceGutter: libgedit-gtksourceview 300 Reference Manual

## GtkSourceGutter

GtkSourceGutter — Gutter object for GtkSourceView

## Functions

GtkSourceView * | gtk_source_gutter_get_view ()
GtkTextWindowType | gtk_source_gutter_get_window_type ()
gboolean | gtk_source_gutter_insert ()
void | gtk_source_gutter_reorder ()
void | gtk_source_gutter_remove ()
void | gtk_source_gutter_queue_draw ()
GtkSourceGutterRenderer * | gtk_source_gutter_get_renderer_at_pos ()

## Properties

GtkSourceView * | view | Read / Write / Construct Only
GtkTextWindowType | window-type | Read / Write / Construct Only

## Types and Values

struct | GtkSourceGutter

## Object Hierarchy

        GObject
        ╰── GtkSourceGutter

## Includes

    #include <gtksourceview/gtksource.h>

## Description

The GtkSourceGutter object represents the left or right gutter of the text view. It is used by GtkSourceView to draw the line numbers and GtkSourceMarks that might be present on a line. By packing additional GtkSourceGutterRenderer objects in the gutter, you can extend the gutter with your own custom drawings.

To get a GtkSourceGutter, use the `gtk_source_view_get_gutter()` function.

The gutter works very much the same way as cells rendered in a GtkTreeView. The concept is similar, with the exception that the gutter does not have an underlying GtkTreeModel. The builtin line number renderer is at position GTK_SOURCE_VIEW_GUTTER_POSITION_LINES (-30) and the marks renderer is at GTK_SOURCE_VIEW_GUTTER_POSITION_MARKS (-20). The gutter sorts the renderers in ascending order, from left to right. So the marks are displayed on the right of the line numbers.

## Functions

### gtk_source_gutter_get_view ()

    GtkSourceView *
    gtk_source_gutter_get_view (GtkSourceGutter *gutter);

#### Parameters

gutter | a GtkSourceGutter. |

#### Returns

the associated GtkSourceView.

[transfer none]

Since: 3.24

### gtk_source_gutter_get_window_type ()

    GtkTextWindowType
    gtk_source_gutter_get_window_type (GtkSourceGutter *gutter);

#### Parameters

gutter | a GtkSourceGutter. |

#### Returns

the GtkTextWindowType of `gutter` .

Since: 3.24

### gtk_source_gutter_insert ()

    gboolean
    gtk_source_gutter_insert (GtkSourceGutter *gutter,
                              GtkSourceGutterRenderer *renderer,
                              gint position);

Insert `renderer` into the gutter. If `renderer` is yet unowned then gutter claims its ownership. Otherwise just increases renderer's reference count. `renderer` cannot be already inserted to another gutter.

#### Parameters

gutter | a GtkSourceGutter. |
renderer | a gutter renderer (must inherit from GtkSourceGutterRenderer). |
position | the renderer position. |

#### Returns

`TRUE` if operation succeeded. Otherwise `FALSE`.

Since: 3.0

### gtk_source_gutter_reorder ()

    void
    gtk_source_gutter_reorder (GtkSourceGutter *gutter,
                               GtkSourceGutterRenderer *renderer,
                               gint position);

Reorders `renderer` in `gutter` to new `position` .

#### Parameters

gutter | a GtkSourceGutterRenderer. |
renderer | a GtkCellRenderer. |
position | the new renderer position. |

Since: 2.8

### gtk_source_gutter_remove ()

    void
    gtk_source_gutter_remove (GtkSourceGutter *gutter,
                              GtkSourceGutterRenderer *renderer);

Removes `renderer` from `gutter` .

#### Parameters

gutter | a GtkSourceGutter. |
renderer | a GtkSourceGutterRenderer. |

Since: 2.8

### gtk_source_gutter_queue_draw ()

    void
    gtk_source_gutter_queue_draw (GtkSourceGutter *gutter);

Invalidates the drawable area of the gutter. You can use this to force a redraw of the gutter if something has changed and needs to be redrawn.

#### Parameters

gutter | a GtkSourceGutter. |

Since: 2.8

### gtk_source_gutter_get_renderer_at_pos ()

    GtkSourceGutterRenderer *
    gtk_source_gutter_get_renderer_at_pos (GtkSourceGutter *gutter,
                                           gint x,
                                           gint y);

Finds the GtkSourceGutterRenderer at (x, y).

#### Parameters

gutter | A GtkSourceGutter. |
x | The x position to get identified. |
y | The y position to get identified. |

#### Returns

the renderer at (x, y) or `NULL`.

[nullable][transfer none]

## Types and Values

### struct GtkSourceGutter

    struct GtkSourceGutter;

## Property Details

### The `“view”` property

      “view”                     GtkSourceView *

The GtkSourceView of the gutter.

Owner: GtkSourceGutter

Flags: Read / Write / Construct Only

### The `“window-type”` property

      “window-type”              GtkTextWindowType

The text window type on which the window is placed.

Owner: GtkSourceGutter

Flags: Read / Write / Construct Only

Default value: GTK_TEXT_WINDOW_PRIVATE

## See Also

GtkSourceView, GtkSourceMark