annotate src/dialog.c @ 288:e11d67e05968 r21-0b42

Import from CVS: tag r21-0b42
author cvs
date Mon, 13 Aug 2007 10:35:54 +0200
parents 57709be46d1b
children 2f8bb876ab1d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1 /* Implements elisp-programmable dialog boxes -- generic.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2 Copyright (C) 1993, 1994 Free Software Foundation, Inc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3 Copyright (C) 1995 Tinker Systems and INS Engineering Corp.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5 This file is part of XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
7 XEmacs is free software; you can redistribute it and/or modify it
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
8 under the terms of the GNU General Public License as published by the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
9 Free Software Foundation; either version 2, or (at your option) any
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
10 later version.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
11
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
12 XEmacs is distributed in the hope that it will be useful, but WITHOUT
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
15 for more details.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
16
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
17 You should have received a copy of the GNU General Public License
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
18 along with XEmacs; see the file COPYING. If not, write to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
20 Boston, MA 02111-1307, USA. */
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
21
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
22 /* Synched up with: Not in FSF. */
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
23
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
24 /* #### There ain't nothin' here because dialog boxes have not been
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
25 properly abstracted yet. */
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
26
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
27 #include <config.h>
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
28 #include "lisp.h"
284
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
29 #include "frame.h"
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
30 #include "device.h"
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
31
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
32 DEFUN ("popup-dialog-box", Fpopup_dialog_box, 1, 1, 0, /*
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
33 Pop up a dialog box.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
34 A dialog box description is a list.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
35
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
36 The first element of a dialog box must be a string, which is the title or
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
37 question.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
38
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
39 The rest of the elements are descriptions of the dialog box's buttons.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
40 Each of these is a vector, the syntax of which is essentially the same as
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
41 that of popup menu items. They may have any of the following forms:
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
42
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
43 [ "name" callback <active-p> ]
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
44 [ "name" callback <active-p> "suffix" ]
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
45 [ "name" callback :<keyword> <value> :<keyword> <value> ... ]
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
46
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
47 The name is the string to display on the button; it is filtered through the
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
48 resource database, so it is possible for resources to override what string
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
49 is actually displayed.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
50
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
51 If the `callback' of a button is a symbol, then it must name a command.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
52 It will be invoked with `call-interactively'. If it is a list, then it is
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
53 evaluated with `eval'.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
54
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
55 One (and only one) of the buttons may be `nil'. This marker means that all
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
56 following buttons should be flushright instead of flushleft.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
57
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
58 Though the keyword/value syntax is supported for dialog boxes just as in
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
59 popup menus, the only keyword which is both meaningful and fully implemented
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
60 for dialog box buttons is `:active'.
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
61 */
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
62 (dbox_desc))
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
63 {
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
64 struct frame *f = selected_frame ();
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
65 struct device *d = XDEVICE (f->device);
286
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
66
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
67 if (!HAS_DEVMETH_P (d, popup_dialog_box))
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
68 signal_simple_error ("Device does not support dialogs", f->device);
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
69
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
70 if (SYMBOLP (dbox_desc))
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
71 dbox_desc = Fsymbol_value (dbox_desc);
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
72 CHECK_CONS (dbox_desc);
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
73 CHECK_STRING (XCAR (dbox_desc));
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
74 if (!CONSP (XCDR (dbox_desc)))
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
75 signal_simple_error ("Dialog descriptor must supply at least one button", dbox_desc);
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
76
57709be46d1b Import from CVS: tag r21-0b41
cvs
parents: 284
diff changeset
77 DEVMETH (d, popup_dialog_box, (f, dbox_desc));
284
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
78
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
79 return Qnil;
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
80 }
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
81
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
82 void
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
83 syms_of_dialog (void)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
84 {
284
558f606b08ae Import from CVS: tag r21-0b40
cvs
parents: 0
diff changeset
85 DEFSUBR (Fpopup_dialog_box);
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
86 }
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
87
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
88 void
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
89 vars_of_dialog (void)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
90 {
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
91 Fprovide (intern ("dialog"));
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
92 }