Περιέκτες μοναδικού στοιχείου

Τα γραφικά συστατικά περιέκτη μοναδικού στοιχείου παράγονται από Gtk::Bin, που παρέχει τις μεθόδους add() και remove() για το θυγατρικό γραφικό συστατικό. Σημειώστε ότι, οι Gtk::Button και Gtk::Window είναι τεχνικά περιέκτες μοναδικού στοιχείου, αλλά το έχουμε ήδη συζητήσει αλλού.

Θα συζητήσουμε επίσης το γραφικό συστατικό Gtk::Paned, που επιτρέπει τη διαίρεση ενός παραθύρου σε δύο ξεχωριστά "φατνώματα". Αυτό το γραφικό συστατικό στην πραγματικότητα περιέχει δύο θυγατρικά γραφικά συστατικά, αλλά ο αριθμός ορίστηκε έτσι ώστε να φαίνεται κατάλληλος.

8.1.1. Σκελετός (frame)

Οι σκελετοί (Frames) μπορούν να περικλείουν ένα ή μια ομάδα γραφικών συστατικών μέσα σε ένα πλαίσιο, προαιρετικά με τίτλο. Για παράδειγμα, μπορείτε να βάλετε μια ομάδα RadioButtons ή CheckButtons σε μια Frame.

Reference

8.1.1.1. Παράδειγμα

Φιγούρα 8-1 Σκελετός (frame)

Source Code

File: examplewindow.h (For use with gtkmm 3, not gtkmm 2) 

#ifndef GTKMM_EXAMPLEWINDOW_H
#define GTKMM_EXAMPLEWINDOW_H

#include <gtkmm.h>

class ExampleWindow : public Gtk::Window
{
public:
  ExampleWindow();
  virtual ~ExampleWindow();

protected:

  //Child widgets:
  Gtk::Frame m_Frame;
};

#endif //GTKMM_EXAMPLEWINDOW_H

File: examplewindow.cc (For use with gtkmm 3, not gtkmm 2) 

#include "examplewindow.h"

ExampleWindow::ExampleWindow()
{
 /* Set some window properties */
  set_title("Frame Example");
  set_size_request(300, 300);

  /* Sets the border width of the window. */
  set_border_width(10);

  add(m_Frame);

  /* Set the frames label */
  m_Frame.set_label("Gtk::Frame Widget");

  /* Align the label at the right of the frame */
  //m_Frame.set_label_align(Gtk::ALIGN_END, Gtk::ALIGN_START);

  /* Set the style of the frame */
  m_Frame.set_shadow_type(Gtk::SHADOW_ETCHED_OUT);

  show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

File: main.cc (For use with gtkmm 3, not gtkmm 2) 

#include "examplewindow.h"
#include <gtkmm/application.h>

int main(int argc, char *argv[])
{
  Glib::RefPtr<Gtk::Application> app = Gtk::Application::create(argc, argv, "org.gtkmm.example");

  ExampleWindow window;

  //Shows the window and returns when it is closed.
  return app->run(window);
}

8.1.2. Με φατνώματα (Paned)

Τα φατνώματα (Panes) διαιρούν ένα γραφικό συστατικό σε δύο μισά, που χωρίζονται από ένα μετακινήσιμο χώρισμα. Τα δύο μισά (φατνώματα) μπορούν να προσανατολιστούν ή οριζόντια (πλάι-πλάι) ή κάθετα (το ένα πάνω από το άλλο).

Αντίθετα με τα άλλα γραφικά συστατικά σε αυτήν την ενότητα, τα γραφικά συστατικά φατνωμάτων (pane) δεν περιέχουν ένα αλλά δύο θυγατρικά γραφικά συστατικά, ένα σε κάθε φάτνωμα. Συνεπώς, θα πρέπει να χρησιμοποιήσετε add1() και add2() αντί για τη μέθοδο add().

Μπορείτε να ρυθμίσετε τη θέση του χωρίσματος χρησιμοποιώντας τη μέθοδο set_position() και θα χρειαστείτε προφανώς να το κάνετε.

Reference

8.1.2.1. Παράδειγμα

Φιγούρα 8-2 Με φατνώματα (Paned)

Source Code

File: examplewindow.h (For use with gtkmm 3, not gtkmm 2) 

#ifndef GTKMM_EXAMPLEWINDOW_H
#define GTKMM_EXAMPLEWINDOW_H

#include "messageslist.h"
#include "messagetext.h"
#include <gtkmm.h>

class ExampleWindow : public Gtk::Window
{
public:
  ExampleWindow();
  virtual ~ExampleWindow();

protected:

  //Child widgets:
  Gtk::Paned m_VPaned;
  MessagesList m_MessagesList;
  MessageText m_MessageText;
};

#endif //GTKMM_EXAMPLEWINDOW_H

File: messagetext.h (For use with gtkmm 3, not gtkmm 2) 

#ifndef GTKMM_EXAMPLE_MESSAGETEXT_H
#define GTKMM_EXAMPLE_MESSAGETEXT_H

#include <gtkmm.h>

class MessageText : public Gtk::ScrolledWindow
{
public:
  MessageText();
  virtual ~MessageText();

  void insert_text();

protected:
  Gtk::TextView m_TextView;
};

#endif //GTKMM_EXAMPLE_MESSAGETEXT_H

File: messageslist.h (For use with gtkmm 3, not gtkmm 2) 

#ifndef GTKMM_EXAMPLE_MESSAGESLIST_H
#define GTKMM_EXAMPLE_MESSAGESLIST_H

#include <gtkmm.h>

class MessagesList: public Gtk::ScrolledWindow
{
public:
  MessagesList();
  virtual ~MessagesList();

  class ModelColumns : public Gtk::TreeModel::ColumnRecord
  {
  public:

    ModelColumns()
    { add(m_col_text); }

    Gtk::TreeModelColumn<Glib::ustring> m_col_text;
  };

  ModelColumns m_Columns;

protected:
  Glib::RefPtr<Gtk::ListStore> m_refListStore; //The Tree Model.
  Gtk::TreeView m_TreeView; //The Tree View.
};
#endif //GTKMM_EXAMPLE_MESSAGESLIST_H

File: examplewindow.cc (For use with gtkmm 3, not gtkmm 2) 

#include "examplewindow.h"

ExampleWindow::ExampleWindow()
: m_VPaned(Gtk::ORIENTATION_VERTICAL)
{
  set_title ("Paned Windows");
  set_border_width(10);
  set_default_size(450, 400);

  /* Add a vpaned widget to our toplevel window */
  add(m_VPaned);

  /* Now add the contents of the two halves of the window */
  m_VPaned.add1(m_MessagesList);
  m_VPaned.add2(m_MessageText);

  show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

File: messageslist.cc (For use with gtkmm 3, not gtkmm 2) 

#include "messageslist.h"
#include <sstream>

MessagesList::MessagesList()
{
  /* Create a new scrolled window, with scrollbars only if needed */
  set_policy(Gtk::POLICY_AUTOMATIC, Gtk::POLICY_AUTOMATIC);

  add(m_TreeView);

  /* create list store */
  m_refListStore = Gtk::ListStore::create(m_Columns);

  m_TreeView.set_model(m_refListStore);

  /* Add some messages to the window */
  for(int i = 0; i < 10; ++i)
  {
    std::ostringstream text;
    text << "message #" << i;

    Gtk::TreeModel::Row row = *(m_refListStore->append());
    row[m_Columns.m_col_text] = text.str();
  }

  //Add the Model's column to the View's columns:
  m_TreeView.append_column("Messages", m_Columns.m_col_text);

  show_all_children();
}

MessagesList::~MessagesList()
{
}

File: main.cc (For use with gtkmm 3, not gtkmm 2) 

#include "examplewindow.h"
#include <gtkmm/application.h>

int main(int argc, char *argv[])
{
  Glib::RefPtr<Gtk::Application> app = Gtk::Application::create(argc, argv, "org.gtkmm.example");

  ExampleWindow window;

  //Shows the window and returns when it is closed.
  return app->run(window);
}

File: messagetext.cc (For use with gtkmm 3, not gtkmm 2) 

#include "messagetext.h"

MessageText::MessageText()
{
  set_policy(Gtk::POLICY_AUTOMATIC, Gtk::POLICY_AUTOMATIC);

  add(m_TextView);
  insert_text();

  show_all_children();
}

MessageText::~MessageText()
{
}

void MessageText::insert_text()
{
  Glib::RefPtr<Gtk::TextBuffer> refTextBuffer = m_TextView.get_buffer();

  Gtk::TextBuffer::iterator iter = refTextBuffer->get_iter_at_offset(0);
  refTextBuffer->insert(iter,
    "From: [email protected]\n"
    "To: [email protected]\n"
    "Subject: Made it!\n"
    "\n"
    "We just got in this morning. The weather has been\n"
    "great - clear but cold, and there are lots of fun sights.\n"
    "Sojourner says hi. See you soon.\n"
    " -Path\n");
}

8.1.3. Κυλιόμενο παράθυρο

Τα γραφικά συστατικά ScrolledWindow δημιουργούν μια κυλιόμενη περιοχή. Μπορείτε να εισάγετε οποιοδήποτε τύπο γραφικού συστατικού στο παράθυρο ScrolledWindow και θα είναι προσβάσιμο ανεξάρτητα από το μέγεθος του χρησιμοποιώντας τις γραμμές κύλισης. Σημειώστε ότι το ScrolledWindow δεν είναι μια Gtk::Window παρά το ελαφρώς παραπλανητικό όνομα.

Τα κυλιόμενα παράθυρα έχουν πολιτικές γραμμής κύλισης που προσδιορίζουν αν οι Scrollbars θα εμφανίζονται. Οι πολιτικές μπορούν να οριστούν με τη μέθοδο set_policy(). Η πολιτική μπορεί να είναι από τις Gtk::POLICY_AUTOMATIC ή Gtk::POLICY_ALWAYS. Το Gtk::POLICY_AUTOMATIC θα προκαλέσει στο κυλιόμενο παράθυρο να εμφανίζει τη γραμμή κύλισης μόνο αν το περιεχόμενο γραφικό συστατικό είναι μεγαλύτερο από την ορατή περιοχή. Το Gtk::POLICY_ALWAYS θα προκαλέσει στη γραμμή κύλισης να εμφανίζεται πάντα.

Reference

8.1.3.1. Παράδειγμα

Να ένα απλό παράδειγμα που πακετάρει 100 κουμπιά εναλλαγής σε ένα κυλιόμενο παράθυρο. Δοκιμάστε αυξομείωση του παραθύρου για να δείτε την αντίδραση των γραμμών κύλισης.

Φιγούρα 8-3 Κυλιόμενο παράθυρο

Source Code

File: examplewindow.h (For use with gtkmm 3, not gtkmm 2) 

#ifndef GTKMM_EXAMPLEWINDOW_H
#define GTKMM_EXAMPLEWINDOW_H

#include <gtkmm.h>

class ExampleWindow : public Gtk::Dialog
{
public:
  ExampleWindow();
  virtual ~ExampleWindow();

protected:
  //Signal handlers:
  void on_dialog_response(int response_id);

  //Child widgets:
  Gtk::ScrolledWindow m_ScrolledWindow;
  Gtk::Grid m_Grid;
};

#endif //GTKMM_EXAMPLEWINDOW_H

File: examplewindow.cc (For use with gtkmm 3, not gtkmm 2) 

#include "examplewindow.h"
#include <iostream>

ExampleWindow::ExampleWindow()
{
  set_title("Gtk::ScrolledWindow example");
  set_border_width(0);
  set_size_request(300, 300);

  m_ScrolledWindow.set_border_width(10);

  /* the policy is one of Gtk::POLICY AUTOMATIC, or Gtk::POLICY_ALWAYS.
   * Gtk::POLICY_AUTOMATIC will automatically decide whether you need
   * scrollbars, whereas Gtk::POLICY_ALWAYS will always leave the scrollbars
   * there.  The first one is the horizontal scrollbar, the second,
   * the vertical. */
  m_ScrolledWindow.set_policy(Gtk::POLICY_AUTOMATIC, Gtk::POLICY_ALWAYS);

  get_content_area()->pack_start(m_ScrolledWindow);

  /* set the spacing to 10 on x and 10 on y */
  m_Grid.set_row_spacing(10);
  m_Grid.set_column_spacing(10);

  /* pack the grid into the scrolled window */
  m_ScrolledWindow.add(m_Grid);

  /* this simply creates a grid of toggle buttons
   * to demonstrate the scrolled window. */
  for(int i = 0; i < 10; i++)
  {
     for(int j = 0; j < 10; j++)
     {
        char buffer[32];
        sprintf(buffer, "button (%d,%d)\n", i, j);
        Gtk::Button* pButton = Gtk::manage(new Gtk::ToggleButton(buffer));
        m_Grid.attach(*pButton, i, j, 1, 1);
     }
  }

  /* Add a "close" button to the bottom of the dialog */
  add_button("_Close", Gtk::RESPONSE_CLOSE);
  signal_response().connect(sigc::mem_fun(*this, &ExampleWindow::on_dialog_response));

  /* This makes it so the button is the default.
   * Simply hitting the "Enter" key will cause this button to activate. */
  set_default_response(Gtk::RESPONSE_CLOSE);

  show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_dialog_response(int response_id)
{
  switch (response_id)
  {
  case Gtk::RESPONSE_CLOSE:
  case Gtk::RESPONSE_DELETE_EVENT:
    hide();
    break;
  default:
    std::cout << "Unexpected response_id=" << response_id << std::endl;
    break;
  }
}

File: main.cc (For use with gtkmm 3, not gtkmm 2) 

#include "examplewindow.h"
#include <gtkmm/application.h>

int main(int argc, char *argv[])
{
  Glib::RefPtr<Gtk::Application> app = Gtk::Application::create(argc, argv, "org.gtkmm.example");

  ExampleWindow window;

  //Shows the window and returns when it is closed.
  return app->run(window);
}

8.1.4. Σκελετός όψης (AspectFrame)

Το γραφικό συστατικό AspectFrame φαίνεται σαν ένα γραφικό συστατικό Frame, αλλά εξαναγκάζει επίσης την αναλογία διαστάσεων (ο λόγος του πλάτους προς το ύψος) του θυγατρικού γραφικού συστατικού, προσθέτοντας πρόσθετο χώρο, αν είναι απαραίτητο. Για παράδειγμα, αυτό μπορεί να επιτρέψει την εμφάνιση μιας φωτογραφίας χωρίς να επιτρέπει στον χρήστη να την παραμόρφωση οριζόντια ή κάθετα κατά την αυξομείωση.

Reference

8.1.4.1. Παράδειγμα

Το παρακάτω πρόγραμμα χρησιμοποιεί μία Gtk::AspectFrame για να παρουσιάσει μια περιοχή σχεδίασης της οποίας η αναλογία διαστάσεων θα είναι πάντα 2:1, ανεξάρτητα πώς ο χρήστης αυξομειώνει το παράθυρο κορυφαίου επιπέδου.

Φιγούρα 8-4 Σκελετός όψης (AspectFrame)

Source Code

File: examplewindow.h (For use with gtkmm 3, not gtkmm 2) 

#ifndef GTKMM_EXAMPLEWINDOW_H
#define GTKMM_EXAMPLEWINDOW_H

#include <gtkmm.h>

class ExampleWindow : public Gtk::Window
{
public:
  ExampleWindow();
  virtual ~ExampleWindow();

protected:

  //Child widgets:
  Gtk::AspectFrame m_AspectFrame;
  Gtk::DrawingArea m_DrawingArea;
};

#endif //GTKMM_EXAMPLEWINDOW_H

File: examplewindow.cc (For use with gtkmm 3, not gtkmm 2) 

#include "examplewindow.h"

ExampleWindow::ExampleWindow()
: m_AspectFrame("2x1", /* label */
    Gtk::ALIGN_CENTER, /* center x */
    Gtk::ALIGN_CENTER, /* center y */
    2.0, /* xsize/ysize = 2 */
    false /* ignore child's aspect */)
{
  set_title("Aspect Frame");
  set_border_width(10);

  // Add a child widget to the aspect frame */
  // Ask for a 200x200 window, but the AspectFrame will give us a 200x100
  // window since we are forcing a 2x1 aspect ratio */
  m_DrawingArea.set_size_request(200, 200);
  m_AspectFrame.add(m_DrawingArea);

  // Add the aspect frame to our toplevel window:
  add(m_AspectFrame);

  show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

File: main.cc (For use with gtkmm 3, not gtkmm 2) 

#include "examplewindow.h"
#include <gtkmm/application.h>

int main(int argc, char *argv[])
{
  Glib::RefPtr<Gtk::Application> app = Gtk::Application::create(argc, argv, "org.gtkmm.example");

  ExampleWindow window;

  //Shows the window and returns when it is closed.
  return app->run(window);
}

8.1.5. Στοίχιση

Το γραφικό συστατικό Alignment επιτρέπει την τοποθέτηση ενός γραφικού συστατικού σε μια θέση και μέγεθος σχετικά με το μέγεθος του ίδιου του γραφικού συστατικού Alignment. Για παράδειγμα, μπορεί να χρησιμοποιηθεί για κεντράρισμα ενός γραφικού συστατικού.

Χρειάζεται να ορίσετε τα χαρακτηριστικά της Alignment στον κατασκευαστή, ή τη μέθοδο set(). Συγκεκριμένα, δεν θα παρατηρήσετε σημαντική επίδραση εκτός και ορίσετε έναν αριθμό διαφορετικό από 1.0 για τις παραμέτρους xscale και yscale, επειδή 1.0 σημαίνει απλά ότι το θυγατρικό γραφικό συστατικό θα επεκταθεί για να γεμίσει όλον τον διαθέσιμο χώρο.

Reference

8.1.5.1. Παράδειγμα

Αυτό το παράδειγμα στοιχίζει δεξιά ένα κουμπί σε ένα παράθυρο χρησιμοποιώντας ένα γραφικό συστατικό Alignment.

Φιγούρα 8-5 Στοίχιση

Source Code

File: examplewindow.h (For use with gtkmm 3, not gtkmm 2) 

#ifndef GTKMM_EXAMPLEWINDOW_H
#define GTKMM_EXAMPLEWINDOW_H

#include <gtkmm.h>

class ExampleWindow : public Gtk::Window
{
public:
  ExampleWindow();
  virtual ~ExampleWindow();

protected:
  //Signal handlers:
  void on_button_clicked();

  //Child widgets:
  Gtk::Alignment m_Alignment;
  Gtk::Button m_Button;
};

#endif //GTKMM_EXAMPLEWINDOW_H

File: examplewindow.cc (For use with gtkmm 3, not gtkmm 2) 

#include "examplewindow.h"

ExampleWindow::ExampleWindow()
: m_Alignment(Gtk::ALIGN_END, Gtk::ALIGN_CENTER, 0.0, 0.0),
  m_Button("Close")
{
  set_title("Gtk::Alignement");
  set_border_width(10);
  set_default_size(200, 50);

  add(m_Alignment);

  m_Alignment.add(m_Button);

  m_Button.signal_clicked().connect( sigc::mem_fun(*this,
              &ExampleWindow::on_button_clicked) );

  show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

void ExampleWindow::on_button_clicked()
{
  hide();
}

File: main.cc (For use with gtkmm 3, not gtkmm 2) 

#include "examplewindow.h"
#include <gtkmm/application.h>

int main(int argc, char *argv[])
{
  Glib::RefPtr<Gtk::Application> app = Gtk::Application::create(argc, argv, "org.gtkmm.example");

  ExampleWindow window;

  //Shows the window and returns when it is closed.
  return app->run(window);
}

Δείτε την ενότητα Γραμμή προόδου για ένα άλλο παράδειγμα που χρησιμοποιεί μια Alignment.

Περιέκτες μοναδικού στοιχείου Γραφικά συστατικά πολλαπλών στοιχείων

Περί