AccountServiceModel QML Type

A model of the user's Online Accounts More...

• List of all members, including inherited members

Properties

• account : Account
• accountId : quint32
• applicationId : string
• includeDisabled : bool
• provider : string
• service : string
• serviceType : string

Methods

• variant get(int row, string roleName)

Detailed Description

The AccountServiceModel is a model representing the user's Online Accounts services. Please note that an Online Account can offer several different services (chat, e-mail, micro-blogging, etc.); these are the items represented by this model, and not the user accounts as a whole. Since most applications are interested on a small subset of the user's accounts, AccountServiceModel offers some filtering functionalities: it is possible to restrict it to only one account provider, to a specific service type (for instance, an e-mail application will probably be interested in only those accounts which offer an e-mail service), or to a specific service (e.g., picasa; this is often equivalent to filtering by provider and by service-type, because it's rare for a provider to offer two different services of the same type). By default, only enabled accounts are returned. Use the includeDisabled property to list also disabled accounts; keep in mind, though, that an application should never use an account which has been disabled by the user.

The model defines the following roles:

• displayName is the name of the account (usually the user's login)
• providerName is the name of the account provider (e.g., "Google")
• serviceName is the name of the service (e.g., "Picasa")
• enabled
• accountServiceHandle is a handle to the underlying Qt object which can be used to instantiate an AccountService from QML
• accountId is the numeric ID of the account
• accountHandle is a handle to the underlying Qt object which can be used to instantiate an Account from QML

Examples of use:

1. Model of all enabled microblogging accounts:

Item {
    AccountServiceModel {
        id: accounts
        serviceType: "microblogging"
    }

    ListView {
        model: accounts
        delegate: Text { text: model.displayName + " by " + model.providerName }
    }
}

2. List all Facebook account services:

Item {
    AccountServiceModel {
        id: accounts
        provider: "facebook"
        includeDisabled: true
    }

    ListView {
        model: accounts
        delegate: Text { text: model.serviceName + " on " + model.displayName }
    }
}

3. List all Flickr accounts enabled for uploading:

Item {
    AccountServiceModel {
        id: accounts
        service: "flickr-sharing"
    }

    ListView {
        model: accounts
        delegate: Rectangle {
            id: rect

            Text { text: rect.model.displayName }

            AccountService {
                id: accountService
                objectHandle: rect.model.accountServiceHandle

                onAuthenticated: { console.log("Access token is " + reply.AccessToken) }
                onAuthenticationError: { console.log("Authentication failed, code " + error.code) }
            }

            MouseArea {
                anchors.fill: parent
                onClicked: accountService.authenticate()
            }
        }
    }
}

4. List all the online accounts, without their services:

Item {
    AccountServiceModel {
        id: accounts
        service: "global"
    }

    ListView {
        model: accounts
        delegate: Rectangle {
            id: rect

            Text { text: account.displayName }

            Account {
                id: account
                objectHandle: rect.model.accountHandle
            }
        }
    }
}

Property Documentation

Method Documentation