Thumbnail.SingleCaption Property (ExThumbnail)

By default, the SingleCaption property is "ffolder ? ( `Name: ` + fname + `` + ` ` + ( len( 0:= ftype ) ? `Type: ` + =:0 + `` + ` ` : `` ) + ( ffolder = 1 ? `Size: ` + fsizeF + `` + ` ` : `` ) + `Created: ` + date(fcreated - bias/24/60) + `` + ` ` + `Modified: ` + date(fmodified - bias/24/60) + ``+ ` ` + `Last Opened: ` + date(fopened - bias/24/60) + ``+ (fpicture ? (` Dimensions: ` + fwidth + ` x ` + fheight + `` ) : ``) ) : ffile" which makes the control to display full information about the file like seen in the following screen shot. The SingleCaption property indicates the expression to generate the HTML caption to be displayed on the thumbnail, when the control shows a single thumbnail ( for instance you filter and you got a single result ). Use the Caption property to specify a caption to be displayed on the thumbnail.

Use the Alignment property to specify the caption's alignment. The CaptionRotate property rotates the HTML caption. Use the Transparency property to specify the transparency to display the caption on the thumbnail control. Use the Font property to specify the font to display the caption on the thumbnail. Use the ForeColor property to specify the control's foreground color. Use the WordWrap property to wrap the caption on the control. The StatusCaption property indicates the expression to generate the HTML caption to be displayed on the thumbnail's status bar.

For instance:

"ffile" displays the full name of the file
"`Name: ` + fname", displays just the name of the file
"`Created: ` + longdate(fcreated) + ` ` + time(fcreated)", displays the date-time the file was created

The SingleCaption property supports the following keywords:

fcount keyword, returns the number of thumbnail files
findex keyword, specifies the index of the thumbnail file
width keyword, specifies the current width of the thumbnail view
height keyword, specifies the current height of the thumbnail view
ffile keyword, returns the file
fname keyword, returns the name of the file
faname keyword, returns the alternate name of the file, 8.3 format truncated version of the name
fext keyword, returns the extension of the file
fcreated keyword, specifies when a file or directory was created
fmodified keyword, specifies when a file or directory was last modified
fopened keyword, specifies when a file or directory was last accessed
fsize keyword, specifies the size of the file
fsizeF keyword, returns automatically the size of the file in KB, MB or GB
ffolder keyword, returns 0, 1, 2, -1 or -2, if the object does not exist, it is a file, a shell item, a folder or a drive
fattr keyword, returns the attributes of the file/folder
ftype keyword, returns the type of the file/folder, like JPG File, ...
fpicture keyword, indicates whether the file points to a known picture type, like BMP, PNG, and so on
fwidth keyword, returns the width of the picture file
fheight keyword, returns the height of the picture file
ffilter keyword, returns the currently filter pattern ( FilterBarPromptPattern property )
fvcount keyword, indicates the number of visible thumbnails. For instance, if a filter is applied the fvcount returns the number of available/visible/filtered thumbnails.
fvindex keyword, indicates the index of the thumbnail in the visible collection.

This property/method supports predefined constants and operators/functions as described here.

The SingleCaption property supports the following HTML tags:

 ...  displays the text in bold
 ...  displays the text in italics
 ...  underlines the text
<s> ... </s> ~~Strike~~-through text
<a id;options> ... </a> displays an anchor element that can be clicked. An anchor is a piece of text or some other object (for example an image) which marks the beginning and/or the end of a hypertext link.The <a> element is used to mark that piece of text (or inline image), and to give its hypertextual relationship to other documents. The control fires the AnchorClick(AnchorID, Options) event when the user clicks the anchor element. The FormatAnchor property customizes the visual effect for anchor elements.
 ...  displays portions of text with a different font and/or different size. For instance, the bit 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, bit displays the bit text using the current font, but with a different size.
<fgcolor rrggbb> ... </fgcolor> or <fgcolor=rrggbb> ... </fgcolor> displays text with a specified foreground color. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<bgcolor rrggbb> ... </bgcolor> or <bgcolor=rrggbb> ... </bgcolor> displays text with a specified background color. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<solidline rrggbb> ... </solidline> or <solidline=rrggbb> ... </solidline> draws a solid-line on the bottom side of the current text-line, of specified RGB color. The <solidline> ... </solidline> draws a black solid-line on the bottom side of the current text-line. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<dotline rrggbb> ... </dotline> or <dotline=rrggbb> ... </dotline> draws a dot-line on the bottom side of the current text-line, of specified RGB color. The <dotline> ... </dotline> draws a black dot-line on the bottom side of the current text-line. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<upline> ... </upline> draws the line on the top side of the current text-line (requires <solidline> or <dotline>).
<r> right aligns the text
<c> centers the text
  forces a line-break
<img>number[:width]</img> inserts an icon inside the text. The number indicates the index of the icon being inserted. Use the Images method to assign a list of icons to your chart. 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 into the text being previously 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.
& glyph characters as & ( & ), < ( < ), > ( > ), &qout; ( " ) and &#number; ( the character with specified code ), For instance, the € displays the EUR character. 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 bold in HTML caption you can use bold
<off offset> ... </off> defines the vertical offset to display the text/element. The offset parameter defines the offset to display the element. This tag is inheritable, so the offset is keep while the associated </off> tag is found. You can use the <off offset> HTML tag in combination with the to define a smaller or a larger font to be displayed. For instance: Text with <off 6>subscript displays the text such as: Text with _subscriptThe Text with <off -6>superscript displays the text such as: Text with ^subscript
<gra rrggbb;mode;blend> ... </gra> defines a gradient text. The text color or <fgcolor> defines the starting gradient color, while the rr/gg/bb represents the red/green/blue values of the ending color, 808080 if missing as gray. The mode is a value between 0 and 4, 1 if missing, and blend could be 0 or 1, 0 if missing. The HTML tag can be used to define the height of the font. Any of the rrggbb, mode or blend field may not be specified. The <gra> with no fields, shows a vertical gradient color from the current text color to gray (808080). For instance the <gra FFFFFF;1;1>gradient-center</gra> generates the following picture:
<out rrggbb;width> ... </out> shows the text with outlined characters, where rr/gg/bb represents the red/green/blue values of the outline color, 808080 if missing as gray, width indicates the size of the outline, 1 if missing. The text color or <fgcolor> defines the color to show the inside text. The HTML tag can be used to define the height of the font. For instance the <out 000000><fgcolor=FFFFFF>outlined</fgcolor></out> generates the following picture:
<sha rrggbb;width;offset> ... </sha> define a text with a shadow, where rr/gg/bb represents the red/green/blue values of the shadow color, 808080 if missing as gray, width indicates the size of shadow, 4 if missing, and offset indicates the offset from the origin to display the text's shadow, 2 if missing. The text color or <fgcolor> defines the color to show the inside text. The HTML tag can be used to define the height of the font. For instance the <sha>shadow</sha> generates the following picture:
or <sha 404040;5;0><fgcolor=FFFFFF>outline anti-aliasing</fgcolor></sha> gets:

		Type	Description
		String	A String value that defines the expression to generate the HTML caption to be displayed on the thumbnail, when the control shows a single thumbnail.