Contents Index Relative method Set method

UltraLite Static C++ User's Guide
  C++ API Reference
    ULCursor class

Reopen method


Prototype 

bool  Reopen( ULConnection *conn )

Description 

This method is available for the Palm Computing Platform only. The ULData and ULCOnnection objects must already be reopened for this call to succeed.

When developing Palm applications, you should never close result set objects if you wish to maintain the cursor position. Instead, you should call Reopen when the user switches back to the UltraLite application.

Although the ULTable object inherits from the ULCursor class, you should not use Reopen on table objects. Instead, you should close them on exiting the Palm application and Open them on re-entering. The cursor position is not maintained in ULTable objects.

Parameters 

conn    A pointer to the ULConnection object on which the cursor is defined.

Returns 

true (1) if successful.

false (0) if unsuccessful.

Example 

The following example reopens a database object, and then a connection object, and then a result set object:

db.Reopen();
conn.Reopen( &db );
rs.Reopen( &conn );
See also 

Open method


Contents Index Relative method Set method