<doc>
	<legacy_id>2022</legacy_id>
	<name>effective</name>
	<type>keyword</type>

	<syntax>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Used with <glossary tag="inheritance">inherited</glossary> <property tag="properties">properties</property> to specify the <glossary tag="object">object's</glossary> own setting or the setting <glossary tag="inheritance">inherited</glossary> from the <glossary tag="object">object's</glossary> <property tag="owner">owner</property>, whichever is actually displayed.</summary>

	<examples>
<example>put the effective textColor of me into myColor</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.0">Added effective entry for LayerMode.</changed>
<changed version="1.1">1.1</changed>
	</history>

	<objects>
	</objects>

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

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

	<security>
	</security>


	<classification>
		<category>Objects  Messages</category>
		<category>Appearance  Positioning</category>
		<category>Files, Folders,  Resources</category>
	</classification>

	<references>
		<property tag="owner">owner Property</property>
		<property tag="label">label Property</property>
		<property tag="topColor">topColor Property</property>
		<property tag="borderPattern">borderPattern Property</property>
		<property tag="threeDHilite">threeDHilite Property</property>
		<property tag="focusPattern">focusPattern Property</property>
		<property tag="foregroundColor">foregroundColor Property</property>
		<property tag="bottomPattern">bottomPattern Property</property>
		<property tag="focusColor">focusColor Property</property>
		<property tag="layerMode">LayerMode Property</property>
	</references>

	<description>
	<overview>Use the <b>effective</b> <glossary tag="keyword">keyword</glossary> to get the displayed color or <glossary tag="font">font</glossary> of an <glossary tag="object">object</glossary>, regardless of whether the <glossary tag="object">object</glossary> itself has that <glossary tag="property">property</glossary> set. The <b>effective</b> <glossary tag="keyword">keyword</glossary> can also be used to get the <property tag="filename">filename</property> of a <glossary tag="substack">substack</glossary> or the current <keyword tag="rectangle">rectangle</keyword> of an <glossary tag="object">object</glossary>.</overview>

		<parameters>
		</parameters>

	<value></value>
	<comments>If one of an object's text, color, or pattern properties is set to empty, the owner's setting is used instead. (If the owner's setting is empty, the setting of that object's <b>owner</b> is used.)<p></p><p>For example, if a card button's <b>backgroundColor</b> <glossary tag="property">property</glossary> is empty, the <property tag="backgroundColor">backgroundColor</property> of the <keyword tag="card">card</keyword> is used as the <glossary tag="button">button's</glossary> <property tag="backgroundColor">backgroundColor</property>. You use the <b>effective</b> <glossary tag="keyword">keyword</glossary> to get the color that is actually used. If the <glossary tag="button">button's</glossary> <property tag="backgroundColor">backgroundColor</property> is not set to empty, the <b>effective</b> <glossary tag="keyword">keyword</glossary> gets the setting for the <keyword tag="button">button</keyword>, since that setting is what the <keyword tag="button">button</keyword> displays as its background color.</p><p></p><p>The <b>effective</b> <glossary tag="keyword">keyword</glossary> can be used with the following inherited <property tag="properties">properties</property>:</p><p></p><p>* <b>backgroundColor</b> property</p><p>* <b>backgroundPattern</b> property</p><p>* <b>backgroundPixel</b> property</p><p>* <b>bottomColor</b> property</p><p>* <b>bottomPattern</b> property</p><p>* <b>bottomPixel</b> property</p><p>* <b>focusColor</b> property</p><p>* <b>focusPattern</b> property</p><p>* <b>focusPixel</b> property</p><p>* <b>foregroundColor</b> property</p><p>* <b>foregroundPattern</b> property</p><p>* <b>foregroundPixel</b> property</p><p>* <b>hiliteColor</b> property</p><p>* <b>hilitePattern</b> property</p><p>* <b>hilitePixel</b> property</p><p>* <b>topColor</b> property</p><p>* <b>topPattern</b> property</p><p>* <b>topPixel</b> property</p><p>* <b>shadowColor</b> property</p><p>* <b>shadowPattern</b> property</p><p>* <b>shadowPixel</b> property</p><p></p><p>* <b>textFont</b> property</p><p>* <b>textHeight</b> property</p><p>* <b>textSize</b> property</p><p>* <b>textStyle</b> property</p><p></p><p>* <b>filename of stack</b> property</p><p>* <b>rectangle</b> property</p><p></p><p>* <property tag="layerMode">layerMode</property><property tag="layerMode"> property</property></p><p></p><p></p><note>The <b>effective</b> keyword is implemented internally as a property and appears in the propertyNames. However, it cannot be used as a prop in an expression, nor with the set com.</note></comments>
	</description>
</doc>