# 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