5119 lines
264 KiB
HTML
5119 lines
264 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
<title>GtkTextBuffer: GTK+ 3 Reference Manual</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
||
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
|
||
<link rel="up" href="TextWidgetObjects.html" title="Multiline Text Editor">
|
||
<link rel="prev" href="GtkTextMark.html" title="GtkTextMark">
|
||
<link rel="next" href="GtkTextTag.html" title="GtkTextTag">
|
||
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
|
||
<td width="100%" align="left" class="shortcuts">
|
||
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
||
<a href="#GtkTextBuffer.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
||
<a href="#GtkTextBuffer.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span>
|
||
<a href="#GtkTextBuffer.properties" class="shortcut">Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
|
||
<a href="#GtkTextBuffer.signals" class="shortcut">Signals</a></span>
|
||
</td>
|
||
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
||
<td><a accesskey="u" href="TextWidgetObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="p" href="GtkTextMark.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="n" href="GtkTextTag.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
||
</tr></table>
|
||
<div class="refentry">
|
||
<a name="GtkTextBuffer"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="GtkTextBuffer.top_of_page"></a>GtkTextBuffer</span></h2>
|
||
<p>GtkTextBuffer — Stores attributed text for display in a GtkTextView</p>
|
||
</td>
|
||
<td class="gallery_image" valign="top" align="right"></td>
|
||
</tr></table></div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.functions"></a><h2>Functions</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="functions_proto_type">
|
||
<col class="functions_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="returnvalue">GtkTextBuffer</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-new" title="gtk_text_buffer_new ()">gtk_text_buffer_new</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-line-count" title="gtk_text_buffer_get_line_count ()">gtk_text_buffer_get_line_count</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-char-count" title="gtk_text_buffer_get_char_count ()">gtk_text_buffer_get_char_count</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextTagTable.html" title="GtkTextTagTable"><span class="returnvalue">GtkTextTagTable</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-tag-table" title="gtk_text_buffer_get_tag_table ()">gtk_text_buffer_get_tag_table</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert" title="gtk_text_buffer_insert ()">gtk_text_buffer_insert</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-at-cursor" title="gtk_text_buffer_insert_at_cursor ()">gtk_text_buffer_insert_at_cursor</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-interactive" title="gtk_text_buffer_insert_interactive ()">gtk_text_buffer_insert_interactive</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-interactive-at-cursor" title="gtk_text_buffer_insert_interactive_at_cursor ()">gtk_text_buffer_insert_interactive_at_cursor</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-range" title="gtk_text_buffer_insert_range ()">gtk_text_buffer_insert_range</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-range-interactive" title="gtk_text_buffer_insert_range_interactive ()">gtk_text_buffer_insert_range_interactive</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-with-tags" title="gtk_text_buffer_insert_with_tags ()">gtk_text_buffer_insert_with_tags</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-with-tags-by-name" title="gtk_text_buffer_insert_with_tags_by_name ()">gtk_text_buffer_insert_with_tags_by_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-markup" title="gtk_text_buffer_insert_markup ()">gtk_text_buffer_insert_markup</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete" title="gtk_text_buffer_delete ()">gtk_text_buffer_delete</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete-interactive" title="gtk_text_buffer_delete_interactive ()">gtk_text_buffer_delete_interactive</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-backspace" title="gtk_text_buffer_backspace ()">gtk_text_buffer_backspace</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-set-text" title="gtk_text_buffer_set_text ()">gtk_text_buffer_set_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-text" title="gtk_text_buffer_get_text ()">gtk_text_buffer_get_text</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-slice" title="gtk_text_buffer_get_slice ()">gtk_text_buffer_get_slice</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-pixbuf" title="gtk_text_buffer_insert_pixbuf ()">gtk_text_buffer_insert_pixbuf</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-child-anchor" title="gtk_text_buffer_insert_child_anchor ()">gtk_text_buffer_insert_child_anchor</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextView.html#GtkTextChildAnchor"><span class="returnvalue">GtkTextChildAnchor</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-create-child-anchor" title="gtk_text_buffer_create_child_anchor ()">gtk_text_buffer_create_child_anchor</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="returnvalue">GtkTextMark</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-create-mark" title="gtk_text_buffer_create_mark ()">gtk_text_buffer_create_mark</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-move-mark" title="gtk_text_buffer_move_mark ()">gtk_text_buffer_move_mark</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-move-mark-by-name" title="gtk_text_buffer_move_mark_by_name ()">gtk_text_buffer_move_mark_by_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-add-mark" title="gtk_text_buffer_add_mark ()">gtk_text_buffer_add_mark</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete-mark" title="gtk_text_buffer_delete_mark ()">gtk_text_buffer_delete_mark</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete-mark-by-name" title="gtk_text_buffer_delete_mark_by_name ()">gtk_text_buffer_delete_mark_by_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="returnvalue">GtkTextMark</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-mark" title="gtk_text_buffer_get_mark ()">gtk_text_buffer_get_mark</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="returnvalue">GtkTextMark</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-insert" title="gtk_text_buffer_get_insert ()">gtk_text_buffer_get_insert</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="returnvalue">GtkTextMark</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-selection-bound" title="gtk_text_buffer_get_selection_bound ()">gtk_text_buffer_get_selection_bound</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-has-selection" title="gtk_text_buffer_get_has_selection ()">gtk_text_buffer_get_has_selection</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-place-cursor" title="gtk_text_buffer_place_cursor ()">gtk_text_buffer_place_cursor</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-select-range" title="gtk_text_buffer_select_range ()">gtk_text_buffer_select_range</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-apply-tag" title="gtk_text_buffer_apply_tag ()">gtk_text_buffer_apply_tag</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-remove-tag" title="gtk_text_buffer_remove_tag ()">gtk_text_buffer_remove_tag</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-apply-tag-by-name" title="gtk_text_buffer_apply_tag_by_name ()">gtk_text_buffer_apply_tag_by_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-remove-tag-by-name" title="gtk_text_buffer_remove_tag_by_name ()">gtk_text_buffer_remove_tag_by_name</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-remove-all-tags" title="gtk_text_buffer_remove_all_tags ()">gtk_text_buffer_remove_all_tags</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="returnvalue">GtkTextTag</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-create-tag" title="gtk_text_buffer_create_tag ()">gtk_text_buffer_create_tag</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-iter-at-line-offset" title="gtk_text_buffer_get_iter_at_line_offset ()">gtk_text_buffer_get_iter_at_line_offset</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-iter-at-offset" title="gtk_text_buffer_get_iter_at_offset ()">gtk_text_buffer_get_iter_at_offset</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-iter-at-line" title="gtk_text_buffer_get_iter_at_line ()">gtk_text_buffer_get_iter_at_line</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-iter-at-line-index" title="gtk_text_buffer_get_iter_at_line_index ()">gtk_text_buffer_get_iter_at_line_index</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-iter-at-mark" title="gtk_text_buffer_get_iter_at_mark ()">gtk_text_buffer_get_iter_at_mark</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-iter-at-child-anchor" title="gtk_text_buffer_get_iter_at_child_anchor ()">gtk_text_buffer_get_iter_at_child_anchor</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-start-iter" title="gtk_text_buffer_get_start_iter ()">gtk_text_buffer_get_start_iter</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-end-iter" title="gtk_text_buffer_get_end_iter ()">gtk_text_buffer_get_end_iter</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-bounds" title="gtk_text_buffer_get_bounds ()">gtk_text_buffer_get_bounds</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-modified" title="gtk_text_buffer_get_modified ()">gtk_text_buffer_get_modified</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-set-modified" title="gtk_text_buffer_set_modified ()">gtk_text_buffer_set_modified</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete-selection" title="gtk_text_buffer_delete_selection ()">gtk_text_buffer_delete_selection</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-paste-clipboard" title="gtk_text_buffer_paste_clipboard ()">gtk_text_buffer_paste_clipboard</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-copy-clipboard" title="gtk_text_buffer_copy_clipboard ()">gtk_text_buffer_copy_clipboard</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-cut-clipboard" title="gtk_text_buffer_cut_clipboard ()">gtk_text_buffer_cut_clipboard</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-selection-bounds" title="gtk_text_buffer_get_selection_bounds ()">gtk_text_buffer_get_selection_bounds</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-begin-user-action" title="gtk_text_buffer_begin_user_action ()">gtk_text_buffer_begin_user_action</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-end-user-action" title="gtk_text_buffer_end_user_action ()">gtk_text_buffer_end_user_action</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-add-selection-clipboard" title="gtk_text_buffer_add_selection_clipboard ()">gtk_text_buffer_add_selection_clipboard</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-remove-selection-clipboard" title="gtk_text_buffer_remove_selection_clipboard ()">gtk_text_buffer_remove_selection_clipboard</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<span class="c_punctuation">(</span><a class="link" href="GtkTextBuffer.html#GtkTextBufferDeserializeFunc" title="GtkTextBufferDeserializeFunc ()">*GtkTextBufferDeserializeFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-deserialize" title="gtk_text_buffer_deserialize ()">gtk_text_buffer_deserialize</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-deserialize-get-can-create-tags" title="gtk_text_buffer_deserialize_get_can_create_tags ()">gtk_text_buffer_deserialize_get_can_create_tags</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-deserialize-set-can-create-tags" title="gtk_text_buffer_deserialize_set_can_create_tags ()">gtk_text_buffer_deserialize_set_can_create_tags</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="returnvalue">GtkTargetList</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-copy-target-list" title="gtk_text_buffer_get_copy_target_list ()">gtk_text_buffer_get_copy_target_list</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkAtom</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-deserialize-formats" title="gtk_text_buffer_get_deserialize_formats ()">gtk_text_buffer_get_deserialize_formats</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="returnvalue">GtkTargetList</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-paste-target-list" title="gtk_text_buffer_get_paste_target_list ()">gtk_text_buffer_get_paste_target_list</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkAtom</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-serialize-formats" title="gtk_text_buffer_get_serialize_formats ()">gtk_text_buffer_get_serialize_formats</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkAtom</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-format" title="gtk_text_buffer_register_deserialize_format ()">gtk_text_buffer_register_deserialize_format</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkAtom</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-tagset" title="gtk_text_buffer_register_deserialize_tagset ()">gtk_text_buffer_register_deserialize_tagset</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkAtom</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-format" title="gtk_text_buffer_register_serialize_format ()">gtk_text_buffer_register_serialize_format</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GdkAtom</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-tagset" title="gtk_text_buffer_register_serialize_tagset ()">gtk_text_buffer_register_serialize_tagset</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">guint8</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<span class="c_punctuation">(</span><a class="link" href="GtkTextBuffer.html#GtkTextBufferSerializeFunc" title="GtkTextBufferSerializeFunc ()">*GtkTextBufferSerializeFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">guint8</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-serialize" title="gtk_text_buffer_serialize ()">gtk_text_buffer_serialize</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-unregister-deserialize-format" title="gtk_text_buffer_unregister_deserialize_format ()">gtk_text_buffer_unregister_deserialize_format</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-unregister-serialize-format" title="gtk_text_buffer_unregister_serialize_format ()">gtk_text_buffer_unregister_serialize_format</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.properties"></a><h2>Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="properties_type">
|
||
<col width="300px" class="properties_name">
|
||
<col width="200px" class="properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer--copy-target-list" title="The “copy-target-list” property">copy-target-list</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer--cursor-position" title="The “cursor-position” property">cursor-position</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer--has-selection" title="The “has-selection” property">has-selection</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer--paste-target-list" title="The “paste-target-list” property">paste-target-list</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkTextTagTable.html" title="GtkTextTagTable"><span class="type">GtkTextTagTable</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer--tag-table" title="The “tag-table” property">tag-table</a></td>
|
||
<td class="property_flags">Read / Write / Construct Only</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer--text" title="The “text” property">text</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.signals"></a><h2>Signals</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="signal_proto_type">
|
||
<col width="300px" class="signal_proto_name">
|
||
<col width="200px" class="signal_proto_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-apply-tag" title="The “apply-tag” signal">apply-tag</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-begin-user-action" title="The “begin-user-action” signal">begin-user-action</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-changed" title="The “changed” signal">changed</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-delete-range" title="The “delete-range” signal">delete-range</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-end-user-action" title="The “end-user-action” signal">end-user-action</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-insert-child-anchor" title="The “insert-child-anchor” signal">insert-child-anchor</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-insert-pixbuf" title="The “insert-pixbuf” signal">insert-pixbuf</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-insert-text" title="The “insert-text” signal">insert-text</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-mark-deleted" title="The “mark-deleted” signal">mark-deleted</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-mark-set" title="The “mark-set” signal">mark-set</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-modified-changed" title="The “modified-changed” signal">modified-changed</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-paste-done" title="The “paste-done” signal">paste-done</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-remove-tag" title="The “remove-tag” signal">remove-tag</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.other"></a><h2>Types and Values</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="other_proto_type">
|
||
<col class="other_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="datatype_keyword"> </td>
|
||
<td class="function_name"><a class="link" href="GtkTextBuffer.html#GtkTextBuffer-struct" title="GtkTextBuffer">GtkTextBuffer</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkTextBuffer.html#GtkTextBufferClass" title="struct GtkTextBufferClass">GtkTextBufferClass</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">enum</td>
|
||
<td class="function_name"><a class="link" href="GtkTextBuffer.html#GtkTextBufferTargetInfo" title="enum GtkTextBufferTargetInfo">GtkTextBufferTargetInfo</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||
<pre class="screen"> GObject
|
||
<span class="lineart">╰──</span> GtkTextBuffer
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.includes"></a><h2>Includes</h2>
|
||
<pre class="synopsis">#include <gtk/gtk.h>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.description"></a><h2>Description</h2>
|
||
<p>You may wish to begin by reading the
|
||
<a class="link" href="TextWidget.html" title="Text Widget Overview">text widget conceptual overview</a>
|
||
which gives an overview of all the objects and data
|
||
types related to the text widget and how they work together.</p>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.functions_details"></a><h2>Functions</h2>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-new"></a><h3>gtk_text_buffer_new ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="returnvalue">GtkTextBuffer</span></a> *
|
||
gtk_text_buffer_new (<em class="parameter"><code><a class="link" href="GtkTextTagTable.html" title="GtkTextTagTable"><span class="type">GtkTextTagTable</span></a> *table</code></em>);</pre>
|
||
<p>Creates a new text buffer.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-new.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>table</p></td>
|
||
<td class="parameter_description"><p>a tag table, or <code class="literal">NULL</code> to create a new one. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-new.returns"></a><h4>Returns</h4>
|
||
<p> a new text buffer</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-line-count"></a><h3>gtk_text_buffer_get_line_count ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_buffer_get_line_count (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>Obtains the number of lines in the buffer. This value is cached, so
|
||
the function is very fast.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-line-count.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-line-count.returns"></a><h4>Returns</h4>
|
||
<p> number of lines in the buffer</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-char-count"></a><h3>gtk_text_buffer_get_char_count ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_text_buffer_get_char_count (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>Gets the number of characters in the buffer; note that characters
|
||
and bytes are not the same, you can’t e.g. expect the contents of
|
||
the buffer in string form to be this many bytes long. The character
|
||
count is cached, so this function is very fast.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-char-count.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-char-count.returns"></a><h4>Returns</h4>
|
||
<p> number of characters in the buffer</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-tag-table"></a><h3>gtk_text_buffer_get_tag_table ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextTagTable.html" title="GtkTextTagTable"><span class="returnvalue">GtkTextTagTable</span></a> *
|
||
gtk_text_buffer_get_tag_table (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>Get the <a class="link" href="GtkTextTagTable.html" title="GtkTextTagTable"><span class="type">GtkTextTagTable</span></a> associated with this buffer.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-tag-table.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-tag-table.returns"></a><h4>Returns</h4>
|
||
<p>the buffer’s tag table. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert"></a><h3>gtk_text_buffer_insert ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_insert (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> len</code></em>);</pre>
|
||
<p>Inserts <em class="parameter"><code>len</code></em>
|
||
bytes of <em class="parameter"><code>text</code></em>
|
||
at position <em class="parameter"><code>iter</code></em>
|
||
. If <em class="parameter"><code>len</code></em>
|
||
is -1,
|
||
<em class="parameter"><code>text</code></em>
|
||
must be nul-terminated and will be inserted in its
|
||
entirety. Emits the “insert-text” signal; insertion actually occurs
|
||
in the default handler for the signal. <em class="parameter"><code>iter</code></em>
|
||
is invalidated when
|
||
insertion occurs (because the buffer contents change), but the
|
||
default signal handler revalidates it to point to the end of the
|
||
inserted text.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a position in the buffer</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>text in UTF-8 format</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>len</p></td>
|
||
<td class="parameter_description"><p>length of text in bytes, or -1</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert-at-cursor"></a><h3>gtk_text_buffer_insert_at_cursor ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_insert_at_cursor (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> len</code></em>);</pre>
|
||
<p>Simply calls <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert" title="gtk_text_buffer_insert ()"><code class="function">gtk_text_buffer_insert()</code></a>, using the current
|
||
cursor position as the insertion point.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-at-cursor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>text in UTF-8 format</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>len</p></td>
|
||
<td class="parameter_description"><p>length of text, in bytes</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert-interactive"></a><h3>gtk_text_buffer_insert_interactive ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_insert_interactive (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> len</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> default_editable</code></em>);</pre>
|
||
<p>Like <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert" title="gtk_text_buffer_insert ()"><code class="function">gtk_text_buffer_insert()</code></a>, but the insertion will not occur if
|
||
<em class="parameter"><code>iter</code></em>
|
||
is at a non-editable location in the buffer. Usually you
|
||
want to prevent insertions at ineditable locations if the insertion
|
||
results from a user action (is interactive).</p>
|
||
<p><em class="parameter"><code>default_editable</code></em>
|
||
indicates the editability of text that doesn't
|
||
have a tag affecting editability applied to it. Typically the
|
||
result of <a class="link" href="GtkTextView.html#gtk-text-view-get-editable" title="gtk_text_view_get_editable ()"><code class="function">gtk_text_view_get_editable()</code></a> is appropriate here.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-interactive.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a position in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>some UTF-8 text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>len</p></td>
|
||
<td class="parameter_description"><p>length of text in bytes, or -1</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_editable</p></td>
|
||
<td class="parameter_description"><p>default editability of buffer</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-interactive.returns"></a><h4>Returns</h4>
|
||
<p> whether text was actually inserted</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert-interactive-at-cursor"></a><h3>gtk_text_buffer_insert_interactive_at_cursor ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_insert_interactive_at_cursor
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> len</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> default_editable</code></em>);</pre>
|
||
<p>Calls <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-interactive" title="gtk_text_buffer_insert_interactive ()"><code class="function">gtk_text_buffer_insert_interactive()</code></a> at the cursor
|
||
position.</p>
|
||
<p><em class="parameter"><code>default_editable</code></em>
|
||
indicates the editability of text that doesn't
|
||
have a tag affecting editability applied to it. Typically the
|
||
result of <a class="link" href="GtkTextView.html#gtk-text-view-get-editable" title="gtk_text_view_get_editable ()"><code class="function">gtk_text_view_get_editable()</code></a> is appropriate here.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-interactive-at-cursor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>text in UTF-8 format</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>len</p></td>
|
||
<td class="parameter_description"><p>length of text in bytes, or -1</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_editable</p></td>
|
||
<td class="parameter_description"><p>default editability of buffer</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-interactive-at-cursor.returns"></a><h4>Returns</h4>
|
||
<p> whether text was actually inserted</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert-range"></a><h3>gtk_text_buffer_insert_range ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_insert_range (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Copies text, tags, and pixbufs between <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
(the order
|
||
of <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
doesn’t matter) and inserts the copy at <em class="parameter"><code>iter</code></em>
|
||
.
|
||
Used instead of simply getting/inserting text because it preserves
|
||
images and tags. If <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
are in a different buffer from
|
||
<em class="parameter"><code>buffer</code></em>
|
||
, the two buffers must share the same tag table.</p>
|
||
<p>Implemented via emissions of the insert_text and apply_tag signals,
|
||
so expect those.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-range.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a position in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>a position in a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>another position in the same buffer as <em class="parameter"><code>start</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert-range-interactive"></a><h3>gtk_text_buffer_insert_range_interactive ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_insert_range_interactive
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> default_editable</code></em>);</pre>
|
||
<p>Same as <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-range" title="gtk_text_buffer_insert_range ()"><code class="function">gtk_text_buffer_insert_range()</code></a>, but does nothing if the
|
||
insertion point isn’t editable. The <em class="parameter"><code>default_editable</code></em>
|
||
parameter
|
||
indicates whether the text is editable at <em class="parameter"><code>iter</code></em>
|
||
if no tags
|
||
enclosing <em class="parameter"><code>iter</code></em>
|
||
affect editability. Typically the result of
|
||
<a class="link" href="GtkTextView.html#gtk-text-view-get-editable" title="gtk_text_view_get_editable ()"><code class="function">gtk_text_view_get_editable()</code></a> is appropriate here.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-range-interactive.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a position in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>a position in a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>another position in the same buffer as <em class="parameter"><code>start</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_editable</p></td>
|
||
<td class="parameter_description"><p>default editability of the buffer</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-range-interactive.returns"></a><h4>Returns</h4>
|
||
<p> whether an insertion was possible at <em class="parameter"><code>iter</code></em>
|
||
</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert-with-tags"></a><h3>gtk_text_buffer_insert_with_tags ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_insert_with_tags (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> len</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *first_tag</code></em>,
|
||
<em class="parameter"><code>...</code></em>);</pre>
|
||
<p>Inserts <em class="parameter"><code>text</code></em>
|
||
into <em class="parameter"><code>buffer</code></em>
|
||
at <em class="parameter"><code>iter</code></em>
|
||
, applying the list of tags to
|
||
the newly-inserted text. The last tag specified must be <code class="literal">NULL</code> to
|
||
terminate the list. Equivalent to calling <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert" title="gtk_text_buffer_insert ()"><code class="function">gtk_text_buffer_insert()</code></a>,
|
||
then <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-apply-tag" title="gtk_text_buffer_apply_tag ()"><code class="function">gtk_text_buffer_apply_tag()</code></a> on the inserted text;
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-with-tags" title="gtk_text_buffer_insert_with_tags ()"><code class="function">gtk_text_buffer_insert_with_tags()</code></a> is just a convenience function.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-with-tags.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>UTF-8 text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>len</p></td>
|
||
<td class="parameter_description"><p>length of <em class="parameter"><code>text</code></em>
|
||
, or -1</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>first_tag</p></td>
|
||
<td class="parameter_description"><p>first tag to apply to <em class="parameter"><code>text</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>...</p></td>
|
||
<td class="parameter_description"><p><code class="literal">NULL</code>-terminated list of tags to apply</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert-with-tags-by-name"></a><h3>gtk_text_buffer_insert_with_tags_by_name ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_insert_with_tags_by_name
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> len</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *first_tag_name</code></em>,
|
||
<em class="parameter"><code>...</code></em>);</pre>
|
||
<p>Same as <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-with-tags" title="gtk_text_buffer_insert_with_tags ()"><code class="function">gtk_text_buffer_insert_with_tags()</code></a>, but allows you
|
||
to pass in tag names instead of tag objects.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-with-tags-by-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>position in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>UTF-8 text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>len</p></td>
|
||
<td class="parameter_description"><p>length of <em class="parameter"><code>text</code></em>
|
||
, or -1</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>first_tag_name</p></td>
|
||
<td class="parameter_description"><p>name of a tag to apply to <em class="parameter"><code>text</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>...</p></td>
|
||
<td class="parameter_description"><p>more tag names</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert-markup"></a><h3>gtk_text_buffer_insert_markup ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_insert_markup (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *markup</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> len</code></em>);</pre>
|
||
<p>Inserts the text in <em class="parameter"><code>markup</code></em>
|
||
at position <em class="parameter"><code>iter</code></em>
|
||
. <em class="parameter"><code>markup</code></em>
|
||
will be inserted
|
||
in its entirety and must be nul-terminated and valid UTF-8. Emits the
|
||
<a class="link" href="GtkTextBuffer.html#GtkTextBuffer-insert-text" title="The “insert-text” signal"><span class="type">“insert-text”</span></a> signal, possibly multiple times; insertion
|
||
actually occurs in the default handler for the signal. <em class="parameter"><code>iter</code></em>
|
||
will point
|
||
to the end of the inserted text on return.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-markup.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>location to insert the markup</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>markup</p></td>
|
||
<td class="parameter_description"><p>a nul-terminated UTF-8 string containing Pango markup</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>len</p></td>
|
||
<td class="parameter_description"><p>length of <em class="parameter"><code>markup</code></em>
|
||
in bytes, or -1</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-16.html#api-index-3.16">3.16</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-delete"></a><h3>gtk_text_buffer_delete ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_delete (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Deletes text between <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
. The order of <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
|
||
is not actually relevant; <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete" title="gtk_text_buffer_delete ()"><code class="function">gtk_text_buffer_delete()</code></a> will reorder
|
||
them. This function actually emits the “delete-range” signal, and
|
||
the default handler of that signal deletes the text. Because the
|
||
buffer is modified, all outstanding iterators become invalid after
|
||
calling this function; however, the <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
will be
|
||
re-initialized to point to the location where text was deleted.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-delete.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>a position in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>another position in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-delete-interactive"></a><h3>gtk_text_buffer_delete_interactive ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_delete_interactive (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start_iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end_iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> default_editable</code></em>);</pre>
|
||
<p>Deletes all editable text in the given range.
|
||
Calls <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete" title="gtk_text_buffer_delete ()"><code class="function">gtk_text_buffer_delete()</code></a> for each editable sub-range of
|
||
[<em class="parameter"><code>start</code></em>
|
||
,<em class="parameter"><code>end</code></em>
|
||
). <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
are revalidated to point to
|
||
the location of the last deleted range, or left untouched if
|
||
no text was deleted.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-delete-interactive.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start_iter</p></td>
|
||
<td class="parameter_description"><p>start of range to delete</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end_iter</p></td>
|
||
<td class="parameter_description"><p>end of range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_editable</p></td>
|
||
<td class="parameter_description"><p>whether the buffer is editable by default</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-delete-interactive.returns"></a><h4>Returns</h4>
|
||
<p> whether some text was actually deleted</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-backspace"></a><h3>gtk_text_buffer_backspace ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_backspace (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> interactive</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> default_editable</code></em>);</pre>
|
||
<p>Performs the appropriate action as if the user hit the delete
|
||
key with the cursor at the position specified by <em class="parameter"><code>iter</code></em>
|
||
. In the
|
||
normal case a single character will be deleted, but when
|
||
combining accents are involved, more than one character can
|
||
be deleted, and when precomposed character and accent combinations
|
||
are involved, less than one character will be deleted.</p>
|
||
<p>Because the buffer is modified, all outstanding iterators become
|
||
invalid after calling this function; however, the <em class="parameter"><code>iter</code></em>
|
||
will be
|
||
re-initialized to point to the location where text was deleted.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-backspace.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>a position in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>interactive</p></td>
|
||
<td class="parameter_description"><p>whether the deletion is caused by user interaction</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_editable</p></td>
|
||
<td class="parameter_description"><p>whether the buffer is editable by default</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-backspace.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the buffer was modified</p>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-set-text"></a><h3>gtk_text_buffer_set_text ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_set_text (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> len</code></em>);</pre>
|
||
<p>Deletes current contents of <em class="parameter"><code>buffer</code></em>
|
||
, and inserts <em class="parameter"><code>text</code></em>
|
||
instead. If
|
||
<em class="parameter"><code>len</code></em>
|
||
is -1, <em class="parameter"><code>text</code></em>
|
||
must be nul-terminated. <em class="parameter"><code>text</code></em>
|
||
must be valid UTF-8.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-set-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>UTF-8 text to insert</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>len</p></td>
|
||
<td class="parameter_description"><p>length of <em class="parameter"><code>text</code></em>
|
||
in bytes</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-text"></a><h3>gtk_text_buffer_get_text ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
||
gtk_text_buffer_get_text (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> include_hidden_chars</code></em>);</pre>
|
||
<p>Returns the text in the range [<em class="parameter"><code>start</code></em>
|
||
,<em class="parameter"><code>end</code></em>
|
||
). Excludes undisplayed
|
||
text (text marked with tags that set the invisibility attribute) if
|
||
<em class="parameter"><code>include_hidden_chars</code></em>
|
||
is <code class="literal">FALSE</code>. Does not include characters
|
||
representing embedded images, so byte and character indexes into
|
||
the returned string do not correspond to byte
|
||
and character indexes into the buffer. Contrast with
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-slice" title="gtk_text_buffer_get_slice ()"><code class="function">gtk_text_buffer_get_slice()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>start of a range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>end of a range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>include_hidden_chars</p></td>
|
||
<td class="parameter_description"><p>whether to include invisible text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-text.returns"></a><h4>Returns</h4>
|
||
<p>an allocated UTF-8 string. </p>
|
||
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-slice"></a><h3>gtk_text_buffer_get_slice ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gchar</span> *
|
||
gtk_text_buffer_get_slice (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> include_hidden_chars</code></em>);</pre>
|
||
<p>Returns the text in the range [<em class="parameter"><code>start</code></em>
|
||
,<em class="parameter"><code>end</code></em>
|
||
). Excludes undisplayed
|
||
text (text marked with tags that set the invisibility attribute) if
|
||
<em class="parameter"><code>include_hidden_chars</code></em>
|
||
is <code class="literal">FALSE</code>. The returned string includes a
|
||
0xFFFC character whenever the buffer contains
|
||
embedded images, so byte and character indexes into
|
||
the returned string do correspond to byte
|
||
and character indexes into the buffer. Contrast with
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-text" title="gtk_text_buffer_get_text ()"><code class="function">gtk_text_buffer_get_text()</code></a>. Note that 0xFFFC can occur in normal
|
||
text as well, so it is not a reliable indicator that a pixbuf or
|
||
widget is in the buffer.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-slice.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>start of a range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>end of a range</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>include_hidden_chars</p></td>
|
||
<td class="parameter_description"><p>whether to include invisible text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-slice.returns"></a><h4>Returns</h4>
|
||
<p>an allocated UTF-8 string. </p>
|
||
<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert-pixbuf"></a><h3>gtk_text_buffer_insert_pixbuf ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_insert_pixbuf (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkPixbuf</span> *pixbuf</code></em>);</pre>
|
||
<p>Inserts an image into the text buffer at <em class="parameter"><code>iter</code></em>
|
||
. The image will be
|
||
counted as one character in character counts, and when obtaining
|
||
the buffer contents as a string, will be represented by the Unicode
|
||
“object replacement character” 0xFFFC. Note that the “slice”
|
||
variants for obtaining portions of the buffer as a string include
|
||
this character for pixbufs, but the “text” variants do
|
||
not. e.g. see <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-slice" title="gtk_text_buffer_get_slice ()"><code class="function">gtk_text_buffer_get_slice()</code></a> and
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-text" title="gtk_text_buffer_get_text ()"><code class="function">gtk_text_buffer_get_text()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-pixbuf.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>location to insert the pixbuf</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pixbuf</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">GdkPixbuf</span></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-insert-child-anchor"></a><h3>gtk_text_buffer_insert_child_anchor ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_insert_child_anchor (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextView.html#GtkTextChildAnchor"><span class="type">GtkTextChildAnchor</span></a> *anchor</code></em>);</pre>
|
||
<p>Inserts a child widget anchor into the text buffer at <em class="parameter"><code>iter</code></em>
|
||
. The
|
||
anchor will be counted as one character in character counts, and
|
||
when obtaining the buffer contents as a string, will be represented
|
||
by the Unicode “object replacement character” 0xFFFC. Note that the
|
||
“slice” variants for obtaining portions of the buffer as a string
|
||
include this character for child anchors, but the “text” variants do
|
||
not. E.g. see <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-slice" title="gtk_text_buffer_get_slice ()"><code class="function">gtk_text_buffer_get_slice()</code></a> and
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-text" title="gtk_text_buffer_get_text ()"><code class="function">gtk_text_buffer_get_text()</code></a>. Consider
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-create-child-anchor" title="gtk_text_buffer_create_child_anchor ()"><code class="function">gtk_text_buffer_create_child_anchor()</code></a> as a more convenient
|
||
alternative to this function. The buffer will add a reference to
|
||
the anchor, so you can unref it after insertion.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-insert-child-anchor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>location to insert the anchor</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>anchor</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextView.html#GtkTextChildAnchor"><span class="type">GtkTextChildAnchor</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-create-child-anchor"></a><h3>gtk_text_buffer_create_child_anchor ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextView.html#GtkTextChildAnchor"><span class="returnvalue">GtkTextChildAnchor</span></a> *
|
||
gtk_text_buffer_create_child_anchor (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>This is a convenience function which simply creates a child anchor
|
||
with <a class="link" href="GtkTextView.html#gtk-text-child-anchor-new" title="gtk_text_child_anchor_new ()"><code class="function">gtk_text_child_anchor_new()</code></a> and inserts it into the buffer
|
||
with <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-child-anchor" title="gtk_text_buffer_insert_child_anchor ()"><code class="function">gtk_text_buffer_insert_child_anchor()</code></a>. The new anchor is
|
||
owned by the buffer; no reference count is returned to
|
||
the caller of <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-create-child-anchor" title="gtk_text_buffer_create_child_anchor ()"><code class="function">gtk_text_buffer_create_child_anchor()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-create-child-anchor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>location in the buffer</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-create-child-anchor.returns"></a><h4>Returns</h4>
|
||
<p>the created child anchor. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-create-mark"></a><h3>gtk_text_buffer_create_mark ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="returnvalue">GtkTextMark</span></a> *
|
||
gtk_text_buffer_create_mark (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *mark_name</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *where</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> left_gravity</code></em>);</pre>
|
||
<p>Creates a mark at position <em class="parameter"><code>where</code></em>
|
||
. If <em class="parameter"><code>mark_name</code></em>
|
||
is <code class="literal">NULL</code>, the mark
|
||
is anonymous; otherwise, the mark can be retrieved by name using
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-mark" title="gtk_text_buffer_get_mark ()"><code class="function">gtk_text_buffer_get_mark()</code></a>. If a mark has left gravity, and text is
|
||
inserted at the mark’s current location, the mark will be moved to
|
||
the left of the newly-inserted text. If the mark has right gravity
|
||
(<em class="parameter"><code>left_gravity</code></em>
|
||
= <code class="literal">FALSE</code>), the mark will end up on the right of
|
||
newly-inserted text. The standard left-to-right cursor is a mark
|
||
with right gravity (when you type, the cursor stays on the right
|
||
side of the text you’re typing).</p>
|
||
<p>The caller of this function does not own a
|
||
reference to the returned <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a>, so you can ignore the
|
||
return value if you like. Marks are owned by the buffer and go
|
||
away when the buffer does.</p>
|
||
<p>Emits the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-mark-set" title="The “mark-set” signal"><span class="type">“mark-set”</span></a> signal as notification of the mark's
|
||
initial placement.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-create-mark.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>mark_name</p></td>
|
||
<td class="parameter_description"><p>name for mark, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>where</p></td>
|
||
<td class="parameter_description"><p>location to place mark</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>left_gravity</p></td>
|
||
<td class="parameter_description"><p>whether the mark has left gravity</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-create-mark.returns"></a><h4>Returns</h4>
|
||
<p>the new <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> object. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-move-mark"></a><h3>gtk_text_buffer_move_mark ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_move_mark (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> *mark</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *where</code></em>);</pre>
|
||
<p>Moves <em class="parameter"><code>mark</code></em>
|
||
to the new location <em class="parameter"><code>where</code></em>
|
||
. Emits the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-mark-set" title="The “mark-set” signal"><span class="type">“mark-set”</span></a>
|
||
signal as notification of the move.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-move-mark.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>mark</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>where</p></td>
|
||
<td class="parameter_description"><p>new location for <em class="parameter"><code>mark</code></em>
|
||
in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-move-mark-by-name"></a><h3>gtk_text_buffer_move_mark_by_name ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_move_mark_by_name (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *where</code></em>);</pre>
|
||
<p>Moves the mark named <em class="parameter"><code>name</code></em>
|
||
(which must exist) to location <em class="parameter"><code>where</code></em>
|
||
.
|
||
See <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-move-mark" title="gtk_text_buffer_move_mark ()"><code class="function">gtk_text_buffer_move_mark()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-move-mark-by-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>name</p></td>
|
||
<td class="parameter_description"><p>name of a mark</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>where</p></td>
|
||
<td class="parameter_description"><p>new location for mark</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-add-mark"></a><h3>gtk_text_buffer_add_mark ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_add_mark (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> *mark</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *where</code></em>);</pre>
|
||
<p>Adds the mark at position <em class="parameter"><code>where</code></em>
|
||
. The mark must not be added to
|
||
another buffer, and if its name is not <code class="literal">NULL</code> then there must not
|
||
be another mark in the buffer with the same name.</p>
|
||
<p>Emits the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-mark-set" title="The “mark-set” signal"><span class="type">“mark-set”</span></a> signal as notification of the mark's
|
||
initial placement.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-add-mark.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>mark</p></td>
|
||
<td class="parameter_description"><p>the mark to add</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>where</p></td>
|
||
<td class="parameter_description"><p>location to place mark</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-delete-mark"></a><h3>gtk_text_buffer_delete_mark ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_delete_mark (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> *mark</code></em>);</pre>
|
||
<p>Deletes <em class="parameter"><code>mark</code></em>
|
||
, so that it’s no longer located anywhere in the
|
||
buffer. Removes the reference the buffer holds to the mark, so if
|
||
you haven’t called <code class="function">g_object_ref()</code> on the mark, it will be freed. Even
|
||
if the mark isn’t freed, most operations on <em class="parameter"><code>mark</code></em>
|
||
become
|
||
invalid, until it gets added to a buffer again with
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-add-mark" title="gtk_text_buffer_add_mark ()"><code class="function">gtk_text_buffer_add_mark()</code></a>. Use <a class="link" href="GtkTextMark.html#gtk-text-mark-get-deleted" title="gtk_text_mark_get_deleted ()"><code class="function">gtk_text_mark_get_deleted()</code></a> to
|
||
find out if a mark has been removed from its buffer.
|
||
The <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-mark-deleted" title="The “mark-deleted” signal"><span class="type">“mark-deleted”</span></a> signal will be emitted as notification after
|
||
the mark is deleted.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-delete-mark.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>mark</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-delete-mark-by-name"></a><h3>gtk_text_buffer_delete_mark_by_name ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_delete_mark_by_name (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
||
<p>Deletes the mark named <em class="parameter"><code>name</code></em>
|
||
; the mark must exist. See
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete-mark" title="gtk_text_buffer_delete_mark ()"><code class="function">gtk_text_buffer_delete_mark()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-delete-mark-by-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>name</p></td>
|
||
<td class="parameter_description"><p>name of a mark in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-mark"></a><h3>gtk_text_buffer_get_mark ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="returnvalue">GtkTextMark</span></a> *
|
||
gtk_text_buffer_get_mark (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
||
<p>Returns the mark named <em class="parameter"><code>name</code></em>
|
||
in buffer <em class="parameter"><code>buffer</code></em>
|
||
, or <code class="literal">NULL</code> if no such
|
||
mark exists in the buffer.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-mark.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>name</p></td>
|
||
<td class="parameter_description"><p>a mark name</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-mark.returns"></a><h4>Returns</h4>
|
||
<p>a <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a>, or <code class="literal">NULL</code>. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-insert"></a><h3>gtk_text_buffer_get_insert ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="returnvalue">GtkTextMark</span></a> *
|
||
gtk_text_buffer_get_insert (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>Returns the mark that represents the cursor (insertion point).
|
||
Equivalent to calling <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-mark" title="gtk_text_buffer_get_mark ()"><code class="function">gtk_text_buffer_get_mark()</code></a> to get the mark
|
||
named “insert”, but very slightly more efficient, and involves less
|
||
typing.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-insert.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-insert.returns"></a><h4>Returns</h4>
|
||
<p>insertion point mark. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-selection-bound"></a><h3>gtk_text_buffer_get_selection_bound ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="returnvalue">GtkTextMark</span></a> *
|
||
gtk_text_buffer_get_selection_bound (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>Returns the mark that represents the selection bound. Equivalent
|
||
to calling <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-mark" title="gtk_text_buffer_get_mark ()"><code class="function">gtk_text_buffer_get_mark()</code></a> to get the mark named
|
||
“selection_bound”, but very slightly more efficient, and involves
|
||
less typing.</p>
|
||
<p>The currently-selected text in <em class="parameter"><code>buffer</code></em>
|
||
is the region between the
|
||
“selection_bound” and “insert” marks. If “selection_bound” and
|
||
“insert” are in the same place, then there is no current selection.
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-selection-bounds" title="gtk_text_buffer_get_selection_bounds ()"><code class="function">gtk_text_buffer_get_selection_bounds()</code></a> is another convenient function
|
||
for handling the selection, if you just want to know whether there’s a
|
||
selection and what its bounds are.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-selection-bound.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-selection-bound.returns"></a><h4>Returns</h4>
|
||
<p>selection bound mark. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-has-selection"></a><h3>gtk_text_buffer_get_has_selection ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_get_has_selection (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>Indicates whether the buffer has some text currently selected.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-has-selection.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-has-selection.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the there is text selected</p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-place-cursor"></a><h3>gtk_text_buffer_place_cursor ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_place_cursor (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *where</code></em>);</pre>
|
||
<p>This function moves the “insert” and “selection_bound” marks
|
||
simultaneously. If you move them to the same place in two steps
|
||
with <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-move-mark" title="gtk_text_buffer_move_mark ()"><code class="function">gtk_text_buffer_move_mark()</code></a>, you will temporarily select a
|
||
region in between their old and new locations, which can be pretty
|
||
inefficient since the temporarily-selected region will force stuff
|
||
to be recalculated. This function moves them as a unit, which can
|
||
be optimized.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-place-cursor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>where</p></td>
|
||
<td class="parameter_description"><p>where to put the cursor</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-select-range"></a><h3>gtk_text_buffer_select_range ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_select_range (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *ins</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *bound</code></em>);</pre>
|
||
<p>This function moves the “insert” and “selection_bound” marks
|
||
simultaneously. If you move them in two steps
|
||
with <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-move-mark" title="gtk_text_buffer_move_mark ()"><code class="function">gtk_text_buffer_move_mark()</code></a>, you will temporarily select a
|
||
region in between their old and new locations, which can be pretty
|
||
inefficient since the temporarily-selected region will force stuff
|
||
to be recalculated. This function moves them as a unit, which can
|
||
be optimized.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-select-range.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>ins</p></td>
|
||
<td class="parameter_description"><p>where to put the “insert” mark</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>bound</p></td>
|
||
<td class="parameter_description"><p>where to put the “selection_bound” mark</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-apply-tag"></a><h3>gtk_text_buffer_apply_tag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_apply_tag (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Emits the “apply-tag” signal on <em class="parameter"><code>buffer</code></em>
|
||
. The default
|
||
handler for the signal applies <em class="parameter"><code>tag</code></em>
|
||
to the given range.
|
||
<em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
do not have to be in order.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-apply-tag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>one bound of range to be tagged</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>other bound of range to be tagged</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-remove-tag"></a><h3>gtk_text_buffer_remove_tag ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_remove_tag (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Emits the “remove-tag” signal. The default handler for the signal
|
||
removes all occurrences of <em class="parameter"><code>tag</code></em>
|
||
from the given range. <em class="parameter"><code>start</code></em>
|
||
and
|
||
<em class="parameter"><code>end</code></em>
|
||
don’t have to be in order.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-remove-tag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>one bound of range to be untagged</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>other bound of range to be untagged</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-apply-tag-by-name"></a><h3>gtk_text_buffer_apply_tag_by_name ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_apply_tag_by_name (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Calls <a class="link" href="GtkTextTagTable.html#gtk-text-tag-table-lookup" title="gtk_text_tag_table_lookup ()"><code class="function">gtk_text_tag_table_lookup()</code></a> on the buffer’s tag table to
|
||
get a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a>, then calls <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-apply-tag" title="gtk_text_buffer_apply_tag ()"><code class="function">gtk_text_buffer_apply_tag()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-apply-tag-by-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>name</p></td>
|
||
<td class="parameter_description"><p>name of a named <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>one bound of range to be tagged</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>other bound of range to be tagged</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-remove-tag-by-name"></a><h3>gtk_text_buffer_remove_tag_by_name ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_remove_tag_by_name (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Calls <a class="link" href="GtkTextTagTable.html#gtk-text-tag-table-lookup" title="gtk_text_tag_table_lookup ()"><code class="function">gtk_text_tag_table_lookup()</code></a> on the buffer’s tag table to
|
||
get a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a>, then calls <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-remove-tag" title="gtk_text_buffer_remove_tag ()"><code class="function">gtk_text_buffer_remove_tag()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-remove-tag-by-name.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>name</p></td>
|
||
<td class="parameter_description"><p>name of a <a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>one bound of range to be untagged</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>other bound of range to be untagged</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-remove-all-tags"></a><h3>gtk_text_buffer_remove_all_tags ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_remove_all_tags (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Removes all tags in the range between <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
. Be careful
|
||
with this function; it could remove tags added in code unrelated to
|
||
the code you’re currently writing. That is, using this function is
|
||
probably a bad idea if you have two or more unrelated code sections
|
||
that add tags.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-remove-all-tags.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>one bound of range to be untagged</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>other bound of range to be untagged</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-create-tag"></a><h3>gtk_text_buffer_create_tag ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="returnvalue">GtkTextTag</span></a> *
|
||
gtk_text_buffer_create_tag (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *tag_name</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
|
||
<em class="parameter"><code>...</code></em>);</pre>
|
||
<p>Creates a tag and adds it to the tag table for <em class="parameter"><code>buffer</code></em>
|
||
.
|
||
Equivalent to calling <a class="link" href="GtkTextTag.html#gtk-text-tag-new" title="gtk_text_tag_new ()"><code class="function">gtk_text_tag_new()</code></a> and then adding the
|
||
tag to the buffer’s tag table. The returned tag is owned by
|
||
the buffer’s tag table, so the ref count will be equal to one.</p>
|
||
<p>If <em class="parameter"><code>tag_name</code></em>
|
||
is <code class="literal">NULL</code>, the tag is anonymous.</p>
|
||
<p>If <em class="parameter"><code>tag_name</code></em>
|
||
is non-<code class="literal">NULL</code>, a tag called <em class="parameter"><code>tag_name</code></em>
|
||
must not already
|
||
exist in the tag table for this buffer.</p>
|
||
<p>The <em class="parameter"><code>first_property_name</code></em>
|
||
argument and subsequent arguments are a list
|
||
of properties to set on the tag, as with <code class="function">g_object_set()</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-create-tag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag_name</p></td>
|
||
<td class="parameter_description"><p>name of the new tag, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>first_property_name</p></td>
|
||
<td class="parameter_description"><p>name of first property to set, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>...</p></td>
|
||
<td class="parameter_description"><p><code class="literal">NULL</code>-terminated list of property names and values</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-create-tag.returns"></a><h4>Returns</h4>
|
||
<p>a new tag. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-iter-at-line-offset"></a><h3>gtk_text_buffer_get_iter_at_line_offset ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_get_iter_at_line_offset
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> line_number</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> char_offset</code></em>);</pre>
|
||
<p>Obtains an iterator pointing to <em class="parameter"><code>char_offset</code></em>
|
||
within the given line. Note
|
||
characters, not bytes; UTF-8 may encode one character as multiple bytes.</p>
|
||
<p>Before the 3.20 version, it was not allowed to pass an invalid location.</p>
|
||
<p>Since the 3.20 version, if <em class="parameter"><code>line_number</code></em>
|
||
is greater than the number of lines
|
||
in the <em class="parameter"><code>buffer</code></em>
|
||
, the end iterator is returned. And if <em class="parameter"><code>char_offset</code></em>
|
||
is off the
|
||
end of the line, the iterator at the end of the line is returned.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-iter-at-line-offset.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>line_number</p></td>
|
||
<td class="parameter_description"><p>line number counting from 0</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>char_offset</p></td>
|
||
<td class="parameter_description"><p>char offset from start of line</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-iter-at-offset"></a><h3>gtk_text_buffer_get_iter_at_offset ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_get_iter_at_offset (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> char_offset</code></em>);</pre>
|
||
<p>Initializes <em class="parameter"><code>iter</code></em>
|
||
to a position <em class="parameter"><code>char_offset</code></em>
|
||
chars from the start
|
||
of the entire buffer. If <em class="parameter"><code>char_offset</code></em>
|
||
is -1 or greater than the number
|
||
of characters in the buffer, <em class="parameter"><code>iter</code></em>
|
||
is initialized to the end iterator,
|
||
the iterator one past the last valid character in the buffer.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-iter-at-offset.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>char_offset</p></td>
|
||
<td class="parameter_description"><p>char offset from start of buffer, counting from 0, or -1</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-iter-at-line"></a><h3>gtk_text_buffer_get_iter_at_line ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_get_iter_at_line (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> line_number</code></em>);</pre>
|
||
<p>Initializes <em class="parameter"><code>iter</code></em>
|
||
to the start of the given line. If <em class="parameter"><code>line_number</code></em>
|
||
is greater
|
||
than the number of lines in the <em class="parameter"><code>buffer</code></em>
|
||
, the end iterator is returned.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-iter-at-line.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>line_number</p></td>
|
||
<td class="parameter_description"><p>line number counting from 0</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-iter-at-line-index"></a><h3>gtk_text_buffer_get_iter_at_line_index ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_get_iter_at_line_index
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> line_number</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> byte_index</code></em>);</pre>
|
||
<p>Obtains an iterator pointing to <em class="parameter"><code>byte_index</code></em>
|
||
within the given line.
|
||
<em class="parameter"><code>byte_index</code></em>
|
||
must be the start of a UTF-8 character. Note bytes, not
|
||
characters; UTF-8 may encode one character as multiple bytes.</p>
|
||
<p>Before the 3.20 version, it was not allowed to pass an invalid location.</p>
|
||
<p>Since the 3.20 version, if <em class="parameter"><code>line_number</code></em>
|
||
is greater than the number of lines
|
||
in the <em class="parameter"><code>buffer</code></em>
|
||
, the end iterator is returned. And if <em class="parameter"><code>byte_index</code></em>
|
||
is off the
|
||
end of the line, the iterator at the end of the line is returned.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-iter-at-line-index.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>line_number</p></td>
|
||
<td class="parameter_description"><p>line number counting from 0</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>byte_index</p></td>
|
||
<td class="parameter_description"><p>byte index from start of line</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-iter-at-mark"></a><h3>gtk_text_buffer_get_iter_at_mark ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_get_iter_at_mark (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> *mark</code></em>);</pre>
|
||
<p>Initializes <em class="parameter"><code>iter</code></em>
|
||
with the current position of <em class="parameter"><code>mark</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-iter-at-mark.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>mark</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-iter-at-child-anchor"></a><h3>gtk_text_buffer_get_iter_at_child_anchor ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_get_iter_at_child_anchor
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextView.html#GtkTextChildAnchor"><span class="type">GtkTextChildAnchor</span></a> *anchor</code></em>);</pre>
|
||
<p>Obtains the location of <em class="parameter"><code>anchor</code></em>
|
||
within <em class="parameter"><code>buffer</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-iter-at-child-anchor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>an iterator to be initialized. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>anchor</p></td>
|
||
<td class="parameter_description"><p>a child anchor that appears in <em class="parameter"><code>buffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-start-iter"></a><h3>gtk_text_buffer_get_start_iter ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_get_start_iter (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Initialized <em class="parameter"><code>iter</code></em>
|
||
with the first position in the text buffer. This
|
||
is the same as using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-iter-at-offset" title="gtk_text_buffer_get_iter_at_offset ()"><code class="function">gtk_text_buffer_get_iter_at_offset()</code></a> to get
|
||
the iter at character offset 0.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-start-iter.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-end-iter"></a><h3>gtk_text_buffer_get_end_iter ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_get_end_iter (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>);</pre>
|
||
<p>Initializes <em class="parameter"><code>iter</code></em>
|
||
with the “end iterator,” one past the last valid
|
||
character in the text buffer. If dereferenced with
|
||
<a class="link" href="GtkTextIter.html#gtk-text-iter-get-char" title="gtk_text_iter_get_char ()"><code class="function">gtk_text_iter_get_char()</code></a>, the end iterator has a character value of 0.
|
||
The entire buffer lies in the range from the first position in
|
||
the buffer (call <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-start-iter" title="gtk_text_buffer_get_start_iter ()"><code class="function">gtk_text_buffer_get_start_iter()</code></a> to get
|
||
character position 0) to the end iterator.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-end-iter.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-bounds"></a><h3>gtk_text_buffer_get_bounds ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_get_bounds (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Retrieves the first and last iterators in the buffer, i.e. the
|
||
entire buffer lies within the range [<em class="parameter"><code>start</code></em>
|
||
,<em class="parameter"><code>end</code></em>
|
||
).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-bounds.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize with first position in the buffer. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize with the end iterator. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-modified"></a><h3>gtk_text_buffer_get_modified ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_get_modified (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>Indicates whether the buffer has been modified since the last call
|
||
to <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-set-modified" title="gtk_text_buffer_set_modified ()"><code class="function">gtk_text_buffer_set_modified()</code></a> set the modification flag to
|
||
<code class="literal">FALSE</code>. Used for example to enable a “save” function in a text
|
||
editor.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-modified.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-modified.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the buffer has been modified</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-set-modified"></a><h3>gtk_text_buffer_set_modified ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_set_modified (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
|
||
<p>Used to keep track of whether the buffer has been modified since the
|
||
last time it was saved. Whenever the buffer is saved to disk, call
|
||
gtk_text_buffer_set_modified (<em class="parameter"><code>buffer</code></em>
|
||
, FALSE). When the buffer is modified,
|
||
it will automatically toggled on the modified bit again. When the modified
|
||
bit flips, the buffer emits the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-modified-changed" title="The “modified-changed” signal"><span class="type">“modified-changed”</span></a> signal.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-set-modified.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>setting</p></td>
|
||
<td class="parameter_description"><p>modification flag setting</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-delete-selection"></a><h3>gtk_text_buffer_delete_selection ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_delete_selection (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> interactive</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> default_editable</code></em>);</pre>
|
||
<p>Deletes the range between the “insert” and “selection_bound” marks,
|
||
that is, the currently-selected text. If <em class="parameter"><code>interactive</code></em>
|
||
is <code class="literal">TRUE</code>,
|
||
the editability of the selection will be considered (users can’t delete
|
||
uneditable text).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-delete-selection.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>interactive</p></td>
|
||
<td class="parameter_description"><p>whether the deletion is caused by user interaction</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_editable</p></td>
|
||
<td class="parameter_description"><p>whether the buffer is editable by default</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-delete-selection.returns"></a><h4>Returns</h4>
|
||
<p> whether there was a non-empty selection to delete</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-paste-clipboard"></a><h3>gtk_text_buffer_paste_clipboard ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_paste_clipboard (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *override_location</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> default_editable</code></em>);</pre>
|
||
<p>Pastes the contents of a clipboard. If <em class="parameter"><code>override_location</code></em>
|
||
is <code class="literal">NULL</code>, the
|
||
pasted text will be inserted at the cursor position, or the buffer selection
|
||
will be replaced if the selection is non-empty.</p>
|
||
<p>Note: pasting is asynchronous, that is, we’ll ask for the paste data and
|
||
return, and at some point later after the main loop runs, the paste data will
|
||
be inserted.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-paste-clipboard.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>clipboard</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> to paste from</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>override_location</p></td>
|
||
<td class="parameter_description"><p>location to insert pasted text, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_editable</p></td>
|
||
<td class="parameter_description"><p>whether the buffer is editable by default</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-copy-clipboard"></a><h3>gtk_text_buffer_copy_clipboard ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_copy_clipboard (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
|
||
<p>Copies the currently-selected text to a clipboard.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-copy-clipboard.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> </p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>clipboard</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> object to copy to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-cut-clipboard"></a><h3>gtk_text_buffer_cut_clipboard ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_cut_clipboard (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> default_editable</code></em>);</pre>
|
||
<p>Copies the currently-selected text to a clipboard, then deletes
|
||
said text if it’s editable.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-cut-clipboard.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>clipboard</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> object to cut to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>default_editable</p></td>
|
||
<td class="parameter_description"><p>default editability of the buffer</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-selection-bounds"></a><h3>gtk_text_buffer_get_selection_bounds ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_get_selection_bounds (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>);</pre>
|
||
<p>Returns <code class="literal">TRUE</code> if some text is selected; places the bounds
|
||
of the selection in <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
(if the selection has length 0,
|
||
then <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
are filled in with the same value).
|
||
<em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
will be in ascending order. If <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
are
|
||
NULL, then they are not filled in, but the return value still indicates
|
||
whether text is selected.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-selection-bounds.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize with selection start. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>iterator to initialize with selection end. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-selection-bounds.returns"></a><h4>Returns</h4>
|
||
<p> whether the selection has nonzero length</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-begin-user-action"></a><h3>gtk_text_buffer_begin_user_action ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_begin_user_action (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>Called to indicate that the buffer operations between here and a
|
||
call to <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-end-user-action" title="gtk_text_buffer_end_user_action ()"><code class="function">gtk_text_buffer_end_user_action()</code></a> are part of a single
|
||
user-visible operation. The operations between
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-begin-user-action" title="gtk_text_buffer_begin_user_action ()"><code class="function">gtk_text_buffer_begin_user_action()</code></a> and
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-end-user-action" title="gtk_text_buffer_end_user_action ()"><code class="function">gtk_text_buffer_end_user_action()</code></a> can then be grouped when creating
|
||
an undo stack. <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> maintains a count of calls to
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-begin-user-action" title="gtk_text_buffer_begin_user_action ()"><code class="function">gtk_text_buffer_begin_user_action()</code></a> that have not been closed with
|
||
a call to <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-end-user-action" title="gtk_text_buffer_end_user_action ()"><code class="function">gtk_text_buffer_end_user_action()</code></a>, and emits the
|
||
“begin-user-action” and “end-user-action” signals only for the
|
||
outermost pair of calls. This allows you to build user actions
|
||
from other user actions.</p>
|
||
<p>The “interactive” buffer mutation functions, such as
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-interactive" title="gtk_text_buffer_insert_interactive ()"><code class="function">gtk_text_buffer_insert_interactive()</code></a>, automatically call begin/end
|
||
user action around the buffer operations they perform, so there's
|
||
no need to add extra calls if you user action consists solely of a
|
||
single call to one of those functions.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-begin-user-action.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-end-user-action"></a><h3>gtk_text_buffer_end_user_action ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_end_user_action (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>Should be paired with a call to <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-begin-user-action" title="gtk_text_buffer_begin_user_action ()"><code class="function">gtk_text_buffer_begin_user_action()</code></a>.
|
||
See that function for a full explanation.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-end-user-action.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-add-selection-clipboard"></a><h3>gtk_text_buffer_add_selection_clipboard ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_add_selection_clipboard
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
|
||
<p>Adds <em class="parameter"><code>clipboard</code></em>
|
||
to the list of clipboards in which the selection
|
||
contents of <em class="parameter"><code>buffer</code></em>
|
||
are available. In most cases, <em class="parameter"><code>clipboard</code></em>
|
||
will be
|
||
the <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> of type <code class="literal">GDK_SELECTION_PRIMARY</code> for a view of <em class="parameter"><code>buffer</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-add-selection-clipboard.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>clipboard</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-remove-selection-clipboard"></a><h3>gtk_text_buffer_remove_selection_clipboard ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_remove_selection_clipboard
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard</code></em>);</pre>
|
||
<p>Removes a <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> added with
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-add-selection-clipboard" title="gtk_text_buffer_add_selection_clipboard ()"><code class="function">gtk_text_buffer_add_selection_clipboard()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-remove-selection-clipboard.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>clipboard</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> added to <em class="parameter"><code>buffer</code></em>
|
||
by
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-add-selection-clipboard" title="gtk_text_buffer_add_selection_clipboard ()"><code class="function">gtk_text_buffer_add_selection_clipboard()</code></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBufferDeserializeFunc"></a><h3>GtkTextBufferDeserializeFunc ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
<span class="c_punctuation">(</span>*GtkTextBufferDeserializeFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *register_buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *content_buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <span class="type">guint8</span> *data</code></em>,
|
||
<em class="parameter"><code><span class="type">gsize</span> length</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> create_tags</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
|
||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||
<p>A function that is called to deserialize rich text that has been
|
||
serialized with <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-serialize" title="gtk_text_buffer_serialize ()"><code class="function">gtk_text_buffer_serialize()</code></a>, and insert it at <em class="parameter"><code>iter</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBufferDeserializeFunc.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>register_buffer</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> the format is registered with</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>content_buffer</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> to deserialize into</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>insertion point for the deserialized text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>data</p></td>
|
||
<td class="parameter_description"><p>data to deserialize. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>length</p></td>
|
||
<td class="parameter_description"><p>length of <em class="parameter"><code>data</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>create_tags</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> if deserializing may create tags</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data that was specified when registering the format</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>error</p></td>
|
||
<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBufferDeserializeFunc.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-deserialize"></a><h3>gtk_text_buffer_deserialize ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_deserialize (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *register_buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *content_buffer</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
|
||
<em class="parameter"><code>const <span class="type">guint8</span> *data</code></em>,
|
||
<em class="parameter"><code><span class="type">gsize</span> length</code></em>,
|
||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||
<p>This function deserializes rich text in format <em class="parameter"><code>format</code></em>
|
||
and inserts
|
||
it at <em class="parameter"><code>iter</code></em>
|
||
.</p>
|
||
<p><em class="parameter"><code>formats</code></em>
|
||
to be used must be registered using
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-format" title="gtk_text_buffer_register_deserialize_format ()"><code class="function">gtk_text_buffer_register_deserialize_format()</code></a> or
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-tagset" title="gtk_text_buffer_register_deserialize_tagset ()"><code class="function">gtk_text_buffer_register_deserialize_tagset()</code></a> beforehand.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-deserialize.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>register_buffer</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> <em class="parameter"><code>format</code></em>
|
||
is registered with</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>content_buffer</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> to deserialize into</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>format</p></td>
|
||
<td class="parameter_description"><p>the rich text format to use for deserializing</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>insertion point for the deserialized text</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>data</p></td>
|
||
<td class="parameter_description"><p>data to deserialize. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>length</p></td>
|
||
<td class="parameter_description"><p>length of <em class="parameter"><code>data</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>error</p></td>
|
||
<td class="parameter_description"><p>return location for a <span class="type">GError</span></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-deserialize.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise.</p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-deserialize-get-can-create-tags"></a><h3>gtk_text_buffer_deserialize_get_can_create_tags ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_text_buffer_deserialize_get_can_create_tags
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>);</pre>
|
||
<p>This functions returns the value set with
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-deserialize-set-can-create-tags" title="gtk_text_buffer_deserialize_set_can_create_tags ()"><code class="function">gtk_text_buffer_deserialize_set_can_create_tags()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-deserialize-get-can-create-tags.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>format</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">GdkAtom</span> representing a registered rich text format</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-deserialize-get-can-create-tags.returns"></a><h4>Returns</h4>
|
||
<p> whether deserializing this format may create tags</p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-deserialize-set-can-create-tags"></a><h3>gtk_text_buffer_deserialize_set_can_create_tags ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_deserialize_set_can_create_tags
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> can_create_tags</code></em>);</pre>
|
||
<p>Use this function to allow a rich text deserialization function to
|
||
create new tags in the receiving buffer. Note that using this
|
||
function is almost always a bad idea, because the rich text
|
||
functions you register should know how to map the rich text format
|
||
they handler to your text buffers set of tags.</p>
|
||
<p>The ability of creating new (arbitrary!) tags in the receiving buffer
|
||
is meant for special rich text formats like the internal one that
|
||
is registered using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-tagset" title="gtk_text_buffer_register_deserialize_tagset ()"><code class="function">gtk_text_buffer_register_deserialize_tagset()</code></a>,
|
||
because that format is essentially a dump of the internal structure
|
||
of the source buffer, including its tag names.</p>
|
||
<p>You should allow creation of tags only if you know what you are
|
||
doing, e.g. if you defined a tagset name for your application
|
||
suite’s text buffers and you know that it’s fine to receive new
|
||
tags from these buffers, because you know that your application can
|
||
handle the newly created tags.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-deserialize-set-can-create-tags.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>format</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">GdkAtom</span> representing a registered rich text format</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>can_create_tags</p></td>
|
||
<td class="parameter_description"><p>whether deserializing this format may create tags</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-copy-target-list"></a><h3>gtk_text_buffer_get_copy_target_list ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="returnvalue">GtkTargetList</span></a> *
|
||
gtk_text_buffer_get_copy_target_list (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>This function returns the list of targets this text buffer can
|
||
provide for copying and as DND source. The targets in the list are
|
||
added with <em class="parameter"><code>info</code></em>
|
||
values from the <a class="link" href="GtkTextBuffer.html#GtkTextBufferTargetInfo" title="enum GtkTextBufferTargetInfo"><span class="type">GtkTextBufferTargetInfo</span></a> enum,
|
||
using <a class="link" href="gtk3-Selections.html#gtk-target-list-add-rich-text-targets" title="gtk_target_list_add_rich_text_targets ()"><code class="function">gtk_target_list_add_rich_text_targets()</code></a> and
|
||
<a class="link" href="gtk3-Selections.html#gtk-target-list-add-text-targets" title="gtk_target_list_add_text_targets ()"><code class="function">gtk_target_list_add_text_targets()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-copy-target-list.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-copy-target-list.returns"></a><h4>Returns</h4>
|
||
<p>the <a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-deserialize-formats"></a><h3>gtk_text_buffer_get_deserialize_formats ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkAtom</span> *
|
||
gtk_text_buffer_get_deserialize_formats
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *n_formats</code></em>);</pre>
|
||
<p>This function returns the rich text deserialize formats registered
|
||
with <em class="parameter"><code>buffer</code></em>
|
||
using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-format" title="gtk_text_buffer_register_deserialize_format ()"><code class="function">gtk_text_buffer_register_deserialize_format()</code></a> or
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-tagset" title="gtk_text_buffer_register_deserialize_tagset ()"><code class="function">gtk_text_buffer_register_deserialize_tagset()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-deserialize-formats.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>n_formats</p></td>
|
||
<td class="parameter_description"><p>return location for the number of formats. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-deserialize-formats.returns"></a><h4>Returns</h4>
|
||
<p>an array of
|
||
<span class="type">GdkAtoms</span> representing the registered formats. </p>
|
||
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_formats][<acronym title="The caller owns the data container, but not the data inside it."><span class="acronym">transfer container</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-paste-target-list"></a><h3>gtk_text_buffer_get_paste_target_list ()</h3>
|
||
<pre class="programlisting"><a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="returnvalue">GtkTargetList</span></a> *
|
||
gtk_text_buffer_get_paste_target_list (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>);</pre>
|
||
<p>This function returns the list of targets this text buffer supports
|
||
for pasting and as DND destination. The targets in the list are
|
||
added with <em class="parameter"><code>info</code></em>
|
||
values from the <a class="link" href="GtkTextBuffer.html#GtkTextBufferTargetInfo" title="enum GtkTextBufferTargetInfo"><span class="type">GtkTextBufferTargetInfo</span></a> enum,
|
||
using <a class="link" href="gtk3-Selections.html#gtk-target-list-add-rich-text-targets" title="gtk_target_list_add_rich_text_targets ()"><code class="function">gtk_target_list_add_rich_text_targets()</code></a> and
|
||
<a class="link" href="gtk3-Selections.html#gtk-target-list-add-text-targets" title="gtk_target_list_add_text_targets ()"><code class="function">gtk_target_list_add_text_targets()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-paste-target-list.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-paste-target-list.returns"></a><h4>Returns</h4>
|
||
<p>the <a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a>. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-get-serialize-formats"></a><h3>gtk_text_buffer_get_serialize_formats ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkAtom</span> *
|
||
gtk_text_buffer_get_serialize_formats (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> *n_formats</code></em>);</pre>
|
||
<p>This function returns the rich text serialize formats registered
|
||
with <em class="parameter"><code>buffer</code></em>
|
||
using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-format" title="gtk_text_buffer_register_serialize_format ()"><code class="function">gtk_text_buffer_register_serialize_format()</code></a> or
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-tagset" title="gtk_text_buffer_register_serialize_tagset ()"><code class="function">gtk_text_buffer_register_serialize_tagset()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-serialize-formats.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>n_formats</p></td>
|
||
<td class="parameter_description"><p>return location for the number of formats. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-get-serialize-formats.returns"></a><h4>Returns</h4>
|
||
<p>an array of
|
||
<span class="type">GdkAtoms</span> representing the registered formats. </p>
|
||
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_formats][<acronym title="The caller owns the data container, but not the data inside it."><span class="acronym">transfer container</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-register-deserialize-format"></a><h3>gtk_text_buffer_register_deserialize_format ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkAtom</span>
|
||
gtk_text_buffer_register_deserialize_format
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *mime_type</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html#GtkTextBufferDeserializeFunc" title="GtkTextBufferDeserializeFunc ()"><span class="type">GtkTextBufferDeserializeFunc</span></a> function</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
|
||
<em class="parameter"><code><span class="type">GDestroyNotify</span> user_data_destroy</code></em>);</pre>
|
||
<p>This function registers a rich text deserialization <em class="parameter"><code>function</code></em>
|
||
along with
|
||
its <em class="parameter"><code>mime_type</code></em>
|
||
with the passed <em class="parameter"><code>buffer</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-register-deserialize-format.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>mime_type</p></td>
|
||
<td class="parameter_description"><p>the format’s mime-type</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>function</p></td>
|
||
<td class="parameter_description"><p>the deserialize function to register</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p><em class="parameter"><code>function</code></em>
|
||
’s user_data</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data_destroy</p></td>
|
||
<td class="parameter_description"><p>a function to call when <em class="parameter"><code>user_data</code></em>
|
||
is no longer needed</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-register-deserialize-format.returns"></a><h4>Returns</h4>
|
||
<p>the <span class="type">GdkAtom</span> that corresponds to the
|
||
newly registered format’s mime-type. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-register-deserialize-tagset"></a><h3>gtk_text_buffer_register_deserialize_tagset ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkAtom</span>
|
||
gtk_text_buffer_register_deserialize_tagset
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *tagset_name</code></em>);</pre>
|
||
<p>This function registers GTK+’s internal rich text serialization
|
||
format with the passed <em class="parameter"><code>buffer</code></em>
|
||
. See
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-tagset" title="gtk_text_buffer_register_serialize_tagset ()"><code class="function">gtk_text_buffer_register_serialize_tagset()</code></a> for details.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-register-deserialize-tagset.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tagset_name</p></td>
|
||
<td class="parameter_description"><p>an optional tagset name, on <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-register-deserialize-tagset.returns"></a><h4>Returns</h4>
|
||
<p>the <span class="type">GdkAtom</span> that corresponds to the
|
||
newly registered format’s mime-type. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-register-serialize-format"></a><h3>gtk_text_buffer_register_serialize_format ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkAtom</span>
|
||
gtk_text_buffer_register_serialize_format
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *mime_type</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html#GtkTextBufferSerializeFunc" title="GtkTextBufferSerializeFunc ()"><span class="type">GtkTextBufferSerializeFunc</span></a> function</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>,
|
||
<em class="parameter"><code><span class="type">GDestroyNotify</span> user_data_destroy</code></em>);</pre>
|
||
<p>This function registers a rich text serialization <em class="parameter"><code>function</code></em>
|
||
along with
|
||
its <em class="parameter"><code>mime_type</code></em>
|
||
with the passed <em class="parameter"><code>buffer</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-register-serialize-format.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>mime_type</p></td>
|
||
<td class="parameter_description"><p>the format’s mime-type</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>function</p></td>
|
||
<td class="parameter_description"><p>the serialize function to register</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p><em class="parameter"><code>function</code></em>
|
||
’s user_data</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data_destroy</p></td>
|
||
<td class="parameter_description"><p>a function to call when <em class="parameter"><code>user_data</code></em>
|
||
is no longer needed</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-register-serialize-format.returns"></a><h4>Returns</h4>
|
||
<p>the <span class="type">GdkAtom</span> that corresponds to the
|
||
newly registered format’s mime-type. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-register-serialize-tagset"></a><h3>gtk_text_buffer_register_serialize_tagset ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">GdkAtom</span>
|
||
gtk_text_buffer_register_serialize_tagset
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *tagset_name</code></em>);</pre>
|
||
<p>This function registers GTK+’s internal rich text serialization
|
||
format with the passed <em class="parameter"><code>buffer</code></em>
|
||
. The internal format does not comply
|
||
to any standard rich text format and only works between <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>
|
||
instances. It is capable of serializing all of a text buffer’s tags
|
||
and embedded pixbufs.</p>
|
||
<p>This function is just a wrapper around
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-format" title="gtk_text_buffer_register_serialize_format ()"><code class="function">gtk_text_buffer_register_serialize_format()</code></a>. The mime type used
|
||
for registering is “application/x-gtk-text-buffer-rich-text”, or
|
||
“application/x-gtk-text-buffer-rich-text;format=<em class="parameter"><code>tagset_name</code></em>
|
||
” if a
|
||
<em class="parameter"><code>tagset_name</code></em>
|
||
was passed.</p>
|
||
<p>The <em class="parameter"><code>tagset_name</code></em>
|
||
can be used to restrict the transfer of rich text
|
||
to buffers with compatible sets of tags, in order to avoid unknown
|
||
tags from being pasted. It is probably the common case to pass an
|
||
identifier != <code class="literal">NULL</code> here, since the <code class="literal">NULL</code> tagset requires the
|
||
receiving buffer to deal with with pasting of arbitrary tags.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-register-serialize-tagset.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tagset_name</p></td>
|
||
<td class="parameter_description"><p>an optional tagset name, on <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-register-serialize-tagset.returns"></a><h4>Returns</h4>
|
||
<p>the <span class="type">GdkAtom</span> that corresponds to the
|
||
newly registered format’s mime-type. </p>
|
||
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBufferSerializeFunc"></a><h3>GtkTextBufferSerializeFunc ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">guint8</span> *
|
||
<span class="c_punctuation">(</span>*GtkTextBufferSerializeFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *register_buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *content_buffer</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>,
|
||
<em class="parameter"><code><span class="type">gsize</span> *length</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
|
||
<p>A function that is called to serialize the content of a text buffer.
|
||
It must return the serialized form of the content.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBufferSerializeFunc.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>register_buffer</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> for which the format is registered</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>content_buffer</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> to serialize</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>start of the block of text to serialize</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>end of the block of text to serialize</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>length</p></td>
|
||
<td class="parameter_description"><p>return location for the length of the serialized data. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data that was specified when registering the format</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBufferSerializeFunc.returns"></a><h4>Returns</h4>
|
||
<p>a newly-allocated array of guint8
|
||
which contains the serialized data, or <code class="literal">NULL</code> if an error occurred. </p>
|
||
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-serialize"></a><h3>gtk_text_buffer_serialize ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">guint8</span> *
|
||
gtk_text_buffer_serialize (<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *register_buffer</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *content_buffer</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start</code></em>,
|
||
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end</code></em>,
|
||
<em class="parameter"><code><span class="type">gsize</span> *length</code></em>);</pre>
|
||
<p>This function serializes the portion of text between <em class="parameter"><code>start</code></em>
|
||
|
||
and <em class="parameter"><code>end</code></em>
|
||
in the rich text format represented by <em class="parameter"><code>format</code></em>
|
||
.</p>
|
||
<p><em class="parameter"><code>formats</code></em>
|
||
to be used must be registered using
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-format" title="gtk_text_buffer_register_serialize_format ()"><code class="function">gtk_text_buffer_register_serialize_format()</code></a> or
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-tagset" title="gtk_text_buffer_register_serialize_tagset ()"><code class="function">gtk_text_buffer_register_serialize_tagset()</code></a> beforehand.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-serialize.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>register_buffer</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> <em class="parameter"><code>format</code></em>
|
||
is registered with</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>content_buffer</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> to serialize</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>format</p></td>
|
||
<td class="parameter_description"><p>the rich text format to use for serializing</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>start of block of text to serialize</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>end of block of test to serialize</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>length</p></td>
|
||
<td class="parameter_description"><p>return location for the length of the serialized data. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-serialize.returns"></a><h4>Returns</h4>
|
||
<p>the serialized
|
||
data, encoded as <em class="parameter"><code>format</code></em>
|
||
. </p>
|
||
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length][<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-unregister-deserialize-format"></a><h3>gtk_text_buffer_unregister_deserialize_format ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_unregister_deserialize_format
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>);</pre>
|
||
<p>This function unregisters a rich text format that was previously
|
||
registered using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-format" title="gtk_text_buffer_register_deserialize_format ()"><code class="function">gtk_text_buffer_register_deserialize_format()</code></a> or
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-deserialize-tagset" title="gtk_text_buffer_register_deserialize_tagset ()"><code class="function">gtk_text_buffer_register_deserialize_tagset()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-unregister-deserialize-format.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>format</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">GdkAtom</span> representing a registered rich text format.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-text-buffer-unregister-serialize-format"></a><h3>gtk_text_buffer_unregister_serialize_format ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_text_buffer_unregister_serialize_format
|
||
(<em class="parameter"><code><a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *buffer</code></em>,
|
||
<em class="parameter"><code><span class="type">GdkAtom</span> format</code></em>);</pre>
|
||
<p>This function unregisters a rich text format that was previously
|
||
registered using <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-format" title="gtk_text_buffer_register_serialize_format ()"><code class="function">gtk_text_buffer_register_serialize_format()</code></a> or
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-register-serialize-tagset" title="gtk_text_buffer_register_serialize_tagset ()"><code class="function">gtk_text_buffer_register_serialize_tagset()</code></a></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-text-buffer-unregister-serialize-format.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>buffer</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>format</p></td>
|
||
<td class="parameter_description"><p>a <span class="type">GdkAtom</span> representing a registered rich text format.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.other_details"></a><h2>Types and Values</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-struct"></a><h3>GtkTextBuffer</h3>
|
||
<pre class="programlisting">typedef struct _GtkTextBuffer GtkTextBuffer;</pre>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBufferClass"></a><h3>struct GtkTextBufferClass</h3>
|
||
<pre class="programlisting">struct GtkTextBufferClass {
|
||
GObjectClass parent_class;
|
||
|
||
void (* insert_text) (GtkTextBuffer *buffer,
|
||
GtkTextIter *pos,
|
||
const gchar *new_text,
|
||
gint new_text_length);
|
||
|
||
void (* insert_pixbuf) (GtkTextBuffer *buffer,
|
||
GtkTextIter *iter,
|
||
GdkPixbuf *pixbuf);
|
||
|
||
void (* insert_child_anchor) (GtkTextBuffer *buffer,
|
||
GtkTextIter *iter,
|
||
GtkTextChildAnchor *anchor);
|
||
|
||
void (* delete_range) (GtkTextBuffer *buffer,
|
||
GtkTextIter *start,
|
||
GtkTextIter *end);
|
||
|
||
void (* changed) (GtkTextBuffer *buffer);
|
||
|
||
void (* modified_changed) (GtkTextBuffer *buffer);
|
||
|
||
void (* mark_set) (GtkTextBuffer *buffer,
|
||
const GtkTextIter *location,
|
||
GtkTextMark *mark);
|
||
|
||
void (* mark_deleted) (GtkTextBuffer *buffer,
|
||
GtkTextMark *mark);
|
||
|
||
void (* apply_tag) (GtkTextBuffer *buffer,
|
||
GtkTextTag *tag,
|
||
const GtkTextIter *start,
|
||
const GtkTextIter *end);
|
||
|
||
void (* remove_tag) (GtkTextBuffer *buffer,
|
||
GtkTextTag *tag,
|
||
const GtkTextIter *start,
|
||
const GtkTextIter *end);
|
||
|
||
void (* begin_user_action) (GtkTextBuffer *buffer);
|
||
|
||
void (* end_user_action) (GtkTextBuffer *buffer);
|
||
|
||
void (* paste_done) (GtkTextBuffer *buffer,
|
||
GtkClipboard *clipboard);
|
||
};
|
||
</pre>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBufferClass.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="struct_members_name">
|
||
<col class="struct_members_description">
|
||
<col width="200px" class="struct_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.insert-text"></a>insert_text</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-insert-text" title="The “insert-text” signal"><span class="type">“insert-text”</span></a> signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.insert-pixbuf"></a>insert_pixbuf</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-insert-pixbuf" title="The “insert-pixbuf” signal"><span class="type">“insert-pixbuf”</span></a>
|
||
signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.insert-child-anchor"></a>insert_child_anchor</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the
|
||
<a class="link" href="GtkTextBuffer.html#GtkTextBuffer-insert-child-anchor" title="The “insert-child-anchor” signal"><span class="type">“insert-child-anchor”</span></a> signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.delete-range"></a>delete_range</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-delete-range" title="The “delete-range” signal"><span class="type">“delete-range”</span></a> signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.changed"></a>changed</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-changed" title="The “changed” signal"><span class="type">“changed”</span></a> signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.modified-changed"></a>modified_changed</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-modified-changed" title="The “modified-changed” signal"><span class="type">“modified-changed”</span></a>
|
||
signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.mark-set"></a>mark_set</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-mark-set" title="The “mark-set” signal"><span class="type">“mark-set”</span></a> signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.mark-deleted"></a>mark_deleted</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-mark-deleted" title="The “mark-deleted” signal"><span class="type">“mark-deleted”</span></a> signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.apply-tag"></a>apply_tag</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-apply-tag" title="The “apply-tag” signal"><span class="type">“apply-tag”</span></a> signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.remove-tag"></a>remove_tag</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-remove-tag" title="The “remove-tag” signal"><span class="type">“remove-tag”</span></a> signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.begin-user-action"></a>begin_user_action</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the
|
||
<a class="link" href="GtkTextBuffer.html#GtkTextBuffer-begin-user-action" title="The “begin-user-action” signal"><span class="type">“begin-user-action”</span></a> signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.end-user-action"></a>end_user_action</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-end-user-action" title="The “end-user-action” signal"><span class="type">“end-user-action”</span></a>
|
||
signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkTextBufferClass.paste-done"></a>paste_done</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>The class handler for the <a class="link" href="GtkTextBuffer.html#GtkTextBuffer-paste-done" title="The “paste-done” signal"><span class="type">“paste-done”</span></a> signal.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBufferTargetInfo"></a><h3>enum GtkTextBufferTargetInfo</h3>
|
||
<p>These values are used as “info” for the targets contained in the
|
||
lists returned by <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-copy-target-list" title="gtk_text_buffer_get_copy_target_list ()"><code class="function">gtk_text_buffer_get_copy_target_list()</code></a> and
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-paste-target-list" title="gtk_text_buffer_get_paste_target_list ()"><code class="function">gtk_text_buffer_get_paste_target_list()</code></a>.</p>
|
||
<p>The values counts down from <code class="literal">-1</code> to avoid clashes
|
||
with application added drag destinations which usually start at 0.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBufferTargetInfo.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="enum_members_name">
|
||
<col class="enum_members_description">
|
||
<col width="200px" class="enum_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-TEXT-BUFFER-TARGET-INFO-BUFFER-CONTENTS:CAPS"></a>GTK_TEXT_BUFFER_TARGET_INFO_BUFFER_CONTENTS</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Buffer contents</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-TEXT-BUFFER-TARGET-INFO-RICH-TEXT:CAPS"></a>GTK_TEXT_BUFFER_TARGET_INFO_RICH_TEXT</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Rich text</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="enum_member_name"><p><a name="GTK-TEXT-BUFFER-TARGET-INFO-TEXT:CAPS"></a>GTK_TEXT_BUFFER_TARGET_INFO_TEXT</p></td>
|
||
<td class="enum_member_description">
|
||
<p>Text</p>
|
||
</td>
|
||
<td class="enum_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.property-details"></a><h2>Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer--copy-target-list"></a><h3>The <code class="literal">“copy-target-list”</code> property</h3>
|
||
<pre class="programlisting"> “copy-target-list” <a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *</pre>
|
||
<p>The list of targets this buffer supports for clipboard copying
|
||
and as DND source.</p>
|
||
<p>Owner: GtkTextBuffer</p>
|
||
<p>Flags: Read</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer--cursor-position"></a><h3>The <code class="literal">“cursor-position”</code> property</h3>
|
||
<pre class="programlisting"> “cursor-position” <span class="type">int</span></pre>
|
||
<p>The position of the insert mark (as offset from the beginning
|
||
of the buffer). It is useful for getting notified when the
|
||
cursor moves.</p>
|
||
<p>Owner: GtkTextBuffer</p>
|
||
<p>Flags: Read</p>
|
||
<p>Allowed values: >= 0</p>
|
||
<p>Default value: 0</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer--has-selection"></a><h3>The <code class="literal">“has-selection”</code> property</h3>
|
||
<pre class="programlisting"> “has-selection” <span class="type">gboolean</span></pre>
|
||
<p>Whether the buffer has some text currently selected.</p>
|
||
<p>Owner: GtkTextBuffer</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer--paste-target-list"></a><h3>The <code class="literal">“paste-target-list”</code> property</h3>
|
||
<pre class="programlisting"> “paste-target-list” <a class="link" href="gtk3-Selections.html#GtkTargetList"><span class="type">GtkTargetList</span></a> *</pre>
|
||
<p>The list of targets this buffer supports for clipboard pasting
|
||
and as DND destination.</p>
|
||
<p>Owner: GtkTextBuffer</p>
|
||
<p>Flags: Read</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer--tag-table"></a><h3>The <code class="literal">“tag-table”</code> property</h3>
|
||
<pre class="programlisting"> “tag-table” <a class="link" href="GtkTextTagTable.html" title="GtkTextTagTable"><span class="type">GtkTextTagTable</span></a> *</pre>
|
||
<p>Text Tag Table.</p>
|
||
<p>Owner: GtkTextBuffer</p>
|
||
<p>Flags: Read / Write / Construct Only</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer--text"></a><h3>The <code class="literal">“text”</code> property</h3>
|
||
<pre class="programlisting"> “text” <span class="type">char</span> *</pre>
|
||
<p>The text content of the buffer. Without child widgets and images,
|
||
see <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-get-text" title="gtk_text_buffer_get_text ()"><code class="function">gtk_text_buffer_get_text()</code></a> for more information.</p>
|
||
<p>Owner: GtkTextBuffer</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: ""</p>
|
||
<p class="since">Since: 2.8</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.signal-details"></a><h2>Signal Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-apply-tag"></a><h3>The <code class="literal">“apply-tag”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag,
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start,
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::apply-tag signal is emitted to apply a tag to a
|
||
range of text in a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>.
|
||
|
||
Applying actually occurs in the default handler.</p>
|
||
<p>Note that if your handler runs before the default handler it must not
|
||
|
||
invalidate the <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
iters (or has to revalidate them). </p>
|
||
<p>See also:
|
||
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-apply-tag" title="gtk_text_buffer_apply_tag ()"><code class="function">gtk_text_buffer_apply_tag()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-with-tags" title="gtk_text_buffer_insert_with_tags ()"><code class="function">gtk_text_buffer_insert_with_tags()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-range" title="gtk_text_buffer_insert_range ()"><code class="function">gtk_text_buffer_insert_range()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-apply-tag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>the applied tag</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>the start of the range the tag is applied to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>the end of the range the tag is applied to</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-begin-user-action"></a><h3>The <code class="literal">“begin-user-action”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::begin-user-action signal is emitted at the beginning of a single
|
||
user-visible operation on a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>.</p>
|
||
<p>See also:
|
||
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-begin-user-action" title="gtk_text_buffer_begin_user_action ()"><code class="function">gtk_text_buffer_begin_user_action()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-interactive" title="gtk_text_buffer_insert_interactive ()"><code class="function">gtk_text_buffer_insert_interactive()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-range-interactive" title="gtk_text_buffer_insert_range_interactive ()"><code class="function">gtk_text_buffer_insert_range_interactive()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete-interactive" title="gtk_text_buffer_delete_interactive ()"><code class="function">gtk_text_buffer_delete_interactive()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-backspace" title="gtk_text_buffer_backspace ()"><code class="function">gtk_text_buffer_backspace()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete-selection" title="gtk_text_buffer_delete_selection ()"><code class="function">gtk_text_buffer_delete_selection()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-begin-user-action.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-changed"></a><h3>The <code class="literal">“changed”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::changed signal is emitted when the content of a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>
|
||
|
||
has changed.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-changed.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-delete-range"></a><h3>The <code class="literal">“delete-range”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start,
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::delete-range signal is emitted to delete a range
|
||
|
||
from a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>. </p>
|
||
<p>Note that if your handler runs before the default handler it must not
|
||
|
||
invalidate the <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
iters (or has to revalidate them).
|
||
|
||
The default signal handler revalidates the <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
iters to
|
||
|
||
both point to the location where text was deleted. Handlers
|
||
which run after the default handler (see <code class="function">g_signal_connect_after()</code>)
|
||
do not have access to the deleted text.</p>
|
||
<p>See also: <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete" title="gtk_text_buffer_delete ()"><code class="function">gtk_text_buffer_delete()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-delete-range.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>the start of the range to be deleted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>the end of the range to be deleted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-end-user-action"></a><h3>The <code class="literal">“end-user-action”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::end-user-action signal is emitted at the end of a single
|
||
user-visible operation on the <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>.</p>
|
||
<p>See also:
|
||
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-end-user-action" title="gtk_text_buffer_end_user_action ()"><code class="function">gtk_text_buffer_end_user_action()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-interactive" title="gtk_text_buffer_insert_interactive ()"><code class="function">gtk_text_buffer_insert_interactive()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-range-interactive" title="gtk_text_buffer_insert_range_interactive ()"><code class="function">gtk_text_buffer_insert_range_interactive()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete-interactive" title="gtk_text_buffer_delete_interactive ()"><code class="function">gtk_text_buffer_delete_interactive()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-backspace" title="gtk_text_buffer_backspace ()"><code class="function">gtk_text_buffer_backspace()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete-selection" title="gtk_text_buffer_delete_selection ()"><code class="function">gtk_text_buffer_delete_selection()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-backspace" title="gtk_text_buffer_backspace ()"><code class="function">gtk_text_buffer_backspace()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-end-user-action.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-insert-child-anchor"></a><h3>The <code class="literal">“insert-child-anchor”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *location,
|
||
<a class="link" href="GtkTextView.html#GtkTextChildAnchor"><span class="type">GtkTextChildAnchor</span></a> *anchor,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::insert-child-anchor signal is emitted to insert a
|
||
<a class="link" href="GtkTextView.html#GtkTextChildAnchor"><span class="type">GtkTextChildAnchor</span></a> in a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>.
|
||
Insertion actually occurs in the default handler.</p>
|
||
<p>Note that if your handler runs before the default handler it must
|
||
not invalidate the <em class="parameter"><code>location</code></em>
|
||
iter (or has to revalidate it).
|
||
|
||
The default signal handler revalidates it to be placed after the
|
||
|
||
inserted <em class="parameter"><code>anchor</code></em>
|
||
.</p>
|
||
<p>See also: <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-child-anchor" title="gtk_text_buffer_insert_child_anchor ()"><code class="function">gtk_text_buffer_insert_child_anchor()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-insert-child-anchor.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>location</p></td>
|
||
<td class="parameter_description"><p>position to insert <em class="parameter"><code>anchor</code></em>
|
||
in <em class="parameter"><code>textbuffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>anchor</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkTextView.html#GtkTextChildAnchor"><span class="type">GtkTextChildAnchor</span></a> to be inserted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-insert-pixbuf"></a><h3>The <code class="literal">“insert-pixbuf”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *location,
|
||
<span class="type">GdkPixbuf</span> *pixbuf,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::insert-pixbuf signal is emitted to insert a <span class="type">GdkPixbuf</span>
|
||
|
||
in a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>. Insertion actually occurs in the default handler.</p>
|
||
<p>Note that if your handler runs before the default handler it must not
|
||
|
||
invalidate the <em class="parameter"><code>location</code></em>
|
||
iter (or has to revalidate it).
|
||
|
||
The default signal handler revalidates it to be placed after the
|
||
|
||
inserted <em class="parameter"><code>pixbuf</code></em>
|
||
.</p>
|
||
<p>See also: <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-pixbuf" title="gtk_text_buffer_insert_pixbuf ()"><code class="function">gtk_text_buffer_insert_pixbuf()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-insert-pixbuf.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>location</p></td>
|
||
<td class="parameter_description"><p>position to insert <em class="parameter"><code>pixbuf</code></em>
|
||
in <em class="parameter"><code>textbuffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>pixbuf</p></td>
|
||
<td class="parameter_description"><p>the <span class="type">GdkPixbuf</span> to be inserted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-insert-text"></a><h3>The <code class="literal">“insert-text”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *location,
|
||
<span class="type">char</span> *text,
|
||
<span class="type">int</span> len,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::insert-text signal is emitted to insert text in a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>.
|
||
Insertion actually occurs in the default handler. </p>
|
||
<p>Note that if your handler runs before the default handler it must not
|
||
|
||
invalidate the <em class="parameter"><code>location</code></em>
|
||
iter (or has to revalidate it).
|
||
|
||
The default signal handler revalidates it to point to the end of the
|
||
|
||
inserted text.</p>
|
||
<p>See also:
|
||
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert" title="gtk_text_buffer_insert ()"><code class="function">gtk_text_buffer_insert()</code></a>,
|
||
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-insert-range" title="gtk_text_buffer_insert_range ()"><code class="function">gtk_text_buffer_insert_range()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-insert-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>location</p></td>
|
||
<td class="parameter_description"><p>position to insert <em class="parameter"><code>text</code></em>
|
||
in <em class="parameter"><code>textbuffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text</p></td>
|
||
<td class="parameter_description"><p>the UTF-8 text to be inserted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>len</p></td>
|
||
<td class="parameter_description"><p>length of the inserted text in bytes</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-mark-deleted"></a><h3>The <code class="literal">“mark-deleted”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> *mark,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::mark-deleted signal is emitted as notification
|
||
after a <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> is deleted. </p>
|
||
<p>See also:
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-delete-mark" title="gtk_text_buffer_delete_mark ()"><code class="function">gtk_text_buffer_delete_mark()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-mark-deleted.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>mark</p></td>
|
||
<td class="parameter_description"><p>The mark that was deleted</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-mark-set"></a><h3>The <code class="literal">“mark-set”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *location,
|
||
<a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> *mark,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::mark-set signal is emitted as notification
|
||
after a <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a> is set.</p>
|
||
<p>See also:
|
||
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-create-mark" title="gtk_text_buffer_create_mark ()"><code class="function">gtk_text_buffer_create_mark()</code></a>,
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-move-mark" title="gtk_text_buffer_move_mark ()"><code class="function">gtk_text_buffer_move_mark()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-mark-set.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>location</p></td>
|
||
<td class="parameter_description"><p>The location of <em class="parameter"><code>mark</code></em>
|
||
in <em class="parameter"><code>textbuffer</code></em>
|
||
</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>mark</p></td>
|
||
<td class="parameter_description"><p>The mark that is set</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-modified-changed"></a><h3>The <code class="literal">“modified-changed”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::modified-changed signal is emitted when the modified bit of a
|
||
|
||
<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> flips.</p>
|
||
<p>See also:
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-set-modified" title="gtk_text_buffer_set_modified ()"><code class="function">gtk_text_buffer_set_modified()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-modified-changed.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-paste-done"></a><h3>The <code class="literal">“paste-done”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> *clipboard,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The paste-done signal is emitted after paste operation has been completed.
|
||
This is useful to properly scroll the view to the end of the pasted text.
|
||
See <a class="link" href="GtkTextBuffer.html#gtk-text-buffer-paste-clipboard" title="gtk_text_buffer_paste_clipboard ()"><code class="function">gtk_text_buffer_paste_clipboard()</code></a> for more details.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-paste-done.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>clipboard</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="type">GtkClipboard</span></a> pasted from</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<p class="since">Since: 2.16</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkTextBuffer-remove-tag"></a><h3>The <code class="literal">“remove-tag”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a> *textbuffer,
|
||
<a class="link" href="GtkTextTag.html" title="GtkTextTag"><span class="type">GtkTextTag</span></a> *tag,
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *start,
|
||
<a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *end,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::remove-tag signal is emitted to remove all occurrences of <em class="parameter"><code>tag</code></em>
|
||
from
|
||
a range of text in a <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>.
|
||
|
||
Removal actually occurs in the default handler.</p>
|
||
<p>Note that if your handler runs before the default handler it must not
|
||
|
||
invalidate the <em class="parameter"><code>start</code></em>
|
||
and <em class="parameter"><code>end</code></em>
|
||
iters (or has to revalidate them). </p>
|
||
<p>See also:
|
||
|
||
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-remove-tag" title="gtk_text_buffer_remove_tag ()"><code class="function">gtk_text_buffer_remove_tag()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkTextBuffer-remove-tag.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>textbuffer</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>tag</p></td>
|
||
<td class="parameter_description"><p>the tag to be removed</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>start</p></td>
|
||
<td class="parameter_description"><p>the start of the range the tag is removed from</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>end</p></td>
|
||
<td class="parameter_description"><p>the end of the range the tag is removed from</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkTextBuffer.see-also"></a><h2>See Also</h2>
|
||
<p><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a>, <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a>, <a class="link" href="GtkTextMark.html" title="GtkTextMark"><span class="type">GtkTextMark</span></a></p>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>Generated by GTK-Doc V1.33.1</div>
|
||
</body>
|
||
</html> |