NetworkingStatus QML Type

Overall system networking status. More...

Import Statement: import Lomiri.Connectivity 1.0

Properties

Detailed Description

This is the top-level class for accessing networking information.

This class inherits the Qt C++ lomiri::connectivity::NetworkingStatus and provides two utility properties online and limitedBandwidth for easier QML usage.

This object is exposed as a singleton.

note: Using this component in confined application requires connectivity policy group.

/*
 * Copyright (C) 2014 Canonical Ltd.
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License version 3,
 * as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

import QtQuick 2.0
import Lomiri.Components 0.1
import Lomiri.Connectivity 1.0

MainView {
    id: root
    objectName: "mainView"
    applicationName: "Connectivity"

    width: units.gu(100)
    height: units.gu(75)

    property real margins: units.gu(2)
    property real buttonWidth: units.gu(9)

    property var statusMap: ["Offline", "Connecting", "Online"]

    Connections {
        target: Connectivity

        // full status can be retrieved from the base C++ class
        // status property
        onStatusChanged: console.log("Status: " + statusMap[Connectivity.status])

        onOnlineChanged: console.log("Online: " + Connectivity.online)
    }

    Page {
        title: i18n.tr("Networking Status")

        Column {
            anchors.centerIn: parent
            Label {
                // use the online property
                text: Connectivity.online ? "Online" : "Not online"
                fontSize: "large"
            }
            Label {
                // use the status property
                text: "Status: " + statusMap[Connectivity.status]
                fontSize: "large"
            }
            Label {
                // use the limitedBandwidth property
                text: Connectivity.limitedBandwidth ? "Bandwidth limited" : "Bandwidth not limited"
                fontSize: "large"
            }
        }
    }
}

Property Documentation

limitations : Limitations


limitedBandwidth : bool

true if Internet connection is bandwidth limited.

shorthand for C++:

networkingStatus->limitations().contains(NetworkingStatus::Limitations::Bandwidth)

online : bool

true if system has Internet connection.

shorthand for C++:

networkingStatus->status() == NetworkingStatus::Online

status : Status

status property of the base C++ class.

onStatusChanged: {
    if (status === NetworkingStatus::Offline)
        ;
    else if (status === NetworkingStatus::Connecting)
        ;
    else if (status === NetworkingStatus::Online)
        ;
}