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


Syntax

PowerBuilder

integer dwcontrol.ResetTransObject ( ) 

Argument

Description

dwcontrol

A reference to a DataWindow control, DataStore, or child DataWindow


Return value

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

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

dw_employee.ResetTransObject()

See also

GetTrans

SetTrans

SetTransObject