The Static control

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Static control

The Static control

Overview of Static control

Creating a Static control

Handling a Static control

Notes

Related examples

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 give effects to the displayed text, you have the ability to use:

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

Notes:

Versions 15 and later
The static controls found in a window can also be configured with a display mask to automatically format the value that is assigned to them.
New in version 15
The static controls found in a window can also be configured with a display mask to automatically format the value that is assigned to them.
The static controls found in a window can also be configured with a display mask to automatically format the value that is assigned to them.

Versions 16 and later

This type of control is now available for the Windows Phone applications.

This type of control is now available for the WINDEV applications in Linux.

New in version 16

This type of control is now available for the Windows Phone applications.

This type of control is now available for the WINDEV applications in Linux.

This type of control is now available for the Windows Phone applications.

This type of control is now available for the WINDEV applications in Linux.

Versions 18 and later

This type of control is now available for the applications in Windows Store apps mode.

New in version 18

This type of control is now available for the applications in Windows Store apps mode.

Creating a Static control

Create a Static control in a window or in a report

To create a Static control in a window or in a report:

In the window or report editor, click . You also have the ability to select:
- "Insert .. Control .. Static" in the window editor.
- "Insert .. New control .. Static" in the report editor.
On the "Creation" pane, in the "Usual controls" group, click .
Click the position where the control will be created in the window or report. The control appears in creation mode.

To display the control characteristics, select "Description" from the popup menu of control. You can for example type the text displayed in the control.

Notes:

The reports are not available.
Versions 19 and later
The multiline Static controls support the ellipse: if the text is too long to fit in its static control, the end of the text is represented by three dots. The ellipsis management is defined in the "Details" tab of Static control.
New in version 19
The multiline Static controls support the ellipse: if the text is too long to fit in its static control, the end of the text is represented by three dots. The ellipsis management is defined in the "Details" tab of Static control.
The multiline Static controls support the ellipse: if the text is too long to fit in its static control, the end of the text is represented by three dots. The ellipsis management is defined in the "Details" tab of Static control.
Versions 21 and later
The multiline Static controls can be justified ("Horizontal alignment: Justified").
New in version 21
The multiline Static controls can be justified ("Horizontal alignment: Justified").
The multiline Static controls can be justified ("Horizontal alignment: Justified").

Create a Static control in a window or in a report

To create a Static control in a window:

On the "Creation" pane, in the "Usual controls" group, click .
Click the position where the control will be created in the window. The control appears in creation mode.

To create a Static control in a report:

On the "Creation" pane, in the "Text" group, click .
Click the position where the control will be created in the report. The control appears in creation mode.

To display the control characteristics, select "Description" from the popup menu of control. You can for example type the text displayed in the control or define the type of information displayed in the control.

Notes:

The reports are not available.
Versions 19 and later
In a window, the multiline Static controls that can manage the ellipsis: if the text is too long to fit in its static control, the end of the text is represented by three dots. The ellipsis management is defined in the "Details" tab of Static control.
New in version 19
In a window, the multiline Static controls that can manage the ellipsis: if the text is too long to fit in its static control, the end of the text is represented by three dots. The ellipsis management is defined in the "Details" tab of Static control.
In a window, the multiline Static controls that can manage the ellipsis: if the text is too long to fit in its static control, the end of the text is represented by three dots. The ellipsis management is defined in the "Details" tab of Static control.
Versions 21 and later
In a window, the multiline Static controls can be justified ("Horizontal alignment: Justified").
New in version 21
In a window, the multiline Static controls can be justified ("Horizontal alignment: Justified").
In a window, the multiline Static controls can be justified ("Horizontal alignment: Justified").

Creating a Static control in RTF format in a window

To create a Static control in RTF format in a window:

In the window editor, click (or select "Insert .. Control .. Static").On the "Creation" pane, in the "Usual controls" group, click .
Display the description window of control ("Description" from the popup menu).
In the "Details" tab, select "Text with formatting (R.T.F.)".
In the "General" tab, type the text of static in RTF format: a specific toolbar is automatically displayed, allowing you to format the text.

Notes:

An RTF static control can also be created via a cut/paste operation of a RTF text in the window.
To use a static control in RTF format, the "RICHED20.DLL" file must be found on the current computer. In most cases, the "RICHED20.DLL" file is found in the system directory of Windows.
Versions 16 and later
You also have the ability to use ..RichEdit to modify the RTF type of a Static control by programming.
New in version 16
You also have the ability to use ..RichEdit to modify the RTF type of a Static control by programming.
You also have the ability to use ..RichEdit to modify the RTF type of a Static control by programming.

Transforming a "Static" control into an "RTF" control (report editor)

To display text in RTF format in a "Static" control, check "RTF format" in the "Details" tab of the control description.

The "Static" control becomes an "RTF" control. All characteristics of "Static" control are kept. See RTF control for more details.

Handling a Static control

Typing the text of Static control

To type the text of Static control:

Click the Static control in the editor. The input cursor is displayed.
Type the text of Static control.

For the HTML or RTF static controls, each element can be formatted via a toolbar.

Modifying a Static control in the report editor

Two methods are available:

Method 1:
1. Select the control. The selection handles appear around the control.
2. Click the control again. The mouse cursor turns into an input cursor.
3. Type the new caption of control.
4. Modify (if necessary) the formatting via the formatting toolbar.
5. As soon as a click is performed outside the control, the control switches back to read-only.
Method 1:
1. Select the control. The selection handles appear around the control.
2. Click the control again. The mouse cursor turns into an input cursor.
3. Type the new caption of control. As soon as a click is performed outside the control, the control switches back to read-only.
  Note: The formatting in the report editor can be performed via the ribbon directly: on the "Modification" pane, use the options of "Fast edit" group.Note: You can format a caption in the report editor directly from the ribbon: on the "Modification" pane, use the options of the "Quick edit" group.
Method 2:
1. Select the control.
2. Display the description window of control ("Description" from the popup menu).
3. Type the new caption in each language supported by the control.
4. Modify (if necessary) the formatting in the "Style" tab.Modify (if necessary) the formatting in the "Style" tab.
  Note: The formatting in the report editor can be performed via the ribbon directly: on the "Modification" pane, use the options of "Fast edit" group.Note: You can format a caption in the report editor directly from the ribbon: on the "Modification" pane, use the options of the "Quick edit" group.

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 a report item or control into the text, enter the item or control name must between [% and %].
For example, the caption of the control can correspond to:
The [%SupplierName%] supplier sells the [%ProductName%] product at [%PriceIOT%].
The SupplierName, ProductName and PriceIOT items will be replaced by their value when printing the report.
This caption can be typed on several lines. In this case, the control must be a multiline control and its size must be large enough.
Note: 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-sizable" option is used to automatically increase the control size according to its content.Reminder: The "Auto-resizable" 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 by programming.
A Static control can be linked to an item of a data file. In this case, the control is used to view the content of the items found in the data file.
Versions 15 and later
In the windows, the Static controls include a display mask in order to automatically format the data assigned to them. This mask can be modified by programming with ..InputMask.
New in version 15
In the windows, the Static controls include a display mask in order to automatically format the data assigned to them. This mask can be modified by programming with ..InputMask.
In the windows, the Static controls include a display mask in order to automatically format the data assigned to them. This mask can be modified by programming with ..InputMask.

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.