comparison runtime/doc/gui.txt @ 11:4424b47a0797

updated for version 7.0003
author vimboss
date Wed, 30 Jun 2004 16:16:41 +0000
parents 7edf9b6e4c36
children c75153d791d0
comparison
equal deleted inserted replaced
10:4e2284e71352 11:4424b47a0797
23 ============================================================================== 23 ==============================================================================
24 1. Starting the GUI *gui-start* *E229* *E233* 24 1. Starting the GUI *gui-start* *E229* *E233*
25 25
26 First you must make sure you actually have a version of Vim with the GUI code 26 First you must make sure you actually have a version of Vim with the GUI code
27 included. You can check this with the ":version" command, it should include 27 included. You can check this with the ":version" command, it should include
28 "+GUI_Athena", "+GUI_BeOS", "+GUI_GTK", "+GUI_Motif" or "MS-Windows ... bit 28 "+GUI_Athena", "+GUI_BeOS", "+GUI_GTK", "+GUI_KDE", "+GUI_Motif" or
29 GUI version". 29 "MS-Windows ... bit GUI version".
30 30
31 How to start the GUI depends on the system used. Mostly you can run the 31 How to start the GUI depends on the system used. Mostly you can run the
32 GUI version of Vim with: 32 GUI version of Vim with:
33 gvim [options] [files...] 33 gvim [options] [files...]
34 34
92 92
93 There are a number of options which only have meaning in the GUI version of 93 There are a number of options which only have meaning in the GUI version of
94 Vim. These are 'guicursor', 'guifont', 'guipty' and 'guioptions'. They are 94 Vim. These are 'guicursor', 'guifont', 'guipty' and 'guioptions'. They are
95 documented in |options.txt| with all the other options. 95 documented in |options.txt| with all the other options.
96 96
97 If using the Motif or Athena version of the GUI (but not for the GTK+ or Win32 97 If using the Motif or Athena version of the GUI (but not for the KDE, GTK+ or
98 version), a number of X resources are available. See |gui-resources|. 98 Win32 version), a number of X resources are available. See |gui-resources|.
99 99
100 Another way to set the colors for different occasions is with highlight 100 Another way to set the colors for different occasions is with highlight
101 groups. The "Normal" group is used to set the background and foreground 101 groups. The "Normal" group is used to set the background and foreground
102 colors. Example (which looks nice): > 102 colors. Example (which looks nice): >
103 103
477 Pressing <F4> will start the menu. You can now use the cursor keys to select 477 Pressing <F4> will start the menu. You can now use the cursor keys to select
478 a menu entry. Hit <Enter> to execute it. Hit <Esc> if you want to cancel. 478 a menu entry. Hit <Enter> to execute it. Hit <Esc> if you want to cancel.
479 This does require the |+menu| feature enabled at compile time. 479 This does require the |+menu| feature enabled at compile time.
480 480
481 *tear-off-menus* 481 *tear-off-menus*
482 GTK+ and Motif support Tear-off menus. These are sort of sticky menus or 482 KDE, GTK+ and Motif support Tear-off menus. These are sort of sticky menus or
483 pop-up menus that are present all the time. If the resizing does not work 483 pop-up menus that are present all the time. If the resizing does not work
484 correctly, this may be caused by using something like "Vim*geometry" in the 484 correctly, this may be caused by using something like "Vim*geometry" in the
485 defaults. Use "Vim.geometry" instead. 485 defaults. Use "Vim.geometry" instead.
486 486
487 The Win32 GUI version emulates Motif's tear-off menus. Actually, a Motif user 487 The Win32 GUI version emulates Motif's tear-off menus. Actually, a Motif user
644 Note that the separator also requires a rhs. It doesn't matter what it is, 644 Note that the separator also requires a rhs. It doesn't matter what it is,
645 because the item will never be selected. Use a single colon to keep it 645 because the item will never be selected. Use a single colon to keep it
646 simple. 646 simple.
647 647
648 *gui-toolbar* 648 *gui-toolbar*
649 The toolbar is currently available in the Win32, Athena, Motif, GTK+ (X11) and 649 The toolbar is currently available in the Win32, Athena, Motif, GTK+ (X11),
650 Photon GUI. It should turn up in other GUIs in due course. The default 650 KDE and Photon GUI. It should turn up in other GUIs in due course. The default
651 toolbar is setup in menu.vim. 651 toolbar is setup in menu.vim.
652 The display of the toolbar is controlled by the 'guioptions' letter 'T'. You 652 The display of the toolbar is controlled by the 'guioptions' letter 'T'. You
653 can thus have menu & toolbar together, or either on its own, or neither. 653 can thus have menu & toolbar together, or either on its own, or neither.
654 The appearance is controlled by the 'toolbar' option. You can chose between 654 The appearance is controlled by the 'toolbar' option. You can chose between
655 an image, text or both. 655 an image, text or both.
733 In the Win32 and GTK+ GUI, starting a menu name with ']' excludes that menu 733 In the Win32 and GTK+ GUI, starting a menu name with ']' excludes that menu
734 from the main menu bar. You must then use the |:popup| or |:tearoff| command 734 from the main menu bar. You must then use the |:popup| or |:tearoff| command
735 to display it. 735 to display it.
736 736
737 *popup-menu* 737 *popup-menu*
738 In the Win32, GTK+, Motif, Athena and Photon GUI, you can define the special 738 In the Win32, KDE, GTK+, Motif, Athena and Photon GUI, you can define the special
739 menu "PopUp". This is the menu that is displayed when the right mouse button 739 menu "PopUp". This is the menu that is displayed when the right mouse button
740 is pressed, if 'mousemodel' is set to popup or popup_setpos. 740 is pressed, if 'mousemodel' is set to popup or popup_setpos.
741 741
742 742
743 5.3 Showing What Menus Are Mapped To *showing-menus* 743 5.3 Showing What Menus Are Mapped To *showing-menus*