de.dimensionv.android.androtools.ui

Class ScreenTools

java.lang.Object

de.dimensionv.android.androtools.ui.ScreenTools

public class ScreenTools
extends Object

Helpful tools that retrieve information about screen-orientation, -size, etc.

Since:

API 1.0.0

Constructor Summary

Constructors

Constructor and Description
ScreenTools()

Method Summary

Methods

Modifier and Type	Method and Description
static DisplayMetrics	getDisplayMetrics(Activity activity) Returns the display metrics of the device, using the currently shown Activity for accessing the window manager.
static int	getScreenOrientation(Activity activity) Returns the current orientation of the device.
static boolean	haveBigScreen(Activity activity) Checks if the device has a big screen using the currently shown Activity for accessing window manager in order to retrieve the device's DisplayMetrics.
static boolean	orientationIsLandscape(Activity activity) Convenience method to quickly identify landscape-orientation
static boolean	orientationIsPortrait(Activity activity) Convenience method to quickly identify portrait-orientation

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ScreenTools

public ScreenTools()

Method Detail

haveBigScreen

public static boolean haveBigScreen(Activity activity)

Checks if the device has a big screen using the currently shown Activity for accessing window manager in order to retrieve the device's DisplayMetrics.

The decision whether is screen size is "big" or not depends on a couple of things. First of all, it is checked whether Configuration.screenLayout is set to eiter large or extra-large. Depending on this check, on of the following two things are checked:

1. If large or xlarge: it's a matter of DPI whether it really is a big screen or not.
2. If not large and not xlarge: check whether the screen-size in pixels is greater than 480x800 and 800x480.

If this evaluates to true, the screen is a big one.

Parameters:

activity - The currently shown activity.

Returns:

Returns true if the device has a big screen, false otherwise.

Since:

Class 1.0, API 1.0.0

getDisplayMetrics

public static DisplayMetrics getDisplayMetrics(Activity activity)

Returns the display metrics of the device, using the currently shown Activity for accessing the window manager.

Parameters:

activity - The currently shown Activity.

Returns:

the DisplayMetrics of the device.

Since:

Class 1.0, API 1.0.0

getScreenOrientation

public static int getScreenOrientation(Activity activity)

Returns the current orientation of the device.

Parameters:

activity - The currently shown activity

Returns:

ORIENTATION_PORTRAIT if it's portrait-oriented, Configuration.ORIENTATION_LANDSCAPE if it's landscape or Configuration.ORIENTATION_SQUARE if the orientation has equal width and height, and the device has a recent enough operating-system.

Since:

Class 1.0, API 1.0.0

orientationIsLandscape

public static boolean orientationIsLandscape(Activity activity)

Convenience method to quickly identify landscape-orientation

Parameters:

activity - The currently shown activity

Returns:

true if orientation is landscape, false otherwise

Since:

Class 1.0, API 1.0.0

orientationIsPortrait

public static boolean orientationIsPortrait(Activity activity)

Convenience method to quickly identify portrait-orientation

Parameters:

activity - The currently shown activity

Returns:

true if orientation is portrait, false otherwise

Since:

Class 1.0, API 1.0.0