ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Various properties
  • Content of Static control
  • Equivalence
  • Caption associated with a window or with a page
  • Text of a Static, Edit, Combo Box, List Box or ListView control
  • Text of with a table column
  • Text of a Check Box or Radio Button control
  • Caption associated with an Image control
  • Caption associated with a button
  • Limitations
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
In a database, the Caption property is used to:
  • Find out the caption associated with a file item.
    Remark: The item was created in the data model editor or through programming.
  • Find out the caption associated with a data file.
    Remark: The data file may have been created in the data model editor or through programming.
  • Find out and modify the connection caption. The connection can correspond to:
In a report, the Caption property is used to get and change the text:
  • of a Static control.
  • of a Link control.
  • of a Chart control.
In a window or page, the Caption property is also used to:
  • Find out and modify the caption of a control in a window or in a page.
  • Find out and modify the caption of a menu option.
  • Find out and modify the title of a window or page.
Reminder: The initial caption of a control, window, page or menu option is defined in the editor during the object description.
Example
Universal Windows 10 AppAndroidAndroid Widget iPhone/iPadIOS Widget
// Find out the caption associated with the Customer.Title item
ResCaption = Customer.Title.Caption
// Modify the text in the "STC_IntroControl" Static control
STC_IntroControl.Caption = "Hello" + Customer.FullName
// Equivalent to: STC_IntroControl.Caption = "Hello [%Customer.FullName%]"
Universal Windows 10 AppAndroidAndroid Widget iPhone/iPadIOS Widget
// Change the button caption
IF WIN_Window1.Modified = True THEN
BTN_Add.Caption = "Save"
ELSE
BTN_Add.Caption = "Close"
END
Syntax
Universal Windows 10 AppAndroidAndroid Widget iPhone/iPadIOS Widget

Finding out the caption associated with an item Hide the details

<Result> = <Data file>.<Item>.Caption
<Result>: Integer
Item caption.
<Data file>: Character string
Logical name of the data file used.
<Item>: Character string
Name of the item used.

Finding out the text of caption associated with an element Hide the details

<Result> = <Element used>.Caption
<Result>: Character string
Text displayed in the specified element.
<Element used>: Type of element
Name of the element to be used.

Modifying the text of caption associated with an element Hide the details

<Element used>.Caption = <New text>
<Element used>: Type of element
Name of element to use.
<New text>: Character string
New text displayed in the specified element.
Remarks

Content of Static control

To retrieve the value of a control or the value of an item in a Static control:
  • In the report editor: insert [%<Control name>%] or [%<Item name>%] directly into the caption of the control.
  • In programming: there are two possible syntaxes with the Caption property:
    • use directly the [%<Control name>%] or [%<Item name>%] string in the string that corresponds to the caption. For example:
      STC_IntroControl.Caption = "Hello [%Customer.FullName%]"
    • use the name of the control or the name of the item in the caption. For example:
      STC_IntroControl.Caption = "Hello" + Customer.FullName

Equivalence

The Caption and Value properties are equivalent.
To retrieve the text of a Static control, the following syntaxes are equivalent:
ResCaption = <Static control>.Caption

ResCaption = <Static control>.Value

ResCaption = <Static control>
To modify the text displayed in a Static control, the following syntaxes are equivalent:
<Name of Static control>.Caption = <New text>

<Name of Static control>.Value = <New text>

<Name of Static control> = <New text>
Universal Windows 10 AppAndroidiPhone/iPadIOS Widget

Caption associated with a window or with a page

The caption associated with a window or with a page corresponds to the title of the window or to the title of the page. This title is returned by the Title property.
Universal Windows 10 AppAndroidAndroid Widget iPhone/iPadIOS Widget

Text of a Static, Edit, Combo Box, List Box or ListView control

The control caption corresponds to the text of caption.
In a Static control, this text is returned by the Value property.
Android Widget This property is available for a Static control only.
AndroidiPhone/iPadIOS Widget

Text of with a table column

The text of a table column corresponds to the column title and is returned by the Title property.
Universal Windows 10 AppAndroidiPhone/iPadIOS Widget

Text of a Check Box or Radio Button control

The Caption property is used to get and change:
  • the text of a Check Box or Radio Button control,
  • the text of an option in the Check Box or Radio Button control.
To modify the caption of an option found in a Check box or Radio Button control:
<Control name>[<Index>].Caption = <New caption>
For example:
RADIO_Radio_Button[2].Caption = "Option number 2"
To modify the caption associated with a Check box or Radio Button control:
<Control name>.Caption = <New caption>
For example:
RADIO_Radio_Button.Caption = "Age of participants"
To retrieve the caption of an option:
<Control>[Index].Caption
Universal Windows 10 AppAndroidiPhone/iPadIOS Widget

Caption associated with an Image control

The Caption property returns or replaces the current image with the image passed as parameter.
The Caption property has the same effect as assigning the name of the image to the control (Control = Image_Name).
The Image control includes a caption: the Caption property is used to change this text. If the new caption does not correspond to a valid image, the caption of the Image control is modified.
Universal Windows 10 AppAndroidAndroid Widget iPhone/iPadIOS Widget

Caption associated with a button

The Caption property can have two actions:
  • replace the image of the button (the name passed as parameter corresponds to an image file),
  • return or replace the button caption (the text passed as parameter is not an image file name).
For example:
// Modify the image of a graphic button
BTN_Button1.Caption = "Help.BMP"
 
// Modify the caption of a text button
BTN_Button1.Caption = "New caption"
Remark: If the specified text contains the & character, the letter that follows & is interpreted as the shortcut of the control.

Limitations

Universal Windows 10 AppiPhone/iPadIOS Widget In a report, the Caption property can only be used on "Static" and "Link" controls.
WINDEV Mobile In a window, the Caption property cannot be used on the following types of controls:
  • Spin
  • Scrollbar
Android Widget The Caption property can only be used with the following elements:
  • Button control.
  • Static control.
iPhone/iPadIOS Widget The Caption property is not available on Table controls. However, it is available for table columns.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/05/2023

Send a report | Local help