Get the current state

Migrated from Issue #66

from TorokDaniel:

A new API method would be nice, where we can see the plugin's current state (unlocked, or locked to a specific orientation). There is a private property for this in the .js file, but it is not published on the screen object.

Example - why would anyone need this:

Someone developing a plugin, which has a screen where an orientation lock is required. When the plugin's screen has disappeared I want to restore the previous screen status. With the current API, I am not able to tell if the screen was locked or not and I don't want to unlock it if the main application had a good reason to lock it in the first place.

Code snippet required:

screenObject.getCurrentOrientation = function() {
return screenOrientation.currOrientation;
};