customKeys

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the customKeys of <object> to {<propertiesList> | empty}
Synonymsuserproperties
Associationsstack, card, field, button, graphic, scrollbar, player, image
Summary

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

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
set the customKeys of stack "Preferences" to empty
set the customKeys of last button to the customKeys of button 1
Values
NameTypeDescription
Value

The customKeys of an object is a list of that object's custom property names, one per line.

RelatedKeyword: line
Property: customPropertySet, customPropertySets
Command: undefine
Glossary: object, property, custom property, custom property set
Description

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

The customKeys lists the names of properties in the object's 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 properties 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 properties in the current custom property set.

Tagsproperties