Document toolboxDocument toolbox

(8.D.2.7) StringControl

Overview

String Control

Discussion

The String Inspector Control interprets and displays a module's string array variable as a string value.

Variables

Properties

Name

Type

Default value

Range

Description

modVar

string

empty string

Unrestricted

Name of array variable to display

length

int

0

Unrestricted

The number of array elements containing text (4 characters per element).

value

string

empty string

Unrestricted

Value displayed below the string and units

caption

string

string

Unrestricted

A short text string to display above the string control

units

string

none

Unrestricted

When not empty, displays units string below the caption

color.text

int

000000

0:1:ffffff

Color of the text

font.name

string

'MS Shell Dlg 2'

Unrestricted

Any available Windows font may be used. All text in the inspector uses the same font

font.size

int

8

6:1:72

Size in points to use for the font. If the font is too large for the space available, the text will be clipped

font.style

string

normal

normal/bold/italic

Available styles are normal italic and bold

scaletext

int

false

0:1:1

When true, text font size scales with inspector size

border

int

1

0:1:1

When true, the surrounding border is turned on

caption.height

int

3

0:1:3

The number of vertical lines to reserve for the caption and units strings. When zero, caption is not displayed

color.bgnd

int

f0f0f0

0:1:ffffff

Color of the inspector background

color.border

int

b4b4b4

0:1:ffffff

Color of the inspector border, if shown

scale

float

1.0

0.5:3.0

Specifies the magnification of all parts of the inspector. Height is computed from scale and other properties and can’t be manually specified,

width

int

69

59:500

Width in DPI independent units

x

int

none

Unrestricted

Horizontal position of top left in DPI independent units

y

int

none

Unrestricted

Vertical position of top left in DPI independent units