wguidlog.gml

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

.np
.ix 'Dialog Editor' 'Information Bar'
The Information Bar is located under the toolbar. It provides
information about the currently selected object you are adding to the
dialog or modifying. This object can be a control or the dialog window
itself. There are three fields in the Information Bar. The contents of
two fields depends on whether the selected object is a dialog or a
control. You may press F9 to set the keyboard focus to the Information Bar.
While the Information Bar has the keyboard focus you may press ESCAPE to
have the focus return to the Editor.
.figure *depth='0.63' *scale=84 *file='DIA7' The Dialog Editor information bar
.np
Changes made to these fields are only processed once you press ENTER
or click on the Set button. Reverse uncommitted changes by clicking on
the Discard button.
.begnote
.note Size
The Size field in this area contains three sets of numbers. These
numbers provide information on the size and position of the selected
dialog or object in the Edit Window. The default number sequence when
you create a new dialog is:
.millust begin
(20, 20) (115, 95) 95x75
.millust end
.np
(20, 20) indicates that the top left hand corner of the dialog is at
the position 20, 20 on the Edit Window grid.
.np
(115, 95) indicates that the bottom right hand corner of the dialog is
at the position 115, 95 on the Edit Window grid.
.np
95x75 indicates the width and height of the dialog.
.endnote
.*
.beglevel
.*
.section Dialogs
.*
.begnote
.note Caption
When the selected object is a dialog, this field contains the name of
the dialog that you want to appear on the dialog in the application.
Any changes you make to this field are not stored until you:
.begbull $compact
.bull
.bd Press ENTER,
or
.bull
.bd Select the Set button
to the right of the field.
.endbull
.note Dlg Name
When the selected object is a dialog, this field contains the name of
the dialog resource. This is the name by which the dialog is stored in
the resource file. When you create a new dialog, the Dialog Editor assigns
the default name DIALOG_# to the new dialog. You change the name of
the dialog using the Dlg Name field.
.begstep To change the dialogs name:
.step Type the new dialog name
using double quotes if the dialogs name is to be an character string.
.orstep Type the symbol name
(without double quotes). New symbols will automatically be created.
.endstep
.endnote
.*
.section Controls
.*
.begnote
.note Text
When the selected object is a control, the Text field contains the
text appearing in the dialog with the selected object.
.figure *depth='0.47' *scale=62 *file='DIA8' The information bar text field
.np
This field is not applicable for all objects. Any changes you make to
this field are not stored until you:
.begbull $compact
.bull
.bd Press ENTER,
or
.bull
.bd Select the Set button
to the right of the field
.endbull
.note ID
There are two parts to the ID field. The field on the right contains
the numeric value of the currently selected control. Each control
always has a numeric identifier. You may enter a symbol here ( new
symbols will automatically be created ) or a numeric identifier.
.np
The symbol is a string used to specify the selected control. This is an
alternate way to identify the control in your source code.
.endnote
.*
.endlevel
.*
.section The Edit Window
.*
.np
The edit window is the window on which you create dialogs and
controls. It represents the resource file that your dialog is a part of.
.figure *depth='3.20' *scale=39 *file='DIA9' The Dialog Editor edit window
.np
The edit window gives you space so you can temporarily move controls
off your dialog when it gets too crowded. For example, to rearrange
controls in your dialog, you can drag them onto the edit window and
then drag them back onto the dialog in the desired order.
.np
Although you can't see it on your screen, the edit window is an
infinite grid with the origin (0,0) initially at its top left. Dialogs
are always positioned relative to the edit window. The origin is in
the middle of the world co-ordinate system, which is the reason the
scroll thumbs are initially in the middle of the scroll bars.
.*
.section The Workspace
.*
.np
The workspace is the area under the Information Bar on which
you can manipulate several resource files. This area can be compared to
your desktop. For instance, if you minimize an edit window, an icon
representing that edit window appears in the workspace. The
workspace provides you with an area in which to open and close
edit windows.
.figure *depth='3.34' *scale=68 *file='DIA10' The Dialog Editor workspace
.*
.endlevel
.*
.section Dialog Functions
.*
.np
.ix 'Dialog Editor' 'dialog functions'
This section describes the several functions you can perform with the
Dialog Editor. The following tasks are included in this section:
.begbull $compact
.bull
Creating New Dialogs
.bull
Opening Existing Dialogs
:cmt..bull
:cmt.Choosing Controls
.bull
Changing the Dialog Size
.bull
Changing the Location of a Dialog
.bull
Saving Dialogs
.bull
Changing the Name of a Dialog
.bull
Changing the Caption in a Dialog
.bull
Adding Controls to a Dialog
.bull
Modifying Controls in a Dialog
.bull
Ordering Controls in a Dialog
.endbull
.*
.beglevel
.*
.section Creating New Dialogs
.*
.np
.ix 'Dialog Editor' 'create new dialogs'
When you open the Dialog Editor, it displays an empty dialog box in
the editor window of the Dialog Editor window. You can change the size
and location of this dialog and add controls to it to meet the needs
of your application. However, if you are not happy with the changes
you have made and want to delete your dialog to start over again, or if
you want to modify more than one dialog at a time, you can create
another empty dialog in one of the following ways:
.begstep
.step Select New
from the File menu.
.step Select New
from the toolbar.
.step Draw another dialog
in the editor window with the "dialog" item from the
toolbox.
.endstep
.np
An empty dialog named "Untitled" appears in the editor window. Now you
can add controls to the empty dialog, and change its size and location
within the edit window.
.*
.section Opening Existing Dialogs
.*
.np
.ix 'Dialog Editor' 'open existing dialogs'
You can open a dialog from any .RES, .EXE, or .DLL file to your edit
window where you can modify it. To do this:
.begstep
.step Open the file you want,
in one of the following ways:
.begbull $compact
.bull
Select Open from the file menu, or
.bull
Select the Open button from the toolbar.
.endbull
.step Select the .RES, .EXE, or .DLL file
that contains the dialog you want to copy.
.result
The &company Dialog Editor Open Resource dialog appears.
.step Select the resource file you want.
.step Select the name of the file you want,
in one of the following ways:
.begbull $compact
.bull
Select the name and press OK, or
.bull
Double click on the name of the file.
.endbull
.np
If there are any dialog resources in the file, the Select Dialog
appears listing the names of all the dialog resources that exist in
that resource file.
.begnote
.mnote Note:
If the file does not contain any dialog resources, the main screen
appears with an empty edit window and dialog for you to add controls
and modify.
.endnote
.step Select one or more dialogs to place in the edit window
in one of the
following ways:
.begbull $compact
.bull
Double click on the dialogs you wish to modify, or
.bull
Select the dialogs you wish to modify and select OK.
.endbull
.np
The dialog you copied appears in the edit window of your main screen.
From here you can add controls to the dialog and modify its size and
location.
.endstep
.*
.section Changing the Dialog Size
.*
.np
To modify the size of a dialog,
.begstep
.step Select the dialog.
.step Position the mouse
above the appropriate sizing handle.
.step Drag the dialog's sizing handle
until the dialog is the size you want.
.endstep
.np
You will notice that the dialog size information in the Information
Bar will track the size of the dialog.
.*
.section Changing the Location of a Dialog
.*
.np
.ix 'Dialog Editor' 'change location of dialog'
.ix 'Dialog' 'change location of'
Since you will want all parts of your dialog to be visible to your
users and grab their attention, you can modify the location of your
dialog relative to the parent window. To do this:
.begstep
.step Position the mouse
either above the dialog caption or within several pixels of the
dialog's border (while remaining in the dialog).
.step Drag the dialog
to the position you want in the edit window.
.endstep
.np
You will notice that the dialog size information in the Information
Bar will track the location of the dialog.
.*
.section Saving Dialogs
.*
.np
.ix 'Dialog' 'save'
.ix 'Dialog Editor' 'saving dialogs'
It is a good idea to save changes to your dialog as you modify it
rather than wait for the Dialog Editor to prompt you when you close
your dialog or exit the Dialog Editor. There are five ways to save
dialogs. The two primary ways to save a dialog are to select one of
the following from the file menu:
.begbull $compact
.bull
Save
.bull
Save As
.endbull
.np
Selecting Save or Save As from the File menu saves the entire resource
file in which your dialog resides, updating any changes you made to
your dialog in the process.
.np
In addition, there are three other ways to save your dialog. You can
choose Save, Save As, or Copy To from the Dialog menu. Saving a dialog
from the Dialog menu only saves one resource &mdash. the currently
selected dialog &mdash. not the entire resource file which typically
contains numerous resources.
.begnote
.note Warning:
If you choose to select Save or Save As from the dialog menu you will
only be saving the current dialog and not any of the other resources
in the resource file. If you save the dialog under the same name as the
resource file, you will overwrite all the resources in that file and be
left with a resource file that contains nothing more than your dialog.
.endnote
.*
.section Changing the Name of a Dialog
.*
.np
.ix 'Dialog Editor' 'change name'
The name of a dialog is the name associated with the dialog resource
when you save it to a dialog resource file.
.np
To avoid name conflicts, (you can't have two dialog resources with the
same name, in the same file) you will want to change the name of your
dialog (the editor gives you one as a default). Type in the edit field
a name you want to give your dialog or, if symbols have been loaded,