The Static control

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / Developing an application or site / Controls, windows and pages / Controls: Available types / Static control

Overview of Static control
Control in a window, in a page (static or dynamic) or in a report
Creating a Static control
Create a Static control in a window or in a report
Creating an RTF Static control in a window
Creating a Static control in a page
Handling a Static control
Typing the text of the Static control
Content of Static control (report editor)
Notes

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

The Static control

Overview of Static control

Control in a window, in a page (static or dynamic) or in a report

A Static control is a control used to display a static text. The content of the control cannot be entered by the user.

To apply effects to the displayed text, you have the ability to use:

The control style, by configuring the "Shadow" element.
The "RTF" type to display a text in RTF.
A specific animation (scroll or blink).

Remarks:

Static controls can also be configured with a display mask to automatically apply a format to the value that is assigned to them.
You can configure different effects for the Static control in the "Style" tab of the control description window. You can:
- configure the border of the control. For example, this option allows you to display an image in a Static control.
  The icon (to the right of the "Border" option) allows you to configure the shadow of the border. If a shadow is used, you can choose the X and Y offset, percentage of opacity, blur radius and shadow color.
- set the characteristics of the font via the button. You can define:
  - the line spacing,
  - the character spacing,
  - New in version 28
    the text angle.

Creating a Static control

Create a Static control in a window or in a report

To create a Static control in a window:

On the "Creation" tab, in the "Usual controls" group, click .
Click at the desired location to create the control. The control appears in the editor.

To create a Static control in a report:

On the "Creation" tab, in the "Text" group, click .
Click where the control will be created in the report. The control appears in the editor.

To view the characteristics of the control, select "Description" in the context menu. You can type text in the control or define the type of information that will be displayed.

Remarks:

Reports are not available.
In a window, multiline Static controls can use ellipsis: if the text is too long to fit in the control, the end of the text is replaced with three dots. The use of the ellipsis can be defined in the "Details" tab of the Static control.
In a window, multiline Static controls can be justified ("Horizontal alignment: Justified").

Creating an RTF Static control in a window

To create an RTF Static control in a window:

On the "Creation" tab, in the "Usual controls" group, click .
Open the control description window (select "Description" in the context menu).
In the "General" tab:
- Select the type of Static control: "RTF".
- Enter the RTF text: a specific toolbar is automatically displayed, allowing you to format the text.

Remarks:

You can also create an RTF Static control via the "RTF text" Smart control.
An RTF Static control can also be created by pasting RTF text directly in the window.
To use a Static control in RTF, the "RICHED20.DLL" file must be on the current computer. In most cases, the "RICHED20.DLL" file is in the Windows system directory.
You can also use the RichEdit property to modify the RTF type of a Static control through programming.

Creating a Static control in a page

To create a Static control in a page:

On the "Creation" tab, in the "Usual controls" group, expand "Text" and select "Simple static".
Click where you want to create the control in the page. The control appears in the editor.

To view the characteristics of the control, select "Description" in the context menu.

Handling a Static control

Typing the text of the Static control

To type the text of the Static control:

Click the Static control in the editor. The input cursor is displayed.
Type the text of the Static control.
For RTF Static controls (in a window or report), the format of each element can be defined via a toolbar.

Remark: The text of the Static control can also be edited in the control description window.

Content of Static control (report editor)

The character string displayed in the Static control can contain the value of an item printed in the report. To insert the value of an item or a control of the report into the text of the Static control, enter the name of the item or control between [% and %].
For example, the text of the control can correspond to:
The [%SupplierName%] supplier sells the [%ProductName%] product at [%PriceIOT%].
SupplierName, ProductName and PriceIOT will be replaced with their value when the report is executed.
Text can span multiple lines. In this case, the control must be a multiline control and its size must be large enough.
Remark: If an orientation angle is applied to a multiline control, the automatic CR characters are ignored. Only the manual CR characters are taken into account.

Reminder: The "Auto-resizing" option is used to automatically increase the control size according to its content.

Notes

The content of a Static control can be typed in the editor or defined through programming.
A Static control can be bound to an item in a data file. In this case, the control is used to view the content of the items in the data file.
To display numeric data (amount, date, time, etc.), use the formatted display control: the data will be displayed according to the selected input mask.
To define an anchor on a Static control:
1. Open the control description window.
2. In the "UI" tab, select "Define as anchor".
3. Validate.
In the windows, Static controls include a display mask to automatically apply a format to the data assigned to them. This mask can be modified programmatically with the InputMask property.

Related Examples:

Unit examples (WINDEV): The Static control

[ + ] Using a Static control

Unit examples (WINDEV): Management of RTF

[ + ] Using the main functions for RTF management in a WINDEV application:
- Load a file in RTF format
- Save a file in RTF format
- Find and select a word in an RTF text
- Display a text in RTF format
- Modify the characteristics of a selection (font, case, color, ...)

Unit examples (WEBDEV): HTMLClass property

[ + ] The property ..HTMLClass allows you to read and update the control's HTML attribute "class".
This property lets you select the CSS Style applied on the control.

Sample components (WEBDEV): WW_CloudTags

[ + ] This example explains how to display a cloud of tags in a dynamic WEBDEV application.
Indeed, on Internet, a site page responds more or less to a set of keywords.
The purpose of this example is to explain how to display the keywords of a site in an area of the page by indicating the important keywords graphically.
The keywords are represented as links of different sizes: the more important the keyword is, the larger the font is.