---
name: "Dialog"
section: "3"
platform: "linux"
package: "ivtools-dev"
version: "1.1.3-4"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/Dialog"
---

# Dialog(3)

popup dialog interactor

## 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)