#
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