@NoelFB @UllCon the real wild rumpus (Today)

@TomFulp rip in pepperonis (Today)

RT @TommyRefenes: Finally I get to talk about my post from Saturday! [REDACTED]'s lifted! VR isn't a gimmick anymore: t.co/s56ukdFwEY (Today)

@infinite_ammo wow stunning grafix... 10/10 out of 10 fever dreams t.co/AdrT9MPfs4 (Today)

@laurclinn thanks so much I actually can't wait to get my hot beverage on with them! ;D (Today)

@invicticide bury me with my laptop... (Today)

Feeling so destroyed right now I'm wondering how I ever did 5 days of sessions years ago. Time to nap until the IGF x_x (Today)

@kenruze <3 (Today)

@AsherVo @benedictfritz is this the valve VR demo (Today)

RT @ADAMATOMIC: Following @kylepulver’s example, we are excited to announce that we have decided to make Flixel free AND open source, no ro… (Today)

@ADAMATOMIC the sweet sound of gravel and phlegm (Today)

@tylerglaiel the only thing sold on the Otter Store™ is sushi (Today)

KPULV announces today at GDC that Otter (t.co/lR87R2gGmD) is now free to all users including all Otter Pro™ features. (Today)

RT @ZackBellGames: Ran into @kylepulver. Yelled "YOU'RE TWITTER FAMOUS!" rather than saying anything cohesive. I'm sorry <3 #GDC2015 (Today)

@Krynis thanks! :3 (Yesterday)

RT @BKennedySounds: Watch @kylepulver crush it in yesterdays Towerfall tournament. Its fucking MAGICAL. t.co/69Z9cEusqt (Yesterday)

@Chounard yeah I still play around with sf4 every once in awhile! (Yesterday)

Thanks everyone :3 (Yesterday)

Successfully defended my title at the humble #towerfall invitational now I can stop feeling like I'm gonna barf (Yesterday)

@BitteWenden99 I can take a look soon. At gdc this week so kinda busy (2 days ago)

follow
search

2013 - 5 - 22 / 12:57 pm / tutorials

Disable ESC in Fullscreen on Adobe AIR

Disable ESC in Fullscreen on Adobe AIR

One of the issues with building a desktop application with Adobe AIR is that there is a built in function in the runtime that will cancel any full screen mode when the user pushes the Escape key. This is mostly a functionality of Flash, but it carries over to AIR since AIR is pretty much an extension of the Flash runtime.

Fortunately when you're using the AIR runtime you can actually override the default functionality of the Escape key and keep your application full screen when the user pushes Escape. This came up in Offspring Fling because I was using the Escape key in my UI design. The user pushes Escape to return to the main menu, pause the game, or skip cutscenes, so it was a problem when escape also canceled the game's full screen mode.

The fix for this is super easy and straight forward. First you just need an event listener on the stage for the KEY_DOWN KeyboardEvent.

//listen for key down event and trigger escOverride function
FP.stage.addEventListener(KeyboardEvent.KEY_DOWN, escOverride);

Now here's what the escOverride function looks like.

private function escOverride(e:KeyboardEvent):void {
if (e.keyCode == 27) {
e.preventDefault();
}
}


The keyCode for the Escape key is 27, so whenever a key is pressed the function escOverride is called. If the keyCode was 27, then the preventDefault() function will prevent the default action from being triggered. In this case, it's the "exit fullscreen" action.

There you have it! With just 4 or 5 lines of code total you can prevent your Adobe AIR game from canceling fullscreen when the user pushes Escape. With great power comes great responsibility. (Also note that I believe this is impossible in a normal swf build. The preventDefault() function only works in Adobe AIR.)

6 Comments
Avatar

2013 - 5 - 25 3:54 AM

Fedyfausto

thx a lot Kyle :D i'm waiting your tutorial for bitmapfont

Avatar

2013 - 7 - 10 12:29 PM

Kristian Welsh

Very useful little tidbit there, thank you!

Avatar

2013 - 10 - 20 8:45 AM

Chris

Thanks for the info. Exactly what I needed.

A tiny improvement of the code:
It's a tad better to write:

private function escOverride(e:KeyboardEvent):void {
if (e.keyCode == Keyboard.ESCAPE) {
e.preventDefault();
}
}

... there is a constant to use for this kind of comparison... it should be used.

Avatar

2013 - 10 - 21 3:01 AM

Kyle

Oh nice! I must've missed the keyboard constants at the time I was using this code ;)

Avatar

2014 - 5 - 5 10:53 PM

VB

It doesn't work in Flex MenuBar,
with open submenus!

Avatar

2015 - 1 - 18 4:07 AM

VB

It doesn't work in Flex MenuBar,
with open submenus!

Make menuBar.hight = 0 as it is in real Fullscreen mode and don't bother more about Esc! Then restore later if need.

Avatar

Post your comment!

POST COMMENT

about

About

Hi there, my name is Kyle, and I'm a kid disguised as a grown up. I'm making video games and living the indie game developer life in Tempe, Arizona. Here you will find my thoughts, games, websites, doodles, and other stuff like that. I worked on Snapshot, Offspring Fling, and a whole bunch of other games. I also created and maintain Otter, a 2d game making framework. If you want to get a hold of me use the form on the bottom of the page, leave a comment, or just tweet at me. I try to post three times a week. Thanks for stoppin' by! You're the coolest.

facebook

videos

Do you want to make a Let's Play of one of my games, or a just a video featuring footage of my games? You have my full permission to do so! Even if you are monetizing your videos, you still have my full permission to use any footage from any of my games. Go for it!

contact

Your message has been sent! Thanks :)
SEND MESSAGE