4GL Access: RW

The DBHandle attribute identifies a bitmap stored in the database. The DBHandle is an internal ID that OpenROAD constructs when you use the InsertIntoDB Method on the bitmap object to store its associated bitmap in the database.

If you set this attribute, OpenROAD automatically reads the image from the database, associates the image with the specified bitmap object, and displays the image if the bitmap object is currently displayed. You can also use this attribute in select statements.

If you set this attribute to an empty or null string, OpenROAD removes the existing bitmap. If you set this attribute to a DBHandle that is invalid or that represents an image that does not exist, OpenROAD generates an error message and removes the bitmap.

Whenever your program sets a DBHandle, you are working directly with the database. For more information about the relationship between DBHandles and database transactions, see the Programming Guide.

If the BitmapObject is attached to a FormField or a stored TaggedValue Item, using this in your program during development may change your frame's source definition. See BitmapObject Attributes and Methods Affecting the Frame Source (see BitmapObject Class).