<doc>
	<legacy_id>1934</legacy_id>
	<name>revLoadedStacks</name>
	<type>function</type>

	<syntax>
		<example>revLoadedStacks([<i>whichStacks</i>])</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary><glossary tag="return">Returns</glossary> a list of the names of all <function tag="stacks">stacks</function> that are <glossary tag="loaded into memory">loaded into memory</glossary>. </summary>

	<examples>
<example>revLoadedStacks(all) </example>
<example>revLoadedStacks(application) </example>
<example><p>revLoadedStacks() </p></example>
	</examples>

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

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
	</platforms>

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

	<security>
	</security>


	<classification>
		<category>Objects &amp; Messages</category>
		<category>Standalone Applications</category>
	</classification>

	<references>
		<function tag="mainStacks">mainStacks Function</function>
	</references>

	<description>
	<overview>Use the <b>revLoadedStacks</b> <control_st tag="function">function</control_st> if you need to perform some operation on all <function tag="stacks">stacks</function> that are <glossary tag="loaded into memory">loaded into memory</glossary>. </overview>

		<parameters>
		<parameter>The <i>whichStacks</i> is one of the following</parameter>
		<parameter>        * application: Only your application's stacks</parameter>
		<parameter>        * all: All stacks including LiveCode development environment stacks</parameter>
		<parameter>        * preference: Depends on Preferences setting</parameter>
		</parameters>

	<value>The <b>revLoadedStacks</b> <control_st tag="function">function</control_st> returns a list of the short names of all loaded <function tag="stacks">stacks</function>, one per line. </value>
	<comments>If the <i>whichStacks</i> <glossary tag="parameter">parameter</glossary> is all, the <b>revLoadedStacks</b> <control_st tag="function">function</control_st> returns all <function tag="stacks">stacks</function> that are <glossary tag="loaded into memory">loaded into memory</glossary>, including <function tag="stacks">stacks</function> that are part of the LiveCode <glossary tag="development environment">development environment</glossary> (such as the <keyword tag="message box">message box</keyword>, <glossary tag="property inspector">property inspector</glossary>, and so on). <p></p><p>If the <i>whichStacks</i> <glossary tag="parameter">parameter</glossary> is application, the <b>revLoadedStacks</b> <control_st tag="function">function</control_st> returns all loaded <function tag="stacks">stacks</function> that are not part of the <glossary tag="development environment">development environment</glossary>. </p><p></p><p>If the <i>whichStacks</i> <glossary tag="parameter">parameter</glossary> is preference, the <b>revLoadedStacks</b> <control_st tag="function">function</control_st> checks the setting of the &quot;LiveCode UI Elements in Lists&quot; item in the View menu, and returns either all <function tag="stacks">stacks</function>, or only <function tag="stacks">stacks</function> that are not part of the <glossary tag="development environment">development environment</glossary>, depending on the setting. </p><p></p><p>If you don't specify a <i>whichStacks</i> <glossary tag="parameter">parameter</glossary>, the <b>revLoadedStacks</b> <control_st tag="function">function</control_st> returns all loaded <function tag="stacks">stacks</function> that are not part of the <glossary tag="development environment">development environment</glossary>. This is the same behavior as if application had been specified as the <i>whichStacks </i>parameter.</p><p></p><p></p><note>When included in a <glossary tag="standalone application">standalone application</glossary>, the <glossary tag="Common library">Common library</glossary> is implemented as a hidden <command tag="group">group</command> and made available when the <command tag="group">group</command> receives its first <message tag="openBackground">openBackground</message> message. During the first part of the <glossary tag="application">application's</glossary> startup process, before this <keyword tag="message box">message</keyword> is sent, the <b>revLoadedStacks</b> <control_st tag="function">function</control_st> is not yet available. This may affect attempts to use this <control_st tag="function">function</control_st> in <message tag="startup">startup</message>, <message tag="preOpenStack">preOpenStack</message>, <message tag="openStack">openStack</message>, or <message tag="preOpenCard">preOpenCard</message> <glossary tag="handler">handlers</glossary> in the <glossary tag="main stack">main stack</glossary>. Once the <glossary tag="application">application</glossary> has finished starting up, the <command tag="start using">library</command> is available and the <b>revLoadedStacks</b> <control_st tag="function">function</control_st> can be used in any <glossary tag="handler">handler</glossary>. </note></comments>
	</description>
</doc>