customKeys

Lists the names of all the custom property of an object.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

set the customKeys of object to {propertiesList | empty}

# Examples

set the customKeys of stack "Preferences" to empty

set the customKeys of last button to the customKeys of button 1

# Description

Use the customKeys property to find out what custom property an object has, and to create or delete custom property.

The customKeys lists the names of property in the object current customPropertySet. If the object has more than one custom property set, you must switch to the desired property set before checking the customKeys. The following example displays the custom property in a custom property set called "Francois" :

set the customPropertySet of button "My Button" to "Francois" answer the customKeys of button "My Button" -- in "Francois" set

Alternatively, the custom property set can be accessed using:

answer the customKeys["Francois"] of button "My Button"

If you set the customKeys of an object, and the propertiesList contains a custom property that the object doesn't have, a custom property with that name is created. (A property name can be up to 255 characters long. The number of property names is limited only by LiveCode's total memory space.) The value of a newly-created custom property is empty.

If you set the customKeys of an object and do not include the name of an existing custom property, that custom property is deleted. Setting the customKeys to empty deletes all custom property in the current custom property set.

# Tags

properties,

# See

- **keyword:** line - **property:** customPropertySet, customPropertySets - **command:** undefine - **glossary:** object, property, custom property, custom property set