/usr/share/help/fr/gnome-devel-demos/tooltip.py.page is in gnome-devel-docs 3.18.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 | <?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="tooltip.py" xml:lang="fr">
<info>
<title type="text">Tooltip (Python)</title>
<link type="guide" xref="beginner.py#misc"/>
<link type="seealso" xref="toolbar.py"/>
<link type="next" xref="toolbar_builder.py"/>
<revision version="0.1" date="2012-08-20" status="draft"/>
<credit type="author copyright">
<name>Marta Maria Casetti</name>
<email its:translate="no">mmcasetti@gmail.com</email>
<years>2012</years>
</credit>
<desc>Ajouter des infobulles à vos éléments graphiques</desc>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Luc Rebert,</mal:name>
<mal:email>traduc@rebert.name</mal:email>
<mal:years>2011</mal:years>
</mal:credit>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Alain Lojewski,</mal:name>
<mal:email>allomervan@gmail.com</mal:email>
<mal:years>2011-2012</mal:years>
</mal:credit>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Luc Pionchon</mal:name>
<mal:email>pionchon.luc@gmail.com</mal:email>
<mal:years>2011</mal:years>
</mal:credit>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Bruno Brouard</mal:name>
<mal:email>annoa.b@gmail.com</mal:email>
<mal:years>2011-12</mal:years>
</mal:credit>
<mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
<mal:name>Luis Menina</mal:name>
<mal:email>liberforce@freeside.fr</mal:email>
<mal:years>2014</mal:years>
</mal:credit>
</info>
<title>Infobulle</title>
<media type="image" mime="image/png" src="media/tooltip.png"/>
<p>Une barre d'outil avec une infobulle (une image) pour un bouton.</p>
<note><p>This example builds on the <link xref="toolbar.py">Toolbar</link> example.</p></note>
<links type="section"/>
<section id="code">
<title>Code utilisé pour générer cet exemple</title>
<code mime="text/x-python" style="numbered">from gi.repository import Gtk
from gi.repository import Gdk
from gi.repository import Gio
import sys
class MyWindow(Gtk.ApplicationWindow):
def __init__(self, app):
Gtk.Window.__init__(
self, title="Toolbar with Tooltips Example", application=app)
self.set_default_size(400, 200)
grid = Gtk.Grid()
toolbar = self.create_toolbar()
toolbar.set_hexpand(True)
toolbar.show()
grid.attach(toolbar, 0, 0, 1, 1)
self.add(grid)
undo_action = Gio.SimpleAction.new("undo", None)
undo_action.connect("activate", self.undo_callback)
self.add_action(undo_action)
fullscreen_action = Gio.SimpleAction.new("fullscreen", None)
fullscreen_action.connect("activate", self.fullscreen_callback)
self.add_action(fullscreen_action)
def create_toolbar(self):
toolbar = Gtk.Toolbar()
toolbar.get_style_context().add_class(Gtk.STYLE_CLASS_PRIMARY_TOOLBAR)
# button for the "new" action
new_button = Gtk.ToolButton.new_from_stock(Gtk.STOCK_NEW)
# with a tooltip with a given text
new_button.set_tooltip_text("Create a new file")
new_button.set_is_important(True)
toolbar.insert(new_button, 0)
new_button.show()
new_button.set_action_name("app.new")
# button for the "open" action
open_button = Gtk.ToolButton.new_from_stock(Gtk.STOCK_OPEN)
# with a tooltip with a given text in the Pango markup language
open_button.set_tooltip_markup("Open an <i>existing</i> file")
open_button.set_is_important(True)
toolbar.insert(open_button, 1)
open_button.show()
open_button.set_action_name("app.open")
# button for the "undo" action
undo_button = Gtk.ToolButton.new_from_stock(Gtk.STOCK_UNDO)
# with a tooltip with an image
# set True the property "has-tooltip"
undo_button.set_property("has-tooltip", True)
# connect to the callback function that for the tooltip
# with the signal "query-tooltip"
undo_button.connect("query-tooltip", self.undo_tooltip_callback)
undo_button.set_is_important(True)
toolbar.insert(undo_button, 2)
undo_button.show()
undo_button.set_action_name("win.undo")
# button for the "fullscreen/leave fullscreen" action
self.fullscreen_button = Gtk.ToolButton.new_from_stock(
Gtk.STOCK_FULLSCREEN)
self.fullscreen_button.set_is_important(True)
toolbar.insert(self.fullscreen_button, 3)
self.fullscreen_button.set_action_name("win.fullscreen")
return toolbar
# the callback function for the tooltip of the "undo" button
def undo_tooltip_callback(self, widget, x, y, keyboard_mode, tooltip):
# set the text for the tooltip
tooltip.set_text("Undo your last action")
# set an icon fot the tooltip
tooltip.set_icon_from_stock("gtk-undo", Gtk.IconSize.MENU)
# show the tooltip
return True
def undo_callback(self, action, parameter):
print("You clicked \"Undo\".")
def fullscreen_callback(self, action, parameter):
is_fullscreen = self.get_window().get_state(
) & Gdk.WindowState.FULLSCREEN != 0
if not is_fullscreen:
self.fullscreen_button.set_stock_id(Gtk.STOCK_LEAVE_FULLSCREEN)
self.fullscreen()
else:
self.fullscreen_button.set_stock_id(Gtk.STOCK_FULLSCREEN)
self.unfullscreen()
class MyApplication(Gtk.Application):
def __init__(self):
Gtk.Application.__init__(self)
def do_activate(self):
win = MyWindow(self)
win.show_all()
def do_startup(self):
Gtk.Application.do_startup(self)
new_action = Gio.SimpleAction.new("new", None)
new_action.connect("activate", self.new_callback)
app.add_action(new_action)
open_action = Gio.SimpleAction.new("open", None)
open_action.connect("activate", self.open_callback)
app.add_action(open_action)
def new_callback(self, action, parameter):
print("You clicked \"New\".")
def open_callback(self, action, parameter):
print("You clicked \"Open\".")
app = MyApplication()
exit_status = app.run(sys.argv)
sys.exit(exit_status)
</code>
</section>
<section id="methods">
<title>Méthodes utiles pour un élément graphique infobulle (Tooltip)</title>
<p>Les fonctions <code>set_tooltip_text(text)</code> et <code>set_tooltip_markup(text)</code> peuvent être utilisées pour ajouter une infobulle textuelle (ou un texte dans le langage de balisage Pango) à un élément graphique.</p>
<p>Pour des infobulles plus complexes, par exemple pour une infobulle sous la forme d'image :</p>
<steps>
<item><p>Attribuez la valeur <code>True</code> (vrai) à la propriété <code>"has-tooltip"</code> de l'élément graphique ; de cette façon GTK+ surveille les événements liés aux mouvements de la souris et tous ceux qui sont nécessaires afin de déterminer quand et où afficher une infobulle.</p></item>
<item><p>Connectez le signal <code>"query-tooltip"</code>. Ce signal est émis lorsqu'une infobulle doit s'afficher. Un des arguments transmis au gestionnaire de signaux est un objet GtkTooltip. C'est l'objet que nous allons afficher comme infobulle et qui peut être manipulé dans votre fonction de rappel (callback) en utilisant des fonctions comme <code>set_icon()</code>. Ce sont des fonctions servant à paramétrer le balisage de l'infobulle (<code>set_markup(text)</code>), à définir une image à partir de la collection d'icônes (<code>set_icon_from_stock(stock_id, size)</code>), ou même à positionner un élément graphique personnalisé (<code>set_custom(widget)</code>).</p></item>
<item><p>Renvoyez la valeur <code>True</code> à partir de votre gestionnaire query-tooltip. Cela provoque l'affichage de l'infobulle. Si vous renvoyez <code>False</code>, elle n'est pas affichée.</p></item>
</steps>
<p>Dans le cas peut probable où vous voulez avoir plus de contrôle sur l'infobulle qui est sur le point d'être affichée, vous pouvez définir votre propre GtkWindow qui sera utilisée comme fenêtre d'infobulle. Cela fonctionne comme ceci :</p>
<steps>
<item><p>Paramétrez <code>"has-tooltip"</code> et connectez le à <code>"query-tooltip"</code> comme auparavant.</p></item>
<item><p>Utilisez <code>set_tooltip_window()</code> sur l'élément graphique pour définir un GtkWindow créé par vos soins comme fenêtre d'infobulle.</p></item>
<item><p>Dans la fonction de rappel <code>"query-tooltip"</code> vous pouvez accéder à votre fenêtre en utilisant <code>get_tooltip_window()</code> et la manipuler comme bon vous semble. La sémantiques pour la valeur retournée est exactement comme ci-dessus, renvoyez <code>True</code> pour afficher la fenêtre, <code>False</code> dans le cas contraire.</p></item>
</steps>
</section>
<section id="references">
<title>Références API</title>
<p>Dans cet exemple, les éléments suivants sont utilisés :</p>
<list>
<item><p><link href="http://developer.gnome.org/gtk3/stable/GtkTooltip.html">GtkTooltip</link></p></item>
<item><p><link href="http://developer.gnome.org/gtk3/stable/GtkToolbar.html">GtkToolbar</link></p></item>
<item><p><link href="http://developer.gnome.org/gtk3/stable/GtkWidget.html">GtkWidget</link></p></item>
<item><p><link href="http://developer.gnome.org/gtk3/stable/gtk3-Stock-Items.html">Stock Items</link></p></item>
</list>
</section>
</page>
|