#
CwOverlayObject

### Syntax:

    handle = CwOverlayObject sFileName

            handle          (handle) The handle of the loaded object.

            sFileName       (string) The path of the .ORC file to load.

### Description:

This function loads a saved object from disk and inserts it into the current view into the current selection rectangle.

### Example:

    orcfile = 'c:\objects\foo.orc'
    call CwSetSelectionRectangle 2, 1, 2, 2
    call CwOverlayObject orcfile

### Remarks:

This routine can fail due to external circumstances (for example, the path being invalid). Under such circumstances, the normal behaviour of a script is to raise a syntax error. If your script needs to be robust, you must trap the syntax error using SIGNAL as is done in example #2 of CwImportProject.

Functions by NAME | Index | Functions by PURPOSE