29 pushbutton

The pushbutton is a type of button that can be used to make a decision, such as Yes, No, Cancel or Continue. The activation state of the pushbutton is not stored, it remains only as long as the user is actively selecting the button.

Definition

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

Events

Children

Parent

29.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
.bgc	identifier	color	S,G/D/C	background color
.class	class	class	-,G/-/-	class of object
.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 not yet carried out
.cut_pending_changed	boolean	boolean	-,G/-/-	changing state during cut operation
.defbutton	boolean	boolean	S,G/D/C	default pushbutton in dialogbox
.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
.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
.index	integer index	integer index	-,G/-/-	current index of object in the child list of its parent
.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	string	S,G/D/C	static text of object
.toolbar	object	object	-,G/-/-	toolbar of object
.toolhelp	string object	string text	S,G/D/C	gives a short explanation of object at the cursor
.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

29.2 Specific Attributes

Plain Attributes

These attributes define the size and position of the pushbutton. If .height or .width is set to 0, the DM calculates the size of the pushbutton on the basis of the actual font.

The attribute .options can have the following values:

option_index	Meaning
opt_use_widget	Pushbutton is displayed as widget. (on Motif version only)

29.3 Example

dialog Test

window Wn
{
  .active false;
  .width  364;
  .height 180;
  .title  "Testfenster";

  child pushbutton PbStop
  {
    .xleft 96;
    .width 109;
    .ytop  136;
    .text  "&Stop";
  }

  child pushbutton PbWeiter
  {
    .xleft 257;
    .width 100;
    .ytop  137;
    .text  "&Weiter";
  }
}

Figure 13-34: window with pushbuttons