System functions

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Windows management functions

System functions

Related examples

See also

System constants

System functions

Versions 16 and later

Most of these functions are now available in Windows Phone.

New in version 16

Most of these functions are now available in Windows Phone.

Versions 18 and later

Some functions are now available for iPhone/iPad applications.

New in version 18

Some functions are now available for iPhone/iPad applications.

Versions 21 and later

Most of these functions are now available in Universal Windows 10 App mode.

New in version 21

Most of these functions are now available in Universal Windows 10 App mode.

The system functions are as follows:


SysAndroidVersion	Returns information about the Android version used by the application.
Versions 26 and later SysBatteryOptimBackground New in version 26 SysBatteryOptimBackground SysBatteryOptimBackground	Used to manage battery optimization: Identifies the battery optimization mode for the current application. Prompts the user to disable battery optimization for a given application on the device. This function can be used to tell the operating system to stop preventing the application from running in the background.
SysCacheExternalStorage	Returns the path of directory that will be used to store the data in cache on the external storage space of application.
SysChangeEnvironment	Modifies the environment variables of the operating system found on the current computer.
SysChangeScreenResolution	Modifies the resolution of a screen.
SysColor	Identifies or modifies the color of a Windows element.
SysColorRes	Returns the resolution of the screen in number of colors.
SysDetectLockedSession	Detects the change of lock for the Windows session.
SysDeviceInfo	Retrieves information from the mobile device where the application is run
SysDir	Returns the path of a system directory.
SysDirExternalStorage	Returns the path of directory that will be used to store files in the external storage space of Android device.
SysDirStorageCard	Returns: the list of storage cards found in the current Mobile device. the path of the root directory of the primary external storage area.
SysEnvironment	Returns the environment variables of the operating system for the current computer.
SysErrorMode	Modifies the display mode of errors.
SysGetDC	Retrieves the DC (Device Context) of a window, control or screen.
SysGetExtLink	Returns the command linked to an extension.
SysIconAdd	Adds an icon into the taskbar (bottom right corner of screen).
SysIconAddImage	Adds an icon that overlays the application icon in the taskbar.
SysIconBadge	Returns or modifies the value displayed in the badge associated with the icon of an iOS or Universal Windows 10 App application.
SysIconDelete	Deletes an icon from the taskbar (next to the clock).
SysIconDeleteImage	Deletes the icon that overlays the application icon in the taskbar.
SysIconDisplayTooltip	Displays a tooltip for an icon found in the taskbar.
SysIconize	Used to find out whether a window is minimized.
SysIconModify	Modifies the icon file and/or the rollover message of an icon in the taskbar (bottom right corner of the screen).
SysIdentifier	Returns the unique identifier of the current mobile device.
SysIMEI	Returns the IMEI number of a Smartphone.
SysInstance	Returns the instance of a module.
SysIOSVersion	Returns information about the iOS version used by the application.
SysLinkExtension	Associates an extension (.txt, .avi, etc.) to a default execution program.
SysListScreen	Returns the list of screens connected to one or more video cards.
SysListScreenOrientation	Used to find out the possible orientations of a screen on a Mobile Device (Pocket PC).
SysListScreenResolution	Returns the possible resolutions for a screen.
SysListVideoCard	Returns the name of the video cards connected to the current computer.
SysMemoryExternalStorage	Returns the amount of available memory on the external storage area of the device.
SysMetric	Returns the resolution of a specific element.
SysNameExe	Returns the name and full path of an application.
SysNameMainScreen	Returns the name of the main screen for the computer.
SysNation	Returns the nation currently used by the system.
SysNbExternalStorage	Returns the number of external storage spaces found on an Android device.
SysNumberScreen	Returns the number of screens currently connected to the current computer.
Versions 26 and later SysPowerStatus New in version 26 SysPowerStatus SysPowerStatus	Used to get various information about the battery (main or secondary) of the device on which the application is running.
SysRecentDocAdd	Adds a file into the list of recently opened documents.
SysRecentDocList	Returns the list of recently opened documents.
SysReleaseDC	Frees the current DC (Device Context) retrieved by SysGetDC.
SysRemovableExternalStorage	Used to find out whether the external storage space corresponds to the moveable memory (SD Card).
SysScreenOrientation	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).
SysScreenRectangle	Returns the coordinates of the display rectangle corresponding to all the screens.
SysScreenResolution	Returns the resolution of a screen.
SysSerialNum	Returns the serial number of the current Mobile Device (Pocket PC).
SysSetFocus	Gives focus to a window or to a control.
SysShutdown	Stops the system or closes the current Windows session.
SysSpace	Returns the physical memory space for the current computer.
SysStandby	Used to: find out and modify the amount of idle time before standby. enable and disable the standby mode.
SysStatusExternalStorage	Returns the availability status of the external storage space of the device.
SysStatusStorageCard	Returns the availability status of the storage card on the device.
SysTheme	Returns the current theme used on the mobile device.
SysThumbnailAddButton	Adds a button into the thumbnail of the application in the taskbar.
SysThumbnailDeleteAll	Deletes all the buttons associated with the thumbnail of the application from the taskbar.
SysThumbnailDeleteButton	Deletes one of the buttons found in the thumbnail of the application from the taskbar.
SysThumbnailModifyButton	Modifies one of the buttons found on the application thumbnail in the taskbar.
SysUnlinkExtension	Deletes the association between an extension and a command that was created by SysLinkExtension.
SysValidHandle	Checks the validity of a window handle.
SysVersion	Returns information about the PHP version used on the current server.
SysWinActive	Returns the handle of the active window or activates a window.
SysWindowsVersion	Returns information about the Windows version used on the current computer.
SysWinHandle	Returns the handle of a window identified by its title.
SysWinShow	Modifies the display status of a window.
SysWinTitle	Returns the title of a window.
SysXRes	Returns the horizontal screen resolution.
SysYRes	Returns the vertical screen resolution.

Related Examples:

Training (WINDEV): WD Jump lists

[ + ] JumpList in Windows 7

A JumpList is a menu accessible from the Start menu or from the application icon in the taskbar.
It is used to display the documents recently or frequently opened by the application. It is also used to display the specific tasks.

This example handles images and some operations are directly accessible from the JumpList.

Unit examples (WINDEV): Managing the Windows session

[ + ] Managing the Windows session by programming with the WLanguage functions.
This example explains how to close the Windows session, stop the system and restart the PC, etc.

Training (WINDEV): WD PC Info

[ + ] WD PC Info

From an application, it may be useful to find out the language of the computer on which the application is run, to directly run the application in the proper language, to find out the currency of the computer, to specify in the application the conversion of currencies into the computer currency for example...

The "WD PC Info" example explains how to retrieve the regional and linguistic options from the computer and how to modify them:
- the language,
- the country,
- the format of the dates,
- the currency symbol,
- the thousand separator,
- the 1st day of the week,
- the decimal separator,
...

Unit examples (WINDEV): The Exe functions

[ + ] Using the functions for managing the memory processes of WINDEV (list of processes, consumed memory, list of DLLs used, location).
It can also be used to enable an application and to find out the list of opened windows as well as their handle.

Unit examples (WINDEV): The SysMetric function

[ + ] Using SysMetric.
This function is used to retrieve a set of dimensions that are configured at system level.
For example, it allows you to find out the height of the menu bar in the applications, ...

Unit examples (WINDEV): The functions specific to Windows 7

[ + ] Using WLanguage functions specific to Windows 7:
- SysIconAddImage
- SysThumbnailAddButton
- SysThumbnailDeleteAll

Unit examples (WINDEV): The system functions (screens)

[ + ] Using the SysXxx functions on the screens in order to get various information:
- Retrieve the number of screens installed on the computer
- Retrieve the graphic cards installed on the computer
- Change the resolution of a screen
- ...

Sample components (WINDEV): WD SystemInfo

[ + ] WD SystemInfo
This example explains how to use the SystemInfo component.
The following topics are presented in this example:
1/ getting information about the operating system
2/ getting information about the user
3/ the browse of the network neighborhood by programing
Summary of the example supplied with WINDEV:
This example presents the features of the SystemInfo component.
A window containing three tabs is opened when starting the example.
Each tab presents one of the component features.
1/ Getting information about the operating system
The functions supplied in the SystemInfo component (see its documentation for more details) are used to get various information about the operating system and the computer: system version, makes and number of processors, amount of physical memory installed, etc.
2/ Getting information about the user
The SystemInfo component can also be used to find out (on the NT, 2000 and XP systems only) the name of the user in session as well as the list of local groups and the list of domain groups to which he belongs.
3/ The browse of the network neighborhood by programming
The third feature proposed by the component is used to browse the network neighborhood of the computer by programming. The returned information depend on the network client used (Microsoft client or Novell client for example) and it is used to enumerate the resources found on the local network: computers, printers, shared disks, etc.

CAUTION:
The modification of the source code of the example and/or component must be performed by an experienced user only. Indeed, unexpected modifications may cause a loss of data and/or an inconstancy of your system

Unit examples (WINDEV Mobile): The System functions

[ + ] Using the WLanguage "System" functions available in WINDEV Mobile:
- SysShutdown associated with the sysReboot, sysPoweroff, sysPoweronScreen and sysPoweroffScreen constants.
- SysDirStorageCard that is used to retrieve the path of the storage card
- SysSpace that is used to retrieve the sizes of spaces (storage and program, total and free)
- SysSerialNum that is used to retrieve the serial number of the device