diff options
author | Nick Roberts <nickrob@snap.net.nz> | 2005-05-24 04:29:14 +0000 |
---|---|---|
committer | Nick Roberts <nickrob@snap.net.nz> | 2005-05-24 04:29:14 +0000 |
commit | 24f8f30b73663e729018eddebd630942e12b46ac (patch) | |
tree | 68a1771aee1dcd58e95ccdbd974d68ada9b0fe0e | |
parent | 87944384533f773997a940804ad2ae8e0545d350 (diff) | |
download | emacs-24f8f30b73663e729018eddebd630942e12b46ac.tar.gz |
(Dialog Boxes): Descibe new optional argument.
-rw-r--r-- | lispref/frames.texi | 19 |
1 files changed, 12 insertions, 7 deletions
diff --git a/lispref/frames.texi b/lispref/frames.texi index 3b43f18e99d..bb3c827fe34 100644 --- a/lispref/frames.texi +++ b/lispref/frames.texi @@ -1438,13 +1438,14 @@ the menu keymap as necessary. 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 @code{y-or-n-p} and @code{yes-or-no-p} use -dialog boxes instead of the keyboard, when called from commands invoked -by mouse clicks. - -@defun x-popup-dialog position contents +one level and one or more buttons. The main use of dialog boxes is +for asking questions that the user can answer with ``yes'', ``no'', +and a few other alternatives. With a single button, they can also +force the user to acknowledge important information. The functions +@code{y-or-n-p} and @code{yes-or-no-p} use dialog boxes instead of the +keyboard, when called from commands invoked by mouse clicks. + +@defun x-popup-dialog position contents header This function displays a pop-up dialog box and returns an indication of what selection the user makes. The argument @var{contents} specifies the alternatives to offer; it has this format: @@ -1474,6 +1475,10 @@ Dialog boxes always appear in the center of a frame; the argument @code{x-popup-menu}, but the precise coordinates or the individual window don't matter; only the frame matters. +If @var{header} is non-nil, the frame title for the box is +``Information'', otherwise it is ``Question''. The former is used +for @code{message-box} (@pxref{The Echo Area}). + 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. |