-
Notifications
You must be signed in to change notification settings - Fork 0
/
ch-TextViewWidget.html
109 lines (98 loc) · 11 KB
/
ch-TextViewWidget.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
<title>Chapitre 13. Le widget TextView</title>
<link rel="stylesheet" href="pygtktutfr.css" type="text/css">
<meta name="keywords" content="python,pygtk,tutoriel,traduction,textview">
<link rel="start" href="index.html" title="Tutoriel PyGTK 2.0">
<link rel="home" href="index.html" title="Table des mati&eagrave;res">
<link rel="up" href="index.html" title="Table des matières">
<link rel="previous" href="sec-DrawingMethods.html" title="12.2. Les méthodes pour dessiner">
<link rel="next" href="sec-TextViews.html" title="13.2. TextView : la zone de texte">
</head>
<body>
<div class="localisation">
Vous êtes à peu près ici :
<a href="../../index.html">Accueil</a> »
<a href="../pygtktut.php">tutoriel PyGTK</a> »
<a href="index.html">PyGTK : sommaire</a>
</div> <!-- fin localisation -->
<div class="navheader">
<table width="100%" summary="En-tête de navigation">
<tr>
<th colspan="3" align="center">Chapitre 13. Le widget TextView</th></tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="sec-DrawingMethods.html">Préc.</a></td>
<th width="60%" align="center"></th>
<td width="20%" align="right"><a accesskey="n" href="sec-TextViews.html">Suiv.</a></td>
</tr></table>
<hr>
</div>
<div class="chapter" lang="fr">
<div class="titlepage">
<div><h2 class="title"><a name="TextViewWidget"></a>Chapitre 13. Le widget TextView</h2></div></div>
<div class="toc">
<p><b>Sommaire</b></p>
<dl>
<dt>13.1. <a href="ch-TextViewWidget.html#sec-TextViewOverview">Présentation des widgets de texte</a></dt>
<dt>13.2. <a href="sec-TextViews.html">TextView : la zone de texte</a></dt>
<dt>13.3. <a href="sec-TextBuffers.html">TextBuffer : le buffer de texte</a></dt>
<dd><dl>
<dt>13.3.1. <a href="sec-TextBuffers.html#RecupInfoBuffer">Récupérer des informations sur le buffer</a></dt>
<dt>13.3.2. <a href="sec-TextBuffers.html#CreerTextIter">Créer des TextIter</a></dt>
<dt>13.3.3. <a href="sec-TextBuffers.html#InserRecupSuppr">Insérer, récupérer et supprimer du texte</a></dt>
<dt>13.3.4. <a href="sec-TextBuffers.html#CreerManipTextMark">Créer et manipuler des TextMark</a></dt>
<dt>13.3.5. <a href="sec-TextBuffers.html#CreerAppliqTextTag">Créer et appliquer des TextTag</a></dt>
<dt>13.3.6. <a href="sec-TextBuffers.html#InserImagesWidgets">Insérer des images et des widgets</a></dt>
</dl></dd>
<dt>13.4. <a href="sec-TextIters.html">TextIter : les itérateurs de texte</a></dt>
<dd><dl>
<dt>13.4.1. <a href="sec-TextIters.html#RecupAttrTextIter">Récupérer les attributs d'un TextIter</a></dt>
<dt>13.4.2. <a href="sec-TextIters.html#RecupAttrTexte">Récupérer les attributs d'un texte portant un TextIter</a></dt>
<dt>13.4.3. <a href="sec-TextIters.html#CopierTextIter">Copier un TextIter</a></dt>
<dt>13.4.4. <a href="sec-TextIters.html#RecupTexteobjets">Récupérer du texte et des objets</a></dt>
<dt>13.4.5. <a href="sec-TextIters.html#VerifBalises">Vérifier les balises à une position de TextIter</a></dt>
<dt>13.4.6. <a href="sec-TextIters.html#VerifPosition">Vérifier la position dans le texte</a></dt>
<dt>13.4.7. <a href="sec-TextIters.html#SeDeplacerTexte">Se déplacer dans le texte</a></dt>
<dt>13.4.8. <a href="sec-TextIters.html#SeDeplacerEmplSpec">Se déplacer à un emplacement spécifique</a></dt>
<dt>13.4.9. <a href="sec-TextIters.html#RechercherTexte">Rechercher du texte</a></dt>
</dl></dd>
<dt>13.5. <a href="sec-TextMarks.html">TextMark : les marques de texte</a></dt>
<dt>13.6. <a href="sec-TextTagsAndTextTagTables.html">TextTag et TextTagTable : les balises de texte</a></dt>
<dd><dl>
<dt>13.6.1. <a href="sec-TextTagsAndTextTagTables.html#TextTag">Les TextTag</a></dt>
<dt>13.6.2. <a href="sec-TextTagsAndTextTagTables.html#TextTagTable">La TextTagTable</a></dt>
</dl></dd>
<dt>13.7. <a href="sec-TextViewExample.html">Un exemple de TextView</a></dt>
</dl>
</div>
<div class="sect1" lang="fr">
<div class="titlepage">
<div>
<h2 class="title" style="clear: both"><a name="sec-TextViewOverview"></a>13.1. Présentation des widgets de texte</h2>
</div></div>
<p>Le widget <a title="13.2. TextView : la zone de texte" href="sec-TextViews.html"><tt>TextView</tt></a> (zone de texte) ainsi que les objets qui lui sont asociés (<a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a>, <a title="13.5. TextMark : les marques de texte" href="sec-TextMarks.html"><tt>TextMark</tt></a>, <a title="13.4. TextIter : les itérateurs de texte" href="sec-TextIters.html"><tt>TextIter</tt></a>, <a title="13.6.1. Les TextTag" href="sec-TextTagsAndTextTagTables.html#TextTag"><tt>TextTag</tt></a> et <a title="13.6.2. La TextTagTable" href="sec-TextTagsAndTextTagTables.html#TextTagTable"><tt>TextTagTable</tt></a>) offrent une structure puissante d'édition de texte multiligne.</p>
<p>Un <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a>
(buffer de texte) contient le texte qui est affiché par un ou plusieurs widgets <a title="13.2. TextView : la zone de texte" href="sec-TextViews.html"><tt>TextView</tt></a>. Avec GTK+ 2.0 le texte est encodé en UTF-8, ce qui signifie qu'un caractère peut être encodé avec plusieurs octets. Dans un <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a> on doit bien faire la distinction entre le décompte des caractères (appelé offset) et le décompte des octets (appelé index).
</p>
<p>Les <a title="13.4. TextIter : les itérateurs de texte" href="sec-TextIters.html"><tt>TextIter</tt></a> (itérateurs de texte) permettent une représentation volatile d'une position dans un <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a>, située entre deux caractères. Les <a title="13.4. TextIter : les itérateurs de texte" href="sec-TextIters.html"><tt>TextIter</tt></a> ne sont valables que tant que le nombre de caractères dans le <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a> est inchangé. Chaque fois que l'on insère ou efface des caractères dans un <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a> tous les <a title="13.4. TextIter : les itérateurs de texte" href="sec-TextIters.html"><tt>TextIter</tt></a> sont invalidés. Les <a title="13.4. TextIter : les itérateurs de texte" href="sec-TextIters.html"><tt>TextIter</tt></a> sont le moyen le plus utilisé de spécifier des positions dans un <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a> afin d'y manipuler du texte.
</p>
<p>Les <a title="13.5. TextMark : les marques de texte" href="sec-TextMarks.html"><tt>TextMark</tt></a> (marques de texte) permettent de marquer des positions qui ne seront pas affectées par les modifications du <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a>. Une marque est comme un <a title="13.4. TextIter : les itérateurs de texte" href="sec-TextIters.html"><tt>TextIter</tt></a> (elle représente une position entre deux caractères d'un <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a>) à la différence que si l'on efface le texte qui l'entoure elle reste à l'endroit où était le texte effacé. Si l'on insère du texte à la position indiquée par cette marque, celle-ci se retrouvera soit à gauche, soit à droite du texte inséré, en fonction de la gravité de la marque — la marque restera à droite du texte inséré dans le cas d'une gravité à droite, et à gauche dans le cas d'une gravité à gauche. On peut choisir de donner un nom à une <a title="13.5. TextMark : les marques de texte" href="sec-TextMarks.html"><tt>TextMark</tt></a>, ou bien la laisser anonyme. Chaque <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a> comporte deux <a title="13.5. TextMark : les marques de texte" href="sec-TextMarks.html"><tt>TextMark</tt></a> prédéfinies, nommées <i><tt>insert</tt></i> et <i><tt>selection_bound</tt></i>, faisant référence aux positions respectives du point d'insertion et de la fin de la sélection (la sélection est comprise entre les marques <i><tt>insert</tt></i> et <i><tt>selection_bound</tt></i>).</p>
<p>Les objets <a title="13.6.1. Les TextTag" href="sec-TextTagsAndTextTagTables.html#TextTag"><tt>TextTag</tt></a> (balises de texte) spécifient un ensemble d'attributs pouvant être appliqués à une portion de texte d'un <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a>. Chaque <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a> a une <a title="13.6.2. La TextTagTable" href="sec-TextTagsAndTextTagTables.html#TextTagTable"><tt>TextTagTable</tt></a> (table des balises de texte) qui recense les balises disponibles dans ce buffer. Plusieurs <a title="13.3. TextBuffer : le buffer de texte" href="sec-TextBuffers.html"><tt>TextBuffer</tt></a> peuvent se partager la même <a title="13.6.2. La TextTagTable" href="sec-TextTagsAndTextTagTables.html#TextTagTable"><tt>TextTagTable</tt></a> pour offrir une meilleure cohérence. On utilise souvent les <a title="13.6.1. Les TextTag" href="sec-TextTagsAndTextTagTables.html#TextTag"><tt>TextTag</tt></a> pour modifier l'apparence d'une portion de texte mais elles peuvent tout aussi bien servir à empêcher l'édition de cette même portion de texte.</p>
</div></div>
<div class="navfooter">
<hr>
<table width="100%" summary="Bas de page de navigation">
<tr>
<td width="40%" align="left"><a accessKey="p" href="sec-DrawingMethods.html">Préc.</a></td>
<td width="20%" align="center"><a accessKey=u href="index.html">Chapitre parent</a></td>
<td width="40%" align="right"><a accessKey="n" href="sec-TextViews.html">Suiv.</a></td>
</tr><tr>
<td width="40%" align="left" vAlign="top">12.2. Les méthodes pour dessiner</td>
<td width="20%" align="center"><a accessKey="h" href="index.html">Table des matières</a></td>
<td width="40%" align="right" vAlign="top">13.2. TextView : la zone de texte</td>
</tr></table>
</div>
</body>
</html>