qmlcontactslistview.qml Example File

qmlcontactslistview/qmlcontactslistview.qml

  /****************************************************************************
  **
  ** Copyright (C) 2017 The Qt Company Ltd.
  ** Contact: https://www.qt.io/licensing/
  **
  ** This file is part of the examples for the Qt PIM module of the Qt Toolkit.
  **
  ** $QT_BEGIN_LICENSE:BSD$
  ** 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 The Qt Company. For licensing terms
  ** and conditions see https://www.qt.io/terms-conditions. For further
  ** information use the contact form at https://www.qt.io/contact-us.
  **
  ** BSD License Usage
  ** Alternatively, you may use this file under the terms of the BSD license
  ** as follows:
  **
  ** "Redistribution and use in source and binary forms, with or without
  ** modification, are permitted provided that the following conditions are
  ** met:
  **   * Redistributions of source code must retain the above copyright
  **     notice, this list of conditions and the following disclaimer.
  **   * Redistributions in binary form must reproduce the above copyright
  **     notice, this list of conditions and the following disclaimer in
  **     the documentation and/or other materials provided with the
  **     distribution.
  **   * Neither the name of The Qt Company Ltd nor the names of its
  **     contributors may be used to endorse or promote products derived
  **     from this software without specific prior written permission.
  **
  **
  ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
  **
  ** $QT_END_LICENSE$
  **
  ****************************************************************************/
  import QtQuick 2.0
  import QtContacts 5.0

  Rectangle {
      id: contactsApplication
      width: 400
      height: 600
      state: "listView"

      Rectangle {
          id: browsingArea
          anchors {
              top: parent.top
              left: parent.left
              right: parent.right
          }
          height: contactsApplication.height - btnArea.height - statusBar.height
          color: "lightblue"

          ContactModel {
              id: contactsModel
              manager: "memory"
              Component.onCompleted: {
                      contactsModel.importContacts(Qt.resolvedUrl("example.vcf"))
              }
              sortOrders: [
                  SortOrder {
                      detail: ContactDetail.Name
                      field: Name.FirstName
                      direction: Qt.AscendingOrder
                  }
              ]
          }

          // ![Contact delegate]
          Component {
              id: contactDelegate

              Rectangle {
                  id: delRect
                  width: parent.width
                  height: 60
                  border.width: 1
                  border.color: "darkgreen"
                  color: delRect.ListView.isCurrentItem ? "#F5678A" : browsingArea.color

                  Column {
                      anchors {
                          verticalCenter: parent.verticalCenter
                          left: parent.left
                          leftMargin: 6
                      }
                      Text {
                          text: contact.name.firstName
                          font.bold: true
                      }
                      Text { text: contact.phoneNumber.number }
                  }

                  Keys.onReturnPressed: {
                      contactEditor.contact = contact
                      goToEditView()
                  }

                  MouseArea {
                      anchors.fill: parent
                      onClicked: {
                          contactsView.currentIndex = index
                      }
                  }
              }
          }
          // ![Contact delegate]

          // ![ListView for showing the contacts]
          ListView {
              id: contactsView
              anchors.fill: browsingArea
              width: browsingArea.width
              height: browsingArea.height
              model: contactsModel
              focus: true
              clip: true
              delegate: contactDelegate
          }
          // ![ListView for showing the contacts]
      }

      // ![Button area]
      Rectangle {
          id: btnArea
          width: parent.width
          height: 20
          color: "#C7BFBF"
          anchors {
              bottom: statusBar.top
              right: parent.right
              left: parent.left
          }
          Row {
              id: btnRow
              anchors.centerIn: parent
              spacing: 10

              // buttons for 'listView' state
              GenericButton {
                  id: btnNew
                  width: 160
                  buttonText: "Add New Contact"
                  visible: true
                  onClicked: {
                      contactEditor.contact = 0
                      goToEditView()
                  }
              }
              GenericButton {
                  id: btnEdit
                  width: 160
                  buttonText: "Edit Contact"
                  visible: true
                  onClicked: {
                      contactEditor.contact = contactsView.model.contacts[contactsView.currentIndex]
                      goToEditView()
                  }
              }
              // buttons for 'editView' state
              GenericButton {
                  id: btnCancel
                  width: 120
                  buttonText: "Cancel"
                  visible: false
                  onClicked: {
                      contactEditor.cancel()
                      goToListView()
                  }
              }

              GenericButton {
                  id: btnDelete
                  width: 120
                  buttonText: "Delete"
                  visible: false
                  onClicked: {
                      contactEditor.deleteContact()
                      goToListView()
                  }
              }

              GenericButton {
                  id: btnSave
                  width: 120
                  buttonText: "Save"
                  visible: false
                  onClicked: {
                      contactEditor.updateContact()
                      goToListView()
                  }
              }
          }
      }
      // ![Button area]

      // ![Status bar area]
      Rectangle {
          id: statusBar
          anchors {
              bottom: parent.bottom
              right: parent.right
              left: parent.left
          }
          width: parent.width
          height: 24
          color: "gainsboro"

          Text {
              id: barText
              anchors.centerIn: parent
              text: " "
          }

          Timer {
              id: barTimer
              interval: 2000
              running: false
              onTriggered: {
                  barText.text = " "
              }
          }

          function updateMsg(msg) {
              barText.text = msg
              barTimer.restart()
          }
      }
      // ![Status bar area]

      // ![Custom contact editor]
      ContactEditor {
          id: contactEditor
          height: parent.height - statusBar.height - btnArea.height
          z: -1
      }
      // ![Custom contact editor]

      // ![Applications state changes]
      states: [
          State {
              name: "listView"
              PropertyChanges {
                  target: contactEditor
                  z: -1
              }
              PropertyChanges {
                  target: contactsView
                  focus: true
              }
          },
          State {
              name: "editView"
              PropertyChanges {
                  target: contactEditor
                  z: 1
              }
              PropertyChanges { target: btnNew; visible: false }
              PropertyChanges { target: btnEdit; visible: false }
              PropertyChanges { target: btnCancel; visible: true }
              PropertyChanges { target: btnDelete; visible: true }
              PropertyChanges { target: btnSave; visible: true }
              StateChangeScript { script: contactEditor.resetToDefaults() }
          }
      ]
      // ![Applications state changes]

      function goToListView() {
          contactEditor.contact = ""
          contactsApplication.state = "listView"
      }

      function goToEditView() {
          contactsApplication.state = "editView"
      }
  }