# MenuBar (Python)

Tiffany Antopolski
tiffany.antopolski@gmail.com 2012
Marta Maria Casetti
mmcasetti@gmail.com 2012
Ένα γραφικό συστατικό που κρατά γραφικά συστατικά GtkMenuItem

# MenuBar

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

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

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

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

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

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

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

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

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

Τώρα εκτελέστε την εφαρμογή python. Θα πρέπει να μοιάζει με την εικόνα στην κορυφή αυτής της σελίδας.

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

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

## menubar.ui

<?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` και ένα `Paste` στο υπομενού `Edit` και ένα στοιχείο `About` στο υπομενού `Help`.

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

Τώρα δημιουργούμε τις ενέργειες για "New" και "Quit" συνδεμένες σε μια συνάρτηση επανάκλησης στο αρχείο Python· για παράδειγμα δημιουργούμε το "new" ως:

new_action = Gio.SimpleAction.new("new", None) new_action.connect("activate", self.new_callback)

Και δημιουργούμε τη συνάρτηση επανάκλησης του "new" ως

def new_callback(self, action, parameter): print "You clicked \"New\""

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

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

Σημειώστε ότι για μια ενέργεια που είναι σχετική με την εφαρμογή, χρησιμοποιούμε το πρόθεμα `app.`· για ενέργειες που είναι σχετικές με το παράθυρο χρησιμοποιούμε το πρόθεμα `win.`.

Τελικά, στο αρχείο Python, προσθέτουμε την ενέργεια στην εφαρμογή ή στο παράθυρο - έτσι για παράδειγμα `app.new` θα προστεθεί στην εφαρμογή στη μέθοδο `do_startup(self)` ως

self.add_action(new_action)

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

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

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

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

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

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

Οι δημιουργημένες ενέργειες μέχρι εδώ είναι χωρίς κατάσταση, δηλαδή δεν κρατούν ή εξαρτώνται από μια δεδομένη κατάσταση από την ίδια την ενέργεια. Οι ενέργειες που χρειαζόμαστε να δημιουργήσουμε για το υπομενού επιλογών, από την άλλη μεριά, είναι με κατάσταση. Ένα παράδειγμα δημιουργίας μιας ενέργειας με κατάσταση είναι:

shape_action = Gio.SimpleAction.new_stateful("shape", GLib.VariantType.new('s'), GLib.Variant.new_string('line'))

όπου οι μεταβλητές της μεθόδου είναι: όνομα, τύπος παραμέτρου (σε αυτήν την περίπτωση, μια συμβολοσειρά - δείτε εδώ για μια πλήρη λίστα σημασιών χαρακτήρα), αρχικής κατάστασης (σε αυτήν την περίπτωση, 'line' - σε περίπτωση μιας `True` τιμής Μπουλ θα πρέπει να είναι `Glib.Variant.new_boolean(True)`, κ.ο.κ, δείτε εδώ για μια πλήρη λίστα)

Μετά τη δημιουργία της SimpleAction με κατάσταση τη συνδέουμε στη συνάρτηση επανάκλησης και την προσθέτουμε στο παράθυρο (ή την εφαρμογή, εάν είναι η περίπτωση), όπως πριν:

shape_action.connect("activate", self.shape_callback) self.add_action(shape_action)

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

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

# Μνημονικές και επιταχυντές

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

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

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

`<attribute name="accel">&lt;Primary&gt;q</attribute>` θα δημιουργήσει την αλληλουχία Ctrl Q όταν προστίθεται στο στοιχείο ετικέτας `Quit`. Εδώ, το "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

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

GSimpleAction

GtkBuilder