Sage Push Button

This option allows you to add a Sage push button control to a dialog window. Process

To access this option, click on the custom control button in the tool box on the right side of the Resource Editor window (see figure 1). The Select Custom Control window will appear (see figure 2).

Select Sage Push Button. If you click on it once, a sample of what it looks like will appear in the Sample box on the right. Double click on it, or select OK to activate it. The Select Custom Control window will disappear.

Place your cursor in the small dialog box on the left side of the resource editor where you want this control to be placed, and click the left mouse button. The control will appear.

NOTE : To view the basic functionality of the control(s) that you have selected, click on Options/Test Mode at any time. Since Test Mode functions as a toggle switch, click on it once again to exit the test mode.

To define the attributes of the Sage push button, place your cursor on the control that you added to the dialog box, and click the right mouse button. The Sage Push Button Control Styles window will appear (see figure 3).

Complete the following information:

a. Table and Field : The contents of the memory record defined by Table and Field will be loaded with the value specified in the Value field. To designate the table and field to which this control will be associated, click on the down arrow in each field and select from the drop down list.

b. Link Information : Enter the label of this link in the Link Label field. This label should be the same as the push button label, but you can choose a different label should you wish to.

Each push button control will be linked to another object, or will terminate the dialog window. To terminate the dialog, select the Terminating check box. To link this control to an object, follow these steps:

Click on the Link check box.

To activate the Link To button, exit this window by clicking on OK and return to it again. Click on the Link To button. The Link Object window will appear (see figure 4).

Click on the down arrow in the In the Sequence field, and select the sequence that the link object is in. To define a new sequence, click on the New button and enter the required information.

Click on the down arrow in the Of the Object field, and select the link object. To define a new object, click on the New button and enter the required information.

NOTE : The Connect, Object and Via the Link fields are defined by the system and can not be edited. The Instance # field is filled in by the system when the sequence is selected. If the field says <new>, there is no dialog in that sequence. The To Instance field is filled in by the system when theobject is selected. If this field says <new>, this object has not been used in this sequence.

Click on OK. You will be returned to the Resource Editor window.

c. Standard/Custom Push Button : Select whether this will be a standard or a custom push button control by clicking on one of these radio buttons. If you select Custom Push Button, the Set Custom Push Button Attributes button will be activated. Click on it. The Custom Push Button Attributes window will appear (see figure 5).

Enter the custom bitmap file to be used on the push button in the Load Bitmaps From field, or click on Browse and select the file from the Open window that appears.

Define the size of the custom push button by entering the width and height measurements.

In the Normal section, define the appearance of the button when not in use by designating the BMP file to be used. If you would like an audible indicator when the control is returned to its normal status, type in the name of the WAV file to be used.

In the Focus section, define the appearance of the button when it is active by designating the BMP file to be used. If you would like an audible indicator when the control is selected, type in the name of the WAV file to be used.

In the Pressed section, define the appearance of the button when it is pressed by designating the BMP file to be used. If you would like an audible indicator when the control is selected, type in the name of the WAV file to be used.

Click on the OK button.

e. Tool-tip Help : To have a tool-tip help appear when the cursor is placed on this push button control, select this option by clicking on the Tool-tip Help check box. Enter the help message to be displayed in the Help field.

f. Label : Type in the label to appear on the push button (for example, OK, Cancel, Help, etc). NOTE: To have a letter underlined, place an ampersand (&) before it.

h. Basic Styles : Following are the four basic styles that you can select:

Visible - This option allows you to select whether you want this control to be visible or invisible on the dialog. If the box is checked, the control will be visible. The default on this control is visible.

Group - This option allows you to group controls so that the user can move between them with the arrow keys.

Disabled - If this box is checked, the control will appear on the dialog but will be disabled.

Tab Stop - A check in this box indicates that this control can be accessed with the keyboard tab key.

To exit the Sage Push Button Control Styles window and save the information, click on OK. To exit without saving, click on Cancel.