Progress
Language Reference


Buffer Object Handle

Interfaces
OS
SpeedScript
All
All
Yes

A handle to a buffer object, corresponding to an underlying Progress buffer, which can be static or dynamic. An example of a static underlying buffer is one you define at compile time by using the DEFINE BUFFER statement, or by implicitly referencing a table in a 4GL construct such as “customer.cust-num”. An example of a dynamic underlying buffer is one you create at run time with the CREATE BUFFER statement.

SYNTAX

buffer-handle [ :attribute | :method ] 

buffer-handle

An item of type WIDGET-HANDLE representing a handle to a buffer object.

attribute

An attribute of the buffer object.

Attribute
Type
Readable
Setable
CHARACTER
LOGICAL
LOGICAL
LOGICAL
LOGICAL
LOGICAL
LOGICAL
CHARACTER
WIDGET-HANDLE
LOGICAL
CHARACTER
LOGICAL
WIDGET-HANDLE
INTEGER
CHARACTER
CHARACTER
RECID
INTEGER
ROWID
CHARACTER
WIDGET-HANDLE
INTEGER
CHARACTER
INTEGER

method

A method of the buffer object.

Method
Return Type
Description
LOGICAL
Compares common fields in the source and target buffers.
LOGICAL
Copies common fields from the source buffer to the target buffer.
LOGICAL
Creates a record, sets each field to its default value, and moves a copy of the record into the buffer.
LOGICAL
Deletes a record from the record buffer and from the database.
WIDGET-
HANDLE
Returns a handle to a particular field of the buffer.
LOGICAL
Releases a record from a buffer object.
LOGICAL
Deletes all records from a temporary table associated with the buffer object.
LOGICAL
Locates the record with the rowid you specify, then moves the record into the buffer.
CHARACTER
Returns index information for the specified index in the buffer.
LOGICAL
Copies data to or from a buffer object with no interpretation.

EXAMPLES

For a sample program that uses the buffer object, see the Progress Programming Handbook .

NOTE

For more information on the buffer object, see the Progress Programming Handbook .

SEE ALSO

Buffer-field Object Handle, Query Object Handle, Temp-table Object Handle


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095