11.01.2013 Views

Oracle Forms Developer – Form Builder Reference, Volume 1

Oracle Forms Developer – Form Builder Reference, Volume 1

Oracle Forms Developer – Form Builder Reference, Volume 1

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

RELEASE_OBJ built-in<br />

Description<br />

Shuts down the connection to the OLE object.<br />

Syntax<br />

PROCEDURE RELEASE_OBJ<br />

(obj OLEOBJ, kill_persistence_boolean := NULL);<br />

Built-in Type unrestricted procedure<br />

Parameters<br />

obj Pointer to the OLE object to be released.<br />

Kill_persistence_boolean A boolean value of NULL releases the<br />

object, ending its persistence.<br />

Usage Notes<br />

A boolean value of TRUE releases only a<br />

persistent object. If you don’t have a pointer<br />

to a persistent object, your code will<br />

misbehave.<br />

A boolean value of FALSE releases only a<br />

non-persistent object. If you don’t have a<br />

pointer to a non-persistent object, you will<br />

get error FRM-40935.<br />

This is an optional parameter. If not<br />

supplied, the default value is NULL (release<br />

object unconditionally).<br />

In general, you should not access an object after you release it.<br />

The conditional form of this procedure (boolean TRUE or FALSE) should be used only in those rare<br />

cases when two instances of an object have been created, each carrying different persistence values, and<br />

the pointer is ambiguous. The procedure will release one of the two objects, leaving the other as the sole<br />

instance.<br />

337

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!