SysScreenOrientation (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for Windows management

See also

SysScreenOrientation (Function)

In french: SysOrientationEcran

Used to:

find out the orientation of the screen on the device (Pocket PC, Android, iOS or Universal Windows 10 App phone).
modify the orientation of the screen on the device (Pocket PC or Android phone).

Versions 16 and later

This function is now available for Android applications.

New in version 16

This function is now available for Android applications.

Versions 17 and later

This function is now available for Windows Phone applications.

New in version 17

This function is now available for Windows Phone applications.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Versions 19 and later

This function is now available for iPhone/iPad applications. It can only be used to find out the device orientation.

New in version 19

This function is now available for iPhone/iPad applications. It can only be used to find out the device orientation.

Versions 21 and later

This function is now available in Universal Windows 10 App mode. It can only be used to find out the device orientation.

New in version 21

This function is now available in Universal Windows 10 App mode. It can only be used to find out the device orientation.

Example

// Fill the "LIST_Orientations" control with the possibles orientations
ListAdd(LIST_Orientations, SysListScreenOrientation())

// Select the current orientation of the screen in the list
LIST_Orientations = SysScreenOrientation()

// Change the orientation of the screen
// The screen will be turned around
SysScreenOrientation(Orient180)

Syntax

Finding out the screen orientation Hide the details

<Result> = SysScreenOrientation()

<Result>: Character String constant

Value of current screen orientation:
Orient0 The screen is oriented in the default direction.
Orient90 The screen is turned around by 90° clockwise.
Orient180 The screen is turned around by 180°.
Orient270 The screen is turned around by 90° anticlockwise (or by 270° clockwise).

Modifying the screen orientation Hide the details

<Result> = SysScreenOrientation(<Orientation>)

<Result>: Character String constant

Orientation of the screen after the call to the function.

<Orientation>: Character String constant

Indicates the new orientation of the screen:
Orient0 The screen is oriented in the default direction.
Orient90 The screen is turned around by 90° clockwise.
Orient180 The screen is turned around by 180°.
Orient270 The screen is turned around by 90° anticlockwise (or by 270° clockwise).

Remarks

The change of screen orientation is not supported by all the mobile devices. When this feature is not available, SysScreenOrientation always returns Orient0.
Versions 16 and later
The modification of the orientation will affect the current window only.
New in version 16
The modification of the orientation will affect the current window only.
The modification of the orientation will affect the current window only.
Versions 16 and later
Depending on the type of device on which the application is run (phone or tablet), the default orientation (Orient0) can correspond to:
- the portrait mode (for most of the phones),
- the landscape mode (for most of the tablets).
New in version 16
Depending on the type of device on which the application is run (phone or tablet), the default orientation (Orient0) can correspond to:
- the portrait mode (for most of the phones),
- the landscape mode (for most of the tablets).
Depending on the type of device on which the application is run (phone or tablet), the default orientation (Orient0) can correspond to:
- the portrait mode (for most of the phones),
- the landscape mode (for most of the tablets).
Versions 16 and later
To define whether an application is displayed in portrait or landscape mode, it is recommended to compare the values returned by SysXRes and SysYRes :
- if the value returned by SysXRes is less than the value returned by SysYRes, the application is in portrait mode,
- otherwise, it is in landscape mode.
New in version 16
To define whether an application is displayed in portrait or landscape mode, it is recommended to compare the values returned by SysXRes and SysYRes :
- if the value returned by SysXRes is less than the value returned by SysYRes, the application is in portrait mode,
- otherwise, it is in landscape mode.
To define whether an application is displayed in portrait or landscape mode, it is recommended to compare the values returned by SysXRes and SysYRes :
- if the value returned by SysXRes is less than the value returned by SysYRes, the application is in portrait mode,
- otherwise, it is in landscape mode.

Component : wp260std.dll