Centrallix - It's Different than what you Think
Home   |   Technology   |   Screen Shots   |   Download   |   Documentation   |   History   |   For Developers

Search...


Search For:

Index...


Centrallix Documentation
1. Getting Started
2. Applications Overview
3. Application Components
4. Reports Overview
5. Report Components
6. SQL Language
7. Process Modeling
8. Application Modeling
9. Role-Based Security
10. Business Logic Modeling
11. Other Objects
12. External API's
13. Internal API's

widget/textbutton


textbutton :: A simple visual button widget built not from images but from a simple text string.

Metadata:
type:widget/textbutton
visual: yes
container: no
form element: no


Overview:

A textbutton provides similar functionality to the imagebutton. However, the programmer need not create two or three graphics images in order to use a textbutton; rather simply specifying the text to appear on the button is sufficient.

Textbuttons, like imagebuttons, can either have two or three states. A three-state textbutton doesn't have a "raised" border until the user points to it, whereas a two-state textbutton retains its raised border whether pointed to or not.


Usage:

The TextButton can be placed inside any visible container, but only nonvisual widgets can be placed within it.


Properties:

PropertyTypeDescription
background string A background image for the button.
bgcolor string A color, RGB or named, to be used as the button's background.If neither bgcolor nor background are specified, the button is transparent.
disable_color string A color, RGB or named, to be used for the button's text when it is disabled.
enabled yes/no or expr Whether the button is enabled (can be clicked). Default is 'yes'. Also supports dynamic runclient() expressions allowing the enabled status of the button to follow the value of an expression.
fgcolor1 string A color, RGB or named, for the text on the button. Default "white".
fgcolor2 string A color, RGB or named, for the text's 1-pixel drop-shadow. Default "black".
height integer height, in pixels, of the text button.
text string The text to appear on the button. This may be a dynamic runclient() expression to dynamically change the button's text.
tristate yes/no Whether or not the button is tri-state (does not display a raised border until the user points at it). Default is yes.
width integer The width, in pixels, of the text button.
x integer x-coordinate of the upper left corner of the button, relative to its container.
y integer y-coordinate of the upper left corner of the button, relative to its container.


Child Properties:

none currently available

Actions:

ActionDescription
SetText Called from a connector, this action sets the button's text to the value passed in through connector's "Text" parameter.


Events:

EventDescription
Click This event occurs when the user clicks the button. No parameters are available from this event.


Sample Code:

$Version=2$
MyButton "widget/textbutton"
	{
	x = 10; y = 10;
	width = 50;
	height = 20;
	tristate = "no";
	background = "/sys/images/grey_gradient.png";
	text = "OK";
	}




Comments...


(none yet)

Add a Comment...


Your Name:
Comment:
(c) 2001-2020 LightSys Technology Services, Inc. All trademarks are property of their respective owners.

Project Hosting Provided By:
Hosted by Sourceforge