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  inter-
       actor  passed  to the dialog constructor.  The dialog com-
       pletes 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  read-
              ing  events  until the button state's value becomes
              non-zero.  Each event is passed to is target's Han-
              dle  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 dia-
              log around the event's (x, y)  coordinate.   Other-
              wise,  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)