properties | |||||||
Type | property | ||||||
Dictionary | LCS | ||||||
Library | LiveCode Script | ||||||
Syntax |
| ||||||
Associations | stack, card, field, button, graphic, scrollbar, player, image | ||||||
Summary | Specifies some of an object's properties and their current values. | ||||||
Introduced | 1.0 | ||||||
Changes | As of version 6.1 the properties property has been revised. On fetching it returns the minimal set of properties of an object to allow it to be recreated exactly, it also returns unicode variants of properties if, and only if, they are needed. | ||||||
OS | mac, windows, linux, ios, android | ||||||
Platforms | desktop, server, mobile | ||||||
Example |
| ||||||
Values |
| ||||||
Related | Property: properties, customProperties Command: combine Function: keys, propertyNames Control Structure: setProp Glossary: value, object | ||||||
Description | Use the properties property to set an object's built-in properties, or to copy properties from one object to another. Not every property is included in the properties property. The following types of properties are excluded:
The key of each element in the array is the property name. Use the following statements to obtain a list of the properties for a particular object type:
The value of each element in the array is the value of that property for the object. For example, use this statement (after the above example) to get the object's ID property:
If you set the properties of an object to an array that contains only some of the properties, any properties that aren't in that array are not changed. This means that you can select which properties to set with the properties property. For example, suppose you want to set the properties of a field to the properties of another field, except that you want to leave the first field's name unchanged:
On storing the properties are set in the correct order to ensure correct recreation of the object.
| ||||||
Tags | properties |