← Back to branch summary

~ubuntu-branches/ubuntu/trusty/gtk+2.0/trusty

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/TextWidget.html

  • Committer: Package Import Robot
  • Author(s): Sebastien Bacher
  • Date: 2013-03-25 19:44:15 UTC
  • mfrom: (1.14.18)
  • Revision ID: package-import@ubuntu.com-20130325194415-47ki11je5se76gim
Tags: 2.24.17-0ubuntu1
New upstream version

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/TextWidget.html
29
29
<td valign="top" align="right"></td>
30
30
</tr></table></div>
31
31
<div class="refsect1">
32
 
<a name="idm267042039856"></a><h2>Conceptual Overview</h2>
 
32
<a name="idm140406247226848"></a><h2>Conceptual Overview</h2>
33
33
<p>
34
34
GTK+ has an extremely powerful framework for multiline text editing.  The
35
35
primary objects involved in the process are <a class="link" href="GtkTextBuffer.html" title="GtkTextBuffer"><span class="type">GtkTextBuffer</span></a>, which represents the 
97
97
no text is selected, these two marks will be in the same position. You can 
98
98
manipulate what is selected and where the cursor appears by moving these 
99
99
marks around.
100
 
<a href="#ftn.idm267040295040" class="footnote" name="idm267040295040"><sup class="footnote">[2]</sup></a>
 
100
<a href="#ftn.idm140406247796592" class="footnote" name="idm140406247796592"><sup class="footnote">[2]</sup></a>
101
101
</p>
102
102
<p>
103
103
Text buffers always contain at least one line, but may be empty (that
111
111
</p>
112
112
</div>
113
113
<div class="refsect1">
114
 
<a name="idm267070905024"></a><h2>Simple Example</h2>
 
114
<a name="idm140406247785472"></a><h2>Simple Example</h2>
115
115
<p>
116
116
The simplest usage of <a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a>  might look like this:
117
117
</p>
158
158
</p>
159
159
</div>
160
160
<div class="refsect1">
161
 
<a name="idm267038273232"></a><h2>Example of Changing Text Attributes</h2>
 
161
<a name="idm140406244524176"></a><h2>Example of Changing Text Attributes</h2>
162
162
<p>
163
163
 
164
164
There are two ways to affect text attributes in <a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a>.
219
219
<span class="function"><a href="GtkTextBuffer.html#gtk-text-buffer-set-text">gtk_text_buffer_set_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">buffer</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Hello, this is some text"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">);</span>
220
220
 
221
221
<span class="comment">/* Change default font throughout the widget */</span>
222
 
<span class="normal">font_desc </span><span class="symbol">=</span><span class="normal"> </span><span class="function">pango_font_description_from_string</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Serif 15"</span><span class="symbol">);</span>
 
222
<span class="normal">font_desc </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-from-string">pango_font_description_from_string</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Serif 15"</span><span class="symbol">);</span>
223
223
<span class="function"><a href="GtkWidget.html#gtk-widget-modify-font">gtk_widget_modify_font</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">view</span><span class="symbol">,</span><span class="normal"> font_desc</span><span class="symbol">);</span>
224
 
<span class="function">pango_font_description_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">font_desc</span><span class="symbol">);</span>
 
224
<span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#pango-font-description-free">pango_font_description_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">font_desc</span><span class="symbol">);</span>
225
225
 
226
226
<span class="comment">/* Change default color throughout the widget */</span>
227
 
<span class="function"><a href="http://library.gnome.org/devel/gdk3/gdk2-Colormaps-and-Colors.html#gdk-color-parse">gdk_color_parse</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"green"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">color</span><span class="symbol">);</span>
 
227
<span class="function"><a href="../gdk2/gdk2-Colormaps-and-Colors.html#gdk-color-parse">gdk_color_parse</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"green"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">color</span><span class="symbol">);</span>
228
228
<span class="function"><a href="GtkWidget.html#gtk-widget-modify-text">gtk_widget_modify_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">view</span><span class="symbol">,</span><span class="normal"> <a href="gtk2-Standard-Enumerations.html#GTK-STATE-NORMAL:CAPS">GTK_STATE_NORMAL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">color</span><span class="symbol">);</span>
229
229
 
230
230
<span class="comment">/* Change left margin throughout the widget */</span>
232
232
 
233
233
<span class="comment">/* Use a tag to change the color for just one part of the widget */</span>
234
234
<span class="normal">tag </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkTextBuffer.html#gtk-text-buffer-create-tag">gtk_text_buffer_create_tag</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">buffer</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"blue_foreground"</span><span class="symbol">,</span>
235
 
<span class="normal">                        </span><span class="string">"foreground"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"blue"</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span><span class="normal">  </span>
 
235
<span class="normal">                        </span><span class="string">"foreground"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"blue"</span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span><span class="normal">  </span>
236
236
<span class="function"><a href="GtkTextBuffer.html#gtk-text-buffer-get-iter-at-offset">gtk_text_buffer_get_iter_at_offset</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">buffer</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">start</span><span class="symbol">,</span><span class="normal"> </span><span class="number">7</span><span class="symbol">);</span>
237
237
<span class="function"><a href="GtkTextBuffer.html#gtk-text-buffer-get-iter-at-offset">gtk_text_buffer_get_iter_at_offset</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">buffer</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">end</span><span class="symbol">,</span><span class="normal"> </span><span class="number">12</span><span class="symbol">);</span>
238
238
<span class="function"><a href="GtkTextBuffer.html#gtk-text-buffer-apply-tag">gtk_text_buffer_apply_tag</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">buffer</span><span class="symbol">,</span><span class="normal"> tag</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">start</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">end</span><span class="symbol">);</span></pre></td>
251
251
</div>
252
252
<div class="footnotes">
253
253
<br><hr style="width:100; text-align:left;margin-left: 0">
254
 
<div id="ftn.idm267040295040" class="footnote"><p><a href="#idm267040295040" class="para"><sup class="para">[2] </sup></a>
 
254
<div id="ftn.idm140406247796592" class="footnote"><p><a href="#idm140406247796592" class="para"><sup class="para">[2] </sup></a>
255
255
If you want to place the cursor in response to a user action, be sure to use
256
256
<a class="link" href="GtkTextBuffer.html#gtk-text-buffer-place-cursor" title="gtk_text_buffer_place_cursor ()"><code class="function">gtk_text_buffer_place_cursor()</code></a>, which moves both at once without causing a 
257
257
temporary selection (moving one then the other temporarily selects the range in