Button Reference

Design-Time Properties

Property	Description
Name	The name of the control.
Operation	The type of operation performed when the button is clicked [Insert, Update, Delete, Cancel or Search]. If the form does not have a Data Source, this property can be set to 'Insert' in which case the button will simply submit the form.
Return Page	Use this property to specify the page that should be viewed after the button has been clicked.
Remove Parameters	Specify a semicolon-separated list of parameters that should be removed from the query string
Convert URL to	Specify whether the URL should be converted to an absolute URL or a secure (https://) URL.
Default Button	If this property is set to 'Yes', pressing the enter key while on the page will be equivalent to clicking on this button.
Enable Validation	[Yes/No] Specify whether validation should be enabled when the button is clicked.

Property

Description

The name of the control.

The type of operation performed when the button is clicked [Insert, Update, Delete, Cancel or Search]. If the form does not have a Data Source, this property can be set to 'Insert' in which case the button will simply submit the form.

Return Page

Use this property to specify the page that should be viewed after the button has been clicked.

Remove Parameters

Specify a semicolon-separated list of parameters that should be removed from the query string

Convert URL to

Specify whether the URL should be converted to an absolute URL or a secure (https://) URL.

Default Button

If this property is set to 'Yes', pressing the enter key while on the page will be equivalent to clicking on this button.

Enable Validation

[Yes/No] Specify whether validation should be enabled when the button is clicked.

Events

Event	Description
Server Side Events
On Click	Occurs after the button has been clicked and the form is submitted. If the button appears in a record or editable grid form, record operations such as insert, update and delete occur after this event has been processed. In cases where the form does not have a Data Source, this event is used to perform post-submission operations such as sending emails messages based on the submitted information.
Before Show	Occurs before the control is rendered to the page. This event can be used to influence the visibility or appearance of the control.
Client Side Events
On Click	Occurs immediately after the button has been clicked and before the form is submitted. This client event can be used to validate the contents of the form on the client side before the values are submitted to the server.
On Load	Occurs after the control has been rendered to the page and before the user can perform any operations. This event can be used to bind validation rules to the control.

Event

Description

Server Side Events

On Click

Occurs after the button has been clicked and the form is submitted. If the button appears in a record or editable grid form, record operations such as insert, update and delete occur after this event has been processed. In cases where the form does not have a Data Source, this event is used to perform post-submission operations such as sending emails messages based on the submitted information.

Before Show

Occurs before the control is rendered to the page. This event can be used to influence the visibility or appearance of the control.

Client Side Events

On Click

Occurs immediately after the button has been clicked and before the form is submitted. This client event can be used to validate the contents of the form on the client side before the values are submitted to the server.

On Load

Occurs after the control has been rendered to the page and before the user can perform any operations. This event can be used to bind validation rules to the control.

Run-Time Properties (ASP)

Property	Description
Visible	This property controls the visibility of the control. If the property is set to false, the control will not be displayed.

Run-Time Properties (PHP)

Property	Description
ComponentType	Specifies type of an object, such as "TextBox", "Record", etc.
Parent	Specifies parent container of an object, for example a record form for a textbox that is included within that form.
Visible	This property controls the visibility of the button. If the property is set to false, the button will not be displayed.

Run-Time Properties (.NET)

Property	Description
Visible	This property controls the visibility of the button. If the property is set to false, the button will not be displayed.

Run-Time Variable (CF,CFT)

Property	Description
hide<control name>	This property controls the visibility of the button. If the property is set to true, the button will not be displayed.

Methods (Servlets & JSP)

Method	Description
isVisible	Whether this control should be shown.
setVisible	Specify whether this control or component should be shown.
getParent	Get the parent component that contains this control or component.

Button Control Reference