comparison src/xmenu.c @ 62090:cd1e4bc8e488

(Fx_popup_menu, Fx_popup_dialog): Doc fixes.
author Luc Teirlinck <teirllm@auburn.edu>
date Thu, 05 May 2005 22:31:36 +0000
parents 76ffd04afaae
children 0c2ce5566afa b151ec53c504
comparison
equal deleted inserted replaced
62089:e002770fe3ac 62090:cd1e4bc8e488
765 but a string can appear as an item--that makes a nonselectable line 765 but a string can appear as an item--that makes a nonselectable line
766 in the menu. 766 in the menu.
767 With this form of menu, the return value is VALUE from the chosen item. 767 With this form of menu, the return value is VALUE from the chosen item.
768 768
769 If POSITION is nil, don't display the menu at all, just precalculate the 769 If POSITION is nil, don't display the menu at all, just precalculate the
770 cached information about equivalent key sequences. */) 770 cached information about equivalent key sequences.
771
772 If the user gets rid of the menu without making a valid choice, for
773 instance by clicking the mouse away from a valid choice or by typing
774 keyboard input, then this normally results in a quit and
775 `x-popup-menu' does not return. But if POSITION is a mouse button
776 event (indicating that the user invoked the menu with the mouse) then
777 no quit occurs and `x-popup-menu' returns nil. */)
771 (position, menu) 778 (position, menu)
772 Lisp_Object position, menu; 779 Lisp_Object position, menu;
773 { 780 {
774 Lisp_Object keymap, tem; 781 Lisp_Object keymap, tem;
775 int xpos = 0, ypos = 0; 782 int xpos = 0, ypos = 0;
1003 The return value is VALUE from the chosen item. 1010 The return value is VALUE from the chosen item.
1004 1011
1005 An ITEM may also be just a string--that makes a nonselectable item. 1012 An ITEM may also be just a string--that makes a nonselectable item.
1006 An ITEM may also be nil--that means to put all preceding items 1013 An ITEM may also be nil--that means to put all preceding items
1007 on the left of the dialog box and all following items on the right. 1014 on the left of the dialog box and all following items on the right.
1008 \(By default, approximately half appear on each side.) */) 1015 \(By default, approximately half appear on each side.)
1016
1017 If the user gets rid of the dialog box without making a valid choice,
1018 for instance using the window manager, then this produces a quit and
1019 `x-popup-dialog' does not return. */)
1009 (position, contents) 1020 (position, contents)
1010 Lisp_Object position, contents; 1021 Lisp_Object position, contents;
1011 { 1022 {
1012 FRAME_PTR f = NULL; 1023 FRAME_PTR f = NULL;
1013 Lisp_Object window; 1024 Lisp_Object window;