bionic (3) Dialog.3I.gz

NAME

       Dialog - popup dialog interactor

SYNOPSIS

       #include <InterViews/dialog.h>

DESCRIPTION

       A  dialog  is  an  interactor  that  handles input for a dialog box.  The dialog layout is specified by a
       separate interactor passed to the dialog  constructor.   The  dialog  completes  when  the  value  of  an
       associated  button  state becomes non-zero.  This button state is typically set by one or more buttons in
       the component interactor.

PUBLIC OPERATIONS

       Dialog(ButtonState*, Interactor*, Alignment = Center)
              Construct a new dialog with the given button state and interactor.  The alignment is used  by  the
              Popup operation.

       virtual boolean Accept()
              Set the dialog button state to zero and loop reading events until the button state's value becomes
              non-zero.  Each event is passed to is target's Handle operation.  Return true if the value is one,
              false otherwise.

       virtual boolean Popup(Event&, boolean placed = true)
              Insert  the  dialog  into the world associated with the given event.  If placed is true, align the
              dialog around the event's (x, y) coordinate.  Otherwise, the dialog is inserted without specifying
              a position.  Popup then calls the Accept operation and returns its value.

SEE ALSO

       Button(3I), Interactor(3I), World(3I)