EXTTEXT dialog element   [VDS6]

Top  Previous  Next

Syntax:

 

DIALOG ADD,EXTTEXT,<name>,<top>,<left>,<width>,<height>,<text>,<tooltip>,<styles>

Description:

 

This dialog element displays the formatted text <text> at the position and size specified, in the specified <style>. If <width> and <height> are left blank, the width of the dialog element is automatically sized to the displayed text.

Text may be formatted using tags similar to HTML. The following tags are supported:

<B>...</B>

Specifies that the text enclosed by the tags should be displayed in bold face

<I>...</I>

Specifies that the text enclosed by the tags should be displayed in italic face

<U>...</U>

Specifies that the text enclosed by the tags should be underlined

<H1>...</H1>

Specifies that the text enclosed by the tags should be displayed as a main heading

<H2>...</H2>

Specifies that the text enclosed by the tags should be displayed as a sub-heading

<A HREF="<url>">...</A>

Specifies a hyperlink. If the user clicks on the hyperlink, the address or file <url> will be opened using the action associated with this type of object, unless the CLICK style has been specified, in which case a CLICK event will be generated, and the <url> may be determined using the @CLICK function.

<COLOR=<color>>...</COLOR>

Specifies that the color of the text enclosed by the tags should be as specified. The <color> may be a string like: BACKGROUND, FOREGROUND, BLACK, RED, DKRED, DKGREEN, BROWN, DKBLUE, MAGENTA, GRAY, SILVER, LTGREY, YELLOW, LTBLUE, CYAN, WHITE, MAROON, OLIVE, GREEN, NAVY, PURPLE, LIME, TEAL, FUCHSIA, AQUA, BLUE, SYSTEM. They may also be hexadecimal RGB values like: $FFEDBA.

<TAB>

Specifies a tab character, which can be used to align text on different rows

<BR>

Specifies where line breaks are to occur. (Lines of text that are too long to fit within the width of the dialog element will not automatically be wrapped.)

A <tooltip> may be specified to be displayed when the pointer is over the area occupied by the dialog element. Note: If a tooltip is required, the <width> and <height> of the dialog element must be specified.

Styles:

In addition to user-defined styles to change the default font style and color, the following styles may be used with this dialog element:

 

CLICK

A <name>CLICK event whenever the user clicks on a hyperlink (not on the rest of the text). The <url> enclosed by the hyperlink may then be determined using the @CLICK function.

<cursor style>

The cursor will change to the named style when the pointer is over the dialog element. Valid styles are: NONE, ARROW, CROSS, IBEAM, SIZE, NESW, NS, NWSE, WE, UP, WAIT, DRAG, NODROP, HSPLIT, VSPLIT, MULTI, SQL, NO, HELP, HAND.

See also:


Dialogs

TEXT dialog element