[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPCEDT - Conditional Editing

GPCEDT (flag)

Purpose

Use GPCEDT to begin and end conditional structure editing in the current open structure.

Once conditional editing begins, all affected structure operation subroutine calls (i.e., all structure store subroutine calls except for inquiry subroutines and those subroutines which do not require an open structure) are performed as usual until either the conditional editing is ended or your application closes the structure or until an error occurs (except for errors caused by inserting or replacing structure elements) When an error occurs while conditional editing is active, the graPHIGS API ignores all subsequent editing operations until either the conditional editing is ended or your application closes the structure store.

Structure operations that temporarily close an open structure, such as the Delete Structure (GPDLST) subroutine, do not affect the conditional editing mode.

Parameters

flag -- specified by user, fullword integer

Conditional edit flag (1=START, 2=END )

Error Codes

4
FUNCTION REQUIRES STATE STOP
137
VALUE OF CONDITIONAL EDIT FLAG IS INVALID

Related Subroutines

GPCLST
Close Structure
GPCPER
Copy Element Range
GPCPST
Copy Structure
GPDELB
Delete Element Between Labels
GPDLE
Delete Element
GPDLER
Delete Element Range
GPEP
Set Element Pointer at Label
GPEPCD
Locate Element Pointer at Element Code
GPEPLG
Generalized Set Element Pointer at Label
GPEPPG
Generalized Set Element Pointer at Pick Identifier
GPMVER
Move Element Range
GPOEP
Offset Element Pointer
GPOPST
Open Structure
GPSSS
Select Structure Store
All Structure Elements
Chapter 3. "Attribute Structure Elements", Chapter 15. "Miscellaneous Subroutines", Chapter 5. "Structure Operations"

RCP code

201331462 (X'0C001306')


[ Previous | Next | Contents | Glossary | Home | Search ]