examples/QtQuick/telephonyexampleqml/qml/telephonyexampleqml/main.qml

/****************************************************************************
**
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation
**
**
** $QT_BEGIN_LICENSE:BSD$
** 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 Nokia Corporation and its Subsidiary(-ies) 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 1.0
import Qt 4.7
import com.nokia.symbian 1.1
import com.nokia.xqtelephonydeclarative 1.0

/*
 * The application demonstrates the telephony Qt style APIs. It demonstrates
 * following use caess:
 * Change the volume level
 * Change the mute/ unmute status
 * Make a call
 * End the call
 * Note: the example does not demonstrates the incoming call use cases as the default phone
 * application has higher priority.
 */
Window {
    id: view
        
        // status bar displayed at the top of the window
        // that shows signal strength, battery strength...      
    StatusBar {
        id: statusBar
        anchors.top: view.top
    }    
                
    
    // provides access to the telephony manager which handles calls and services.       
    XQTelephonyManager {
        id: manager
    }
    
    
    // provides access to operations, properties related to microphone and speaker volume levels     
    XQTelephonyAudio {
        id: audio
        maxCallVolume: 20       // maximum volume of a call       
        callVolume:10           // volume of a call        
        
        // The event handler for the micMuteChanged signal that emites when the 
        //mute status changes. It displays an appropriate icon when the status changes.                 
        onMicMuteChanged: {
                if (audio.micMuted == true) {                   
                        actionImage.source = "qgn_indi_button_mute_mic.svg";
                }       
                else {                  
                        actionImage.source = "qgn_indi_button_unmute_mic.svg";
                }                       
        }           
        
        // The event handler for the callVolumeChanged signal that emits when the 
        // volume level changes. It displays an appropriate icon when the level changes.         
        onCallVolumeChanged: {      
                actionImage.source = "button_sound_on.png";                     
        }
    }
    
    
    // CallHeader is displayed when a user dials a number.     
    Component {
        id: callItem
                CallHeader {
                        id: callHeaderDisplay   
                        // Sets the labels of the buttons based on the state of the call 
                        // and takes the action appropriately.                  
                        property bool incomingCall: (call.callState == XQTelephonyCall.Incoming);
                stateText: "";          
                button1Text: incomingCall ? "Answer" : "End call";
                onButton1Pressed: incomingCall ? answer() : endcall();       
                
                //Different call states are defined here
            states: [
                State {
                    name: "idle"
                    when: call.callState == XQTelephonyCall.Idle || call.callState == XQTelephonyCall.Unknown
                    PropertyChanges { target: callHeaderDisplay; stateText: "Idle"; }
                },
                State {
                    name: "dialing"                             
                    when: call.callState == XQTelephonyCall.Dialing
                    PropertyChanges { target: callHeaderDisplay; stateText: "Dialing..."; }
                },
                State {
                    name: "remotebusy"
                    when: call.callError == XQTelephonyCall.RemoteBusy
                    PropertyChanges { target: callHeaderDisplay; stateText: "Remote busy"; }
                },
                State {
                    name: "alerting"
                    when: call.callState == XQTelephonyCall.Alerting
                    PropertyChanges { target: callHeaderDisplay; stateText: "Alerting..."; }
                },
                State {
                    name: "connected"
                    when: call.callState == XQTelephonyCall.Connected
                    PropertyChanges { target: callHeaderDisplay; stateText: "Connected"; }
                },
                State {
                    name: "onhold"
                    when: call.callState == XQTelephonyCall.Hold
                    PropertyChanges { target: callHeaderDisplay; stateText: "On hold"; }
                },
                State {
                    name: "disconnecting"
                    when: call.callState == XQTelephonyCall.Disconnecting
                    PropertyChanges { target: callHeaderDisplay; stateText: "Disconnecting..."; }
                },
                State {
                    name: "incoming"
                    when: call.callState == XQTelephonyCall.Incoming
                    PropertyChanges { target: callHeaderDisplay; stateText: "Incoming"; }
                }
            ]
                    
                // Function definitions for call actions - end call and answer call       
            function endcall() {             
                call.handleEndCallPressed();
            }

            function answer() {              
                call.handleAnswerPressed();
            }                   
            }
    }
    
    
    // View populates XQTelephonyManager active calls     
    ListView {
        id: callList
        model: manager.activeCalls
        delegate: callItem
        anchors.left: parent.left
                anchors.top: statusBar.bottom
            anchors.topMargin: 10
    }   
   
    // Displays the dialled number at the specified position and sets 
    // the formating options for the text     
    Text {
                id: phoneNumberEdit             
                text:""                 
                anchors.right: parent.right
                anchors.rightMargin: 5                  
                anchors.bottom: volumeSlider.top
                anchors.bottomMargin: 25                        
                font.weight: Font.Bold
        font.pixelSize:25
        color: "white"          
    }    
    
    
    // Displays appropriate image based on the event handler.     
    Image {
        id: actionImage
        anchors.bottom: volumeSlider.top
                anchors.bottomMargin: 20
                source: "button_sound_on.png"                   
    }
    
    
    // Slider for adjusting the volume level
    // Sets the minimum, maximum and default values 
    // When the slider value changes, it emits the callVolumeChanged
    // signal and sets the volume as per the slider value     
    Slider {
                id: volumeSlider
                maximumValue: audio.maxCallVolume
        minimumValue: 0
        value: audio.callVolume
        stepSize: 1
        valueIndicatorVisible: true             
        anchors.left: parent.left               
                anchors.bottom: numberKeyboard.top      
                anchors.bottomMargin: 5                 
                onValueChanged: {
                        audio.callVolume = value;                                                                               
                }       
    }   

        // The mute/unmute button. when clicked emits the micMuteChanged signal
        // also changes the mute satus.  
        Button {
                id: muteButton
                text: audio.micMuted ? "Unmute" : "Mute"
                width: 120
                height: 35              
                anchors.left: volumeSlider.right
                anchors.leftMargin: 20
                anchors.bottom: numberKeyboard.top
                anchors.bottomMargin: 25                
                onClicked: {
                audio.micMuted = !audio.micMuted             
        }
        } 

        
        // The keyboard for dialing a number and displays it.    
        VKeyboard {
                id:numberKeyboard
                anchors.bottom:dialButton.top   
                onSend: {         
                phoneNumberEdit.text =  phonenumber 
                loader.sourceComponent = null
            onClicked: mainMenu.close()
        }                               
     }   

        
        // The dial button. It makes a call when clicked. 
        Button {
                id:dialButton
                text:"Dial"
                anchors.right:parent.right
                anchors.left:parent.left
                anchors.bottom:toolBar.top              
                height: 50
                onClicked: {                    
            manager.makeCall(phoneNumberEdit.text, "CS");    
        } 
        }
        
        
        // The tool bar is displayed at the bottom of the screen with the option to exit 
        // the application and for the menu      
    ToolBar {
        id: toolBar
        anchors.bottom: view.bottom
        tools: ToolBarLayout {
            id: toolBarLayout
            ToolButton {
                flat: true
                iconSource: "toolbar-back"
                onClicked: Qt.quit()
            }
            ToolButton {
                flat: true
                iconSource: "toolbar-menu"
                onClicked: mainMenu.open()
            }
        }
    }
    
    // TextArea that displays the help of the application
    Component {
        id: helpComponent
        TextArea {
                        readOnly: true  
                        anchors.bottom: parent.bottom
                        anchors.right: parent.right                                             
                        text: "Click the Mute button to make it on/off \nUse the slider to change the volume \
                                                                        \nlevel. Type a number and click \nthe Dial button"                     
        }     
    }
    
    // TextArea that displays the information "about" the application
    Component {
        id: aboutComponent
        TextArea {
                        readOnly: true  
                        anchors.bottom: parent.bottom
                        anchors.right: parent.right                                             
                        text: "The example demonstrates the\nTelephony Qt style API by showcasing \
                                                                                                                                \nout going call feature."                      
        }     
    }
    
    // To load a component
    Loader {
        id: loader       
    }
    
    // A Menu with 3 options - Help, About and Close
    Menu{
            id: mainMenu
            content:
            Column{
                width: pageMenu.width

                MenuItem{
                    id: menu1
                    text: "Help"
                    onClicked:{
                        loader.sourceComponent = helpComponent                  
                    }
                }
                MenuItem{
                    id: menu2
                    text: "About"
                    onClicked:{                        
                        loader.sourceComponent = aboutComponent
                    }
                }
                MenuItem{
                    id: menu3
                    text: "Close"
                    onClicked:{                        
                        loader.sourceComponent = null
                        onClicked: mainMenu.close()
                    }
                }     
            }
    }           
}

---