SetHTMLAction (obsolete)

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.

Obsolete method

SetHTMLAction is obsolete and should not be used, because the Web DataWindow technology is obsolete.

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.


Return value

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

-1 -- Reloading the current context failed.

-2 -- The action was attempted but it failed.

-3 -- The action could not be performed (for example, the action was InsertRow but the DataWindow has no editable fields for entering new data).

-4 -- The action was aborted by the HTMLContextApplied event.

-5 -- The action is invalid.

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.

See also

SetAction