Tooltip (JavaScript) Meg Ford megford@gnome.org 2013 Přidání vysvětlivek do vašich widgetů Tooltip

Nástrojová lišta s vysvětlivkami (s obrázky) u tlačítek.

Tento příklad navazuje na příklad Toolbar.

Kód použitý k vygenerování tohoto příkladu //!/usr/bin/gjs imports.gi.versions.Gdk = '3.0'; imports.gi.versions.Gtk = '3.0'; const Gdk = imports.gi.Gdk; const GLib = imports.gi.GLib; const Gio = imports.gi.Gio; const Gtk = imports.gi.Gtk; class TooltipExample { // Vytvoří aplikaci constructor() { this.application = new Gtk.Application({ application_id: 'org.example.jstooltip' }); // Napojí signály "activate" a "startup" k funkcím zpětného volání this.application.connect('activate', this._onActivate.bind(this)); this.application.connect('startup', this._onStartup.bind(this)); } // Funkce zpětného volání pro signál "activate" zobrazujicí okno při aktivaci _onActivate() { this.window.present(); } // Funkce zpětného volání pro signál "startup" sestavující uživatelské rozhraní _onStartup() { this._buildUI(); } // Sestaví uživatelské rozhraní aplikace _buildUI() { // Vytvoří okno aplikace this.window = new Gtk.ApplicationWindow({ application: this.application, window_position: Gtk.WindowPosition.CENTER, title: "Toolbar with Tooltips Example", default_width: 400, default_height: 200, border_width: 10 }); this.grid = new Gtk.Grid(); this.toolbar = this._createToolbar(); this.toolbar.set_hexpand(true); this.toolbar.show(); this.grid.attach(this.toolbar, 0, 0, 1, 1); this.window.add(this.grid); this._newAction = new Gio.SimpleAction({ name: "new" }); this._newAction.connect("activate", this._newCallback.bind(this)); this.window.add_action(this._newAction); this._openAction = new Gio.SimpleAction({ name: "open" }); this._openAction.connect("activate", this._openCallback.bind(this)); this.window.add_action(this._openAction); this._undoAction = new Gio.SimpleAction({ name: "undo" }); this._undoAction.connect("activate", this._undoCallback.bind(this)); this.window.add_action(this._undoAction); this._fullScreenAction = new Gio.SimpleAction({ name: "fullscreenToggle" }); this._fullScreenAction.connect("activate", this._fullScreenCallback.bind(this)); this.window.add_action(this._fullScreenAction); this.window.show_all(); } _createToolbar() { this.toolbar = new Gtk.Toolbar(); this.toolbar.get_style_context().add_class(Gtk.STYLE_CLASS_PRIMARY_TOOLBAR); // Tlačítko pro akci „new“ this.newButton = Gtk.ToolButton.new_from_stock(Gtk.STOCK_NEW); // s vysvětlivkou se zadaným textem this.newButton.set_tooltip_text("Create a new file"); this.newButton.set_is_important(true); this.toolbar.insert(this.newButton, 0); this.newButton.show(); this.newButton.set_action_name("win.new"); // Tlačítko pro akci „open“ this.openButton = Gtk.ToolButton.new_from_stock(Gtk.STOCK_OPEN); // s vysvětlivkou se zadaným textem ve značkovacím jazyce Pango this.openButton.set_tooltip_markup("Open an <i>existing</i> file"); this.openButton.set_is_important(true); this.toolbar.insert(this.openButton, 1); this.openButton.show(); this.openButton.set_action_name("win.open"); // Tlačítko pro akci „undo“ this.undoButton = Gtk.ToolButton.new_from_stock(Gtk.STOCK_UNDO); // s vysvětlivkou s obrázkem // Nataví vlastnost „has-tooltip“ na true this.undoButton.set_property("has-tooltip", true); // Napojí funkci zpětného volání pro vysvětlivku // se signálem „query-tooltip“ this.undoButton.connect("query-tooltip", this._undoTooltipCallback.bind(this)); this.undoButton.set_is_important(true); this.toolbar.insert(this.undoButton, 2); this.undoButton.show(); this.undoButton.set_action_name("win.undo"); // Tlačítko pro akci „fullscreen/leave fullscreen“ this.fullscreenButton = Gtk.ToolButton.new_from_stock(Gtk.STOCK_FULLSCREEN); this.fullscreenButton.set_is_important(true); this.toolbar.insert(this.fullscreenButton, 3); this.fullscreenButton.set_action_name("win.fullscreenToggle"); return this.toolbar; } _newCallback(action, parameter) { print("You clicked \"New\"."); } _openCallback(action, parameter) { print("You clicked \"Open\"."); } // Funkce zpětného volání pro vysvětlivku tlačítka „undo“ _undoTooltipCallback(widget, x, y, keyboard_mode, tooltip) { // Nastaví text pro vysvětlivku tooltip.set_text("Undo your last action"); // Nastaví ikonu pro vysvětlivku tooltip.set_icon_from_stock(Gtk.STOCK_UNDO, Gtk.IconSize.MENU); // Zobrazí vysvětlivku return true; } _undoCallback(action, parameter) { print("You clicked \"Undo\"."); } _fullScreenCallback() { if ((this.window.get_window().get_state() & Gdk.WindowState.FULLSCREEN) != 0 ){ this.fullscreenButton.set_stock_id(Gtk.STOCK_FULLSCREEN); this.fullscreenButton.set_tooltip_text("Make your window fullscreen"); this.window.unfullscreen(); } else { this.fullscreenButton.set_stock_id(Gtk.STOCK_LEAVE_FULLSCREEN); this.fullscreenButton.set_tooltip_text("Leave fullscreen"); this.window.fullscreen(); } } }; // Spustí aplikaci let app = new TooltipExample (); app.application.run (ARGV);
Odkazy k API

V této ukázce se používá následující:

GtkTooltip

GtkToolbar

GtkWidget

Standardní položky