13.08.2012 Views

ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3 Developer’s Guide en

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

<strong>ACTIONSCRIPT</strong> 3.0 DEVELOPER’S GUIDE<br />

Working with m<strong>en</strong>us<br />

Handling m<strong>en</strong>u ev<strong>en</strong>ts<br />

Flash Player 9 and later, Adobe AIR 1.0 and later<br />

A m<strong>en</strong>u dispatches ev<strong>en</strong>ts wh<strong>en</strong> the user selects the m<strong>en</strong>u or wh<strong>en</strong> the user selects a m<strong>en</strong>u item.<br />

Ev<strong>en</strong>ts summary for m<strong>en</strong>u classes<br />

Flash Player 9 and later, Adobe AIR 1.0 and later<br />

Add ev<strong>en</strong>t list<strong>en</strong>ers to m<strong>en</strong>us or individual items to handle m<strong>en</strong>u ev<strong>en</strong>ts.<br />

Object Ev<strong>en</strong>ts dispatched<br />

NativeM<strong>en</strong>u (AIR) Ev<strong>en</strong>t.PREPARING (Adobe AIR 2.6 and later)<br />

Select m<strong>en</strong>u ev<strong>en</strong>ts<br />

Adobe AIR 1.0 and later<br />

Ev<strong>en</strong>t.DISPLAYING<br />

Ev<strong>en</strong>t.SELECT (propagated from child items and subm<strong>en</strong>us)<br />

NativeM<strong>en</strong>uItem (AIR) Ev<strong>en</strong>t.PREPARING (Adobe AIR 2.6 and later)<br />

Ev<strong>en</strong>t.SELECT<br />

Ev<strong>en</strong>t.DISPLAYING (propagated from par<strong>en</strong>t m<strong>en</strong>u)<br />

ContextM<strong>en</strong>u ContextM<strong>en</strong>uEv<strong>en</strong>t.MENU_SELECT<br />

ContextM<strong>en</strong>uItem ContextM<strong>en</strong>uEv<strong>en</strong>t.MENU_ITEM_SELECT<br />

Ev<strong>en</strong>t.SELECT (AIR)<br />

To handle a click on a m<strong>en</strong>u item, add an ev<strong>en</strong>t list<strong>en</strong>er for the select ev<strong>en</strong>t to the NativeM<strong>en</strong>uItem object:<br />

var m<strong>en</strong>uCommandX:NativeM<strong>en</strong>uItem = new NativeM<strong>en</strong>uItem("Command X");<br />

m<strong>en</strong>uCommandX.addEv<strong>en</strong>tList<strong>en</strong>er(Ev<strong>en</strong>t.SELECT, doCommandX)<br />

Because select ev<strong>en</strong>ts bubble up to the containing m<strong>en</strong>us, you can also list<strong>en</strong> for select ev<strong>en</strong>ts on a par<strong>en</strong>t m<strong>en</strong>u.<br />

Wh<strong>en</strong> list<strong>en</strong>ing at the m<strong>en</strong>u level, you can use the ev<strong>en</strong>t object target property to determine which m<strong>en</strong>u command<br />

was selected. The following example traces the label of the selected command:<br />

Last updated 6/6/2012<br />

642

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!