In this section: How to: Reference: |
Edit boxes and multi-edit boxes enable end users to view, enter, and edit data for a stack or user-defined field. Edit boxes allow only single lines of text, while multi-edit boxes allow multiple lines.
Draw a rectangle on your form approximately where you want your edit box or multi-edit box to be at approximately the size you want.
To assign the contents of the edit box or multi-edit box to a variable, select From a variable, and then select a variable or data source stack column. You can create a new variable or data source stack by clicking New variable or New data source stack. For more information, see How to Create a Variable in a Procedure.
Note:
Use the Insert dialog box, shown in the following image, to populate edit and multi-edit boxes with data.
This dialog box contains the following elements:
Select As entered below to set the text directly.
Select From a variable to set the value from a variable.
This is available only if you select As entered below. This option enters the maximum number of characters this edit box or multi-edit box can contain.
This is available only if you select From a variable. This option opens the New Variable dialog box, where you can create a variable.
This is available only if you select From a variable. This option opens the Stack Editor, where you can create a stack.
This is available only if you select From a variable. This option contains a list of the existing stacks, variables, and database fields in your procedure, as shown in the image below.
Either select a variable, or expand a data source stack or database and select a column.
This is available only if you select From a variable. This option lists the fields from the data sources used in this procedure.
Note: We recommend that you do not use the Current Area. Data source stacks are a superior way of accessing and manipulating data source values, and they function more intuitively than the Current Area.
When you select your edit box or multi-edit box, you will see a list of edit box or multi-edit box properties in the property sheet. Changing these properties will change what your edit box or multi-edit box looks like and what it does at run time.
Many of the styling properties can also be changed using a Cascading Style Sheet. For more information on Cascading Style Sheets, see Using Cascading Style Sheets.
Choose your edit box property or multi-edit box property based on the task you wish to perform:
If you want to change the contents of the edit box of multi-edit box, use the Text Property to open the Insert Text dialog box. For more information, see the Insert Text Dialog Box.
If you want to change the name of the edit box or multi-edit box that identifies it to the procedure, use the (Name) Property. For more information, see the (Name) Property.
If you want to change the size or location of the edit box or multi-edit box, use the Bottom Property, Left Property, Right Property, Top Property, or use a style sheet. For more information, see the Bottom Property, Left Property, Right Property, and Top Property. You can also move or resize the edit box or multi-edit box directly in the form.
If you want to change the color of the edit box or multi-edit box, use the BackColor Property to determine the color of the box, the ForeColor Property to determine the color of the text in the box, or use a style sheet. For more information, see the BackColorOver Property and the ForeColor Property.
If you want to change the font in the edit box or multi-edit box, use a style sheet or use the Font Property. For more information, see the Font Property.
If you want to change the case of text entered in the edit box or multi-edit box before being returned to the bound variable, use the CaseStyle Property. For more information, see the CaseStyle Property.
If you want to display only asterisks, instead of actual characters when an end user enters information into an edit box, use the Password Property. This property does not apply to multi-edit boxes. For more information, see the Password Property.
If you want to make the contents of the edit box or multi-edit box read-only, use the ReadOnly Property. You can accomplish this by disabling the Enable property, but this method does not dim the control. For more information, see the ReadOnly Property.
If you want to remove the border or add a border to the edit box or multi-edit box, use the Border Property.
If you want to make the edit box or multi-edit box inactive or make it invisible, use the Enabled Property to determine whether the edit box or multi-edit box is active or not. If the edit box or multi-edit box is inactive, it will be dimmed out and nothing will happen when the end user clicks it. You can also use the Visible Property to determine whether the edit box or multi-edit box is visible to the end user or use a style sheet. For more information, see the Enabled Property and the Visible Property.
If you want to change what the cursor looks like when it is on top of the edit box or multi-edit box, use the CursorPointer Property or use a style sheet. For more information, see CursorPointer Property.
If you want to display a tooltip when the cursor is on the top of the edit box or multi-edit box, use the ToolTipText Property. For more information, see the ToolTipText Property.
If you want to assign a Help topic to the edit box or multi-edit box, use the Help Property. For more information, see Assigning Help to Your Forms and Controls.
If you want the end user to be able to tab to the edit box or multi-edit box, use the Tabstop Property. For more information, see the Tabstop Property.
If you want to move the edit box or multi-edit box to another layer, use the Layer Property. For more information, see Layering Controls.
If you want to enable automatic validation of data formats at run time, use the IBIValidation Property.
If you want to control the display order of the combo box or list box when more than one control is overlaid, use the ZIndex Property. For more information, see the ZIndex Property.
Reference: |
A prompted edit box consists of two controls grouped together, an edit box and a text control describing the edit box, as shown in the following image.
WebFOCUS Maintain generates prompted edit boxes for you automatically during the following situations:
Note: We recommend that you do not use this method for generating prompted edit fields. Data source stacks are a superior way of accessing and manipulating data source values, and they function more intuitively than the Current Area.
If you want to change the properties for either the edit box or the text control separately, select the prompted edit box. Then select either the edit box or the text control in the drop-down list of grouped controls in the property sheet.
For more information on grouping controls, see Grouping Controls.
WebFOCUS Maintain includes a special alignment command for aligning prompted edit boxes along the left sides of the edit boxes. For more information, see How to Align Prompted Edit Boxes Along the Left Sides of the Edit Boxes.
When you drag a data source stack from the Project Explorer into the Form Editor, WebFOCUS Maintain displays the Select Stack Columns dialog box, shown in the following image. Use this dialog box to determine which columns in the data source stack for which to create prompted edit boxes.
This dialog box has the following options:
Select the columns in this data source stack that you want to display on your form. Clear the columns you do not want to display.
Selects all the columns in the data source stack.
Clears all the columns in the data source stack.
When you drag a segment from a data source in the Project Explorer into the Form Editor, WebFOCUS Maintain displays the Select Segment Fields dialog box, shown in the following image. Use this dialog box to determine which fields in the data source segment WebFOCUS Maintain should create prompted edit boxes for and what their data source should be.
When you finish specifying information in this dialog box and click OK, WebFOCUS Maintain will do the following:
This dialog box has the following options:
Select the fields in this data source segment that you want to display on your form. Clear the fields you do not want to display.
Selects all the fields in the segment.
Clears all the fields in the segment.
Select Current Area to specify that the data source for the edit fields will be the Current Area.
Select New stack to specify that the data source for the edit fields will be the data source stack you specify here. WebFOCUS Maintain suggests a name for this data source stack, but you can type another name here.
Note:
Enables you to select all of the fields in a single segment of a hierarchical database. If you have a flat file or relational database this enables you to select all of the fields.
WebFOCUS |