SetAction (obsolete)
Description
Accepts action and context information about user interaction with
the Web DataWindow client control in a Web browser so that generated HTML
reflects any requested changes.
Obsolete method
SetAction is obsolete and should not be used, because the Web
DataWindow technology is obsolete.
Applies to
|
DataWindow type |
Method applies to |
|---|---|
|
Web |
Server component |
Syntax
Web DataWindow server
component
|
1 |
integer dwcomponent.SetAction ( string action, string context ) |
|
Argument |
Description |
|---|---|
|
dwcomponent |
A reference to a Web DataWindow server |
|
action |
A string describing an action associated with a |
|
context |
A string describing the context of action in the Web The format is not |
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
Usage
When the user clicks a button in the Web DataWindow client control,
the JavaScript for the control stores the action in a page parameter
called HTMLGenObjectName_action, and it stores the context in a page
parameter called HTMLGenObjectName_context. These parameters are passed to
the page server which uses them to call the SetAction method for the
server component.
The SetAction method uses the SetHTMLAction method of the
DataWindow.
Call GetLastError and GetLastErrorString to get information about
database errors that cause SetAction, Update, Retrieve, and RetrieveEx to
return -1.
Examples
This JSP example calls SetAction for the server component called
dwGen:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
int retVal; String dw_1_action = (String)request.GetParameter ("dw_1_action"); String dw_1_context = (String)request.GetParameter ("dw_1_context"); if (dw_1_context == null){ dw_1_context = " "; } // Check if we need to perform the action if (dw_1_action!=null){ retVal = dwGen.SetAction(dw_1_action, dw_1_context); if (retVal < 0 ) { out.print("Error on SetAction: " + retVal + "<BR>"); out.print(dwGen.GetLastErrorString()+ "<BR>"); } } |
See also