CwGetNextProperty

Syntax:

sPropName = CwGetNextProperty()

        sPropName       (string) The name of the Next property.

Description:

This function returns the name of the next property of the object specified in a call to GetFirstProperty and after the last call to CwGetNextProperty. 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. If all property names have already been returned, an empty string will be returned.

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