37 statictext

The keyword statictext is used for the definition of the text which is not interactively modifiable by the user. Single-line texts can be positioned and displayed in one window.

Definition

{ export | reexport } { model } statictext { <Identifier> }
{
  <standard attributes>
  <plain attributes>
  <geometry attributes>
  <hierarchy attributes>
  <layout attributes>
  <text attributes>
  <object-specific attributes>
}

Events

Children

Parent

37.1 Attributes

Attribute	RLD	PID	Properties	Short Description
.acc_label	string object	string text	S.G/D/C	overwrites the Automation Identifier for Microsoft UI Automation
.acc_text	object string	text string	S.G/D/C	overwrites the Automation Name for Microsoft UI Automation
.accelerator	identifier	accel	S,G/D/C	accelerator of object
.alignment	integer (-1, 0, 1)	integer	S,G/D/C	alignment of text
.bgc	identifier	color	S,G/D/C	background color
.class	class	class	-,G/-/-	object class
.control	identifier	instance	-,G/-/-	control the object currently belongs to
.cursor	identifier	cursor	S,G/D/C	cursor belonging to object
.cut_pending	boolean	boolean	S,G/-/-	cut operation has not been executed yet
.cut_pending_changed	boolean	boolean	-,G/-/-	changing state during a cut operation
.depth	integer	integer	S,G/-/C	controls appearance of statictext
.dialog	identifier	instance	-,G/-/-	dialog to which the object belongs
.document[integer]	object	document	S,G/-/-	accesses the I-th XML Document
.external	boolean	boolean	-,G/-/-	returns if the object class is an USW class
.external[integer]	class	class	-,G/-/-	returns the I-th registered USW class
.fgc	identifier	color	S,G/D/C	foreground color
.firstrecord	object	record	S,G/-/C	accesses the first record of an object
.focus	boolean	boolean	S,G/-/C	input focus on object
.focus_on_click	boolean	boolean	S,G/-/-	defines if a mouse click into an object’s client area activates the object
.font	identifier	font	S,G/D/C	object font
.function	identifier	func	S,G/D/C	function belonging to object
.groupbox	identifier	instance	-,G/-/-	object groupbox
.height	integer	integer	S,G/D/C	object height
.help	string identifier	string text	S,G/D/C	help text of object
.label	string	string	S,G/D/C	name/identifier of object
.lastrecord	object	record	S,G/-/C	accesses the last record of an object
.layoutbox	object	object	-,G/-/-	layoutbox of object
.mapped	boolean	boolean	S,G/D/-	defers the display of a visibly created object
.member[integer]	attribute	attribute	-,G/-,-	user-defined attribute [I] of object
.membercount	integer	integer	-,G/-,-	number of user-defined attributes
.menu	identifier	instance	S,G/D/C	object menu
.model	identifier	instance	S,G/D/C	model belonging to object
.notepage	object	object	-,G/-/-	notepage which object currently belongs to
.options[enum]	boolean	boolean	S,G/D/-	special options of object
.parent	identifier	instance	S,G/-/-	parent of object
.posraster	boolean	boolean	S,G/D/C	positions refer to grid
.real_height	integer	integer	-,G/-/-	real height of object
.real_sensitive	boolean	boolean	-,G/-/-	real selectivity of object
.real_visible	boolean	boolean	-,G/-/-	real visibility of object
.real_width	integer	integer	-,G/-/-	real width of object
.real_x	integer	integer	-,G/-/-	real distance from left (in pixel)
.real_y	integer	integer	-,G/-/-	real distance from top (in pixel)
.record[integer]	object	record	S,G/-/C	accesses the I-th record of an object
.recordcount	integer	integer	-,G/-/-	queries the number of child records
.scope	integer (1, 2, 3)	scope	-,G/-/-	queries the object type (Default, Model or instance)
.sensitive	boolean	boolean	S,G/D/C	selectivity of object
.sizeraster	boolean	boolean	S,G/D/C	size refers to grid of parent object
.statushelp	string object	string text	S,G/-/C	text to be displayed in statusbar
.text	string identifier	string text	S,G/D/C	static text of object
.toolbar	object	object	-,G/-/-	toolbar of object
.toolhelp	text	text	S,G/-/-	specified text to be displayed in pop-up
.userdata	anyvalue	anyvalue	S,G/D/C	object userdata (any DM datatype)
.visible	boolean	boolean	S,G/D/C	visibility of object
.width	integer may be 0	integer	S,G/D/C	actual width of object
.window	identifier	instance	-,G/-/-	window to which object belongs
.xauto	integer (-1, 0, 1)	integer	S,G/D/C	definition type of x-coordinates
.xleft	integer	integer	S,G/D/C	x-coordinate, distance from left
.xright	integer	integer	S,G/D/C	x-coordinate, distance from right
.yauto	integer (-1, 0, 1)	integer	S,G/D/C	definition type of y-coordinates
.ybottom	integer	integer	S,G/D/C	y-coordinate, distance from bottom
.ytop	integer	integer	S,G/D/C	y-coordinate, distance from top

37.2 Specific Attributes

These attributes define the position and the size of the statictext. If .height or .width is specified as 0, the DM calculates the size of the statictext on the basis of the actual font.

The statictext if it is the child of a statusbar requires the additional attribute .depth. This attribute controls the appearance of the statictext.

The value range of this attribute is integer, the default is 0. Negative values mean that the statictext will be displayed intaglio in contrast to the parent object. Positive values mean that the statictext will be displayed in highlighted form. The value corresponds to the negative values used for the highlighting. The attribute is inherited as all other attributes.

This attribute will only have an effect if the statictext is a child of an statusbar.

The attribute .options can have the following values:

option_index	Meaning
opt_use_widget	the statictext will be displayed as a widget (only with Motif)

37.3 Example

Text in a window

window MAIN

{

.title "main window";

child statictext FixText

{

.xleft 10;

.ytop 10;

.text "Smith Ltd.";

}

Figure 13-40: Statictext