Application.html

---

layout: api
title: "Application - MontageJS API"

---

<nav class="sidenav js-api-sidenav">
    <input id="index-search" type="search" placeholder="Search"><details open><summary>Types</summary><ul><li><a href="AbstractButton.html">AbstractButton</a></li><li><a href="AbstractCheckbox.html">AbstractCheckbox</a></li><li><a href="AbstractControl.html">AbstractControl</a></li><li><a href="AbstractImage.html">AbstractImage</a></li><li><a href="AbstractLink.html">AbstractLink</a></li><li><a href="AbstractNumberField.html">AbstractNumberField</a></li><li><a href="AbstractRadioButton.html">AbstractRadioButton</a></li><li><a href="AbstractSelect.html">AbstractSelect</a></li><li><a href="AbstractSlider.html">AbstractSlider</a></li><li><a href="AbstractTextArea.html">AbstractTextArea</a></li><li><a href="AbstractTextField.html">AbstractTextField</a></li><li><a href="AbstractToggleButton.html">AbstractToggleButton</a></li><li><a href="AbstractToggleSwitch.html">AbstractToggleSwitch</a></li><li><a href="AbstractVideo.html">AbstractVideo</a></li><li><a href="ActionEventListener.html">ActionEventListener</a></li><li><a href="Alert.html">Alert</a></li><li><a href="Alias.html">Alias</a></li><li><a href="Application.html">Application</a></li><li><a href="AssociationBlueprint.html">AssociationBlueprint</a></li><li><a href="Binder.html">Binder</a></li><li><a href="BinderManager.html">BinderManager</a></li><li><a href="BitField.html">BitField</a></li><li><a href="Blueprint.html">Blueprint</a></li><li><a href="BytesConverter.html">BytesConverter</a></li><li><a href="Component.html">Component</a></li><li><a href="Composer.html">Composer</a></li><li><a href="Condition.html">Condition</a></li><li><a href="Converter.html">Converter</a></li><li><a href="CubicBezier.html">CubicBezier</a></li><li><a href="CurrencyConverter.html">CurrencyConverter</a></li><li><a href="DateConverter.html">DateConverter</a></li><li><a href="DateValidator.html">DateValidator</a></li><li><a href="DefaultLocalizer.html">DefaultLocalizer</a></li><li><a href="DerivedPropertyBlueprint.html">DerivedPropertyBlueprint</a></li><li><a href="ElementReference.html">ElementReference</a></li><li><a href="Enum.html">Enum</a></li><li><a href="EventBlueprint.html">EventBlueprint</a></li><li><a href="EventManager.html">EventManager</a></li><li><a href="Exception.html">Exception</a></li><li><a href="Flow.html">Flow</a></li><li><a href="FlowTranslateComposer.html">FlowTranslateComposer</a></li><li><a href="Gate.html">Gate</a></li><li><a href="InvertConverter.html">InvertConverter</a></li><li><a href="Iteration.html">Iteration</a></li><li><a href="KeyComposer.html">KeyComposer</a></li><li><a href="KeyManager.html">KeyManager</a></li><li><a href="Loader.html">Loader</a></li><li><a href="Localizer.html">Localizer</a></li><li><a href="Logger.html">Logger</a></li><li><a href="LowerCaseConverter.html">LowerCaseConverter</a></li><li><a href="MediaController.html">MediaController</a></li><li><a href="MessageFormat.html">MessageFormat</a></li><li><a href="MessageLocalizer.html">MessageLocalizer</a></li><li><a href="ModalOverlay.html">ModalOverlay</a></li><li><a href="ModuleBlueprint.html">ModuleBlueprint</a></li><li><a href="ModuleReference.html">ModuleReference</a></li><li><a href="Montage.html">Montage</a></li><li><a href="MontageBuilder.html">MontageBuilder</a></li><li><a href="MontageReviver.html">MontageReviver</a></li><li><a href="MontageWindow.html">MontageWindow</a></li><li><a href="MutableEvent.html">MutableEvent</a></li><li><a href="NewLineToBrConverter.html">NewLineToBrConverter</a></li><li><a href="NumberConverter.html">NumberConverter</a></li><li><a href="NumberValidator.html">NumberValidator</a></li><li><a href="ObjectController.html">ObjectController</a></li><li><a href="ObjectProperty.html">ObjectProperty</a></li><li><a href="Overlay.html">Overlay</a></li><li><a href="Point_.html">Point</a></li><li><a href="PressComposer.html">PressComposer</a></li><li><a href="PressEvent.html">PressEvent</a></li><li><a href="PromiseController.html">PromiseController</a></li><li><a href="PropertyBlueprint.html">PropertyBlueprint</a></li><li><a href="PropertyValidationRule.html">PropertyValidationRule</a></li><li><a href="PropertyValidationSemantics.html">PropertyValidationSemantics</a></li><li><a href="RadioButtonController.html">RadioButtonController</a></li><li><a href="RangeController.html">RangeController</a></li><li><a href="Repetition.html">Repetition</a></li><li><a href="RootComponent.html">RootComponent</a></li><li><a href="Serialization.html">Serialization</a></li><li><a href="SerializationExtractor.html">SerializationExtractor</a></li><li><a href="SerializationInspector.html">SerializationInspector</a></li><li><a href="SerializationMerger.html">SerializationMerger</a></li><li><a href="Slot.html">Slot</a></li><li><a href="State.html">State</a></li><li><a href="StateChart.html">StateChart</a></li><li><a href="Substitution.html">Substitution</a></li><li><a href="SwipeComposer.html">SwipeComposer</a></li><li><a href="Target.html">Target</a></li><li><a href="Template.html">Template</a></li><li><a href="TemplateResources.html">TemplateResources</a></li><li><a href="Text.html">Text</a></li><li><a href="TranslateComposer.html">TranslateComposer</a></li><li><a href="TreeController.html">TreeController</a></li><li><a href="TreeControllerNode.html">TreeControllerNode</a></li><li><a href="TrimConverter.html">TrimConverter</a></li><li><a href="UpperCaseConverter.html">UpperCaseConverter</a></li><li><a href="Uuid_.html">Uuid</a></li><li><a href="Validator.html">Validator</a></li></ul></details><details><summary>Externals</summary><ul><li><a href="external-Array.html">Array</a></li><li><a href="external-Function.html">Function</a></li><li><a href="external-Object.html">Object</a></li><li><a href="external-RegExp.html">RegExp</a></li><li><a href="external-String.html">String</a></li></ul></details><details><summary>Events</summary><ul><li><a href="AbstractButton.html#event:action">action</a></li><li><a href="AbstractButton.html#event:longAction">longAction</a></li><li><a href="AbstractButton.html#event:longpress">longpress</a></li><li><a href="AbstractCheckbox.html#event:action">action</a></li><li><a href="AbstractLink.html#event:action">action</a></li><li><a href="AbstractRadioButton.html#event:action">action</a></li><li><a href="AbstractSelect.html#event:action">action</a></li><li><a href="AbstractTextField.html#event:action">action</a></li><li><a href="AbstractToggleButton.html#event:action">action</a></li><li><a href="AbstractToggleButton.html#event:longAction">longAction</a></li><li><a href="AbstractToggleSwitch.html#event:action">action</a></li><li><a href="Overlay.html#event:dismiss">dismiss</a></li><li><a href="PressComposer.html#event:longPress">longPress</a></li><li><a href="PressComposer.html#event:press">press</a></li><li><a href="PressComposer.html#event:pressCancel">pressCancel</a></li><li><a href="PressComposer.html#event:pressStart">pressStart</a></li><li><a href="UndoManager.html#event:operationRegistered">operationRegistered</a></li><li><a href="UndoManager.html#event:redo">redo</a></li><li><a href="UndoManager.html#event:undo">undo</a></li></ul></details><details><summary>Global</summary><ul><li><a href="global.html#determinate">determinate</a></li><li><a href="global.html#error">error</a></li><li><a href="global.html#fulfilled">fulfilled</a></li><li><a href="global.html#ok">ok</a></li><li><a href="global.html#pending">pending</a></li><li><a href="global.html#progress">progress</a></li><li><a href="global.html#progressState">progressState</a></li><li><a href="global.html#promise">promise</a></li><li><a href="global.html#rejected">rejected</a></li><li><a href="global.html#state">state</a></li><li><a href="global.html#">undefined</a></li><li><a href="global.html#value">value</a></li></ul></details>
</nav>

<div class="main">
    <article class="content">




<header>
    <h2>

        Application


            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L21">source</a></span>

    </h2>

</header>

<article>

        <p>Specializes <a href="Target.html">Target</a> </p>

    <div class="container-overview">




<dt>



</dt>
<dd>


    <div class="description markdown-body">
        <p>The application is a singleton, it initially loads and oversees the running
program.
It is also responsible for window management.
The behavior of the application can be modified by implementing a delegate
{Application#delegate}.
It is also possible to subclass the application by specifying an
<code>applicationPrototype&quot;</code> in <code>the package.json</code>.</p>
    </div>












<table class="details">





















</table>









</dd>


    </div>










        <h3 class="subsection-title">Properties</h3>

        <dl>

<dt>
    <h4 class="name" id="acceptsActiveTarget">
        acceptsActiveTarget<span class="type-signature"> :boolean</span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/target.js#L32">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>Whether or not this target can accept user focus and become the
activeTarget This matches up with the <code>document.activeElement</code> property
purpose-wise; Events from components that should be dispatched as
logically occurring at the point of user focus should be dispatched at
the activeTarget</p>
<p>By default a target does not accept this responsibility.</p>
    </div>






<table class="details">





	<tr>
        <th class="details-header inherited-from">Inherited From:</th>
	    <td class="details-content inherited-from">
			<ul class="dummy">
				<li>
	                <a href="Target.html#acceptsActiveTarget">Target#acceptsActiveTarget</a>
	            </li>
			</ul>
		</td>
	</tr>











	<tr>
	    <th class="details-header tag-default">Default Value:</th>
	    <td class="details-content tag-default"><ul class="dummy"><li>false</li></ul></td>
	</tr>







</table>



</dd>




<dt>
    <h4 class="name" id="attachedWindows">
        attachedWindows<span class="type-signature"> :Array.&lt;<a href="MontageWindow.html">MontageWindow</a>></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L162">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>An array of the child windows attached to the application.</p>
    </div>






<table class="details">















	<tr>
	    <th class="details-header tag-default">Default Value:</th>
	    <td class="details-content tag-default"><ul class="dummy"><li>{Array} []</li></ul></td>
	</tr>







</table>



</dd>




<dt>
    <h4 class="name" id="delegate">
        delegate<span class="type-signature"> :Object</span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L211">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>The application's delegate object, it can implement a
<code>willFinishLoading</code> method that will be called right after the
index.html is loaded.
The application delegate is also the next event target after the
application.</p>
    </div>






<table class="details">















	<tr>
	    <th class="details-header tag-default">Default Value:</th>
	    <td class="details-content tag-default"><ul class="dummy"><li>null</li></ul></td>
	</tr>







</table>



</dd>




<dt>
    <h4 class="name" id="eventManager">
        eventManager<span class="type-signature"> :<a href="EventManager.html">EventManager</a></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L39">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>Provides a reference to the Montage event manager used in the
application.</p>
    </div>






<table class="details">





















</table>



</dd>




<dt>
    <h4 class="name" id="focusWindow">
        focusWindow<span class="type-signature"> :<a href="MontageWindow.html">MontageWindow</a></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L183">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>Return the top most window of any of the Montage Windows.</p>
    </div>






<table class="details">















	<tr>
	    <th class="details-header tag-default">Default Value:</th>
	    <td class="details-content tag-default"><ul class="dummy"><li>document.defaultView</li></ul></td>
	</tr>







</table>



</dd>




<dt>
    <h4 class="name" id="isActiveTarget">
        isActiveTarget<span class="type-signature"> :boolean</span> <span class="type-signature">&lt;readonly> </span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/target.js#L46">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>Whether or not this is the activeTarget</p>
<p>This is a getter and is not bindable. Bind to
<code>defaultEventManager.activeTarget == this</code>.</p>
    </div>






<table class="details">





	<tr>
        <th class="details-header inherited-from">Inherited From:</th>
	    <td class="details-content inherited-from">
			<ul class="dummy">
				<li>
	                <a href="Target.html#isActiveTarget">Target#isActiveTarget</a>
	            </li>
			</ul>
		</td>
	</tr>

















</table>



</dd>




<dt>
    <h4 class="name" id="mainApplication">
        mainApplication<span class="type-signature"> :<a href="Application.html">Application</a></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L57">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>Provides a reference to the main application.</p>
    </div>






<table class="details">















	<tr>
	    <th class="details-header tag-default">Default Value:</th>
	    <td class="details-content tag-default"><ul class="dummy"><li>this</li></ul></td>
	</tr>







</table>



</dd>




<dt>
    <h4 class="name" id="parentApplication">
        parentApplication<span class="type-signature"> :<a href="Application.html">Application</a></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L48">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>Provides a reference to the parent application.</p>
    </div>






<table class="details">















	<tr>
	    <th class="details-header tag-default">Default Value:</th>
	    <td class="details-content tag-default"><ul class="dummy"><li>null</li></ul></td>
	</tr>







</table>



</dd>




<dt>
    <h4 class="name" id="window">
        window<span class="type-signature"> :<a href="MontageWindow.html">MontageWindow</a></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L139">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>Provides a reference to the MontageWindow associated with the
application.</p>
    </div>






<table class="details">





















</table>



</dd>




<dt>
    <h4 class="name" id="windows">
        windows<span class="type-signature"> :Array.&lt;<a href="MontageWindow.html">MontageWindow</a>></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L109">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>Provides a reference to all the windows opened by the main application
or any of its descendents, including the main window itself.
The list is kept sorted, the sort order is determined by the
<code>Application.windowsSortOrder</code> property</p>
    </div>






<table class="details">





















</table>



</dd>




<dt>
    <h4 class="name" id="windowsSortOrder">
        windowsSortOrder<span class="type-signature"> :string</span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L82">source</a></span>

    </h4>


</dt>
<dd>

    <div class="description">
        <p>Determines the sort order for the Application.windows array.
Possible values are: z-order, reverse-z-order, open-order,
reverse-open-order</p>
    </div>






<table class="details">















	<tr>
	    <th class="details-header tag-default">Default Value:</th>
	    <td class="details-content tag-default"><ul class="dummy"><li>"reverse-z-order"</li></ul></td>
	</tr>







</table>



</dd>


        </dl>



        <h3 class="subsection-title">Methods</h3>

        <dl>

<dt>

    <h4 class="name" id="addEventListener">
        addEventListener<span class="signature">(type, listener, useCapture)</span><span class="type-signature"></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/target.js#L139">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Adds an event listener to the object.</p>
    </div>







        <h5>Parameters:</h5>


<table class="params">
    <thead>
	<tr>

		<th>Name</th>


		<th>Type</th>





		<th class="last">Description</th>
	</tr>
	</thead>

	<tbody>


        <tr>

                <td class="name"><code>type</code></td>


            <td class="type">


<span class="param-type">string</span>



            </td>





            <td class="description last"><p>The event type to listen for.</p></td>
        </tr>



        <tr>

                <td class="name"><code>listener</code></td>


            <td class="type">


<span class="param-type">object</span>
|

<span class="param-type">function</span>



            </td>





            <td class="description last"><p>The listener object or function.</p></td>
        </tr>



        <tr>

                <td class="name"><code>useCapture</code></td>


            <td class="type">


<span class="param-type">boolean</span>



            </td>





            <td class="description last"><p>Specifies whether to listen for the event during the bubble or capture phases.</p></td>
        </tr>


	</tbody>
</table>







<table class="details">





	<tr>
        <th class="details-header inherited-from">Inherited From:</th>
	    <td class="details-content inherited-from">
			<ul class="dummy">
				<li>
	                <a href="Target.html#addEventListener">Target#addEventListener</a>
	            </li>
			</ul>
		</td>
	</tr>

















</table>









</dd>



<dt>

    <h4 class="name" id="attachWindow">
        attachWindow<span class="signature">(window)</span><span class="type-signature"></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L338">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Attach a window to a parent application.
When a window open, it is automatically attached to the Application used
to create the window.</p>
    </div>







        <h5>Parameters:</h5>


<table class="params">
    <thead>
	<tr>

		<th>Name</th>


		<th>Type</th>





		<th class="last">Description</th>
	</tr>
	</thead>

	<tbody>


        <tr>

                <td class="name"><code>window</code></td>


            <td class="type">


<span class="param-type"><a href="MontageWindow.html">MontageWindow</a></span>



            </td>





            <td class="description last"><p>to detach.</p></td>
        </tr>


	</tbody>
</table>







<table class="details">





















</table>









</dd>



<dt>

    <h4 class="name" id="detachWindow">
        detachWindow<span class="signature">(window)</span><span class="type-signature"></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L370">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Detach the window from its parent application.
If no montageWindow is specified, the current application's windows will
be detached.</p>
    </div>







        <h5>Parameters:</h5>


<table class="params">
    <thead>
	<tr>

		<th>Name</th>


		<th>Type</th>





		<th class="last">Description</th>
	</tr>
	</thead>

	<tbody>


        <tr>

                <td class="name"><code>window</code></td>


            <td class="type">


<span class="param-type"><a href="MontageWindow.html">MontageWindow</a></span>



            </td>





            <td class="description last"><p>to detach.</p></td>
        </tr>


	</tbody>
</table>







<table class="details">





















</table>









</dd>



<dt>

    <h4 class="name" id="didBecomeActiveTarget">
        didBecomeActiveTarget<span class="signature">()</span><span class="type-signature"></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/target.js#L65">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Called after to this target became the activeTarget</p>
    </div>












<table class="details">





	<tr>
        <th class="details-header inherited-from">Inherited From:</th>
	    <td class="details-content inherited-from">
			<ul class="dummy">
				<li>
	                <a href="Target.html#didBecomeActiveTarget">Target#didBecomeActiveTarget</a>
	            </li>
			</ul>
		</td>
	</tr>

















</table>









</dd>



<dt>

    <h4 class="name" id="dispatchEvent">
        dispatchEvent<span class="signature">(event)</span><span class="type-signature"></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/target.js#L98">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Dispatches the specified event with this target
as the event's proximal target</p>
    </div>







        <h5>Parameters:</h5>


<table class="params">
    <thead>
	<tr>

		<th>Name</th>


		<th>Type</th>





		<th class="last">Description</th>
	</tr>
	</thead>

	<tbody>


        <tr>

                <td class="name"><code>event</code></td>


            <td class="type">


<span class="param-type">Event</span>



            </td>





            <td class="description last"><p>The event object to dispatch</p></td>
        </tr>


	</tbody>
</table>







<table class="details">





	<tr>
        <th class="details-header inherited-from">Inherited From:</th>
	    <td class="details-content inherited-from">
			<ul class="dummy">
				<li>
	                <a href="Target.html#dispatchEvent">Target#dispatchEvent</a>
	            </li>
			</ul>
		</td>
	</tr>

















</table>









</dd>



<dt>

    <h4 class="name" id="dispatchEventNamed">
        dispatchEventNamed<span class="signature">(type, canBubble, cancelable, detail)</span><span class="type-signature"></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/target.js#L122">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Creates and dispatches an event with the specified properties with this
target as the event's proximal target</p>
    </div>







        <h5>Parameters:</h5>


<table class="params">
    <thead>
	<tr>

		<th>Name</th>


		<th>Type</th>





		<th class="last">Description</th>
	</tr>
	</thead>

	<tbody>


        <tr>

                <td class="name"><code>type</code></td>


            <td class="type">


<span class="param-type">string</span>



            </td>





            <td class="description last"><p>The type of the event to dispatch</p></td>
        </tr>



        <tr>

                <td class="name"><code>canBubble</code></td>


            <td class="type">


<span class="param-type">boolean</span>



            </td>





            <td class="description last"><p>Whether or not the event can bubble</p></td>
        </tr>



        <tr>

                <td class="name"><code>cancelable</code></td>


            <td class="type">


<span class="param-type">boolean</span>



            </td>





            <td class="description last"><p>Whether or not the event can be cancelled</p></td>
        </tr>



        <tr>

                <td class="name"><code>detail</code></td>


            <td class="type">


<span class="param-type">Object</span>



            </td>





            <td class="description last"><p>The optional detail object of the event</p></td>
        </tr>


	</tbody>
</table>







<table class="details">





	<tr>
        <th class="details-header inherited-from">Inherited From:</th>
	    <td class="details-content inherited-from">
			<ul class="dummy">
				<li>
	                <a href="Target.html#dispatchEventNamed">Target#dispatchEventNamed</a>
	            </li>
			</ul>
		</td>
	</tr>

















</table>









</dd>



<dt>

    <h4 class="name" id="eventManagerForWindow">
        eventManagerForWindow<span class="signature">(aWindow)</span><span class="type-signature"></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L172">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Returns the event manager for the specified window object.</p>
    </div>







        <h5>Parameters:</h5>


<table class="params">
    <thead>
	<tr>

		<th>Name</th>


		<th>Type</th>





		<th class="last">Description</th>
	</tr>
	</thead>

	<tbody>


        <tr>

                <td class="name"><code>aWindow</code></td>


            <td class="type">


<span class="param-type">Window</span>



            </td>





            <td class="description last"><p>The browser window whose event manager object should be returned.</p></td>
        </tr>


	</tbody>
</table>







<table class="details">





















</table>








            <h5>
                Returns:

            </h5>

                <div class="param-desc">
                    <p>aWindow.defaultEventMananger</p>
                </div>





</dd>



<dt>

    <h4 class="name" id="openWindow">
        openWindow<span class="signature">(component,, name,, parameters,)</span><span class="type-signature"></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/application.js#L238">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Opens a component in a new browser window, and registers the window with
the Montage event manager.</p>
<p>The component URL must be in the same domain as the calling script. Can
be relative to the main application</p>
    </div>







        <h5>Parameters:</h5>


<table class="params">
    <thead>
	<tr>

		<th>Name</th>


		<th>Type</th>





		<th class="last">Description</th>
	</tr>
	</thead>

	<tbody>


        <tr>

                <td class="name"><code>component,</code></td>


            <td class="type">


<span class="param-type">string</span>



            </td>





            <td class="description last"><p>the path to the reel component to open in the
new window.</p></td>
        </tr>



        <tr>

                <td class="name"><code>name,</code></td>


            <td class="type">


<span class="param-type">string</span>



            </td>





            <td class="description last"><p>the component main class name.</p></td>
        </tr>



        <tr>

                <td class="name"><code>parameters,</code></td>


            <td class="type">


<span class="param-type">Object</span>



            </td>





            <td class="description last"><p>the new window parameters (accept same
parameters than window.open).</p></td>
        </tr>


	</tbody>
</table>







<table class="details">





















</table>









        <h5>Example</h5>

    <pre class="prettyprint"><code>var app = document.application;
app.openWindow("docs/help.reel", "Help", "{width:300, height:500}");</code></pre>


</dd>



<dt>

    <h4 class="name" id="removeEventListener">
        removeEventListener<span class="signature">(type, listener, useCapture)</span><span class="type-signature"></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/target.js#L154">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Removes an event listener from the object.</p>
    </div>







        <h5>Parameters:</h5>


<table class="params">
    <thead>
	<tr>

		<th>Name</th>


		<th>Type</th>





		<th class="last">Description</th>
	</tr>
	</thead>

	<tbody>


        <tr>

                <td class="name"><code>type</code></td>


            <td class="type">


<span class="param-type">string</span>



            </td>





            <td class="description last"><p>The event type.</p></td>
        </tr>



        <tr>

                <td class="name"><code>listener</code></td>


            <td class="type">


<span class="param-type">object</span>
|

<span class="param-type">function</span>



            </td>





            <td class="description last"><p>The listener object or function.</p></td>
        </tr>



        <tr>

                <td class="name"><code>useCapture</code></td>


            <td class="type">


<span class="param-type">boolean</span>



            </td>





            <td class="description last"><p>The phase of the event listener.</p></td>
        </tr>


	</tbody>
</table>







<table class="details">





	<tr>
        <th class="details-header inherited-from">Inherited From:</th>
	    <td class="details-content inherited-from">
			<ul class="dummy">
				<li>
	                <a href="Target.html#removeEventListener">Target#removeEventListener</a>
	            </li>
			</ul>
		</td>
	</tr>

















</table>









</dd>



<dt>

    <h4 class="name" id="surrendersActiveTarget">
        surrendersActiveTarget<span class="signature">(newTarget)</span><span class="type-signature"> &rarr; {boolean}</span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/target.js#L76">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Ask this target to surrender its activeTarget status.</p>
    </div>







        <h5>Parameters:</h5>


<table class="params">
    <thead>
	<tr>

		<th>Name</th>


		<th>Type</th>





		<th class="last">Description</th>
	</tr>
	</thead>

	<tbody>


        <tr>

                <td class="name"><code>newTarget</code></td>


            <td class="type">


<span class="param-type"><a href="Target.html">Target</a></span>



            </td>





            <td class="description last"><p>the Target that is about to become the
<code>activeTarget</code></p></td>
        </tr>


	</tbody>
</table>







<table class="details">





	<tr>
        <th class="details-header inherited-from">Inherited From:</th>
	    <td class="details-content inherited-from">
			<ul class="dummy">
				<li>
	                <a href="Target.html#surrendersActiveTarget">Target#surrendersActiveTarget</a>
	            </li>
			</ul>
		</td>
	</tr>

















</table>








            <h5>
                Returns:

                    <span class="return-type">
<span class="param-type">boolean</span>

</span>

            </h5>

                <div class="param-desc">
                    <p>Whether or not to surrender activeTarget status</p>
                </div>





</dd>



<dt>

    <h4 class="name" id="willBecomeActiveTarget">
        willBecomeActiveTarget<span class="signature">(oldTarget)</span><span class="type-signature"></span> <span class="type-signature"></span>

            <span class="source"><a href="https://github.com/montagejs/montage/blob/v0.14.14/core/target.js#L57">source</a></span>

    </h4>



</dt>
<dd>


    <div class="description markdown-body">
        <p>Called prior to this target becoming the activeTarget</p>
    </div>







        <h5>Parameters:</h5>


<table class="params">
    <thead>
	<tr>

		<th>Name</th>


		<th>Type</th>





		<th class="last">Description</th>
	</tr>
	</thead>

	<tbody>


        <tr>

                <td class="name"><code>oldTarget</code></td>


            <td class="type">


<span class="param-type"><a href="Target.html">Target</a></span>



            </td>





            <td class="description last"><p>the current activeTarget</p></td>
        </tr>


	</tbody>
</table>







<table class="details">





	<tr>
        <th class="details-header inherited-from">Inherited From:</th>
	    <td class="details-content inherited-from">
			<ul class="dummy">
				<li>
	                <a href="Target.html#willBecomeActiveTarget">Target#willBecomeActiveTarget</a>
	            </li>
			</ul>
		</td>
	</tr>

















</table>









</dd>

        </dl>






    <p class="generated-from">Generated from <a href="https://github.com/montagejs/montage/tree/v0.14.14">v0.14.14</a></p>
</article>





    </article>

</div>

<script>
(function() {
    var codeBlocks = document.querySelectorAll("code[class|='lang']");

    // Add "prettyprint" class name to each code block that defines a lang
    // because it is needed for prettify to find the block.
    for (var i = 0, block; block = codeBlocks[i]; i++) {
        block.className += " prettyprint";
    }

    window.prettyPrint();
})();
</script>