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

GPEDMO - Set Edit Mode

GPEDMO (mode)

Purpose

Use GPEDMO to set the current edit mode entry of the graPHIGS API state list. If you do not use this subroutine, then the edit mode default to 1=INSERT_MODE

When moving an element into an open structure, the edit mode determines how the element is placed into the structure:

  1. When in 2=REPLACE_MODE , the graPHIGS API deletes the element at the element pointer and the incoming element takes its place. The element pointer does not move (so if you place another element into the structure, then it replaces the last element that was just placed into the structure) If the element pointer is set to element 0, then the graPHIGS API inserts the incoming element into the structure and sets the element element pointer to element 1.

  2. When in 1=INSERT_MODE , the graPHIGS API inserts the incoming element into the open structure after the element at the element pointer. The element pointer is then incremented by 1 to point to the new element.

    3. Parameters

    mode -- specified by user, fullword integer

    Edit mode (1=INSERT_MODE, 2=REPLACE_MODE )

    Error Codes

    121
    EDIT MODE IS INVALID

    Related Subroutines

    None

    RCP code

    201331460 (X'0C001304')

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