/**
* gtk_source_gutter_queue_draw:
* @gutter: a #GtkSourceGutter.
*
* 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
*/
void
gtk_source_gutter_queue_draw (GtkSourceGutter *gutter)
{
g_return_if_fail (GTK_SOURCE_IS_GUTTER (gutter));
do_redraw (gutter);
}
/**
* gtk_source_gutter_get_window:
* @gutter: a #GtkSourceGutter.
*
* Get the #GdkWindow of the gutter. The window will only be available when the
* gutter has at least one, non-zero width, cell renderer packed.
*
* Returns: (transfer none): the #GdkWindow of the gutter, or %NULL
* if the gutter has no window.
*
* Since: 2.8
* Deprecated: 3.12: Use gtk_text_view_get_window() instead.
*/
GdkWindow *
gtk_source_gutter_get_window (GtkSourceGutter *gutter)
{
g_return_val_if_fail (GTK_SOURCE_IS_GUTTER (gutter), NULL);
g_return_val_if_fail (gutter->priv->view != NULL, NULL);
return get_window (gutter);
}
/**
* gtk_source_gutter_get_window:
* @gutter: a #GtkSourceGutter.
*
* Get the #GdkWindow of the gutter. The window will only be available when the
* gutter has at least one, non-zero width, cell renderer packed.
*
* Returns: (transfer none): the #GdkWindow of the gutter, or %NULL
* if the gutter has no window.
*
* Since: 2.8
*/
GdkWindow *
gtk_source_gutter_get_window (GtkSourceGutter *gutter)
{
g_return_val_if_fail (GTK_SOURCE_IS_GUTTER (gutter), NULL);
g_return_val_if_fail (gutter->priv->view != NULL, NULL);
return gtk_text_view_get_window (GTK_TEXT_VIEW (gutter->priv->view),
gutter->priv->window_type);
}
void
gtk_source_gutter_set_padding (GtkSourceGutter *gutter,
gint xpad,
gint ypad)
{
g_return_if_fail (GTK_SOURCE_IS_GUTTER (gutter));
if (set_xpad (gutter, xpad, FALSE) || set_ypad (gutter, ypad, FALSE))
{
update_gutter_size (gutter);
}
}
/**
* gtk_source_gutter_insert:
* @gutter: a #GtkSourceGutter.
* @renderer: a gutter renderer (must inherit from #GtkSourceGutterRenderer).
* @position: the renderer 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.
*
* Returns: %TRUE if operation succeeded. Otherwise %FALSE.
*
* Since: 3.0
*
**/
gboolean
gtk_source_gutter_insert (GtkSourceGutter *gutter,
GtkSourceGutterRenderer *renderer,
gint position)
{
Renderer* internal_renderer;
g_return_val_if_fail (GTK_SOURCE_IS_GUTTER (gutter), FALSE);
g_return_val_if_fail (GTK_SOURCE_IS_GUTTER_RENDERER (renderer), FALSE);
g_return_val_if_fail (gtk_source_gutter_renderer_get_view (renderer) == NULL, FALSE);
g_return_val_if_fail (gtk_source_gutter_renderer_get_window_type (renderer) == GTK_TEXT_WINDOW_PRIVATE, FALSE);
internal_renderer = renderer_new (gutter, renderer, position);
append_renderer (gutter, internal_renderer);
return TRUE;
}
void
gtk_source_gutter_get_padding (GtkSourceGutter *gutter,
gint *xpad,
gint *ypad)
{
g_return_if_fail (GTK_SOURCE_IS_GUTTER (gutter));
if (xpad)
{
*xpad = gutter->priv->xpad;
}
if (ypad)
{
*ypad = gutter->priv->ypad;
}
}
/**
* gtk_source_gutter_get_renderer_at_pos:
* @gutter: A #GtkSourceGutter.
* @x: The x position to get identified.
* @y: The y position to get identified.
*
* Finds the #GtkSourceGutterRenderer at (x, y).
*
* Returns: (transfer none): the renderer at (x, y) or %NULL.
*/
GtkSourceGutterRenderer *
gtk_source_gutter_get_renderer_at_pos (GtkSourceGutter *gutter,
gint x,
gint y)
{
Renderer *renderer;
g_return_val_if_fail (GTK_SOURCE_IS_GUTTER (gutter), NULL);
renderer = renderer_at_x (gutter, x, NULL, NULL);
if (renderer == NULL)
{
return NULL;
}
return renderer->renderer;
}
/**
* gtk_source_gutter_remove:
* @gutter: a #GtkSourceGutter.
* @renderer: a #GtkSourceGutterRenderer.
*
* Removes @renderer from @gutter.
*
* Since: 2.8
*/
void
gtk_source_gutter_remove (GtkSourceGutter *gutter,
GtkSourceGutterRenderer *renderer)
{
Renderer *ret;
GList *retlist;
g_return_if_fail (GTK_SOURCE_IS_GUTTER (gutter));
g_return_if_fail (GTK_SOURCE_IS_GUTTER_RENDERER (renderer));
if (renderer_find (gutter, renderer, &ret, &retlist))
{
gutter->priv->renderers =
g_list_delete_link (gutter->priv->renderers,
retlist);
update_gutter_size (gutter);
renderer_free (ret);
}
}
/**
* gtk_source_gutter_reorder:
* @gutter: a #GtkSourceGutterRenderer.
* @renderer: a #GtkCellRenderer.
* @position: the new renderer position.
*
* Reorders @renderer in @gutter to new @position.
*
* Since: 2.8
*/
void
gtk_source_gutter_reorder (GtkSourceGutter *gutter,
GtkSourceGutterRenderer *renderer,
gint position)
{
Renderer *ret;
GList *retlist;
g_return_if_fail (GTK_SOURCE_IS_GUTTER (gutter));
g_return_if_fail (GTK_SOURCE_IS_GUTTER_RENDERER (renderer));
if (renderer_find (gutter, renderer, &ret, &retlist))
{
gutter->priv->renderers =
g_list_delete_link (gutter->priv->renderers,
retlist);
ret->position = position;
append_renderer (gutter, ret);
}
}
