DADiSP Online Help
Click here to see this page in full context

DADiSP Worksheet Functions > Function Categories > Annotation > TEXTCUR

 

TEXTCUR

Purpose:

Invokes a free-roaming text cursor in the current Window.

Syntax:

TEXTCUR(

target, fg, bg, font, box, legend, stretch, margin, focus)

target

-

Optional. An integer specifying the spatial relationship of the text to the Window:

0:

PAPER (default). The text is located on the "graph paper" in the Window; within the coordinate system of the data. The text scrolls with the series.

1:

GLASS. The text is located within the plotting area of Window. The text remains fixed in place when the series scrolls.

2:

GLASS_WMARGIN. The text is located within the area of the entire Window. The text remains fixed in place when the series scrolls.

3:

GLASS_WPMARGIN. The text is located within the vertical dimensions of a Window, and within the horizontal dimensions of the plotting area. The text remains fixed in place when the series scrolls.

4:

GLASS_WSMARGIN. The text is located anywhere within the entire Worksheet area.

fg

-

Optional. An integer specifying the foreground color of the text. Defaults to 1, the color of the primary series.

bg

-

Optional. An integer specifying the background color of the text. Defaults to 1, the Window background color.

font

-

Optional. An integer specifying the font:

0:

NORM_FONT (default)

1:

SMALL_FONT

2:

STATLINE_FONT

3:

POPBOX_FONT

4:

WINLABEL_FONT

5:

TOOLBAR_FONT

6:

LISTBOX_FONT

7:

MENU_FONT

8:

USER1_FONT

9:

USER2_FONT

10:

USER3_FONT

11:

PANEL_FONT

box

-

Optional. An integer specifying presence or absence of a solid line box surrounding the text (with margin if legend is ON, otherwise, no margin). 1: ON; 0: OFF. Defaults to 1.

legend

-

Optional. An integer specifying whether legend symbols are present or absent. 1: ON; 0: OFF. Defaults to 0.

stretch

-

Optional. An integer specifying whether to stretch the annotation to fit the rectangular region where the text block resides. 1: ON; 0: OFF. Defaults to 0.

margin

-

Optional. An integer specifying the margin to be adjusted:

-1:

No Margin Adjustment (default)

0:

Top Margin

1:

Right Margin

2:

Bottom Margin

3:

Left Margin

focus

-

Optional. An integer specifying the focus for PAPER annotations. Defaults to 1, the primary focus.

Example:

textcur

 

invokes a free-roaming crosshair cursor in the current Window. To move the cursor, use the mouse, the arrow keys or the [CTRL] arrow keys. Pressing the left mouse button, the [RETURN] key, or typing in text causes the "Input:" prompt to appear. Text may then be entered at the command line. Each newly entered text line immediately follows the most recently completed text line on the screen as the next row of the text block.

 

Pressing [RETURN] ends editing of the current line. At this point, the cursor can be positioned anywhere in the Window and additional blocks of text can be entered. Or press the right mouse button (or [ESC]) to complete text editing.

 

Pressing the right mouse button, pressing [ESC], or moving the crosshair cursor completes the previous text block.

Remarks:

To evaluate functions or macros and have resulting scalar or string value(s) displayed as a text annotation, surround the function name by curly braces. For example, {max} evaluates the MAX function and displays the maximum value of the current series in the text annotation.

 

To erase single lines of text (while in the input mode) use [CTRL]-[X]; use TEXTDEL to erase blocks of text.

 

TEXTCUR does not work in an empty Window.

 

See TEXT to add text to a window programmatically.

 

Use SETPRECISION to control display of numeric values of functions embedded in text.

See Also:

LEGCUR

TEXT

TEXTDEL

TEXTEDIT

TEXTMOVE