1. Basic information
1.1. Description of the control
RichTextBox is a text box of any width and height for entering formatted text.
1.2. Create a new control
The new richtextbox can be created as follows from the preview page using the toolbar with controls:
- First, clicking the mouse on the view page determines the position in which the new richtextbox should be placed. This will highlight the selected position with a gray horizontal line. Then just click on the item “RichTextBox” in the toolbar of the view page, fill in the attributes of the new control in the newly opened dialog, and then save. This will insert a new richtextbox at a pre-selected location on the view page.
- If the desired position is not determined before inserting a new richtextbox, the new richtextbox will be inserted at the end of the view page.
1.3. Edit or delete a control
- For each existing control, a pencil icon appears to the left of the control page to change or delete the control's settings.
- Individual controls can be moved vertically on the view page using the Drag&Drop method. Moving consists of grabbing the control, preferably behind its name, and then dragging it to the desired location on the view page.
- For security reasons, it is important to have the function of moving controls enabled using the “Drag&Drop” check box located above the toolbar with controls. This field is unchecked each time you log in to the application.
2. List of tabs in the control settings dialog
- General – Setting general properties
- Rights – Rights settings
- Administration – Setting other properties
2.1. “General” tab
- The name of the control displayed on the preview page in a separate column with a coloured background to the left of the text box itself.
- The dictionary lists the names of other controls, forms, view pages, categories, applications, and application groups used across the entire application.
- The dictionary search is used to design the correct control name and to maintain the consistency of the nomenclature throughout the application so that controls with the same meaning located in different places in the application are named in the same way.
- The width of the control, expressed in pixels.
- The default height of the control, in pixels.
- The height of the text box automatically increases so that the entire contents of the text box are always visible.
- The value is defined by the database query that is evaluated when the preview page is opened, and specifies the value displayed in the text box.
- The value of the text field can be accessed using the variables “#richtextbox1#”, “#richtextbox2#”, “#richtextbox3#” etc. in the script. The index indicates the order of the rich text box on the view page.
- Read only
- The read-only control setting determines whether the text box should be disabled on the preview page.
- It is not possible to enter values manually in the disabled field.
- The comment determines whether the text box should be displayed read-only with the option to enter comments using the “New Comment” button located below the text box in the edit form.
- Clicking on the “New comment” button will display a new dialog with the option to enter a comment in the form of formatted text.
- Subsequent confirmation of the entered comment using the “Insert comment” button or using the “CTRL + ENTER” key combination inserts into text fields on the view page
- blank line
- login name of the author of the comment,
- comma and space,
- current date and time,
- go to a new line and
- the text of the written comment itself.
2.2. “Rights” tab
- Rights define a list of user groups and users who have permission to display the control on the view page.
2.2.2. Replace rights to other controls
- The “Replace rights to other controls” feature is used to unify rights across the entire view page for controls that are related in terms of rights.
- Thanks to the “Show…” link, it is possible to display a list of all controls on the view page, including the settings of the rights of these controls. For each control, a check box is displayed that allows you to select the control. When you save a control, the same rights are then set for those selected controls.
- An alternative for unifying rights within the entire view page is to display the report available from the “Subordinate object rights” tab in the view page settings.
2.3. “Administration” tab
- The “Administration” tab is only displayed for existing controls.
- Select the view page on which the control is located.
- The drop-down list contains all view pages located in the same application.