<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="menubar.py" xml:lang="el">

  <info>

  <title type="text">MenuBar (Python)</title>

  <link type="guide" xref="beginner.py#menu-combo-toolbar"/>

  <link type="seealso" xref="gmenu.py"/>

    <link type="next" xref="colorbutton.py"/>

    <revision version="0.1" date="2012-08-01" status="stub"/>

    <credit type="author copyright">

      <name>Tiffany Antopolski</name>

      <email its:translate="no">tiffany.antopolski@gmail.com</email>

      <years>2012</years>

    </credit>

    <credit type="author copyright">

      <name>Marta Maria Casetti</name>

      <email its:translate="no">mmcasetti@gmail.com</email>

      <years>2012</years>

    </credit>

    <desc>Ένα γραφικό στοιχείο που κρατά γραφικά στοιχεία GtkMenuItem</desc>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Ελληνική μεταφραστική ομάδα GNOME</mal:name>

      <mal:email>team@gnome.gr</mal:email>

      <mal:years>2012-2015</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Δημήτρης Σπίγγος</mal:name>

      <mal:email>dmtrs32@gmail.com</mal:email>

      <mal:years>2012, 2013</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Μαρία Θουκιδίδου</mal:name>

      <mal:email>marablack3@gmail.com</mal:email>

      <mal:years>2014</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Θάνος Τρυφωνίδης</mal:name>

      <mal:email>tomtryf@gmail.com</mal:email>

      <mal:years>2014, 2015</mal:years>

    </mal:credit>

  </info>

  <title>Μια γραμμή μενού δημιουργήθηκε χρησιμοποιώντας XML και GtkBuilder</title>

  <media type="image" mime="image/png" src="media/menubar.png"/>

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

  <links type="section"/>

  <section id="xml"> <title>Δημιουργήστε μια γραμμή μενού χρησιμοποιώντας XML</title>

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

   <steps>

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

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

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

     </item>

    <item>
Θέλουμε να δημιουργήσουμε τη διεπαφή που θα περιέχει τη γραμμή μενού μας και τα υπομενού της. Η γραμμή μενού μας θα περιέχει τα υπομενού <gui>Αρχείο</gui>, <gui>Επεξεργασία</gui>, <gui>Επιλογές</gui> και <gui>Βοήθεια</gui>. Προσθέτουμε τον ακόλουθο κώδικα 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>

     </item>

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

   </steps>

   </section>

   <section id="basis"> <title>Προσθέστε τη MenuBar στο παράθυρο χρησιμοποιώντας GtkBuilder</title>

from gi.repository import Gtk

import sys

class MyWindow(Gtk.ApplicationWindow):

    def __init__(self, app):

        Gtk.Window.__init__(self, title="MenuBar Example", application=app)

        self.set_default_size(200, 200)

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)

        # a builder to add the UI designed with Glade to the grid:

        builder = Gtk.Builder()

        # get the file (if it is there)

        try:

            builder.add_from_file("menubar_basis.ui")

        except:

            print("file not found")

            sys.exit()

        # we use the method Gtk.Application.set_menubar(menubar) to add the menubar

        # to the application (Note: NOT the window!)

        self.set_menubar(builder.get_object("menubar"))

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

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

</section>

<section id="xml2"> <title>Προσθήκη στοιχείων στα μενού</title>

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

   <listing>

      <title>menubar.ui</title>

<?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>

</listing>

  
Ακολουθώντας αυτό το μοτίβο, μπορείτε τώρα να προσθέσετε ένα στοιχείο Copy και ένα Paste στο υπομενού Edit και ένα στοιχείο About στο υπομενού Help.

  </section>

  <section id="actions">

    <title>Εγκατάσταση ενεργειών</title>

    
Τώρα δημιουργούμε τις ενέργειες για "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)

    
Δείτε <link xref="signals-callbacks.py"/> για μια πιο λεπτομερή εξήγηση των σημάτων και επανακλήσεων.
 

  </section>

  <section id="win-app"><title>Ενέργειες: εφαρμογή ή παράθυρο;</title>

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

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

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

  </section>

  <section id="choices">

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

    <media type="image" mime="image/png" src="media/menubar_choices.png"/>

    
Οι γραμμές 30 έως 80 συμπεριλαμβανόμενης της εμφάνισης <link xref="menubar.py#xml-code"/> του χρησιμοποιούμενου κώδικα XML για δημιουργία της UI για το μενού <gui>επιλογές</gui>.

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

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

    
όπου οι μεταβλητές της μεθόδου είναι: όνομα, τύπος παραμέτρου (σε αυτήν την περίπτωση, μια συμβολοσειρά - δείτε <link href="http://developer.gnome.org/glib/unstable/glib-GVariantType.html">εδώ</link> για μια πλήρη λίστα σημασιών χαρακτήρα), αρχικής κατάστασης (σε αυτήν την περίπτωση, 'line' - σε περίπτωση μιας True τιμής Μπουλ θα πρέπει να είναι Glib.Variant.new_boolean(True), κ.ο.κ, δείτε <link href="http://developer.gnome.org/glib/unstable/glib-GVariant.html">εδώ</link> για μια πλήρη λίστα)

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

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

self.add_action(shape_action)

  </section>

  <section id="xml-code">

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

    <?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>

  </section>

  <section id="python-code">

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

    from gi.repository import Gtk

from gi.repository import GLib

from gi.repository import Gio

import sys

class MyWindow(Gtk.ApplicationWindow):

    def __init__(self, app):

        Gtk.Window.__init__(self, title="MenuBar Example", application=app)

        self.set_default_size(200, 200)

        # action without a state created (name, parameter type)

        copy_action = Gio.SimpleAction.new("copy", None)

        # connected with the callback function

        copy_action.connect("activate", self.copy_callback)

        # added to the window

        self.add_action(copy_action)

        # action without a state created (name, parameter type)

        paste_action = Gio.SimpleAction.new("paste", None)

        # connected with the callback function

        paste_action.connect("activate", self.paste_callback)

        # added to the window

        self.add_action(paste_action)

        # action with a state created (name, parameter type, initial state)

        shape_action = Gio.SimpleAction.new_stateful(

            "shape", GLib.VariantType.new('s'), GLib.Variant.new_string('line'))

        # connected to the callback function

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

        # added to the window

        self.add_action(shape_action)

        # action with a state created

        about_action = Gio.SimpleAction.new("about", None)

        # action connected to the callback function

        about_action.connect("activate", self.about_callback)

        # action added to the application

        self.add_action(about_action)

    # callback function for copy_action

    def copy_callback(self, action, parameter):

        print("\"Copy\" activated")

    # callback function for paste_action

    def paste_callback(self, action, parameter):

        print("\"Paste\" activated")

    # callback function for shape_action

    def shape_callback(self, action, parameter):

        print("Shape is set to", parameter.get_string())

        # Note that we set the state of the action!

        action.set_state(parameter)

    # callback function for about (see the AboutDialog example)

    def about_callback(self, action, parameter):

        # a  Gtk.AboutDialog

        aboutdialog = Gtk.AboutDialog()

        # lists of authors and documenters (will be used later)

        authors = ["GNOME Documentation Team"]

        documenters = ["GNOME Documentation Team"]

        # we fill in the aboutdialog

        aboutdialog.set_program_name("MenuBar Example")

        aboutdialog.set_copyright(

            "Copyright \xc2\xa9 2012 GNOME Documentation Team")

        aboutdialog.set_authors(authors)

        aboutdialog.set_documenters(documenters)

        aboutdialog.set_website("http://developer.gnome.org")

        aboutdialog.set_website_label("GNOME Developer Website")

        # to close the aboutdialog when "close" is clicked we connect the

        # "response" signal to on_close

        aboutdialog.connect("response", self.on_close)

        # show the aboutdialog

        aboutdialog.show()

    # a callback function to destroy the aboutdialog

    def on_close(self, action, parameter):

        action.destroy()

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):

        # FIRST THING TO DO: do_startup()

        Gtk.Application.do_startup(self)

        # action without a state created

        new_action = Gio.SimpleAction.new("new", None)

        # action connected to the callback function

        new_action.connect("activate", self.new_callback)

        # action added to the application

        self.add_action(new_action)

        # action without a state created

        quit_action = Gio.SimpleAction.new("quit", None)

        # action connected to the callback function

        quit_action.connect("activate", self.quit_callback)

        # action added to the application

        self.add_action(quit_action)

        # action with a state created

        state_action = Gio.SimpleAction.new_stateful(

            "state",  GLib.VariantType.new('s'), GLib.Variant.new_string('off'))

        # action connected to the callback function

        state_action.connect("activate", self.state_callback)

        # action added to the application

        self.add_action(state_action)

        # action with a state created

        awesome_action = Gio.SimpleAction.new_stateful(

            "awesome", None, GLib.Variant.new_boolean(False))

        # action connected to the callback function

        awesome_action.connect("activate", self.awesome_callback)

        # action added to the application

        self.add_action(awesome_action)

        # a builder to add the UI designed with Glade to the grid:

        builder = Gtk.Builder()

        # get the file (if it is there)

        try:

            builder.add_from_file("menubar.ui")

        except:

            print("file not found")

            sys.exit()

        # we use the method Gtk.Application.set_menubar(menubar) to add the menubar

        # and the menu to the application (Note: NOT the window!)

        self.set_menubar(builder.get_object("menubar"))

        self.set_app_menu(builder.get_object("appmenu"))

    # callback function for new

    def new_callback(self, action, parameter):

        print("You clicked \"New\"")

    # callback function for quit

    def quit_callback(self, action, parameter):

        print("You clicked \"Quit\"")

        sys.exit()

    # callback function for state

    def state_callback(self, action, parameter):

        print("State is set to", parameter.get_string())

        action.set_state(parameter)

    # callback function for awesome

    def awesome_callback(self, action, parameter):

        action.set_state(GLib.Variant.new_boolean(not action.get_state()))

        if action.get_state().get_boolean() is True:

            print("You checked \"Awesome\"")

        else:

            print("You unchecked \"Awesome\"")

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

  </section>

  <section id="mnemonics-and-accelerators"><title>Μνημονικές και επιταχυντές</title>

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

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

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

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

<item>

  <attribute name="label">_Quit</attribute>

  <attribute name="action">app.quit</attribute>

  <attribute name="accel">&lt;Primary&gt;q</attribute>

</item>

  </section>

  <section id="translatable"><title>Μεταφράσιμες συμβολοσειρές</title>

   
Επειδή οι εφαρμογές GNOME μεταφράζονται σε <link href="http://l10n.gnome.org/languages/">πολλές γλώσσες</link>, είναι σημαντικό ότι οι συμβολοσειρές στην εφαρμογή σας είναι μεταφράσιμες. Για να κάνετε μια ετικέτα μεταφράσιμη, απλά βάλτε translatable="yes":

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

  </section>

  <section id="references">

    <title>Αναφορές API</title>

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

    <list>

      <item>
<link href="http://developer.gnome.org/gio/unstable/GSimpleAction.html">GSimpleAction</link>
</item>

      <item>
<link href="http://developer.gnome.org/gtk3/unstable/GtkBuilder.html">GtkBuilder</link>
</item>

    </list>

  </section>

</page>