.
Eloquence JDLG contact contact


JDLG object and attribute reference:
PushButton class

 
.
  Document revision: 2023-02-22
Refers to JDLG version: 2.0.16


Contents


The PushButton class implements a clickable button which returns its rule value to the program when clicked or activated by an accelerator key.

A PushButton displays a text label and optionally an icon image.

bgcolor : string, get/set
Note: Depending on the look-and-feel definition, it may be possible that setting the PushButton background color has no effect.

Please refer to the common bgcolor attribute documentation. See also fgcolor below.

border : integer, get/set
Provided for ASCII DLG backward compatibility.

The PushButton border visibility and thickness cannot be specified. A PushButton always has a (platform or look-and-feel specific) border.

The default value is 1.

class : string, get
Returns "PushButton".
fgcolor : string, get/set
Note: Depending on the look-and-feel definition, it may be possible that setting the PushButton foreground color has no effect.

Please refer to the common fgcolor attribute documentation. See also bgcolor above.

icon : string, get/set
Specifies the URL referring to an icon image in png, gif or jpg format, to be displayed in the PushButton.

If a relative URL is specified, the value of the Application.baseurl or System.baseurl attribute or eloquence.config.baseurl configuration property is prepended.

The default value is empty (icon image not specified).

See also iconpressed and textpos below.

iconpressed : string, get/set
Specifies the URL referring to an alternative icon image, to be displayed while the PushButton is clicked.

See also icon below.

rule : integer, get/set
The rule value, regardless if nonzero or zero, is returned to the program, along with the path of the PushButton object (see also ruleoverride below), when the PushButton is clicked or activated by an accelerator key.

The default rule value is zero.

See also the documentation of the common rule attribute.

ruleoverride : integer, get/set
If nonzero, the rule of a previously focused EditText or ComboBox object is overridden (the PushButton rule value combined with the EditText or ComboBox path is returned).

The default ruleoverride value is 1.

For details, please refer to the RuleOverride documentation.

text : string, get/set
PushButton text.

If an & character occurs in the text, the next character or digit is used to define a corresponding accelerator key. The PushButton is then activated when pressing the ALT key along with this accelerator key.

textpos : string, get/set
Specifies the position of the PushButton text in relation to an icon image.

Possible values are:
 "left"
 "right"
 "top"
 "bottom"

The default textpos value is "right" if an icon image is specified.

Note: If no icon image is specified, the textpos attribute is ignored and the PushButton text is centered.

traversecr : integer, get/set
Zero (default): Pressing the ENTER key triggers a PushButton rule submission, as if the PushButton was clicked.

Nonzero: Pressing the ENTER key moves the focus to the next focusable object.


 
 
 
  Privacy | Webmaster | Terms of use | Impressum Revision: 2023-02-22  
  Copyright © 1995-2021 Marxmeier Software AG