<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:xi="http://www.w3.org/2001/XInclude" type="guide" style="task" id="filechooserdialog.py" xml:lang="el">
  <info>
    <title type="text">FileChooserDialog (Python)</title>
    <link type="guide" xref="beginner.py#file-selectors"/>
    <link type="seealso" xref="gmenu.py"/>
    <link type="seealso" xref="toolbar_builder.py"/>
    <link type="seealso" xref="textview.py"/>
    <revision version="0.1" date="2012-08-14" status="draft"/>

    <credit type="author copyright">
      <name>Marta Maria Casetti</name>
      <email>mmcasetti@gmail.com</email>
      <years>2012</years>
    </credit>

    <desc>Ένας διάλογος κατάλληλος για τις εντολές "Open" και "Save"</desc>
  </info>

  <title>FileChooserDialog</title>
  <media type="image" mime="image/png" src="media/filechooserdialog_save.png"/>
  <p>Αυτός ο FileChooserDialog αποθηκεύει ένα έγγραφο κειμένου, που μπορεί να ανοιχτεί ή να γραφτεί από την αρχή σε μια TextView (δείτε παρακάτω).</p>
  <media type="image" mime="image/png" src="media/filechooserdialog_menu.png"/>
  <p>Είναι επίσης πιθανό να καλείτε έναν FileChooserDialog για να ανοίξετε ένα νέο έγγραφο.</p>

  <links type="sections"/>
  
  <section id="overview">
  <title>Βήματα για αναδημιουργία του παραδείγματος</title>
  <steps>
    <item><p>Δημιουργήστε ένα αρχείο .ui για να περιγράψετε ένα μενού εφαρμογών με στοιχεία "New", "Open", "Save", "Save as" και "Quit". Αυτό μπορεί να γίνει με Glade ή έναν επεξεργαστή κειμένου. Δείτε <link xref="#xml"/></p></item>
    <item><p>Δημιουργήστε ένα πρόγραμμα Python για μία Gtk.TextView με μια Gtk.Buffer <code>self.buffer</code> και ένα <code>self.file</code> που θα είναι ένα Gio.File και το ορίζουμε αρχικά ως <code>None</code>.</p></item>
    <item><p>Σε αυτό το πρόγραμμα, δημιουργήστε επίσης τις ενέργειες που αντιστοιχούν στα στοιχεία στο μενού εφαρμογών, συνδέστε τα στις συναρτήσεις επανάκλησης και εισάγετε το μενού στη μέθοδο <code>do_startup()</code> με ένα Gtk.Builder.</p></item>
    <item><p>Οι ενέργειες "New" και "Quit" και οι συναρτήσεις επανάκλησης είναι αρκετά απλές, δείτε <link xref="#code"/>.</p></item>
    <item><p>Η επανάκληση "Open" πρέπει να δημιουργεί και να ανοίγει έναν Gtk.FileChooserDialog για "Open", συνδεμένο με μια άλλη συνάρτηση επανάκλησης για κάθε κουμπί από τα δύο "Open" και "Cancel" του FileChooserDialog.</p></item>
    <item><p>Η "Save as" δουλεύει βασικά ως "Open", αλλά η συνάρτηση επανάκλησης του κουμπιού "Save" εξαρτάται από μια πιο σύνθετη μέθοδο <code>save_to_file()</code>.</p></item>
    <item><p>Η "Save" μπορεί να αναχθεί σε περίπτωση όπου το αρχείο είναι <code>None</code>, δηλαδή η περίπτωση όπου <code>self.file</code> είναι ένα νέο αρχείο, που με τη σειρά του είναι η περίπτωση "Save as"· και στην περίπτωση όπου το αρχείο δεν είναι <code>None</code>, που με τη σειρά του ανάγεται σε to <code>save_to_file()</code>.</p></item>
    <item><p>Τελικά, η μέθοδος <code>save_to_file()</code>: δείτε <link xref="#code"/>, γραμμές 146 - 175.</p></item>
  </steps>
  </section>
  
  <section id="xml">
  <title>Το αρχείο XML που δημιουργεί το μενού εφαρμογών</title>
  <code mime="application/xml" style="numbered"><xi:include href="samples/filechooserdialog.ui" parse="text"><xi:fallback/></xi:include></code>
  </section>
  
  <section id="code">
  <title>Ο χρησιμοποιούμενος κώδικας για παραγωγή αυτού παραδείγματος</title>
  <code mime="text/x-python" style="numbered"><xi:include href="samples/filechooserdialog.py" parse="text"><xi:fallback/></xi:include></code>
  </section>
  
  <section id="methods">
  <title>Χρήσιμες μέθοδοι για ένα FileChooserDialog</title>
    <p>Σημειώστε ότι η ενέργεια του FileChooserDialog μπορεί να είναι μία από τις ακόλουθες: <code>Gtk.FileChooserAction.OPEN</code> (ο επιλογέας αρχείου θα επιτρέψει μόνο ο χρήστης να επιλέξει ένα υπάρχον αρχείο) <code>Gtk.FileChooserAction.SAVE</code> (ο επιλογέας αρχείου θα επιτρέψει στον χρήστη να επιλέξει ένα υπάρχον αρχείο, ή τύπο σε ένα νέο όνομα αρχείου), <code>Gtk.FileChooserAction.SELECT_FOLDER</code> (ο επιλογέας αρχείου θα επιτρέψει στον χρήστη να επιλέξει έναν υπάρχοντα φάκελο), <code>Gtk.FileChooserAction.CREATE_FOLDER</code> (ο επιλογέας αρχείου θα επιτρέψει στον χρήστη να ονομάσει έναν υπάρχοντα ή νέο φάκελο).</p>
    <p>Εκτός από τις χρησιμοποιούμενες μεθόδους στο <link xref="#code"/>, έχουμε:</p>
    <list>
      <item><p><code>set_show_hidden(True)</code> χρησιμοποιείται για προβολή κρυφών αρχείων και φακέλων.</p></item>
      <item><p>Ο <code>set_select_multiple(True)</code> ορίζει ότι πολλά αρχεία μπορούν να επιλεγούν. Αυτό είναι κατάλληλο μόνο εάν η κατάσταση είναι <code>Gtk.FileChooserAction.OPEN</code> ή <code>Gtk.FileChooserAction.SELECT_FOLDER</code>.</p></item>
      <item><p>Σε έναν διάλογο "Save as", ο <code>set_current_name(current_name)</code> ορίζει το <code>current_name</code> στον επιλογέα αρχείου, σαν να εισαγόταν από τον χρήστη· το <code>current_name</code> μπορεί να είναι κάτι σαν <em>άτιτλο.txt</em>. Αυτή η μέθοδος δεν πρέπει να χρησιμοποιηθεί εκτός από έναν διάλογο "Save as".</p></item>
      <item><p>Ο προεπιλεγμένος τρέχον φάκελος είναι "recent items". Για τον ορισμό άλλου φακέλου χρησιμοποιήστε <code>set_current_folder_uri(uri)</code>· αλλά σημειώστε ότι θα πρέπει να χρησιμοποιήσετε αυτήν τη μέθοδο και να προκαλέσετε τον επιλογέα αρχείου να εμφανίσει έναν συγκεκριμένο φάκελο μόνο όταν εκτελείτε μια εντολή "Save as" και έχετε ήδη ένα αρχείο αποθηκευμένο κάπου.</p></item>
    </list>
  </section>

  <section id="references">
  <title>Αναφορές API</title>
  <p>Σε αυτό το παράδειγμα χρησιμοποιήσαμε τα παρακάτω:</p>
  <list>
    <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkFileChooserDialog.html">GtkFileChooserDialog</link></p></item>
    <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkFileChooser.html">GtkFileChooser</link></p></item>
    <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkWindow.html">GtkWindow</link></p></item>
    <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkTextView.html">GtkTextView</link></p></item>
    <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkTextBuffer.html">GtkTextBuffer</link></p></item>
    <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkScrolledWindow.html">GtkScrolledWindow</link></p></item>
    <item><p><link href="http://developer.gnome.org/gio/stable/GFile.html">GFile</link></p></item>
    <item><p><link href="http://developer.gnome.org/gio/stable/GSimpleAction.html">GSimpleAction</link></p></item>
    <item><p><link href="http://developer.gnome.org/gtk3/stable/GtkBuilder.html">GtkBuilder</link></p></item>
  </list>
  </section>
</page>
