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

  <info>

    <title type="text">Η εργαλειοθήκη δημιουργήθηκε χρησιμοποιώντας Glade (Python)</title>

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

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

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

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

    <revision version="0.1" date="2012-07-17" status="draft"/>

    <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 edit">

      <name>Marta Maria Casetti</name>

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

      <years>2012</years>

    </credit>

    <credit type="author copyright">

      <name>Sebastian Pölsterl</name>

      <email its:translate="no">sebp@k-d-w.org</email>

      <years>2011</years>

    </credit>

    <desc>Μια γραμμή κουμπιών και άλλα γραφικά στοιχεία</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>Η γραμμή εργαλείων δημιουργήθηκε χρησιμοποιώντας Glade</title>

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

  
Αυτό το παράδειγμα είναι παρόμοιο με <link xref="toolbar.py"/>, εκτός από τη χρήση Glade για δημιουργία της εργαλειοθήκης σε ένα αρχείο XML .ui.

<links type="sections"/>

<section id="glade">

<title>Δημιουργία της εργαλειοθήκης με Glade</title>

  
Για δημιουργία της γραμμής εργαλείων χρησιμοποιώντας το <link href="http://glade.gnome.org/">σχεδιαστή διεπαφής Glade</link>:

  <steps>

    <item>
Άνοιγμα του Glade και αποθήκευση του αρχείου ως <file>toolbar_builder.ui</file>

          
<media type="image" src="media/glade_ui.png" width="900"> Στιγμιότυπο διεπαφής του Glade </media>

    </item>

    <item>
Στο <gui>περιέκτες</gui> στα αριστερά, δεξί πάτημα στην εργαλειοθήκη και επιλογή <gui>προσθήκη γραφικού στοιχείου ως ανώτατου επιπέδου</gui>.

          
<media type="image" src="media/glade_select_toolbar.png"> Στιγμιότυπο του εικονιδίου εργαλειοθήκης στο Glade ui </media>

    </item>

    <item>
Στην καρτέλα <gui>γενικά</gui> στα κάτω δεξιά, αλλαγή του <gui>ονόματος</gui> σε <input>γραμμή εργαλείων</input> και <gui>εμφάνιση βέλους</gui> σε <gui>όχι</gui>.

          
<media type="image" src="media/glade_toolbar_general.png"> Στιγμιότυπο της καρτέλας Γενικά</media>

    </item>

    <item>
Στην καρτέλα <gui>κοινά</gui>, ορίστε <gui>οριζόντια επέκταση</gui> σε <gui>ναι</gui>.

         
<media type="image" src="media/glade_toolbar_common.png"> Στιγμιότυπο της καρτέλας Κοινά </media>

     </item>

     <item>
Δεξί κλικ στη γραμμή εργαλείων στα πάνω δεξιά και επιλέξτε <gui>επεξεργασία</gui>. Το παράθυρο <gui>επεξεργαστής γραμμής εργαλείων</gui> θα εμφανιστεί.

         
<media type="image" src="media/glade_toolbar_edit.png"> Στιγμιότυπο πού να δεξιοπατήσετε για να επεξεργαστείτε την εργαλειοθήκη. </media>

   </item>

   <item>
Θέλουμε να προσθέσουμε 5 κουμπιά εργαλείων: νέο, άνοιγμα, αναίρεση, πλήρης οθόνη και εγκατάλειψη πλήρους οθόνης. Πρώτα, θα προσθέσουμε το νέο ToolButton.

     <steps>

       <item>
Στην καρτέλα <gui>ιεραρχία</gui>, πατήστε <gui>προσθήκη</gui>.
</item>

       <item>
Αλλαγή του ονόματος του στοιχείου εργαλείου σε <input>new_button</input>.
</item>

       <item>
Κύλιση προς τα κάτω και ρύθμιση του <gui>είναι σημαντικό</gui> σε <gui>ναι</gui>. Αυτό θα προκαλέσει την ετικέτα του ToolButton να εμφανιστεί, όταν προβάλετε τη γραμμή εργαλείων.
</item>

       <item>
Εισάγετε το <gui>όνομα ενέργειας</gui>: <input>app.new</input>.
</item>

       <item>
Αλλαγή του <gui>ετικέτα</gui> σε <input>New</input>.
</item>

       <item>
Επιλογή του <gui>νέου</gui> αναγνωριστικού παρακαταθήκης από το πτυσσόμενο μενού, ή πληκτρολογήστε <input>gtk-new</input>.
</item>

     </steps>

     
Επανάληψη των παραπάνω βημάτων για τα υπολειπόμενα κουμπιά εργαλείων (ToolButtons), με τις παρακάτω ιδιότητες:

        
Όνομα

        
Είναι σημαντικό

        
Όνομα ενέργειας

        
Ετικέτα

        
Αναγνωριστικό παρακαταθήκης

      
open_button

      
Ναι

      
app.open

      
Open

      
gtk-open

      
undo_button

      
Ναι

      
win.undo

      
Αναίρεση

      
gtk-undo

      
fullscreen_button

      
Ναι

      
win.fullscreen

      
Πλήρης οθόνη

      
gtk-fullscreen

      
leave_fullscreen_button

      
Ναι

      
win.fullscreen

      
Έξοδος από πλήρη οθόνη

      
gtk-leave-fullscreen

          <media type="image" src="media/glade_toolbar_editor.png">

          </media>

    </item>

    <item>
Κλείσιμο του <gui>επεξεργαστή γραμμής εργαλείων</gui>.

   </item>

   <item>
Όταν το πρόγραμμά μας θα ξεκινήσει στην αρχή, δεν θέλουμε το κουμπί εργαλείου (ToolButton) <gui>Έξοδος από πλήρη οθόνη</gui> να είναι ορατό, αφού η εφαρμογή δεν θα είναι σε λειτουργία πλήρους οθόνης. Μπορείτε να το ρυθμίσετε στην καρτέλα <gui>κοινά</gui>, πατώντας στην ιδιότητα <gui>ορατό</gui> σε <gui>όχι</gui>. Το κουμπί εργαλείου θα εξακολουθεί να εμφανίζεται στον σχεδιαστή διεπαφής, αλλά θα συμπεριφέρεται σωστά, όταν το αρχείο φορτώνεται στον κώδικα προγράμματός σας. Σημειώστε ότι η μέθοδος show_all() θα αντικαταστήσει αυτή τη ρύθμιση - έτσι στον κώδικα πρέπει να χρησιμοποιήσουμε show() ξεχωριστά σε όλα τα στοιχεία.

          
<media type="image" src="media/glade_visible_no.png"> Ορισμός της ιδιότητας ορατό σε Όχι </media>

   </item>

    <item>
Αποθήκευση της εργασίας σας και κλείσιμο του Glade.

   </item>

   <item>
Το δημιουργημένο αρχείο XML από το Glade εμφανίζεται παρακάτω. Αυτή είναι η περιγραφή της εργαλειοθήκης. Τη στιγμή της εγγραφής, η επιλογή προσθήκης στην κλάση Gtk.STYLE_CLASS_PRIMARY_TOOLBAR στην διεπαφή Glade δεν υπάρχει. Μπορούμε χειροκίνητα να το προσθέσουμε στο αρχείο XML. Για να το κάνουμε, προσθέστε τον παρακάτω κώδικα XML στη γραμμή 9 του <file>toolbar_builder.ui</file>:

  <style>

     <class name="primary-toolbar"/>

  </style>

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

   </item>

</steps>

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

<interface>

  <!-- interface-requires gtk+ 3.0 -->

  <object class="GtkToolbar" id="toolbar">

    <property name="visible">True</property>

    <property name="can_focus">False</property>

    <property name="hexpand">True</property>

    <property name="show_arrow">False</property>

    <child>

      <object class="GtkToolButton" id="new_button">

        <property name="use_action_appearance">False</property>

        <property name="visible">True</property>

        <property name="can_focus">False</property>

        <property name="use_action_appearance">False</property>

        <property name="is_important">True</property>

        <property name="action_name">app.new</property>

        <property name="label" translatable="yes">New</property>

        <property name="use_underline">True</property>

        <property name="stock_id">gtk-new</property>

      </object>

      <packing>

        <property name="expand">False</property>

        <property name="homogeneous">True</property>

      </packing>

    </child>

    <child>

      <object class="GtkToolButton" id="open_button">

        <property name="use_action_appearance">False</property>

        <property name="visible">True</property>

        <property name="can_focus">False</property>

        <property name="use_action_appearance">False</property>

        <property name="is_important">True</property>

        <property name="action_name">app.open</property>

        <property name="label" translatable="yes">Open</property>

        <property name="use_underline">True</property>

        <property name="stock_id">gtk-open</property>

      </object>

      <packing>

        <property name="expand">False</property>

        <property name="homogeneous">True</property>

      </packing>

    </child>

    <child>

      <object class="GtkToolButton" id="undo_button">

        <property name="use_action_appearance">False</property>

        <property name="visible">True</property>

        <property name="can_focus">False</property>

        <property name="use_action_appearance">False</property>

        <property name="is_important">True</property>

        <property name="action_name">win.undo</property>

        <property name="label" translatable="yes">Undo</property>

        <property name="use_underline">True</property>

        <property name="stock_id">gtk-undo</property>

      </object>

      <packing>

        <property name="expand">False</property>

        <property name="homogeneous">True</property>

      </packing>

    </child>

    <child>

      <object class="GtkToolButton" id="fullscreen_button">

        <property name="use_action_appearance">False</property>

        <property name="visible">True</property>

        <property name="can_focus">False</property>

        <property name="use_action_appearance">False</property>

        <property name="is_important">True</property>

        <property name="action_name">win.fullscreen</property>

        <property name="label" translatable="yes">Fullscreen</property>

        <property name="use_underline">True</property>

        <property name="stock_id">gtk-fullscreen</property>

      </object>

      <packing>

        <property name="expand">False</property>

        <property name="homogeneous">True</property>

      </packing>

    </child>

    <child>

      <object class="GtkToolButton" id="leave_fullscreen_button">

        <property name="use_action_appearance">False</property>

        <property name="can_focus">False</property>

        <property name="use_action_appearance">False</property>

        <property name="is_important">True</property>

        <property name="action_name">win.fullscreen</property>

        <property name="label" translatable="yes">Leave Fullscreen</property>

        <property name="use_underline">True</property>

        <property name="stock_id">gtk-leave-fullscreen</property>

      </object>

      <packing>

        <property name="expand">False</property>

        <property name="homogeneous">True</property>

      </packing>

    </child>

  </object>

</interface>

</section>

<section id="code">

<title>Ο χρησιμοποιούμενος κώδικας για παραγωγή αυτού παραδείγματος</title>

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

from gi.repository import Gtk

from gi.repository import Gdk

from gi.repository import Gio

import sys

class MyWindow(Gtk.ApplicationWindow):

    def __init__(self, app):

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

        self.set_default_size(400, 200)

        # a grid to attach the toolbar (see below)

        grid = Gtk.Grid()

        self.add(grid)

        # we have to show the grid (and therefore the toolbar) with show(),

        # as show_all() would show also the buttons in the toolbar that we want to

        # be hidden (such as the leave_fullscreen button)

        grid.show()

        # 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("toolbar_builder.ui")

        except:

            print("file not found")

            sys.exit()

        # and attach it to the grid

        grid.attach(builder.get_object("toolbar"), 0, 0, 1, 1)

        # two buttons that will be used later in a method

        self.fullscreen_button = builder.get_object("fullscreen_button")

        self.leave_fullscreen_button = builder.get_object(

            "leave_fullscreen_button")

        # create the actions that control the window, connect their signal to a

        # callback method (see below), add the action to the window:

        # undo

        undo_action = Gio.SimpleAction.new("undo", None)

        undo_action.connect("activate", self.undo_callback)

        self.add_action(undo_action)

        # and fullscreen

        fullscreen_action = Gio.SimpleAction.new("fullscreen", None)

        fullscreen_action.connect("activate", self.fullscreen_callback)

        self.add_action(fullscreen_action)

    # callback for undo

    def undo_callback(self, action, parameter):

        print("You clicked \"Undo\".")

    # callback for fullscreen

    def fullscreen_callback(self, action, parameter):

        # check if the state is the same as Gdk.WindowState.FULLSCREEN, which

        # is a bit flag

        is_fullscreen = self.get_window().get_state(

        ) & Gdk.WindowState.FULLSCREEN != 0

        if is_fullscreen:

            self.unfullscreen()

            self.leave_fullscreen_button.hide()

            self.fullscreen_button.show()

        else:

            self.fullscreen()

            self.fullscreen_button.hide()

            self.leave_fullscreen_button.show()

class MyApplication(Gtk.Application):

    def __init__(self):

        Gtk.Application.__init__(self)

    def do_activate(self):

        win = MyWindow(self)

        # show the window - with show() not show_all() because that would show also

        # the leave_fullscreen button

        win.show()

    def do_startup(self):

        Gtk.Application.do_startup(self)

        # actions that control the application: create, connect their signal to a

        # callback method (see below), add the action to the application

        # new

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

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

        app.add_action(new_action)

        # open

        open_action = Gio.SimpleAction.new("open", None)

        open_action.connect("activate", self.open_callback)

        app.add_action(open_action)

    # callback for new

    def new_callback(self, action, parameter):

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

    # callback for open

    def open_callback(self, action, parameter):

        print("You clicked \"Open\".")

app = MyApplication()

exit_status = app.run(sys.argv)

sys.exit(exit_status)

</section>

<section id="methods">

<title>Χρήσιμες μέθοδοι για Gtk.Builder</title>

Για τις χρήσιμες μεθόδους για ένα γραφικό στοιχείο εργαλειοθήκης, δείτε <link xref="toolbar.py"/>

Το Gtk.Builder κατασκευάζει μια διεπαφή από έναν ορισμό UI XML.

<list>

<item>
Η add_from_file(filename) φορτώνει και αναλύει το δεδομένο αρχείο και το συγχωνεύει με τα τρέχοντα περιεχόμενα του Gtk.Builder.
</item>

<item>
Η add_from_file(string) φορτώνει την δεδομένη συμβολοσειρά και το συγχωνεύει με τα τρέχοντα περιεχόμενα του Gtk.Builder.
</item>

<item>
Η add_objects_from_file(filename, object_ids) είναι η ίδια με add_from_file(), αλλά φορτώνει μόνο τα αντικείμενα με τις ταυτότητες που δίνονται στη λίστα object_id.
</item>

<item>
Το add_objects_from_string(string, object_ids) είναι ίδιο με το add_from_string(), αλλά φορτώνει μόνο τα αντικείμενα με τα αναγνωριστικά που δόθηκαν στη λίστα object_ids.
</item>

<item>
Η get_object(object_id) ανακτά το γραφικό στοιχείο με την ταυτότητα object_id από τα φορτωμένα αντικείμενα του δομητή.
</item>

<item>
Η get_objects() επιστρέφει όλα τα φορτωμένα αντικείμενα.
</item>

<item>
Το connect_signals(handler_object) συνδέει τα σήματα στις μεθόδους που δίνονται στον handler_object. Αυτό μπορεί να είναι οποιοδήποτε αντικείμενο περιέχει κλειδιά ή γνωρίσματα που καλούνται όπως τα ονόματα χειριστή σήματος που δίνονται στην περιγραφή διεπαφής, π.χ. μια κλάση ή ένα λεξικό. Στη γραμμή 39 το σήμα "activate" από την ενέργεια undo_action συνδέεται σε μια συνάρτηση επανάκλησης undo_callback() χρησιμοποιώντας action.connect(signal, callback function). Δείτε <link xref="signals-callbacks.py"/> για μια πιο λεπτομερή εξήγηση.

</item>

</list>

</section>

<section id="references">

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

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

<list>

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

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

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

  <item>
<link href="http://developer.gnome.org/gdk3/unstable/gdk3-Event-Structures.html#GdkEventWindowState">Δομή γεγονότων</link>
</item>

</list>

</section>

</page>