wguistrg.gml

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

.*
.section String Functions
.*
.np
.ix 'String functions'
.ix 'String Editor' 'string functions'
You can perform several functions with the String Editor. This section
describes the following tasks:
.begbull $compact
.bull
Adding a New String Item
.bull
Changing an Existing String Item
.bull
Deleting String Items
.bull
Saving String Items
.bull
Using Shortcuts to Create String Tables
.ix 'String Editor' 'shortcuts to create string tables'
.ix 'String Tables' 'shortcuts to creating'
.bull
Changing Memory Options
.endbull
.*
.beglevel
.*
.section Adding a New String Item
.*
.np
The steps for adding a new string item to the Strings list are the
same, regardless of whether the Strings list is empty or already
contains string items.
.begstep To add a new string item:
.step Enter the text
that you want to appear in the application in the String Text Field of
the &company String Editor window.
.result
The text that will be displayed in your application appears exactly as
you enter it in this field.
.step Enter symbol or numeric identifier
fo the string.
.result
The identifier you enter here is associated with the string
item. This is the identifier by which your source code references the
string.
.step Press the Insert action button
.ix 'Insert New Item'
.ix 'String Editor' 'insert new item'
.orstep Choose Insert New Item
from the Strings menu.
.orstep Select the Insert New Item button on the toolbar.
.result
The String Editor adds the new string item to the Strings list. The
editor automatically arranges the strings in order by String ID.
.endstep
.*
.section Changing an Existing String Item
.*
.np
.ix 'String Editor' 'change existing string'
.ix 'String Item' 'change existing'
You may want to change the text or identifier for a string item in the
Strings list.
.begstep To modify an existing sting table item:
.step Choose the string table you want to work with
from the Resource window on the &company Resource Editor window.
.result
The String Editor window appears displaying all of the string items
for the selected string table.
.step Click on the string item
from the Strings list that you want to modify.
.result
The selected string item appears highlighted in the Strings list.
.step Change the String Item or String ID field.
.step Press the Change action button
.result
These actions update the selected string item with the modified string
item details.
.endstep
.*
.section Deleting String Items
.*
.np
.ix 'String Editor' 'delete string items'
.ix 'String Items' 'delete'
.ix 'String Items' 'clear'
.ix 'String Editor' 'Clear option'
These are two functions you can use to delete string items from the
Strings list:
.begbull $compact
.bull
Delete
.bull
Clear
.endbull
.np
The Delete item in the Edit menu deletes the selected string item. You
can delete only one string item at a time with this function.
.np
The Clear item in the File menu deletes all string items in the
current string table. This is a powerful function and must be used
carefully to avoid accidentally deleting an entire String list.
.*
.beglevel
.*
.section Deleting a String Item
.*
.np
To delete string items from the current string table one at a time:
.begstep
.step Select the string item you want to delete
from the Strings table by clicking on it.
.result
The selected string item is highlighted.
.step Choose Delete
from the Edit menu
.orstep Select the Delete button from the toolbar.
.result
The String Editor removes the selected string item from the Strings list.
.step Choose Update
from the File menu
to save the string table changes.
.endstep
.*
.section Deleting All String Items
.*
.np
To delete all string items in the current string table:
.begstep
.step Choose Clear
from the File menu
.orstep Select the Clear button on the toolbar.
.result
A message box appears prompting you to verify that you want to clear
all of the string items from the current string table.
.step Choose Yes, No, or Cancel
to continue.
.result
Choosing Yes removes all string items from the current string table.
The Strings list is left empty.
.endstep
:CMT. .figure *depth='2.22' *scale=200 *file='STR3' As a safety feature, a message box appears when you choose the Clear function.
.figure *depth='1.46' *scale=68 *file='STR5' As a safety feature, a message box appears when you choose the Clear function.
.*
.endlevel
.*
.section Saving String Items
.*
.np
.ix 'String Editor' 'save string items'
.ix 'String Items' 'save'
There are three functions you can use to save string tables with the
String Editor:
.begbull $compact
.bull
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 String Editor: Update
.*
.np
After modifying a string item in a string table, choose Update
from the File menu on the String Editor window to save the updated
string table to the current resource file. This prevents the changes from
being lost when you exit the String 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 string table changes made.
.*
.section String Editor: Save As
.*
.np
Choose Save As from the File menu on the String Editor window to save
the current string table to another resource file. A Save Menu dialog
appears where you specify the resource file to which you want to save the
current string table.
:CMT. .figure *depth='2.78' *scale=150 *file='STR4' On the Save Menu dialog, specify the resource file to which you want to save the string table.
.figure *depth='2.24' *scale=65 *file='STR6' On the Save Menu dialog, specify the resource file to which you want to save the string table.
.begnote
.note Important:
If the resource file to which you are saving the string table already
contains resources, the existing resources will be discarded and
replaced with the string table you are saving.
.endnote
.*
.section String Editor: Copy To
.*
.np
Choose Copy To from the Resource menu on the String Editor window to
copy the current string table into an existing resource file. A Copy To
dialog appears where you specify the resource file to which you want to copy
the current string table. Unlike the Save As function, copying a
string table to a resource file adds an entry to the list of resources
rather than replacing the existing resources with the new entry.
:CMT. .figure *depth='3.24' *scale=165 *file='STR5' On the Copy To dialog, specify the resource file to which you want to copy the String list.
.figure *depth='2.24' *scale=65 *file='STR7' On the Copy To dialog, specify the resource file to which you want to copy the String list.
.*
.endlevel
.*
.section Using Shortcuts to Create String Tables
.*
.np
.ix 'String Tables' 'shortcuts to creating'
.ix 'String Editor' 'shortcuts to creating string tables'
The Edit menu on the &company String Editor window contains some
standard Windows options that you can use to quickly create string
tables. The options are:
.begbull $compact
.bull
Cut
.bull
Copy
.bull
Paste
.endbull
.np
These options allow you to perform functions on a string table but not
on individual string items.
.begnote
.note Cut
Choose Cut from the Edit menu of the String Editor window to cut the
Strings list from the current string table and paste it to the
clipboard.
.note Copy
Choose Copy from the Edit menu of the String Editor window to copy the
String list in the current string table to the clipboard.
.note Paste
Choose Paste from the Edit menu of the String Editor window to copy
the string table on the clipboard into the current String list.
.endnote
.*
.section String Editor: Changing Memory Options
.*
.np
.ix 'Memory Options' 'in String Editor'
.ix 'String Editor' 'change memory options'
The Memory Flags option allows you to change the selected memory
options for the current string table. These options indicate the
memory type and loading instructions.
:CMT. This is a new screen snap shot
.figure *depth='1.89' *scale=66 *file='STR8' Changing memory options
.begstep To set the memory flags for a string table:
.step Choose Memory Flags
from the Resource menu
of the &company String Editor window.
.result
The Memory Options dialog opens displaying either the current or
default memory options.
.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.
.result
Following is a description of each option.
.begpoint $break
.point Moveable
Selecting this option marks this string table to be stored in moveable
memory when it is loaded by an application.
.point Discardable
Selecting this option marks this string 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 string
table is loaded into to be modified.
.point Preload
All string tables marked as Preload will be loaded when the
application for which you are creating the string table is loaded.
.point LoadOnCall
String tables marked as LoadOnCall will be loaded only when an
application issues a call to load them.
.endpoint
.step Click on OK
when all memory option selects are made.
.result
The Memory Options dialog closes returning you to the String Editor window.
.endstep
.*
.endlevel
.*