SetHTMLAction

Description

Accepts action and context information about user interaction with the Web DataWindow client control in a Web browser so that newly generated HTML can reflect any requested changes.

Applies to

DataWindow type

Method applies to

PowerBuilder

DataWindow control, DataStore object

Syntax

PowerBuilder

integer dwcontrol.SetHTMLAction ( string action, string context )

Argument

Description

dwcontrol

A reference to a DataWindow control or DataStore.

action

A string describing an action associated with a button click or method call in a Web DataWindow client control on a Web page. The value is stored in a page parameter called HTMLGenObjectName_action. action must be a valid action and cannot be an empty string or the value none.

context

A string describing the context of action in the Web DataWindow client control. The string is generated by a Web DataWindow script and the value is stored in a page parameter called HTMLGenObjectName_context.

The format is not documented and subject to change.

Returns

Returns 1 if it succeeds and one of these negative values if an error occurs:

Usage

SetHTMLAction triggers the HTMLContextApplied event after restraining the context but before performing the action. You can use the event to perform data validation using methods of a server component.

If you write your own server component in PowerBuilder instead of using the generic Web DataWindow server component, you use this method to update the generated HTML to reflect user actions.

For information about building your own server component, see the DataWindow Programmers Guide.

See also

SetAction