<doc>
	<legacy_id>2318</legacy_id>
	<name>customPropertySet</name>
	<type>property</type>

	<syntax>
		<example>set the customPropertySet of object to {setName | empty}</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies a set of custom properties applied to an object.</summary>

	<examples>
<example>set the customPropertySet of me to &quot;Mac Properties&quot;</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
	</history>

	<objects>
		<stack/>
		<group/>
		<field/>
		<button/>
		<graphic/>
		<scrollbar/>
		<player/>
		<image/>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
	  <ios/>
    <android/>
  </platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
	  <mobile/>
  </classes>

	<security>
	</security>


	<classification>
		<category>Values &amp; Properties</category>
	</classification>

	<references>
		<command tag="set">set Command</command>
		<property tag="customPropertySets">customPropertySets Property</property>
	</references>

	<description>
	<overview>Use the <b>customPropertySet</b> property to create and switch between sets of custom properties and property values.</overview>

	<parameters></parameters>

	<value>The <b>customPropertySet</b> of an object is the name of the active property set.<p></p><p>By default, the <b>customPropertySet</b> of an object is empty.</p></value>
	<comments>An object can have multiple sets of custom properties. Each set is independent of the others, and the same property can have different values in different sets. To make a set's custom properties accessible, set the object's <b>customPropertySet</b> property to the name of the set you want to use. The values and properties in the current <b>customPropertySet</b> are used when you refer to a custom property.<p></p><p>If the setName is not already a custom property set, setting the <b>customPropertySet</b> to the setName creates a custom property set named setName for the object.</p><p></p><p>To use the default set of custom properties, set the <b>customPropertySet</b> to empty.</p><p></p><p>You can access a property that is not part of the current <b>customPropertySet</b> using array notation. For example, the following statement gets the value of a custom property named &quot;foo&quot; in a custom property set named &quot;myCustomSet&quot;:</p><p></p><p><code tag=""> get the myCustomSet[&quot;foo&quot;] of field &quot;Example&quot;</code></p><p></p><p>If using arbitrary custom property names, be aware that it won't be possible to access them by changing the <b>customPropertySet</b> if they clash with LiveCode language keywords. Instead, either use the array style notation above, or use a prefix to prevent name clashes (for example &quot;uName&quot; instead of &quot;name&quot;).</p></comments>
	</description>
</doc>