wguidlog.gml

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

.chap The &company Dialog Editor
.*
.if &e'&dohelp eq 0 .do begin
.section Introduction
.do end
.*
.np
.ix 'Dialog Editor'
Dialogs are windows that contain controls such as push buttons, check
boxes, list boxes, and combo boxes. Dialogs are the principle medium
for the exchanging of information between the user and the
application. You include dialogs in your application to prompt the
user for information, enable the user to change settings, and allow
the user to make choices. Dialogs provide the medium through which
users and your application can communicate with each other.
.np
The &company Dialog Editor enables you to create dialogs. With this
editor you can design and test your dialogs so you can see exactly how
they will look and work in your application.
.np
The Dialog Editor allows you to create a new dialog or modify an
existing dialog. When you complete the dialog you can save it as a
resource script or binary resource file. You can also save your dialog
directly to an .EXE or .DLL file if you originally loaded that dialog
from one of these files.
.*
.section Using the Dialog Editor
.*
.np
This section discusses the following topics:
.np
.begbull $compact
.bull
Starting the Dialog Editor
.bull
Quitting the Dialog Editor
.bull
Saving a Resource File with the Dialog Editor
.bull
The Dialog Editor Menu Bar
.bull
The Dialog Editor Toolbar
.endbull
.*
.beglevel
.*
.section Starting the Dialog Editor
.*
.np
.ix 'Dialog Editor' 'start'
.ix 'start' 'Dialog Editor'
The Dialog Editor is a stand-alone application, so you can invoke it
without first starting the Resource Editor. To start the Dialog
Editor, double click on the Dialog Editor icon in your Windows Program
Manager. An empty &company Dialog Editor window opens. To create a
dialog resource you must first open a resource file. You can either open a
new or existing resource file.
.np
How you proceed depends on whether you are opening a new resource file or
working with an existing resource file.
.figure *depth='3.20' *scale=50 *file='DIA1' The Dialog Editor window
.*
.beglevel
.*
.section Opening a New Resource File with the Dialog Editor
.*
.np
.ix 'New'
.ix 'Dialog Editor' 'open new resource file'
.bd Choose New from the File menu
of the &company Dialog Editor window.
.np
Default dialog information appears in the editor window of the Dialog
Editor window. The Dialog Editor window is ready for you to create a
new dialog resource.
.*
.section Opening an Existing Resource File with the Dialog Editor
.*
.np
.ix 'Dialog Editor' 'open existing resource file'
.ix 'Open option'
.begstep
.step Double click on the Dialog Editor icon.
.result
The &company Dialog Editor window opens.
.step Choose Open
from the File menu.
.result
An Open Dialog Resource dialog appears listing all resource files.
.step Double click on the resource file you want to open
.orstep Click on the resource file you want to open
to select it, then
.bd click on OK.
.result
A Select Dialog(s) dialog appears listing all of the dialog resources
in the selected resource file. You can select one, several, or all of the
dialog resources in the resource file. All of the dialog resources you
select will open on the editor window of the Dialog Editor window.
.step Double click on the dialog you want to open.
.orstep Click on the dialogs you want to open
to select them, then
.bd click on OK.
.result
The selected dialog(s) appears in the &company Dialog Editor window in
the editor window.
.endstep
.figure *depth='1.78' *scale=66 *file='DIA2' You can select one or more resources to edit
.*
.endlevel
.*
.section Quitting the Dialog Editor
.*
.np
.ix 'leave' 'Dialog Editor'
.ix 'Dialog Editor' 'leave'
.ix 'quit' 'Dialog Editor'
To exit the Dialog Editor, choose Exit from the File menu of the
&company Dialog Editor window.
.np
When you exit the Dialog Editor, it remembers the size and position of
its main window and the position of the toolbox. It also remembers
whether the toolbar and toolbox were hidden or not. The next time you
open the Dialog Editor, it will be set up the same way you left it.
The Dialog Editor also remembers the directory in which you last
opened or saved a dialog. This feature makes the Dialog Editor more
convenient and efficient to use.
.*
.section Saving a Resource File with the Dialog Editor
.*
.np
There are two functions you can use to save resource files with the Dialog
Editor:
.begbull $compact
.bull
Save
.bull
Save As
.endbull
.begnote
.note Important:
You can have several resource files open in the Dialog Editor window at one
time. The caption bar of the currently selected resource file appears
highlighted. Only this window is affected when you choose Save
or Save As from the File menu.
.endnote
.begnote
.note Note:
Save operations will always create a file containing the dialog script(s)
(.DLG) and a resource file (.RES).
.endnote
.*
.beglevel
.*
.section Dialog Editor: Save
.*
.np
.ix 'Save option'
.ix 'Dialog Editor' 'Save'
.bd Choose Save from the File menu
in the &company Dialog Editor window to save any changes made to the
resource file.
.np
After modifying individual dialog resources, you perform an update at
the resource level (the Save item in the Dialog menu). The resource file is
not saved until you perform a save at the editor level as well, using
the Save function. The Dialog Editor prompts you if you
attempt to exit the editor without saving changes. Choose Yes, No, or
Cancel to continue.
.*
.section Dialog Editor: Save As
.*
.ix 'Save As option'
.begstep
.step Choose Save As
from the File menu in the &company Dialog Editor window to save any
changes made to the resource file.
.result
A Save Resource dialog appears where you specify the file to which you
want to save the current resource file.
.step Specify the file to which you are saving
by selecting an existing file or entering the name of a new file.
.begnote
.note Note:
If you attempt to save the current resource file to an existing resource file, a
Save Resource message box appears informing you that the selected file
already exists. Choosing Yes on this dialog overwrites the selected
existing resource file with the contents of the current resource file.
Choosing No returns you to the Save Resource dialog.
.endnote
.step Click on OK
when completed.
.result
The dialog closes and the editor saves the resource file, returning you to
the Dialog Editor window.
.endstep
.*
.endlevel
.*
.section The Dialog Editor Menu Bar
.*
.figure *depth='3.20' *scale=50 *file='DIA3' The Dialog Editor menu bar
.np
.ix 'Dialog Editor' 'menu bar'
.ix 'menu bar' 'Dialog Editor'
The menu bar consists of the following five menus:
.begpoint $break
.point File
Open and save resource file, load libraries, select custom controls, work
with symbols, and exit the editor
.point Edit
Access the clipboard functions, align and size the dialog controls,
configure the dialog, and delete dialogs
.point Dialog
Test, revert, and save the dialog, create a new dialog, copy the
dialog to another resource file, and set the order, tabs, and groups for
dialog controls
.point Tools
Select the desired tools to use to create the dialog
.point Window
Manipulate child windows, arrange icons, and hide/show the toolbox and
toolbar
.point Help
Access the 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 Dialog Editor Toolbar
.*
.np
.ix 'Dialog Editor' 'toolbar'
In the &company Dialog Editor window, the toolbar appears below the
menu bar when the Show Toolbar item in the Window menu is enabled.
Once enabled, the menu item changes to Hide Toolbar. To disable this
feature, choose Hide Toolbar from the File menu and the Toolbar
disappears.
.figure *depth='0.43' *scale=100 *file='DIA4' The Dialog Editor Toolbar
.np
The following explains the function each icon performs, as well as the
equivalent function in the menu bar.
.begpoint
.point Create
Create a new resource file. This is equivalent to the item New in
the File menu.
.point Open
Open an existing resource file. This is equivalent to the item Open
in the File menu.
.point Save
Save the current resource file. This is equivalent to the item Save
in the File menu.
.point Cut
Cut the selected object(s) to the clipboard. This is equivalent to the
item Cut in the Edit menu.
.point Copy
Copy the selected object(s) to the clipboard. This is equivalent to the
item Copy in the Edit menu.
.point Paste
Paste the object(s) on the clipboard to the current resource file. This is
equivalent to the item Paste in the Edit menu.
.point Size
Size the selected control to the text within it. This is equivalent to
the item Size to Text in the Edit menu.
.point Test
Test the current dialog. This is equivalent to the item Test Mode in
the Dialog menu.
.point Order
Order the controls in the current dialog. This is equivalent to the
item Set Order in the Dialog menu.
.point Set Tab
Set tab stops in the current dialog. This is equivalent to the item Set
Tabs in the Dialog menu.
.point Set Groups
Set groups in the current dialog. This is equivalent to the item Set
Groups in the Dialog menu.
.endpoint
.np
To see the function of an item in the toolbar, position your cursor
over the desired icon. A description of the button's function appears
in the status line at the bottom of the window.
.*
.section The Dialog Editor Toolbox
.*
.np
The toolbox allows you to conveniently select the tool you want,
without having to access it through the Tools menu. Each toolbox
button represents an option in the Tools menu. Moving the cursor over
the toolbox buttons displays the function of the button in the status
bar.
.figure *depth='3.20' *scale=43 *file='DIA5' The Dialog Editor toolbox
.*
.endlevel
.*
.section Using the Dialog Editor Window
.*
.np
.ix 'Dialog Editor' 'window'
The &company Dialog Editor window contains a menu bar, toolbar, toolbox,
and status line. The rest of the window is divided into three
sections:
.begbull $compact
.bull
The Information Bar
.bull
The Edit Window
.bull
The Workspace
.endbull
.figure *depth='3.20' *scale=44 *file='DIA6' The Dialog Editor window contains a menu bar, toolbar, workspace, and status line.
.*
.beglevel
.*
.section The Dialog Editor Information Bar
.*