/****************************************************************************
**
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file.  Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: http://www.gnu.org/copyleft/fdl.html.
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
    \example querymessages
    \title Query Messages Example



    This simple example shows how to query messages stored in the system,
    using the QtMobility Messaging API.

    Messages are queried by using the QMessageManager interface which
    provides access to the message data stored in the system.  We will
    use the \l{QMessageManager::queryMessages()}{queryMessages} function to
    locate messages that match a filter object which defines the
    properties of the messages we would like to find.

    We define our query properties like this:

    \snippet    ../../examples/querymessages/main.cpp setup-query

    Then we use these properties to extract the set of matching message
    identifiers from the QMessageManager instance:

    \snippet    ../../examples/querymessages/main.cpp perform-query

    Now we can iterate over our list of message identifiers, retrieving
    a QMessage instance containing the details of each message in turn:

    \snippet    ../../examples/querymessages/main.cpp iterate-results

    For each message we located, we now generate an output element
    corresponding to each data item requested at the command line:

    \snippet    ../../examples/querymessages/main.cpp generate-output

    Finally, we print the results accumulated for each message that
    matched our query.

    \snippet    ../../examples/querymessages/main.cpp print-result

*/