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