wguidlog.gml

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

you can select a symbol from the combo box. You can drop down the
combo list box and select a symbol from there.
.figure *depth='0.47' *scale=62 *file='DIA11' The combo box is labelled "ID".
:cmt. For more information about loading and selecting symbols, see the
:cmt. sections entitled "Loading Symbols" and "Selecting Symbols".
.*
.section Changing the Caption in a Dialog
.*
.np
A dialog's caption is the text that appears in the title bar of the
dialog.
.np
You can type in the edit field of the Information Bar to change the
caption's name.
.*
.section Adding Controls to a Dialog
.*
.np
.ix 'Dialog Editor' 'add controls'
Select a tool that will allow you to create controls by selecting an
item from the Tools menu or from the toolbox.
.np
There are two ways in which controls may be drawn in the dialog.
.onestep
.step Click the left mouse button
at the position where you would like the top left corner of the
control to be. The control will be created in its default size.
.orstep Press the left mouse button and drag out a rectangle.
Release the left mouse button.
.endstep
.np
The tool box goes back to select mode when you draw a control (the
current tool becomes the select tool).
.np
To draw more than one of the same types of controls without having to
choose the control from the toolbar or menu every time, choose the
sticky tool which causes the tool to stay down.
.*
.section Modifying Controls in a Dialog
.*
.ix 'Dialog Editor' 'modifying dialog controls'
.np
Once you have created controls for your dialog you can modify the
controls as follows:
.begstep
.step Double-click the control.
.orstep Select the control and Press ENTER.
.result
A Style dialog box appears.
.endstep
.np
Once in the Dialog editor, you can define your dialog box. You can
also add, change, group, reorder, move, resize, ore delete dialog
controls so that your dialog box functions the way you want it to.
.*
.section Ordering Controls in a Dialog
.*
.ix 'Dialog Editor' 'ordering dialog controls'
.np
There is an ordering associated with the controls of a dialog. This
ordering is commonly referred to as the "tab order" and controls which
dialog control is highlighted next when you press the TAB or cursor
keys. As you add controls to a dialog, they are added to the end of
the list.
.np
The Dialog editor allows you to change this ordering using a simple
"point-and-click" technique. To do this:
.begstep
.step Select the dialog
.step Select Set Order
from the Dialog Menu dialog
.orstep Press the Set Order button
on the toolbar
.result
All of the controls in the dialog now have a button at their top-left
corner indicating their current position.
.step Click the dialog controls
in order until the ordering is what you would like.
.step Select Set Order
from the Dialog Menu dialog
.orstep Press the Set Order button
on the toolbar
.result
Reselecting Set Order will terminate the ordering session and record
any changes made.
.endstep
.np
As you click the dialog controls you will notice two things. First,
the buttons at the dialog controls top-left take on a "depressed"
look. This indicates a button you have already clicked. Second, the
unselected or unclicked buttons will reorder themselves to reflect any
changes you have made so far. This will allow you terminate the
ordering session without having to click all of the dialogs controls.
.np
Clicking on a dialog control that is in the "depressed" or selected
state will undo the new ordering you have given it and it will go back
to its original position. If a "depressed" dialog control already has
its original position then it finds the first available position. This
feature is handy if you make a mistake and would like to perform a
quick fix.
.np
There may be a point in the ordering process where you decide to start
over from the beginning. Instead of clicking over all the dialog
controls you have previously clicked or leaving and then re-entering
the Set Order mode you may simply double click the dialog control you
wish to be first. This will undo all that you have done and make the
selected dialog control the first one.
.np
You may run into a situation where the first n dialog controls are
correctly ordered but subsequent one are not. Before you begin to
click through the first n dialog controls note that there is a better
way. Simply shift-click the n'th control to accept the current
ordering up to that point and proceed.
.*
:cmt.######### this is the beginning of the commented out text #########
:cmt..np
:cmt..ix 'Dialog Editor' 'choosing Controls'
:cmt..ix 'Controls' 'choosing in Dialog Editor'
:cmt.Depending on the type of information you want the user to give your
:cmt.application, you must create the appropriate controls for your dialog. The
:cmt.following list helps you decide when to use one control and when to use
:cmt.another:
:cmt..begpoint $break Choosing Options
:cmt..point If only one option
:cmt.Use a push button
:cmt..point If between two exclusive options
:cmt.Use a check box
:cmt..point If between three exclusive options
:cmt.Use a radio button
:cmt..endpoint
:cmt..np
:cmt.Following are descriptions of the controls you can use to create your
:cmt.dialogs:
:cmt..np
:cmt..bd Push Buttons
:cmt..br
:cmt.If you want users to initiate some action, such as OK, Cancel, or Help, use a
:cmt.push button.
:cmt..np
:cmt..bd Check Boxes
:cmt..br
:cmt.If you want the user to choose binary, yes or no information, use a check
:cmt.box.
:cmt..np
:cmt..bd Radio Buttons
:cmt..br
:cmt.If you want the user to choose between three or more exclusive options, use
:cmt.a radio button.
:cmt..np
:cmt..bd Group Boxes
:cmt..br
:cmt.If you would like to group controls together such as radio buttons and check
:cmt.boxes to help users understand your dialogs, use one of the static controls:
:cmt..np
:cmt.If you want to give users more information about why a group of controls-
:cmt.such as radio buttons and check boxes-are grouped together, use a group
:cmt.box with a meaningful heading on it.
:cmt..np
:cmt..bd Frames
:cmt..br
:cmt.If you want to group controls together without a heading, use a frame.
:cmt..np
:cmt..bd List Boxes
:cmt..br
:cmt.If you want the users to be able to read a list of options and select one, use a
:cmt.list box.
:cmt..np
:cmt..bd Simple Combo Boxes
:cmt..br
:cmt.If you want users to be able to select an option from the list box or type the
:cmt.option they want directly into the edit field, use a simple combo box.
:cmt..np
:cmt..bd Drop Down Combo Boxes
:cmt..br
:cmt.If you want users to be able to.... Help?
:cmt.you have to press another button to make the list box drop down and then it
:cmt.works the same way. It has a button beside the edit field (a pop-box or
:cmt.drop-down button).
:cmt.drop down list combo box: same as drop down but not given an edit field,
:cmt.but are given a static text field that shows user what he selected from list
:cmt.box. You can't type in it.
:cmt..np
:cmt..bd Icon Control
:cmt..br
:cmt.Use this button to display an icon in your dialog for visual impact.
:cmt..np
:cmt..bd Horizontal and Vertical Scroll Bars
:cmt..br
:cmt.If you want to allow users to scroll within a large dialog quickly and, be able
:cmt.to see where they are within a large dialog, use horizontal and vertical scroll
:cmt.bars.
.*
:cmt..section Changing the Dialog Size
.*
:cmt..np
:cmt.To modify the size of a dialog,
:cmt..autonote
:cmt..note
:cmt.Select the dialog.
:cmt..note
:cmt.Drag the dialog's sizing handles until the dialog is the size you want.
:cmt..endnote
.*
:cmt..section Changing the Location of a Dialog
.*
:cmt..np
:cmt..ix 'Dialog Editor' 'change location of dialog'
:cmt..ix 'Dialog' 'change location of'
:cmt.Since you'll want all parts of your dialog to be visible to your users and grab
:cmt.their attention, you can modify the location of your dialog relative to the
:cmt.parent window. To do this:
:cmt..autonote
:cmt..note
:cmt.Drag the dialog to the position you want in the edit window.
:cmt..endnote
.*
:cmt..section Saving Dialogs
.*
:cmt..np
:cmt..ix 'Dialog' 'save'
:cmt..ix 'Dialog Editor' 'saving dialogs'
:cmt.It is a good idea to save changes to your dialog as you modify it rather than
:cmt.wait for the Dialog Editor to prompt you when you close your dialog or exit
:cmt.the Dialog Editor. There are five ways to save dialogs. The two primary
:cmt.ways to save a dialog are to select the following from the file menu:
:cmt..begbull $compact
:cmt..bull
:cmt.Select Save from the file menu.
:cmt..bull
:cmt.Select Save As from the file menu.
:cmt..endbull
:cmt..np
:cmt.Selecting Save or Save As from the File menu saves the entire .RES, .EXE, or .DLL file in which your dialog resides, updating any changes you made to
:cmt.your dialog in the process.
:cmt..np
:cmt.In addition, there are three other ways to save your dialog. You can choose
:cmt.Dialog Save, Dialog Save As, or Dialog Save Into from the Dialog menu.
:cmt.Saving a dialog from the Dialog menu only saves one resource-the current,
:cmt.selected dialog-not the entire .RES, .EXE, or .DLL file which typically
:cmt.contains numerous resources. To create your own private copy of a favorite
:cmt.resource from an executable in a library or in.... (This is wrong. When would
:cmt.you want to save from Dialog menu?)...choose save from the Dialog menu.
:cmt..begnote
:cmt..mnote Warning:
:cmt.If you choose to save from the dialog menu you will only be saving the
:cmt.current dialog and not any of the other resources in the .RES, .EXE, or .DLL
:cmt.file. If you save the dialog under the same name as the .RES, .EXE, or .DLL
:cmt.file, you will overwrite all the resources in that file and be left with a .RES, .EXE, or .DLL file that contains nothing more than your dialog.
:cmt..endnote

:cmt..section Changing the Caption Name of a Dialog
.*
:cmt..np
:cmt..ix 'Dialog Editor' 'change caption name'
:cmt.The caption name of a dialog is the name associated with the dialog
:cmt.resource when you save it to a dialog resource file.
:cmt..np
:cmt.To avoid name conflicts, (you can't have two dialog resources with the same
:cmt.name, in the same file) you will want to change the name of your dialog (the
:cmt.editor gives you one as a default) Type in the edit field a name you want to
:cmt.give your dialog, or , if you have loaded symbols, you can select a symbol
:cmt.from the combo box. You can drop down the combo list box and select a
:cmt.symbol from there. For more information about loading and selecting symbols,
:cmt.see the sections titled Loading Symbols and Selecting Symbols
.*
:cmt..section Changing the Caption in a Dialog
.*
:cmt..np
:cmt.A dialog's caption is the text that appears in the title bar of the dialog.
:cmt..np
:cmt.You can type in the edit field of the Information Bar to change the caption's
:cmt.name.
.*
:cmt..section Modifying Controls in a Dialog
.*
:cmt..ix 'Dialog Editor' 'modifying dialog controls'
:cmt..np
:cmt.Once you have created controls for your dialog you can modify the controls
:cmt.as follows:
:cmt..begbull
:cmt..bull
:cmt.Double-click the control.
:cmt..br
:cmt.The Style dialog box appears.
:cmt..endbull
:cmt..np
:cmt.Once in the Dialog editor, you can define your dialog box. You can also add,
:cmt.change, group, reorder, move, resize, ore delete dialog controls so that your
:cmt.dialog box functions the way you want it to.
.*
:cmt..section Ordering Controls in a Dialog
.*
:cmt..np
:cmt.The moment you add controls to a dialog, they are ordered (there is an
:cmt.ordering associated with the controls of a dialog) Ordered as you created
:cmt.them (if you open an existing Dialog, they will be ordered the same way
:cmt.they were when they were created).
.*
:cmt..section Adding Controls to a Dialog
.*
:cmt..np
:cmt..ix 'Dialog Editor' 'add controls'
:cmt.Select a tool that will allow you to create controls by selecting an item from
:cmt.the Tools menu or from the toolbox.
:cmt..np
:cmt.Drawing with the tool: drag out a rectangle with the mouse. Drag mouse
:cmt.across the dialog or edit window.
:cmt..np
:cmt.The tool box goes back to select mode when you draw a control (the current
:cmt.tool becomes the sect tool).
:cmt..np
:cmt.To draw more than one of the same types of controls without having to
:cmt.choose the control from the toolbar or menu every time, choose the sticky
:cmt.tool which causes the tool to stay down.
.*
.endlevel