gtkDialogRun              package:RGtk2              R Documentation

_g_t_k_D_i_a_l_o_g_R_u_n

_D_e_s_c_r_i_p_t_i_o_n:

     Blocks in a recursive main loop until the 'dialog' either emits
     the response signal, or is destroyed. If the dialog is destroyed
     during the call to 'gtkDialogRun', gtk_dialog_returns
     'GTK_RESPONSE_NONE'. Otherwise, it returns the response ID from
     the "response" signal emission. Before entering the recursive main
     loop, 'gtkDialogRun' calls 'gtkWidgetShow' on the dialog for you.
     Note that you still need to show any children of the dialog
     yourself.

_U_s_a_g_e:

     gtkDialogRun(object)

_A_r_g_u_m_e_n_t_s:

'object': ['GtkDialog']  a 'GtkDialog'

_D_e_t_a_i_l_s:

     During 'gtkDialogRun', the default behavior of "delete_event" is
     disabled; if the dialog receives "delete_event", it will not be
     destroyed as windows usually are, and 'gtkDialogRun' will return
     'GTK_RESPONSE_DELETE_EVENT'. Also, during 'gtkDialogRun' the
     dialog will be modal. You can force 'gtkDialogRun' to return at
     any time by calling 'gtkDialogResponse' to emit the "response"
     signal. Destroying the dialog during 'gtkDialogRun' is a very bad
     idea, because your post-run code won't know whether the dialog was
     destroyed or not.

     After 'gtkDialogRun' returns, you are responsible for hiding or
     destroying the dialog if you wish to do so.

     Typical usage of this function might be:


      result <- dialog$run()
      if (result == "accept")
              do_application_specific_something()
      else do_nothing_since_dialog_was_cancelled()
      dialog$destroy()

     Note that even though the recursive main loop gives the effect of
     a modal dialog (it prevents the user from interacting with other 
     windows in the same window group while the dialog is run),
     callbacks  such as timeouts, IO channel watches, DND drops, etc,
     _will_  be triggered during a 'gtkDialogRun' call.

_V_a_l_u_e:

     [integer]  response ID

_A_u_t_h_o_r(_s):

     Derived by RGtkGen from GTK+ documentation

