ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
  • Static and HTML static
  • Validity of HTML code
  • Limitation
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
The CaptionHTML property is used to handle the text of a control as HTML code.
Example
LINK_GSC.CaptionHTML = "Display the <strong>general sales conditions</strong>"
Syntax

Retrieving the value of control caption Hide the details

<Result> = <Control to use>.CaptionHTML
<Result>: Character string
Control caption in HTML format.
<Control to use>: Control name
Name of the control to be used: Rich Text Area, Button, etc.

Modifying the value of control caption Hide the details

<Control to use>.CaptionHTML = <New value>
<Control to use>: Control name
Name of the control to be used: Rich Text Area, Button, etc.
<New value>: Character string
New caption for the control. This value must correspond to a valid HTML code.
Remarks

Static and HTML static

A control includes a caption or an HTML caption: it cannot include both at the same time. Assigning a value to the CaptionHTML property deletes the value of the text assigned with the Caption property (and conversely).
An error occurs if the Caption property is accessed in read-only mode and the text in the control is in HTML. However, reading the CaptionHTML property in a control whose caption has been assigned using the Caption property returns the value of the caption in HTML.
Summary table:
Property assigned in the control: CaptionProperty assigned in the control: CaptionHTML
Property read: CaptionReturns the value.Error.
Property read: CaptionHTMLReturns the value encoded in HTML.Returns the value.

Validity of HTML code

No check is performed regarding the validity of HTML code. If an invalid HTML value is assigned in the control, the page may not be displayed properly by the browser. You must pay attention to:
  • The tags (and attributes) not properly closed or invalid for the HTML standard of the page (HTML 4, HTML 5, ...).
  • The encoding of special characters. You have the ability to use TextToHTML.

Limitation

This property is available for the following controls:
  • Button control,
  • Link control,
  • Rich Text Area control,
  • Edit control,
  • Check Box control,
  • Radio Button control,
  • List Box control,
  • Formatted display control,
  • Combo Box control,
  • Option of Check Box control,
  • Option of Radio Button control,
  • Menu option.
  • Table column.
Minimum version required
  • Version 19
Comments
Click [Add] to post a comment

Last update: 05/26/2023

Send a report | Local help