   #home GTK Classes disconnect GtkDialog Constructor

       GTK Classes
   Prev  GtkDialog  Next
     _________________________________________________________________

GtkDialog

     Widget that eases creation of popup dialogs.

Object Hierarchy

   GtkObject
   `-- GtkWidget
         `-- GtkContainer
               `-- GtkBin
                     `-- GtkWindow
                           `-- GtkDialog

Description

     GtkDialog is used to create a popup window for presenting or
     requesting small amounts of information. It is composed of two
     containers separated by a GtkHSeparator. The top container is a
     GtkVBox, and would typically contain GtkLabel and GtkEntry widgets
     to present the user with information and allow input. The bottom
     container is a GtkHBox and would usually contain dialog buttons,
     e.g. OK, Cancel, Help and so on.

     Note that widgets should not be added to the GtkDialog itself but
     to the containers, which can be accessed as vbox and action_area
     respectively.

     Dialogs can be made modal (in effect freezing input to the rest of
     the application) by calling the GtkWindow method set_modal() on the
     GtkDialog object.

     Note that making a GtkDialog modal does not stop execution of the
     code that calls it. In the example below, the call to 'echo' will
     still get executed even though the main application may not respond
     to user input. To stop execution of the code the GtkDialog must
     contain a call to a nested gtk::main() function. Execution will
     then continue when the corresponding gtk::main_quit() function is
     called.

   Example 10. Using set_modal()

<?php

$dialog = &new GtkDialog();
$dialog->set_modal(TRUE);
echo "This message will still be printed \n";

?>


Constructor

   GtkDialog (void);

     -- Creates the basis for a popup dialog window.

Properties

   vbox:

     Upper container.

   action_area:
     Lower container.
     _________________________________________________________________

   Prev        Home                   Next
   disconnect   Up   GtkDialog Constructor
