Flex/AIR Application Scope Tips

January 27, 2009By 15 Comments

Since I’ve been developing in Flex, the one thing I’ve been trying to get a better handle on is how to go about accessing what I need and when. After digging in to the Flex SDK a bit, I have come to some conclusions on different properties and objects that can be used in different scenarios. The following summary is what I came up with and would like to share with others that may find it useful.


The highest level root application object for a Flex application. This can be used to access the root application object regardless of where you are within a component or sub-application. It can be referenced via the fully qualified name, or in cases where you will use it multiple times, import mx.core.Application and use Application.application to reference the root app variables or methods. For instance:

where sayHello() is defined in your root application code… this property is especially useful for your projects where you have custom components or classes that need to access a shared set of data that is defined in the root.


A property you access within your AIR app that retrieves properties specific to that AIR application. For instance, it can be used to get at properties such as the application descriptor, the publisher of the AIR app, main application icon or menu. You would also use this Singleton object to add event listeners for actions specific to the AIR app, such as the app exiting (NativeApplication.nativeApplication.addEventListener(Event.EXITING, onExiting);).


The outerDocument property is used to access functions and properties defined in your main MXML file when the scope within your code block might have changed, such as when using the tag . The Component object causes the MXML within it to be treated with a new document scope, so while it may seem you can access your functions defined in your main MXML file normally, you will not be able to unless you prefix it with the word outerDocument such as in the following code excerpt. Without this keyword, you will receive a compiler error stating ‘Call to a possibly undefined method




This property can be used to access the application object containing the enclosed object. This could be the top-level application object, but in the case where an application loaded another via the SWFLoader, it will be the currently enclosing application object. An application’s parentApplication will either be the application object that loaded it, or null if it is the top-level app.


The parent document object for the given Flex application, MXML component or AS component, and only valued when isDocument() is true. The top-level application will have a parentDocument of null.


Parent is used specifically for UIComponent classes or those extending from them to indicate the parent container or component for this UIComponent. The parent object type is always a DisplayObjectContainer.


This is the core class of an AIR app, and the object you are using when specifying ‘this’ in your AIR app. It implements IWindow as well as extending the Application class, so it serves two purposes, essentially wrapping the initial NativeWindow AND the NativeApplication objects. One big thing to note here, is that only events from the inherent NativeWindow are dispatched from the root WindowedApplication object, which differs from a browser application which dispatches events for ALL windows associated with that root Application. This is an important distinction to be wary of when developing multi-windowed applications.

Filed in: Adobe FlexFlex/AIR Tags:

About the Author ()

Comments (15)

Trackback URL | Comments RSS Feed

  1. Wow, that outerDocument property really saved my ass! Thanks for that…

  2. James says:

    Wow. outerDocument that’s gonna make things so much easier.

    Awesome post!

  3. Chaney says:

    Just dropping by.Btw, you website have great content!

    How Would You Like To UNPLUG Your House From Your Electrical Company, Knowing That You Are “100% Powered By Nature” With Renewable Energy?

  4. saccestet says:

    Good info=) hope to visit again…

  5. arthipesa says:

    nice post there..thank you very much.
    at my first time code flex to air, this is very important to know, yet I skipped, got me code-lagged for awhile.

  6. ivan says:

    this is exactly what im looking for…
    thanks a lot

  7. Thierry says:

    Really cool, this scope thing was hard to find, what I needed was parentDocument. to access my function. BTW devgirl, you look great on your avatar!

  8. sanka says:

    I wont to know Application vs Component(custom).how can i access when item is an application or component. Application.application is not accesible when it is Component(custom)
    plz let me know how can I handle this problem.

  9. Nicolas says:

    The parentApplication is much useful for event handling between components. I searched the web for hours before coming here. Much appreciated!

  10. Beau says:

    Thanks a bunch… that outerDocument was a lifesaver, pity adobe documentation is so poor, couldn’t find anything else similar anywhere, thanks again

  11. Freddyk says:

    This was very helpful. I really appreciate it.

Leave a Reply