wguimenu.gml

开放源码的编译器open watcom 1.6.0版的源代码

.chap The &company Menu Editor
.*
.if &e'&dohelp eq 0 .do begin
.section Introduction
.do end
.*
.np
.ix 'Menu Editor'
Windows applications typically contain menus that enable users to
initiate actions. When users see familiar menus in the menu bar, such
as the File or Edit menu, they may feel less intimidated by a new
application and be more apt to explore its capabilities.
.np
In an application you can have three types of menu items:
.begbull $compact
.bull
Standard
.bull
Popup
.bull
Separator
.endbull
.np
A standard menu item performs a function when selected. A popup menu
item is a menu item with a sub-menu. Selecting a popup menu reveals
another menu list, rather than performing a function. A separator is a
horizontal line that separates groups of menu items within a popup
menu. A resource file can have multiple menus.
.np
The &company Menu Editor enables you to create new menus and edit
existing menus found in resource files.
A resource file may contain multiple menus.
.np
With the Menu Editor you can create all of the menus needed for
your application visually, without having to create a resource
script or use a resource compiler.
.*
.section Using the Menu Editor
.*
.np
This section discusses the following topics:
.begbull $compact
.bull
Starting the Menu Editor
.bull
Quitting the Menu Editor
.bull
The Menu Editor Menu Bar
.bull
The Menu Editor Toolbar
.endbull
.*
.beglevel
.*
.section Starting the Menu Editor
.*
.np
.ix 'Menu Editor' 'start'
.ix 'start' 'Menu Editor'
The Menu Editor may be invoked in one of two ways. The first
involves first starting the Resource Editor then starting the Menu
Editor. The second way the editor may be started is from the &company IDE.
.np
To start the Menu Editor from the Resource Editor,
you must first open the Resource Editor. How
you proceed depends on whether you are opening a new (empty) menu
table or an existing menu table.
:CMT.  This is a new figure
.figure *depth='3.20' *scale=45 *file='MNU1' The Menu Editor window
.*
.beglevel
.*
.section Creating a New Menu
.*
.ix 'Menu Editor' 'create new menu'
.ix 'Menu' 'create new'
.begstep
.step Double click on the Resource Editor icon
in your Windows Program Manager.
.result
The &company Resource Editor window opens.
.step Open a new or existing resource file.
.result
.if &e'&dohelp eq 0 .do begin
Refer to the chapter entitled :HDREF refid='resedit'. for more
information.
.do end
.step Choose New
from the Resource menu.
.result
A cascading menu appears from the New menu item.
.step Select Menu
from the New cascading menu.
.result
The &company Menu Editor window opens and displays an empty menu.
.endstep
.*
.section Opening an Existing Menu
.*
.ix 'Menu' 'open existing'
.begstep
.step Double click on the Resource Editor icon
in your Windows Program Manager.
.result
The &company Resource Editor window opens.
.step Open an existing Resource File.
.result
.if &e'&dohelp eq 0 .do begin
Refer to the chapter entitled :HDREF refid='resedit'. for more
information.
.do end
The Resource window for the existing resource file displays
buttons representing each existing resource type.
.step Select the menu button
to view the existing menus.
.orstep Choose Menu
from the cascading menu that appears when you choose View from the
Resource menu.
.result
The Menu list appears revealing all menus in this resource file.
.step Double click on the existing menu you want to open
.orstep Click on the desired menu
to select it, then
.bd press ENTER
or
.bd choose Edit from the Resource menu
on the &company Resource Editor window.
.result
The &company Menu Editor window opens and displays the selected menu.
.endstep
.*
.endlevel
.*
.section Quitting the Menu Editor
.*
.np
.ix 'Menu Editor' 'leave'
.ix 'leave' 'Menu Editor'
To exit the Menu Editor, choose Exit from the File menu of the
&company Menu Editor window.
.np
If you made changes to menu items but did not save the information, a
message box prompts you to save before exiting. Choose Yes to save the
changes and exit the Menu Editor, No to exit the Menu Editor without
saving the changes, or Cancel to return to the Menu Editor.
.np
When you exit the Menu Editor, the application remembers the directory
in which you last opened or saved a menu (not the resource file). The next
time you open a menu, the last directory accessed appears in the File
Selection dialog so you do not have to reenter its path. This feature
makes the Menu Editor more convenient and efficient to use.
.*
.section The Menu Editor Menu Bar
.*
.figure *depth='1.61' *scale=67 *file='MNU2' The Menu Editor menu bar.
.np
.ix 'Menu Editor' 'menu bar'
The menu bar consists of the following five menus:
.begpoint
.point File
Clear and save the menu, and exit the Menu Editor
.point Edit
Access the clipboard functions, hide or show the toolbar, and delete a
menu
.point Resource
Rename the menu and change its memory flags
.point Menu
Insert menu entries
.point Help
Access on-line help information
.endpoint
.np
To see the function of an item in the menu bar or submenus, hold the
mouse button and drag the cursor over the desired menu item. A
description of the item appears in the status line at the bottom of
the screen. If you do not want to select the menu item, drag the
cursor off of the menu item before releasing the mouse button.
.*
.section The Menu Editor Toolbar
.*
.np
.ix 'Menu Editor' 'toolbar'
In the &company Menu Editor window, the toolbar appears below the menu
bar. When the toolbar is shown choose Hide Toolbar from the Edit menu
to hide it. When the toolbar is hidden you can display it by choosing
Show Toolbar from the Edit menu.
:CMT. .figure *depth='4.30' *scale=150 *file='MNU2' You can access eight Menu Editor functions from the toolbar.
.figure *depth='0.86' *scale=76 *file='MNU3' The Menu Editor toolbar.
.np
The following explains the function each icon performs, as well as the
equivalent function in the menu bar.
.begpoint
.point Clear
Clear the menu workspace. This is equivalent to Clear in the File
menu.
.point Save
Save the current menu. This is equivalent to Update in the
File menu.
.point Cut
Cut the current menu item to the clipboard. This is equivalent to Cut
in the Edit menu.
.point Copy
Copy the current menu item to the clipboard. This is equivalent to
Copy in the Edit menu.
.point Paste
Paste the menu item that is on the clipboard to the current menu
workspace. This is equivalent to Paste in the Edit menu.
.point Delete
Delete the selected menu item from the menu workspace. This is
equivalent to Delete in the Edit menu.
.endpoint
.np
Only one of the following two buttons appears at a time. The displayed
button indicates where new menu items will be inserted. When one is
selected the other one replaces it on the toolbar.
.begpoint
.point Insert Before
When this button is displayed, new menu items will be inserted before
the currently selected menu item. Selecting this button is equivalent
to selecting Insert After from the Menu menu.
.point Insert After
When this button is displayed, new menu items will be inserted after
the currently selected menu item. Selecting this button is equivalent
to selecting Insert Before from the Menu menu.
.endpoint

.begpoint
.point Insert
This button will insert a new menu item into the menu. This is equivalent
to Insert New Item in the Menu menu.
.endpoint

.np
To see the function of an item in the toolbar, position your cursor
over the desired button. A description of the button's function
appears in the status line at the bottom of the window.
.*
.endlevel
.*
.section *refid=medwin Using the Menu Editor Window
.*
.np
.ix 'Menu Editor' 'window'
The &company Menu Editor window contains a menu bar, toolbar, and status
line to help you create and edit menus. The rest of the window is
divided into five sections:
.begbull $compact
.bull
Resource Name Field
.bull
Preview Window
.bull
Attributes Area
.bull
Menu Item List
.bull
Action Buttons
.endbull
:CMT. .figure *depth='3.59' *scale=125 *file='MNU2' On the &company Menu Editor window, you create menus for your application.
.figure *depth='3.20' *scale=45 *file='MNU4' On the &company Menu Editor window, you create menus for your application.
.*
.beglevel
.*
.section Menu Editor: Resource Name Field
.*
.np
.ix 'Resource Name field'
.ix 'Menu Editor' 'Resource Name field'
The Resource Name field in the &company Menu Editor window contains the
name of the menu currently being edited. A resource file can contain more
than one menu, so it is important that the resource names for the menu
resources be unique. The Resource Name field is not case sensitive and
can hold up to 255 characters. You can enter a textual name, a number
or a symbol in this field.
.np
When you create a new menu, the Resource Editor assigns the default
name MENU_# to it. You can rename the menu using the Rename item in
the Resource menu.
.*
.section Menu Editor: The Preview Window
.*
.np
.ix 'Menu Editor' 'Preview Window'
.ix 'Preview Window' 'in Menu Editor'
The Preview window appears on the Menu Editor window above the menu
item list. This window allows you to see how the menu you are creating
will look in the application. The popup menu items in the preview
window are functional so you can test your menu as you create it.
:CMT. .figure *depth='1.24' *scale=200 *file='MNU3' The preview window allows you to see how the menu will look and work in the application.
.figure *depth='0.71' *scale=81 *file='MNU5' The preview window allows you to see how the menu will look and work in the application.
.np
You can use the sample menu that appears in the preview window to test
the behaviour of your menu items. For example, by selecting top-level
menu items in the preview window you can check the positions and
breaks of your menu items and separators. The preview window allows
you to verify that your menus cascade properly and that other
attributes function properly, including inactive, grayed, and check
marked menu items.
.*
.section Menu Editor: Attributes Area
.*
.np
.ix 'Attributes area'
.ix 'Menu Editor' 'attributes area'
The attributes area provides information about the currently selected
menu item. You can edit menu items using only the fields in this area.
.np
The attributes area displays menu item details in five sections.
Following is an explanation of each section.
.begpoint
.point Item Text
The Item Text field contains the name of the menu item. Whatever
appears in this field will appear in the menu.
.np
An ampersand (&) in front of a letter in this field tells the editor
to underscore that letter in the menu. This automatically creates a
hot key for that menu item. When using the menu, pressing ALT plus the
underscored letter activates that menu item.
.np
To specify a tab character, enter \t in this field. All text after \t
in the Item Text field will be right justified in the menu.
.point Item ID
The Item ID is the unique numeric identifier for the menu item. In the
source code, you match the identifier to the function the menu item is
to perform. The Item ID applies only to normal menu items. Popups and
separators do not perform functions, so do not need an identifier.
.np
You can enter any number in the range 0 to 65535 in the Item ID field.
Hexadecimal values can be entered by prefixing them with 0x. Octal
values can be entered by prefixing them with zero.
.np
The two Item ID fields contain:
.begbull $compact
.bull
the numeric identifier of the selected menu item
.bull
the symbol information for the selected menu item.
.endbull
.begnote
.note Note:
Both Menu Item fields currently contain the same numerical information
because the Menu Editor does not yet support symbols.
.endnote
.point Item Type
The Item Type section of the window indicates whether the selected
menu item is a popup, normal, or separator menu item. Following is a
description of each menu item type.
.begpoint
.point Popup
A popup menu is a menu item that has a sub-menu. When you select a
popup menu, another menu appears.
.point Normal
A normal menu item is an item that performs a function when selected.
.point Separator
A separator menu item is a horizontal line that separates menu items
to logically group menu items with similar functions. When a separator
is selected from the menu item list, the Item Text and Item ID fields
are always empty because they do not apply to separators.
.endpoint
.point Attributes
The options in the Attributes section allow you to specify how the
selected menu item will appear in the menu. Use the check boxes to
select the desired menu item characteristic. Following is a
description of each option.
.begpoint
.point Checked
When the Checked option is selected, the menu item appears in the menu
with a check mark beside it. This is a graphic only and does not
affect the functionality of the menu item.
.begnote
.note Note:
Top level menu items cannot be checked.
.endnote
.point Grayed
When the Grayed option is selected, the menu item text appears in gray
instead of black. This option also makes the menu item inactive.
.point Inactive
When the Inactive option is selected, the menu item appears unchanged
in the menu. However, this option prevents the menu item from being
selected.
.endpoint
.point Break Styles
The options in the Break Styles section control the positioning of the
menu items. The break styles you choose affects the selected menu item
and all menu items that follow that item. Following is a description
of the available options.
.begpoint
.point Help
The Help break option positions the selected menu to the far right of
the menu bar. This option is available only for top-level menus.
.point Menu
For top-level menu items, the Menu break option begins a new line in
the menu bar, positioning the selected menu item on the far left. In a
popup menu, this break option creates a new column, positioning the
selected menu item at the beginning of the new column.
.begnote
.note Note
The Menu option overrides the Menu Bar option.
.endnote
.point Menu Bar