Specifies the caption being displayed on the control's sort bar when the sort bar contains no columns.
Type
Description
String
A String expression that indicates the caption of the control's sort bar.
The SortBarCaption property specifies the caption of the
control's sort bar, when it contains no sorted columns. Use the SortBarVisible
property to show the control's sort bar. Use the BackColorSortBar,
BackColorSortBarCaption and ForeColorSortBar
properties to specify colors for the control's sort bar. Use the SortBarHeight
property to specify the height of the control's sort bar. Use the SortBarColumnWidth
property to specify the width of the column in the control's sort bar. By
default, the SortBarCaption property is "Drag a <b>column</b>
header here to sort by that column.". Use the Font
property to specify the control's font. Use the ItemBySortPosition
property to access the columns in the control's sort bar.
The SortBarCaption property may include built-in HTML tags like follows:
<b> bold </b> bolds a part of the caption.
<u> underline </u> specifies that the portion should
appear as underlined.
<s> strikeout </s> specifies that the portion should
appear as strikeout.
<i> italic </i> specifies that the portion should
appear as italic.
<fgcolor=FF0000>fgcolor</fgcolor>
changes the foreground color for a portion.
<bgcolor=FF0000>bgcolor</bgcolor>
changes the background color for a portion.
<br> breaks a line.
<solidline> draws a solid line. If has no effect for a single line
caption.
<dotline> draws a dotted line. If has no effect for a single line
caption.
<upline> draws the line to the top of the text line
<r> aligns the rest of the text line to the right side. It has no
effect if the caption contains a single line
<img>number[:width]</img> inserts an icon inside the cell's
caption. The number indicates the index of the icon being inserted. The last
7 bits in the high significant byte of the number expression indicates the
identifier of the skin being used to paint the object. Use the Add
method to add new skins to the control. If you need to remove the skin
appearance from a part of the control you need to reset the last 7 bits in
the high significant byte of the color being applied to the part. The
width is optional and indicates the width of the icon being inserted. Using
the width option you can overwrite multiple icons getting a nice effect. By
default, if the width field is missing, the width is 18 pixels.
<img>key[:width]</img> inserts a custom size picture being
loaded using the HTMLPicture property.
The Key parameter indicates the key of the picture being displayed. The
Width parameter indicates a custom size, if you require to stretch the
picture, else the original size of the picture is used.
<font face;size>text </font> displays portions of text
with a different font and/or different size. For instance, the <font
Tahoma;12>bit</font> draws the
bit text using the Tahoma font, on size 12 pt. If the name of the font is
missing, and instead size is present, the current font is used with a
different size. For instance, <font ;12>bit</font>
displays the bit text using the current font, but with a different size.
& glyph characters as & ( & ), <
( < ), > ( > ), &qout ( " ), &#number,
For instance, the € displays the EUR character, in UNICODE
configuration. The & ampersand is only recognized as markup
when it is followed by a known letter or a # character and a digit. For
instance if you want to display <b>bold</b> in HTML caption
you can use <b>bold</b>