Top |
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 |
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
);
Since: 3.24
gtk_source_gutter_get_window_type ()
GtkTextWindowType
gtk_source_gutter_get_window_type (GtkSourceGutter *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 |
||
renderer |
a gutter renderer (must inherit from GtkSourceGutterRenderer). |
|
position |
the renderer position. |
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
.
Since: 2.8
gtk_source_gutter_remove ()
void gtk_source_gutter_remove (GtkSourceGutter *gutter
,GtkSourceGutterRenderer *renderer
);
Removes renderer
from gutter
.
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.
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).
Property Details
The “view”
property
“view” GtkSourceView *
The GtkSourceView of the gutter.
Flags: Read / Write / Construct Only