First time here? First time here? Newsletter Signup Newsletter
Search tutorials
Author: Jonathan Kaye | Website: http://www.amethyst-research.com

_targetInstanceName: Creating Components that Change the Behavior of Other Stage Elements

We have taught you how to create a self-contained component, but one of the most exciting features introduced with Flash MX Components is the ability to create a component that modifies the behavior of some other stage element onto which it is dropped. For those of you who are familiar with Director, you will already know these as 'behaviors.'

With this feature, you can drag the component onto some other stage element (e.g., a movie clip or text field) and have the component alter that stage element's properties. For example, the scroll bar component that Macromedia provides places and sizes itself to any text field onto which it is dropped, and automatically provides scroll bar functionality to that text field. The _targetInstanceName property tells the component the name (String) of the stage element onto which it has been dropped. To access the target object's properties or methods, you use the following syntax from within a component method: this._parent[_targetInstanceName]. For example, to retrieve the width of the target object, you would write


To make this property available, you include it in the list of your component parameters (see Figure above). You also get a special surprise: your component will 'snap' into place. When you drop your component over another stage element, your component will align itself with the upper left-hand corner of the target stage element. This is also a convenient visual check that the component has been connected with a target object. Alternatively, you can type in the name of the target object into the property inspector. If the component is not dropped onto a stage element, the _targetInstanceName property is set to the default value you give it when you add the property to the component's property list.

» Level Intermediate

Added: 2002-04-16
Rating: 8 Votes: 55
(10 being the highest)
» Author
Jonathan Kaye, PhD, is the President and CTO of Amethyst Research LLC, an award-winning interactive design and engineering firm specializing in the creation of online device simulations. He and David Castillo are the authors of "Flash for Interactive Simulation: How to Construct and Use Device Simulations", to be published by Delmar Thomson Learning in November, 2002 (the accompanying web site will be www.FlashSim.com).
» Download
Download the files used in this tutorial.
» Forums
More help? Search our boards for quick answers!


  • There are no comments yet. Be the first to comment!

  • You must have javascript enabled in order to post comments.

Leave a Comment
  • Your email address will not be published. All fields are required.
Featured Flash FLA
» Author: Inocreato
» Title: RaiseTheBlocks
» Description: Raise all the blocks to win the game
Featured Sound Loops
Image for equalize

Audio Player

» Author: TomCat Carty
» Title: The Wood
» Description: Just a little game ending or it can maybe be looped. Recorders with music box and percussion to give the feel of well, I don't know, the woods? Free to use, just credit me. thank you
Latest Font
» Author: Fábio FAFERS
» Description: I created this font for free use. Everyone can apply it in personal or business texts. Its free, but I want to be communicated in case of business use. Donations are accepted to keep the project of free fonts alive! Thank you all
Featured Sound Fx
Image for equalize

Audio Player

» Author: Davisigner
» Description: Hmm... what to say about this one? It's reminiscent of the closing notes of the opening music from the Three Stooges done in a church organ style with a closing cymbal crash. I'll give this one away gratis, but feel free to check out my free loops and potential upcoming license-mandated ones over in the respective part of Flashkit.