8 dialog

In every DM file the dialog identifier has to be defined. This can be done with the keyword dialog, followed by the dialog identifier and the attributes of the dialog.

Definition

dialog { <Identifier> }
{
  <standard attributes>
  <grid attributes>
  <object-specific attributes>
}

Events

deactivate (if a timeout occurred)

Children

Parent

none

8.1 Attributes

Attribute	RLD	PID	Properties	Short Description
.child[integer]	object	object	S,G/-/C	accesses the I-th child object
.childcount	integer	integer	-,G/-/-	queries the number of child objects
.class	class	class	-,G/-/-	class/id of object
.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
.firstchild	object	object	S,G/-/C	accesses the first child object
.firstrecord	object	record	S,G/-/C	accesses the first record of an object
.focus	boolean	boolean	S,G/-/C	input focus on object
.ignorecursor	boolean	boolean	S,G/D/C	cursor will not be used
.label	string	string	S,G/D/C	name/id of object
.lastchild	object	object	S,G/-/C	accesses the last child object
.lastrecord	object	record	S,G/-/C	accesses the last record of an object
.member[integer]	attribute	attribute	-,G/-,-	user-defined attribute [I] of object
.membercount	integer	integer	-,G/-,-	number of user-defined attributes
.msgboxtext[enum]	string	text	S,G/D/C	contents of a messagebox
.options[enum]	boolean	boolean	S,G/D/-	special options of object
.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
.reffont	object	font	S,G/D/C	reference font of object
.timeout	integer	integer	S,G/D/C	time specification for timeout
.xraster	integer	integer	S,G/D/C	unit in x-direction
.yraster	integer	integer	S,G/D/C	unit in y-direction

8.2 Specific Attributes

Grid Attributes

With the grid values defined in the dialog, the windows contained in the dialog can be positioned relatively to a user-determined size or to a fixed font. A grid can be specified with the attributes .xraster and .yraster.

Dialog Attributes

The attribute .msgboxtext[I] defines the text of messagebox buttons.

If a button text is not supported by the window system, the attribute will be ignored.

Some window systems (e.g. Microsoft Windows) have fixed button texts and do not allow labeling by the user.

The attribute .timeout defines the time delay after which the timeout is to become active when the user doesn't work with the program. The delay is specified according to the same schemes that are used for the timer increments.

If .timeout of the dialog is not 0, the DM will set up this timer each time it reads the window system blocking it. A deactivate event is sent to the setup object when the timer becomes active. Every event other than another timer resets the timeout.