# MenuBar (Vala)

Tiffany Antopolski
tiffany.antopolski@gmail.com 2012
Ένα γραφικό στοιχείο που κρατά γραφικά στοιχεία GtkMenuItem
Ελληνική μεταφραστική ομάδα GNOME
team@gnome.gr 2012-2015
Δημήτρης Σπίγγος
dmtrs32@gmail.com 2012, 2013
Μαρία Θουκιδίδου
marablack3@gmail.com 2014
Θάνος Τρυφωνίδης
tomtryf@gmail.com 2014, 2015

# MenuBar

Μια γραμμή εργαλείων δημιουργήθηκε χρησιμοποιώντας XML και GtkBuilder.

# Δημιουργήστε μια γραμμή μενού χρησιμοποιώντας XML

Για να δημιουργήσετε μια γραμμή μενού χρησιμοποιώντας XML:

Δημιουργήστε menubar.ui χρησιμοποιώντας τον αγαπημένο σας επεξεργαστή κειμένου.

Εισάγετε την επόμενη γραμμή στην κορυφή του αρχείου:

<?xml version="1.0"? encoding="UTF-8"?>

Θέλουμε να δημιουργήσουμε τη διεπαφή που θα περιέχει τη γραμμή μενού μας και τα υπομενού της. Η γραμμή μενού μας θα περιέχει τα υπομενού Αρχείο, Επεξεργασία, Επιλογές και Βοήθεια. Προσθέτουμε τον ακόλουθο κώδικα XML στο αρχείο:

<?xml version="1.0" encoding="UTF-8"?> <interface> <menu id="menubar"> <submenu> <attribute name="label">File</attribute> </submenu> <submenu> <attribute name="label">Edit</attribute> </submenu> <submenu> <attribute name="label">Choices</attribute> </submenu> <submenu> <attribute name="label">Help</attribute> </submenu> </menu> </interface>

Τώρα θα δημιουργήσουμε το αρχείο .vala και θα χρησιμοποιήσουμε GtkBuilder για εισαγωγή του menubar.ui που μόλις δημιουργήσαμε.

# Προσθέστε τη MenuBar στο παράθυρο χρησιμοποιώντας GtkBuilder

public class MyWindow : Gtk.ApplicationWindow { internal MyWindow (MyApplication app) { Object (application: app, title: "MenuBar Example"); this.set_default_size (200, 200); } }

class MyApplication: Gtk.Application { protected override void activate () { new MyWindow (this).show (); } protected override void startup () { base.startup ();

/* Setup menubar. */ /* Get the UI file. */ var builder = new Gtk.Builder (); try { builder.add_from_file ("menubar_basis.ui"); /* Handle the exception. */ } catch (Error e) { error ("Unable to load file: %s", e.message); }

/* Get the menubar from the builder. */ this.menubar = builder.get_object ("menubar") as MenuModel; } }

/* main creates and runs the application. */ public int main (string[] args) { return new MyApplication ().run (args); }

Τώρα, μεταγλωττίστε το αρχείο vala και εκτελέστε το. Η εφαρμογή θα πρέπει να φαίνεται σαν την εικόνα στην κορυφή αυτής της σελίδας.

# Προσθήκη στοιχείων στα μενού

Ξεκινάμε προσθέτοντας 2 στοιχεία μενού στο μενού αρχείο: νέο και κλείσιμο. Τι κάνουμε αυτό προσθέτοντας μια `section` στο υπομενού `File` με αυτά τα στοιχεία. Το menubar.ui πρέπει να φαίνεται σαν αυτό (γραμμές 6 έως 13 συμπεριλαμβανόμενης αποτελούν τη νέα ενότητα που προστέθηκε):

<?xml version="1.0" encoding="UTF-8"?> <interface> <menu id="menubar"> <submenu> <attribute name="label">File</attribute> <section> <item> <attribute name="label">New</attribute> </item> <item> <attribute name ="label">Quit</attribute> </item> </section> </submenu> <submenu> <attribute name="label">Edit</attribute> </submenu> <submenu> <attribute name="label">Choices</attribute> </submenu> <submenu> <attribute name="label">Help</attribute> </submenu> </menu> </interface>

Ακολουθώντας αυτό το μοτίβο, μπορείτε τώρα να προσθέσετε ένα στοιχείο `Copy` and μια `Paste` στο υπομενού `Edit` και ένα στοιχείο `About` στο υπομενού `Help`. Θα καθυστερήσουμε την προσθήκη στοιχείων στο υπομενού επιλογές μέχρι παραπέρα στο μάθημα.

Δεν χρειάζεστε ξαναμεταγλώττιση του προγράμματος vala εάν κάνετε αλλαγές μόνο στο αρχείο UI. Απλά εκτελέστε την προηγουμένως μεταγλωττισμένη εφαρμογή και οι αλλαγές UI θα ανακλαστούν.

# Εγκατάσταση ενεργειών

Αυτή είναι μια διεργασία τριών βημάτων.

Πρώτα δημιουργούμε τον πίνακα ActionEntry στην κλάση MyApplication. Μια ActionEntry αποτελείται από:

το "action name" (υποχρεωτικό)

τη συνάρτηση επανάκλησης για να συνδέσετε το σήμα "activate" της ενέργειας (εάν γίνεται)

τον τύπο της παραμέτρου που πρέπει να περαστεί στην ενεργοποιημένη συνάρτηση για την ενέργεια (εάν γίνεται)

την αρχική κατάσταση για αυτήν την ενέργεια (εάν γίνεται)

την επανάκληση σύνδεσης με το σήμα "change-state" (εάν γίνεται)

const ActionEntry[] actions = { { "new", new_cb }, // {"action name", callback_function} { "quit", quit_cb } }·

Δεύτερο, δημιουργούμε στις συναρτήσεις επανάκλησης τις ενέργειες που σχετίζονται.

void new_cb (SimpleAction action, Variant? parameter) { print ("You clicked \"New\"\n"); //new MyWindow (this).show (); }

void quit_cb (SimpleAction action, Variant? parameter) { print ("You clicked \"Quit\"\n"); this.quit (); }

Και τελευταία, συνδέουμε τα στοιχεία μενού στις ενέργειες στο αρχείο XML προσθέτοντας το γνώρισμα "action":

<item> <attribute name="label">New</attribute> <attribute name="action">app.new</attribute> </item> <item> <attribute name="label">Quit</attribute> <attribute name="action">app.quit</attribute> </item>

# Επιλογές υπομενού και στοιχείων με κατάσταση

Γραμμές 30 έως 80 συμπεριλαμβανόμενης της εμφάνισης του χρησιμοποιούμενου κώδικα XML για δημιουργία της UI για το μενού επιλογές.

# Ενέργειες: εφαρμογή ή παράθυρο;

Πιο πάνω, δημιουργήσαμε τις ενέργειες "new" και "open" ως μέρος της κλάσης MyApplication. Οι ενέργειες που ελέγχουν την ίδια την εφαρμογή, όπως "quit" πρέπει να δημιουργηθούν παρόμοια.

Μερικές ενέργειες, όπως "copy" και "paste" αντιμετωπίζουν το παράθυρο, όχι την εφαρμογή. Οι ενέργειες παραθύρου πρέπει να δημιουργηθούν ως μέρος της κλάσης παραθύρου.

Τα πλήρη αρχεία παραδείγματος περιέχουν αμφότερες τις ενέργειες εφαρμογής και παραθύρου. Οι ενέργειες παραθύρου είναι αυτές που συνήθως συμπεριλαμβάνονται στο μενού εφαρμογής. Δεν είναι καλή πρακτική να συμπεριλαμβάνετε ενέργειες παραθύρου στο μενού της εφαρμογής. Για σκοπούς επίδειξης, τα πλήρη αρχεία του παραδείγματος που ακολουθεί περιέχουν XML στο αρχείο UI που δημιουργεί το μενού εφαρμογής που περιλαμβάνει τα στοιχεία "New" και "Open" και αυτά συνδέονται με τις ίδιες ενέργειες όπως τα στοιχεία της γραμμής μενού του ίδιου ονόματος.

# Πλήρες αρχείο UI XML για αυτό το παράδειγμα

<?xml version="1.0" encoding="UTF-8"?> <interface> <menu id="menubar"> <submenu> <attribute name="label">File</attribute> <section> <item> <attribute name="label">New</attribute> <attribute name="action">app.new</attribute> </item> <item> <attribute name="label">Quit</attribute> <attribute name="action">app.quit</attribute> </item> </section> </submenu> <submenu> <attribute name="label">Edit</attribute> <section> <item> <attribute name="label">Copy</attribute> <attribute name="action">win.copy</attribute> </item> <item> <attribute name="label">Paste</attribute> <attribute name="action">win.paste</attribute> </item> </section> </submenu> <submenu> <attribute name="label">Choices</attribute> <submenu> <attribute name="label">Shapes</attribute> <section> <item> <attribute name="label">Line</attribute> <attribute name="action">win.shape</attribute> <attribute name="target">line</attribute> </item> <item> <attribute name="label">Triangle</attribute> <attribute name="action">win.shape</attribute> <attribute name="target">triangle</attribute> </item> <item> <attribute name="label">Square</attribute> <attribute name="action">win.shape</attribute> <attribute name="target">square</attribute> </item> <item> <attribute name="label">Polygon</attribute> <attribute name="action">win.shape</attribute> <attribute name="target">polygon</attribute> </item> <item> <attribute name="label">Circle</attribute> <attribute name="action">win.shape</attribute> <attribute name="target">circle</attribute> </item> </section> </submenu> <section> <item> <attribute name="label">On</attribute> <attribute name="action">app.state</attribute> <attribute name="target">on</attribute> </item> <item> <attribute name="label">Off</attribute> <attribute name="action">app.state</attribute> <attribute name="target">off</attribute> </item> </section> <section> <item> <attribute name="label">Awesome</attribute> <attribute name="action">app.awesome</attribute> </item> </section> </submenu> <submenu> <attribute name="label">Help</attribute> <section> <item> <attribute name="label">About</attribute> <attribute name="action">win.about</attribute> </item> </section> </submenu> </menu> <menu id="appmenu"> <section> <item> <attribute name="label">New</attribute> <attribute name="action">app.new</attribute> </item> <item> <attribute name="label">Quit</attribute> <attribute name="action">app.quit</attribute> </item> </section> </menu> </interface>

# Πλήρες αρχείο Vala για αυτό το παράδειγμα

public class MyWindow : Gtk.ApplicationWindow {

/* Callback functions for the window actions. */ void copy_cb (SimpleAction action, Variant? parameter) { print ("\"Copy\" activated\n"); }

void paste_cb (SimpleAction action, Variant? parameter) { print ("\"Paste\" activated\n"); }

void shape_cb (SimpleAction action, Variant? parameter) { print ("shape is set to %s\n", parameter.get_string(null)); action.set_state (parameter); }

/* Create the window actions. */ const ActionEntry[] actions = { /*{ "action name", cb to connect to "activate" signal, parameter type, initial state, cb to connect to "change-state" signal } */ { "copy", copy_cb }, { "paste", paste_cb }, { "shape", shape_cb, "s", "'line'"} };

internal MyWindow (MyApplication app) { Object (application: app, title: "MenuBar Example"); this.set_default_size (200, 200);

/* Setup window actions. */ this.add_action_entries (actions, this); } }

class MyApplication: Gtk.Application { protected override void activate () { new MyWindow (this).show (); }

/* Callback functions for the application actions. */ void new_cb (SimpleAction action, Variant? parameter) { //new MyWindow (this).show (); print ("You clicked \"New\"\n"); }

void quit_cb (SimpleAction action, Variant? parameter) { print ("You clicked \"Quit\"\n"); this.quit (); }

void awesome_cb (SimpleAction action, Variant? parameter) { var active = action.get_state ().get_boolean (); action.set_state (new Variant.boolean (!active)); if (active) print ("You unchecked \"Awesome\"\n"); else print ("You checked \"Awesome\"\n"); }

void state_cb (SimpleAction action, Variant? parameter) { print ("state is set to %s\n", parameter.get_string(null)); action.set_state (parameter); }

/* Create the application actions. */ const ActionEntry[] actions = { { "new", new_cb }, { "quit", quit_cb }, { "awesome", awesome_cb, null, "false" }, { "state", state_cb, "s", "'off'" } };

protected override void startup () { base.startup ();

/* Setup application actions. */ this.add_action_entries (actions, this);

/* Setup menubar and app_menu. */ /* Get the UI file. */ var builder = new Gtk.Builder (); try { builder.add_from_file ("menubar.ui"); } catch (Error e) { error ("Unable to load file: %s", e.message); }

/* Get the menubar from the builder. */ this.menubar = builder.get_object ("menubar") as MenuModel;

/* Get the app_menu from the builder. */ this.app_menu = builder.get_object ("appmenu") as MenuModel; } }

/* main creates and runs the application. */ public int main (string[] args) { return new MyApplication ().run (args); }

# Μνημονικά

Οι ετικέτες μπορεί να περιέχουν μνημονικούς κανόνες. Οι μνημονικοί είναι υπογραμμισμένοι χαρακτήρες στην ετικέτα, χρησιμοποιούμενοι για περιήγηση πληκτρολογίου. Οι μνημονικοί δημιουργούνται τοποθετώντας μια υπογράμμιση πριν τον μνημονικό χαρακτήρα. Για παράδειγμα "_File" αντί για απλά "File" στο γνώρισμα ετικέτας menubar.ui.

Οι μνημονικοί είναι ορατοί όταν πατάτε το πλήκτρο Alt. Πατώντας AltF θα ανοίξει το μενού αρχείο.

# Επιταχυντές

Οι επιταχυντές μπορούν να προστεθούν ρητά στους ορισμούς UI. Για παράδειγμα, είναι κοινό να μπορείτε να κλείσετε μια εφαρμογή πατώντας CtrlQ ή να αποθηκεύσετε ένα αρχείο πατώντας CtrlS. Για την προσθήκη ενός επιταχυντή στον ορισμό της UI, χρειάζεστε απλά να προσθέσετε ένα γνώρισμα "accel" στο στοιχείο.

Το `<attribute name="accel">&lt;Primary&gt;q</attribute>` θα δημιουργήσει την αλληλουχία CtrlQ όταν προστίθεται στο στοιχείο ετικέτας `'Εξοδος`. Εδώ, το "Primary" αναφέρεται στο πλήκτρο Ctrl σε ένα προσωπικό υπολογιστή ή στο πλήκτρο ⌘ σε ένα Mac.

<item> <attribute name="label">_Quit</attribute> <attribute name="action">app.quit</attribute> <attribute name="accel">&lt;Primary&gt;q</attribute> </item>

# Μεταφράσιμες συμβολοσειρές

Επειδή οι εφαρμογές GNOME μεταφράζονται σε πολλές γλώσσες, είναι σημαντικό ότι οι συμβολοσειρές στην εφαρμογή σας είναι μεταφράσιμες. Για να κάνετε μια ετικέτα μεταφράσιμη, απλά βάλτε `translatable="yes"`:

`<attribute name="label" translatable="yes">Quit</attribute>`

# Σχετική τεκμηρίωση API

Σε αυτό το παράδειγμα χρησιμοποιήσαμε τα παρακάτω:

Glib.ActionEntry

Gtk.Builder

# Ασκήσεις