GNU Info

(elisp)Dialog Boxes

---

Next: Pointer Shapes Prev: Pop-Up Menus Up: Frames

---

Enter node , (file) or (file)node

Dialog Boxes
============

   A dialog box is a variant of a pop-up menu--it looks a little
different, it always appears in the center of a frame, and it has just
one level and one pane.  The main use of dialog boxes is for asking
questions that the user can answer with "yes", "no", and a few other
alternatives.  The functions `y-or-n-p' and `yes-or-no-p' use dialog
boxes instead of the keyboard, when called from commands invoked by
mouse clicks.

 - Function: x-popup-dialog position contents
     This function displays a pop-up dialog box and returns an
     indication of what selection the user makes.  The argument
     CONTENTS specifies the alternatives to offer; it has this format:

          (TITLE (STRING . VALUE)...)

     which looks like the list that specifies a single pane for
     `x-popup-menu'.

     The return value is VALUE from the chosen alternative.

     An element of the list may be just a string instead of a cons cell
     `(STRING . VALUE)'.  That makes a box that cannot be selected.

     If `nil' appears in the list, it separates the left-hand items from
     the right-hand items; items that precede the `nil' appear on the
     left, and items that follow the `nil' appear on the right.  If you
     don't include a `nil' in the list, then approximately half the
     items appear on each side.

     Dialog boxes always appear in the center of a frame; the argument
     POSITION specifies which frame.  The possible values are as in
     `x-popup-menu', but the precise coordinates don't matter; only the
     frame matters.

     In some configurations, Emacs cannot display a real dialog box; so
     instead it displays the same items in a pop-up menu in the center
     of the frame.