#
CwGetSelectedObject

### Syntax:

    hObj = CwGetSelectedObject()

            hObj            (handle)  The handle to an object.

### Description:

This function returns a handle to the currently selected object. This is the object currently surrounded by a marquee box (the "ants"). An object can be selected either by being clicked on with the mouse or via a call to CwSelectObject. If no object is selected, a null handle is returned.

### Example:

    /* Delete the selected object.*/

    handle = CwGetSelectedObject()

    if \CwIsHandleValid(handle) then do
            say "No object selected."
            exit
            end

    call CwDeleteObject(handle)

Functions by NAME | Index | Functions by PURPOSE