Πλαίσιο συμβάντων (Event Box)

Μερικά γραφικά συστατικά της gtkmm δεν έχουν συσχετισμένα παράθυρα Χ· σχεδιάζονται στα γονικά τους παράθυρα. Λόγω αυτού, δεν μπορούν να δεχτούν συμβάντα. Επίσης, αν είναι λαθεμένα σε μέγεθος, δεν περικόπτονται, έτσι μπορείτε να δεχτείτε μπερδεμένη αντικατάσταση κλπ. Για την λήψη συμβάντων σε ένα από αυτά τα γραφικά συστατικά, μπορείτε να το τοποθετήσετε μέσα σε ένα γραφικό συστατικό EventBox και έπειτα να καλέσετε Gtk::Widget::set_events() στο EventBox πριν το εμφανίσετε.

Αν και το όνομα EventBox δίνει έμφαση στη μέθοδο χειρισμού συμβάντων, το γραφικό συστατικό μπορεί επίσης να χρησιμοποιηθεί για απόκομμα (και περισσότερα· δείτε το παρακάτω παράδειγμα).

Ο κατασκευαστής για Gtk::EventBox είναι:

Gtk::EventBox()·

Ένα θυγατρικό γραφικό συστατικό μπορεί να προστεθεί στο EventBox χρησιμοποιώντας:

event_box.add(child_widget);

Reference

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

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

Φιγούρα 15-1Πλαίσιο συμβάντων (Event Box)

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:
  bool on_eventbox_button_press(GdkEventButton* button_event);

  //Child widgets:
  Gtk::EventBox m_EventBox;
  Gtk::Label m_Label;
};

#endif //GTKMM_EXAMPLEWINDOW_H

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

#include "examplewindow.h"

ExampleWindow::ExampleWindow()
: m_Label("Click here to quit, quit, quit, quit, quit")
{
  set_title ("EventBox");
  set_border_width(10);

  add(m_EventBox);

  m_EventBox.add(m_Label);

  //Clip the label short:
  set_default_size(110, 20);
  m_Label.set_size_request(110, 20);
  m_Label.set_ellipsize(Pango::ELLIPSIZE_END);

  //And bind an action to it:
  m_EventBox.set_events(Gdk::BUTTON_PRESS_MASK);
  m_EventBox.signal_button_press_event().connect(
    sigc::mem_fun(*this, &ExampleWindow::on_eventbox_button_press) );

  m_EventBox.set_tooltip_text("Click me!");

  show_all_children();
}

ExampleWindow::~ExampleWindow()
{
}

bool ExampleWindow::on_eventbox_button_press(GdkEventButton*)
{
  hide();
  return true;
}

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

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

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

  ExampleWindow window;

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