wguiaccl.gml

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

This relationship is defined in the Menu Editor. If you do not
know the desired menu item identifier, open the appropriate menu and
look up the identifier. It is not possible for the Accelerator Editor to
get this information for you.
.step Specify ASCII or Virtual Key
in the Key Type section of the window.
.begnote
.note ASCII Keys
.ix 'ASCII keys'
When the Key Type specified is ASCII, keys you press appear as
characters, such as
.us a, B, 2,
or
.us $.
In the Key field, the ASCII characters are surrounded by quotation
marks. For example,
.us c
appears as
.us "c"
and
.us Ctrl+C
appears as
.us "^C".
When using ASCII characters as accelerators, you may combine them with
the Ctrl key to form key sequences, such as Ctrl+X or Ctrl+P. There is
no symbol to represent the Shift key in ASCII. Applying the Shift key
with an ASCII character results in an upper case character in the Key
field. For example,
.us Shift+d
appears as
.us "D".
:cmt. To apply the Alt key to an ASCII character, mark the appropriate check
:cmt. box in the Modifiers section of the attributes area.
.note Virtual Keys
.ix 'Virtual Keys'
When the Key Type specified is Virtual Key, you enter the standard
Windows identifier for the desired key. For example, the Windows
identifier for the Home key is
.us VK_HOME.
The header file WINDOWS.H defines these identifiers. To avoid looking
up these identifiers yourself, use the Key Value function explained in
the section
.us Editing the Key Value.
:cmt. There is no virtual key equivalent for the Alt, Ctrl,
:cmt. and Shift keys.
To specify whether the Alt, Ctrl, or Shift keys must be pressed with
another key to form a key sequence, mark the appropriate check box in
the Modifiers section of the attributes area.
.endnote
.step Select the desired modifiers
in the Modifiers section.
.result
Modifiers are flags indicating keys that you must press in addition to
the specified key value to activate the menu item. When the ASCII
option is selected, the Control and Shift modifiers are not available.
.step Press the Insert action button
.orstep Choose Insert New Item
from the Accelerator menu.
.orstep Select the Insert New Item button on the toolbar.
.result
The Accelerator Editor adds the new accelerator item to the
accelerator table. When accelerator items exist in the accelerator
table, one item is always selected. Choosing the Insert New Item menu
item or button positions the new accelerator item directly after the
selected accelerator item in the list.
.endstep
.*
.section Changing an Existing Accelerator Item
.*
.np
.ix 'Accelerator Editor' 'change existing item'
.ix 'Accelerator Item' 'change existing'
You may want to change the key value or the menu item identifier
associated with an accelerator item.
.begstep To modify an existing accelerator item:
.step Click the accelerator item you want to modify.
.result
The selected accelerator item appears highlighted in the accelerator
item list and the accelerator item details appear in the attributes area
of the window.
.step Enter the new accelerator item details
in the attributes area.
.step Press the Change action button
.result
These actions update the selected accelerator item with the modified
accelerator item attributes.
.endstep
.*
.beglevel
.*
.section Editing the Key Value
.*
.np
.ix 'Key Value' 'edit'
.ix 'Accelerator Editor' 'edit the key value'
When editing only the key value of an accelerator item, use the Key
Value function. With this function, the Accelerator Editor looks up
the correct virtual key value for the selected key and inserts it into
the accelerator item list for you. This is a quick way to make
accelerator item changes, but it only applies to accelerator items
whose key type is Virtual Key.
.begstep To use the Key Value function:
.step Choose the accelerator table you want to work with
from the Resource window on the &company Resource Editor window.
.result
The Accelerator Editor window appears displaying all of the
accelerator items for the selected accelerator table.
.step Click on the accelerator item you want to modify.
.result
The selected accelerator item appears highlighted in the accelerator
table and the accelerator item details appear in the attributes area
of the window.
.step Choose Select Key Value
from the Accelerator menu
.orstep Select the Key Value button on the toolbar.
.result
The accelerator table disappears and instructions for using the Key
Value function appear in its place.
.step Press the desired key on the keyboard.
.result
This is the key that you want to activate the menu item specified in
the Menu Item field.
The instructions disappear from the window revealing the modified
accelerator table. The updated accelerator item is still selected.
.step Change modifiers,
if required.
.endstep
.*
.endlevel
.*
.section Deleting Accelerator Items
.*
.np
There are two functions you can use to delete accelerator items from
the accelerator table:
.begbull $compact
.bull
Delete
.bull
Clear
.endbull
.np
The Delete item in the Edit menu deletes the selected accelerator
item from the accelerator item list. You can delete only one
accelerator item at a time with this function.
.np
The Clear item in the File menu deletes all accelerator items in
the current accelerator table. This is a powerful function and must be
used carefully to avoid accidentally deleting all accelerator items.
.*
.beglevel
.*
.section Deleting an Accelerator Item
.*
.np
.ix 'Accelerator Editor' 'delete item'
.ix 'Accelerator Item' 'delete'
To delete accelerator items from the current accelerator table one at
a time:
.begstep
.step Select the accelerator item you want to delete
from the accelerator item list by clicking on it.
.result
The selected accelerator item is highlighted.
.step Choose Delete
from the Edit menu
.orstep Select the Delete button from the toolbar.
.result
The Accelerator Editor removes the selected item from the accelerator
item list.
.step Choose Update
from the File menu
to save the accelerator table changes.
.endstep
.*
.section Deleting All Accelerator Items
.*
.np
To delete all accelerator items in the current accelerator table:
.begstep
.step Choose Clear
from the File menu
.orstep Select the Clear button from the toolbar.
.result
A message box appears prompting you to verify that you want to clear
all accelerator items from the current accelerator table.
.step Choose Yes or No
to continue.
.result
Choosing Yes removes all accelerator items from the current
accelerator table. The accelerator item list is empty. Choosing
No cancels the operation.
.endstep
.figure *depth='1.46' *scale=88 *file='ACC8' As a safety feature, a message box appears when you choose the Clear function.
.*
.endlevel
.*
.section Renaming an Accelerator Table
.*
.np
.ix 'Accelerator Table' 'rename'
.ix 'Accelerator Editor' 'rename table'
When you create an Accelerator Table, the Resource Editor assigns a
default name to it. Assign a new name to the accelerator table using
the Rename function.
.begstep To rename an accelerator table:
.step Choose Rename
from the Resource menu on the &company Accelerator Editor window.
.orstep Double click or right click on the Resource Name field.
.result
A Rename Resource dialog box appears containing two fields:
.begbull $compact
.bull
Old Name
.bull
New Name
.endbull
.figure *depth='1.31' *scale=72 *file='ACC9' In the Rename Resource dialog, you enter the new name of the accelerator table.
.step Enter the desired accelerator table name
in the New Name field.
.step Click on OK
to close the Rename Resource dialog.
.result
The dialog closes and the new accelerator table name appears in the
Resource Name field.
.endstep
.*
.section Saving Accelerator Items
.*
.np
There are two functions you can use to save accelerator tables with
the Accelerator Editor:
.begbull $compact
.bull
Update
.ix 'Update'
.ix 'Accelerator Editor' 'update'
.bull
Save As
.bull
Copy To
.endbull
.np
Each of these options performs a different type of save function. This
section describes how to use each function.
.*
.beglevel
.*
.section Accelerator Editor: Update
.*
.np
After modifying an accelerator item in an accelerator table, choose
Update from the File menu on the Accelerator Editor window to
save the updated accelerator table to the current resource file. This
prevents the changes from being lost when you exit the Accelerator
Editor.
.np
The Update function updates the resource file only at the resource
level. The resource file is not saved until you perform a save at the
Resource Editor level as well. Exiting the Resource Editor without
saving causes you to lose the accelerator table changes made.
.*
.section Accelerator Editor: Save As
.*
.np
Choose Save As from the File menu on the Accelerator Editor window to
save the current accelerator table to another resource file.
.np
If you added any new symbol names (Item ID's), a Save Symbol Header
File dialog  appears which allows you to create a new header file which
includes the newly added symbol names.
.figure *depth='2.24' *scale=66 *file='ACC10' On the Save Symbol Header File dialog, specify the header file to which you want to save symbol ID's.
.np
Afterwards, a Save Accelerator Table dialog appears where you specify
the resource file to which you want to save the current accelerator
table.
.figure *depth='2.24' *scale=66 *file='ACC11' On the Save Accelerator Table dialog, specify the resource file to which you want to save the accelerator table.
.begnote
.note Important:
If the resource file to which you are saving the accelerator table already
contains resources, the existing resources will be discarded and
replaced with the accelerator table you are saving.
.endnote
.*
.section Accelerator Editor: Copy To
.*
.np
Choose Copy To from the Resource menu of the Accelerator Editor window
to copy the current accelerator table into an existing resource file.
.np
If you added any new symbol names (Item ID's), a Save Symbol Header
File dialog  appears which allows you to create a new header file which
includes the newly added symbol names.
.figure *depth='2.24' *scale=66 *file='ACC10' On the Save Symbol Header File dialog, specify the header file to which you want to save symbol ID's.
.np
Afterwards, a Copy To dialog appears where you specify the resource
file to which you want to copy the current accelerator table. Unlike
the Save As function, copying an accelerator table to a resource file
adds an entry to the list of resources rather than replacing the
existing resources with the new entry.
.figure *depth='2.24' *scale=66 *file='ACC12' On the Copy To dialog, specify the resource file to which you want to copy the accelerator table.
.*
.endlevel
.*
.section Using Shortcuts to Create Accelerator Tables
.*
.np
.ix 'Accelerator Editor' 'shortcuts to create tables'
.ix 'Accelerator Tables' 'shortcuts to create'
The Edit menu on the &company Accelerator Editor window contains some
standard Windows options that you can use to quickly create
accelerator resources. The options are:
.begbull $compact
.bull
Cut
.bull
Copy
.bull
Paste
.endbull
.np
These options allow you to perform functions on accelerator tables but
not on individual accelerators items.
.begnote
.note Cut
Choose Cut from the Edit menu of the Accelerator Editor
window to cut the accelerator item list from the current accelerator
table and place it on the clipboard.
.note Copy
Choose Copy from the Edit menu of the Accelerator Editor window to
copy the accelerator item list in the current accelerator table
to the clipboard.
.note Paste
Choose Paste from the Edit menu of the Accelerator Editor window to
copy the accelerator item list on the clipboard into the current
accelerator table.
.endnote
.*
.section Accelerator Editor: Changing Memory Options
.*
.np
.ix 'Accelerator Editor' 'change memory options'
The Memory Flags option allows you to change the selected memory
options for the current accelerator table. These options indicate the
memory type and loading instructions.
.begstep To set the flags for an accelerator table resource:
.step Choose Memory Flags
from the Resource menu
.ix 'Memory Flags'
of the &company Accelerator Editor window.
.result
The Memory Options dialog opens displaying either the current or
default memory options.
.figure *depth='1.89' *scale=67 *file='ACC13' On the Memory Options dialog, you change the memory options for the accelerator table.
.step Select the required flags
in the Memory Options and Load Options sections of the dialog by
clicking on the check box beside the field. Following is a description
of each option.
.begpoint $break
.point Moveable
Selecting this option marks this accelerator table to be stored in
moveable memory when it is loaded by an application.
.point Discardable
Selecting this option marks this accelerator table to be stored in
discardable memory when it is loaded by an application.
.point Pure
When marked as Pure, Windows will not allow the memory that the
accelerator table is loaded into to be modified.
.point Preload
All accelerator tables marked as Preload will be loaded when
the application for which you are creating the accelerator table is loaded.
.point LoadOnCall
Accelerator tables marked as LoadOnCall will only be loaded when an
application issues a call to load them.
.endpoint
.step Click on OK
when all memory option selections are made.
.result
The Memory Options dialog closes returning you to the Accelerator
Editor window.
.endstep
.*
.endlevel