PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US

X
Y
  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
..CaptionHTML is used to handle the caption of a control in HTML format.
Versions 23 and later
WEBDEV - Browser code This property is now available in browser code.
New in version 23
WEBDEV - Browser code This property is now available in browser code.
WEBDEV - Browser code This property is now available in browser code.
Example
LINK_GSC..CaptionHTML = "Display the <strong>general sales conditions</strong>"
Syntax

Retrieving the value of the control caption Hide the details

<Result> = <Control Name>..CaptionHTML
<Result>: Character string
Caption of the control in HTML format.
<Control Name>: Character string (with or without quotes)
Name of control to use: Rich Text Area, button, ...

Modifying the value of the control caption Hide the details

<Control Name>..CaptionHTML = <New Value>
<Control Name>: Character string (with or without quotes)
Name of control to use: Rich Text Area, button, ...
<New Value>: Character string (with quotes)
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. The assignment of ..CaptionHTML deletes the value of the caption assigned by ..Caption (and conversely).
An access in read-only to ..Caption while the caption of the control is an HTML caption triggers an error. On the contrary, reading ..CaptionHTML while the control caption is assigned by ..Caption returns the caption value encoded in HTML.
Summary table:
Property assigned in the control: ..CaptionProperty assigned in the control: ..CaptionHTML
Property read: ..CaptionThis option returns.Error.
Property read: ..CaptionHTMLReturns the value encoded in HTML.This option returns.

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,
  • Versions 20 and later
    Edit control,
    New in version 20
    Edit control,
    Edit control,
  • Versions 20 and later
    Check Box control,
    New in version 20
    Check Box control,
    Check Box control,
  • Versions 20 and later
    Radio Button control,
    New in version 20
    Radio Button control,
    Radio Button control,
  • Versions 20 and later
    List Box control,
    New in version 20
    List Box control,
    List Box control,
  • Versions 20 and later
    Formatted display control,
    New in version 20
    Formatted display control,
    Formatted display control,
  • Versions 20 and later
    Combo Box control,
    New in version 20
    Combo Box control,
    Combo Box control,
  • Versions 20 and later
    Option of a Check Box control,
    New in version 20
    Option of a Check Box control,
    Option of a Check Box control,
  • Versions 20 and later
    Option of a Radio Button control,
    New in version 20
    Option of a Radio Button control,
    Option of a Radio Button control,
  • Versions 21 and later
    Menu option.
    New in version 21
    Menu option.
    Menu option.
  • Versions 22 and later
    Table column.
    New in version 22
    Table column.
    Table column.
Minimum required version
  • Version 19
Comments
Click [Add] to post a comment