QtMobility Reference Documentation

Contents

QML DeviceInfo Element

The DeviceInfo element allows you to access information anbout the device and receive notifications from the device. More...

  • List of all members, including inherited members
  • Properties

    Signals

    Detailed Description

    This element is part of the QtMobility.systeminfo 1.1 module. It is a convience class to make QML usage easier.

    Note: To use notification signals, you need to set the monitor* properties to true.

    See also QSystemDeviceInfo.

    Property Documentation

    batteryLevel : int

    Returns the battery charge level as percentage 1 - 100 scale.


    batteryStatus : BatteryStatus

    Returns the battery charge status.


    currentBluetoothPowerState : bool

    Gets the current bluetooth power state.


    currentPowerState : PowerState

    Gets the current QSystemDeviceInfo::currentPowerState state.


    currentProfile : Profile

    Gets the current QSystemDeviceInfo::currentProfile device profile.


    imei : QString

    Returns the International Mobile Equipment Identity (IMEI), or a null QString in the case of none.


    imsi : QString

    Returns the International Mobile Subscriber Identity (IMSI), or a null QString in the case of none


    inputMethodType : InputMethodFlags

    Returns the QSystemDeviceInfo::InputMethodFlags InputMethodType that the system uses.


    isDeviceLocked : bool

    Returns true if the device is locked, otherwise false.


    isKeyboardFlippedOpen : bool

    Returns true if the flip keyboard is open, otherwise false;


    isWirelessKeyboardConnected : bool

    Returns true if a wireless keyboard is connected, otherwise false;


    keyboardTypes : KeyboardTypeFlags

    Returns the type of keyboards found.


    lockStatus : LockTypeFlags

    Returns the QSystemDeviceInfo::LockTypeFlags type of lock state the device might be in. The LockType must be currently active not just enabled.


    manufacturer : QString

    Returns the name of the manufacturer of this device. In the case of desktops, the name of the vendor of the motherboard.


    messageRingtoneVolume() : int

    Returns the active profile's message ringtone volume. From 0 to 100.


    model : QString

    Returns the model information of the device. In the case of desktops where no model information is present, the CPU architect, such as i686, and machine type, such as Server, Desktop or Laptop.


    monitorBatteryLevelChanges : bool

    Use the monitorBatteryLevelChanges signal.


    monitorBatteryStatusChanges : bool

    Use the monitorBatteryStatusChanges signal.


    monitorBluetoothStateChanges : bool

    Use the bluetoothStateChanges signal.


    monitorCurrentProfileChanges : bool

    Use the monitorCurrentProfileChanges signal.


    monitorKeyboardFlips() : bool

    Start the connection for the keyboardFlipped signal.


    monitorLockStatusChanges() : bool

    Start the connection for the lockStatusChanged signal.


    monitorPowerStateChanges : bool

    Use the monitorPowerStateChanges signal.


    monitorThermalStateChanges : bool

    Use the thermalStateChanges signal.


    monitorWirelessKeyboardConnects() : bool

    Start the connection for the wirelessKeyboardConnected signal.


    primaryKeypadLightOn() : bool

    Returns the whether he primary keypad or keyboard light is on.


    productName : QString

    Returns the product name of the device. In the case where no product information is available, an empty string will be returned.


    screen : int

    Contains the display number of this screen.


    secondaryKeypadLightOn() : bool

    Returns the whether he secondary keypad or keyboard light is on.


    simStatus : SimStatus

    Returns the QSystemDeviceInfo::simStatus status of SIM card.


    uniqueID : string

    Returns a unique identifier for the machine.

    Depending on security enforcement on platform, this may return a non unique number, or 0.


    vibrationActive() : bool

    Returns the whether the active profile's vibration is active.


    voiceRingtoneVolume() : int

    Returns the active profile's voice ringtone volume. From 0 to 100.


    Signal Documentation

    DeviceInfo::batteryLevelChanged ( int )

    This handler is called when battery level has changed.


    DeviceInfo::batteryStatusChanged ( DeviceInfo::BatteryStatus )

    This handler is called when battery status has changed.


    DeviceInfo::bluetoothStateChanged ( bool )

    This handler is called when bluetooth power state has changed.


    DeviceInfo::currentProfileChanged ( DeviceInfo::Profile )

    This handler is called when current device profile has changed.


    DeviceInfo::deviceLocked ( bool )

    This signal is emitted whenever the device lock state changes


    DeviceInfo::keyboardFlipped ( bool )

    This signal is emitted whenever a phone flips open.


    DeviceInfo::lockStatusChanged ( DeviceInfo::LockTypeFlags )

    This signal is emitted whenever the lock state changes


    DeviceInfo::powerStateChanged ( DeviceINfo::PowerState )

    This handler is called when the power state has changed.


    DeviceInfo::thermalStateChanged ( DeviceInfo::ThermalState )

    This handler is called when thermal state has changed.


    DeviceInfo::wirelessKeyboardConnected ( bool )

    This signal is emitted whenever a wireless keyboard is connected