#
CwGetFirstProperty

### Syntax:

    sPropName = CwGetFirstProperty(hObject)

            sPropName       (string) The name of the first property.

            hObject         (handle) The handle of an object.  May be a tool,
                            region, effect, group or application-defined
                            object.

### Description:

This function returns the name of the first property of the object. Subsequent calls to CwGetNextProperty will return the rest of the properties of the object in sequence. In this way, it is possible to list all available properties of an object.

Each returned property name is a single property. Thus, if a property has several elements, each element (with the associated property) is returned in its turn. For example, if an object has the property "Position" with elements "Width" and "Height", calls to CwGetNextProperty will return "Position:Width" and "Position:Height".

### Example:

    /* Function to list all properties of an object, store them in a
       string and return it. */

    getprops:procedure
    arg handle

    cr = x2c('0A')

    p = CwGetFirstProperty(handle)
    property=''
    do while p \= ''
            property = property||"  '" || p || "' = '"|| ,
                    CwGetProperty(handle,p)||"'" '('|| ,
                    CwGetPropertyType(handle,p) || ')' || cr
            p = CwGetNextProperty()
            end
    return property

Functions by NAME | Index | Functions by PURPOSE