ResetTransObject

Description

Stops a DataWindow control or DataStore from using the programmer-specified transaction object that is currently in effect through a call to the SetTransObject method. After you call the ResetTransObject method, the DataWindow control or DataStore uses its internal transaction object.

Applies to

DataWindow type	Method applies to
PowerBuilder	DataWindow control, DataWindowChild object, DataStore object
Web ActiveX	DataWindow control, DataWindowChild object

Syntax

PowerBuilder

integer dwcontrol.ResetTransObject ( )

Web ActiveX

number dwcontrol.ResetTransObject ( )

Argument	Description
dwcontrol	A reference to a DataWindow control, DataStore, or child DataWindow

Returns

Returns 1 if it succeeds and –1 if an error occurs. The return value is usually not used.

If dwcontrol is null, the method returns null.

Usage

If you reset the transaction object and SetTrans has never been called to set the values in the internal transaction object, call SetTrans to set them or SetTransObject to establish a new programmer-specified transaction object.

ResetTransObject is almost never used because programmer-specified and internal transaction objects in one application are generally not used together. Programmer-specified transaction objects, specified with SetTransObject, provide better application performance. To change the programmer-specified transaction object, simply call SetTransObject again.

Examples

Example 1

This statement stops dw_employee from using programmer-specified transaction objects:

dw_employee.ResetTransObject()