void GetSystemInfo(String &manufacturer, String &productName, String &version, int &numberOfProcessors, String &mbSerial)

Returns hardware information including computer manufacturer, productName, version, numberOfProcessors and mbSerial (motherboard serial number).

void GetBiosInfo(String &biosVersion, Date &biosReleaseDate, String &biosSerial)

Returns bios information including biosVersion, biosReleaseDate.and biosSerial.

bool GetProcessorInfo(int number, String &vendor, String &identifier, String &architecture, int &speed)

Returns information about the different cpu cores.

number is the core number to get the information

vendor is the core vendor

identifier is the core identifier

architecture is the core architecture (32, 64)

speed.is the core speed in MHz.

Gets the real time main CPU speed in MHz.

This data is directly calculated by the function.

bool GetVideoInfo(Array <Value> &name, Array <Value> &description, Array <Value> &videoProcessor, Array <Value> &ram, Array <Value> &videoMode)

If true gets information about video systems installed:

name is the video system name

description is the video description

videoProcessor is the processor used

ram is the available memory in the video hardware in Mb

videoMode is the video mode actually selected including screen resolution and number of colors

Only available in Windows

bool GetPackagesInfo(Array <Value> &name, Array <Value> &version, Array <Value> &vendor, Array <Value> &installDate, Array <Value> &caption, Array <Value> &description, Array <Value> &state)

If true gets information about installed software:

name

version

vendor

installDate

caption is a summary of the software description

description

state is the status of the software. Values are:

- "Bad Configuration"

- "Invalid Argument"

- "Unknown Package"

- "Advertised"

- "Absent"

- "Ok"

Only available in Windows

Returns CPU temperature in degrees Celsius.

Returns the MAC address in uppercase hexadecimal formated like "0A:0B:0C:0C:0D:0E" or Null.

This function is deprecated by GetAdapterInfo().

Array <NetAdapter> GetAdapterInfo()

Gets an array of type NetAdapter with all the network adapters installed.

NetAdapter contains:

String description:    Adapter description

String fullname:    Adapter name

String mac:    Adapter MAC address if available

String type;    Adapter type. Some of the included types are:

"ETHERNET"        Ethernet

"TOKENRING"        Token ring

"MODEM"        Point to Point Protocol

"SOFTWARE_LOOPBACK"    Software loopback

"ATM"        Asynchronous Transfer Mode

"IEEE80211"        Wifi

"TUNNEL"        Tunnel encapsulation

"IEEE1394"        Firewire

Returns the hard disk physical serial number or Null. This code is not affected by disk formatting.

Only available in Windows

bool GetMemoryInfo(int &memoryLoad, uint64 &totalPhys, uint64 &freePhys, uint64 &totalPageFile, uint64 &freePageFile, uint64 &totalVirtual, uint64 &freeVirtual)

Gets information about the system memory:

memoryLoad is the percent of memory in use

totalPhys is the total physical memory

freePhys is the free physical memory

totalPageFile is the total paging file

freePageFile is the free paging file

totalVirtual is the total virtual memory

freeVirtual is the free virtual memory.

bool GetOsInfo(String &kernel, String &kerVersion, String &kerArchitecture, String &distro, String &distVersion, String &desktop, String &deskVersion)

Gets many information to identify the operating system and Desktop where the application is being run.

kernel: Kernel name

kerVersion: Kernel version

kerArchitecture: Kernel architecture

distro: Distro name

distVersion: Distro version

desktop: Desktop manager name

deskVersion.: Desktop manager version

bool GetDriveSpace(String drive, uint64 &freeBytesUser, uint64 &totalBytesUser, uint64 &totalFreeBytes)

Gets drive space.

freeBytesUser: Amount of free bytes available to the user

totalBytesUser: Size of drive visible for the user

totalFreeBytes: Amount of free bytes.

    Returns false if drive is not mounted or it is not accessible

bool GetDriveInformation(String drive, String &type, String &volume, int &maxName, String &fileSystem)

Gets drive information

type: Gets the type of the drive.

Available types are "Hard", "Network", "Optical", "RAM", "Removable".

volume: Gets the name of the drive

maxName: Gets the maximum length permitted for a file name

fileSystem: Gets the drive formatting system.

    Returns false if drive is not mounted or it is not accessible

void GetCompilerInfo(String &name, int &version, String &date)

Returns compiling information, like compiler name, compiler version and program compilation date.

Gets battery information like if it is discharging or connected to the grid, percentage of charging where 100% means full charge, and number of expected computer running minutes in remainingMin.

    Returns true if the values got are valid.

Gets if battery is present or not.

    Returns true if the values got are valid.

Ejects CD/DVD tray.

Closes CD/DVD tray if possible

void GetWindowsList(Array<long> &wid, Array<long> &pid, Array<String> &name, Array<String> &fileName, Array<String> &title)

Gets arrays with handles to all the opened windows with additional info as:

wid: Handle to the the window

pid: Handle to the process that manages the window

name: Window name

fileName: Window process program file name

title: Window title (caption)

Array<long> GetWindowsList()

Gets an array with handles to all the opened windows.

bool GetProcessList(Array<long> &pid, Array<String> &pNames)

Gets arrays with handles to all the opened processes pid and process names pNames.

Array<long> GetProcessList()

Gets an array with handles to all the opened processes

String GetProcessName(long pid)

Returns the process name for a process with handle pid.

String GetProcessFileName(long processID)

Gets the program file name of a process with handle processID.

long GetProcessIdFromWindowCaption(String windowCaption, bool exactMatch = false)

Gets the process handle of a program with a window with title windowCaption.

If exactMatch.is true it only returns the process handle of a process with a window title that is equal to windowCaption. If it is false then the handle is returned if only part of the window title matches with windowCaption.

long GetWindowIdFromCaption(String windowCaption, bool exactMatch = false)

Gets the window handle of a program with a window with title windowCaption.

If exactMatch.is true it only returns the process handle of a process with a window title that is equal to windowCaption. If it is false then the handle is returned if only part of the window title matches with windowCaption.

Returns the process handle of a program with window handle wid.

Returns the window handle of a program with process handle pid.

Ends the program with handle pid.

If after asking the process to end timeout is over, it will kill the process by different means in order of increasing "aggressivity".

For example in Posix it will send the process first a SIGTERM, if the process does not stop it will send a SIGKILL, and if the process remains running it will simply call WindowKill() to do the dirty job.

Gets the process priority of the process with handle pid as a number from 0 (minimum) to 10 (maximum), if possible.

Sets the process priority to priority of the process with handle pid as a number from 0 (minimum) to 10 (maximum), if possible.

Returns true if a process with handle pid exists.

Gets actual running process handle.

bool Shutdown(String action)

Tries to logoff, reboot or shutdown the actual running session.

    Actual valid action values are "logoff", "reboot" and "shutdown".

Giving this function the windowId, it returns the window location in the screen in left, top, right and bottom.

    Returns true if the values got are valid.

Giving this function the windowId, it sets the window location in the screen in left, top, right and bottom.

    Returns true if the window is relocated correctly..

Gets the mouse position x, y.in screen pixels where upper left corner is (0, 0).

    Returns true if the operation has been done successfully.

Sets the mouse position to x y referenced to the upper left vertex of window with window handle windowId.

    Returns true if the operation has been done successfully.

Simulates by software a mouse click with the left button as if it would have been done with the mouse.

Simulates by software a mouse click with the middle button as if it would have been done with the mouse.

Simulates by software a mouse click with the right button as if it would have been done with the mouse.

Simulates by software a mouse double click with the left button as if it would have been done with the mouse.

Simulates by software a mouse double click with the middle button as if it would have been done with the mouse.

Simulates by software a mouse double click with the right button as if it would have been done with the mouse.

Simulates by software a mouse press with the left button as if it would have been done with the mouse.

Caution: The button will remain pressed after this function.

Simulates by software a mouse release with the left button as if it would have been done with the mouse.

Simulates by software a mouse press with the right button as if it would have been done with the mouse.

Caution: The button will remain pressed after this function.

Simulates by software a mouse release with the right button as if it would have been done with the mouse.

Simulates by software a mouse press with the middle button as if it would have been done with the mouse.

Caution: The button will remain pressed after this function.

Simulates by software a mouse release with the middle button as if it would have been done with the mouse.

void Keyb_SendKeys(String text, long finalDelay = 100, long delayBetweenKeys = 50)

Simulates by software a text entered using the keyboard as if it would have been entered with the keyboard.

To really simulate manual key typing the function lets to enter delays between keys and after entering the text.

text: Is the text to be entered

finalDelay: Is the delay in ms that is forced after entering text

delayBetweenKeys: Is the delay in ms that is forced between text keys.

Gets the status of keys caps lock,  num lock and scroll lock. Not fully functional in Linux.

Sets the status of keys caps lock,  num lock and scroll lock. Not fully functional in Linux.

bool Snap_Desktop(String fileName)

Saves the desktop in fileName.as an image file.

    Allowed formats are:

        - Posix: .xwd

        - Windows: .bmp

bool Snap_DesktopRectangle(String fileName, int left, int top, int width, int height)

Saves a rectangle of the desktop defined by left, top, width and height.in fileName as an image file.

    Allowed formats are:

        - Posix: .xwd

        - Windows: .bmp

bool Snap_Window(String fileName, long handle)

Saves a window defined by its handle in fileName as an image file.

    Allowed formats are:

        - Posix: .xwd

        - Windows: .bmp

bool Record_Desktop(String fileName, int duration, int secsFrame = 1, bool viewMouse = true)

Records the desktop activity in fileName as a video file of duration in seconds with secsFrame seconds between frames and recording also mouse movement if viewMouse.is true.

Allowed formats are:

Windows: Uncompressed .avi

Only available in Windows

bool Record_DesktopRectangle(String fileName, int duration, int left, int top, int width, int height, int secsFrame = 1, bool viewMouse = true)

Records the desktop activity in the rectangle defined by left, top, width and height. in fileName as a video file of duration in seconds with secsFrame seconds between frames and recording also mouse movement if viewMouse.is true.

Allowed formats are:

Windows: Uncompressed .avi

Only available in Windows

bool Record_Window(String fileName, int duration, long handle, int secsFrame = 1, bool viewMouse = true)

Records the activity of a window defined by its handle in fileName as a video file of duration in seconds with secsFrame seconds between frames and recording also mouse movement if viewMouse.is true.

Allowed formats are:

Windows: Uncompressed .avi

Only available in Windows

Sets path.file as desktop wallpaper. Supports Gnome, Kde v3 and Windows desktops.

In Gnome, path has to be .png

In Kde, path has to be .png, .gif or .jpg

In Windows, path has to be .bmp

If path.is empty, the desktop wallpaper is removed.

Do you want to contribute?