CwSetName

Syntax:

call CwSetName hObject, sName

        hObject         (handle) The effect to name

        sName           (string) The name to change to

Description:

This procedure changes the name of an object. The name of the currently selected object is visible on the access bar of the P>G PRO user interface and may also be changed there. It retrieved with CwGetName and specificly-named objects may be sought with CwGetHandleFromObjectName.

The name may be any valid string and more than one object may have the same name, all though that may cause problems if you need to use CwGetHandleFromObjectName.

Example:

/* Name every object 'Bill Door'.  This is completely useless. */

o = CwFindFirstObject( CwGetCurrentView() )
do while CwIsHandleValid(o)
        call CwSetName o, 'Bill Door'
        o = CwFindNextObject( o )
        end

Remarks:

This is equivalent to CwSetProperty on the Name property.

Functions by NAME

Index

Functions by PURPOSE