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)