Qt Reference Documentation

# textselection.qml Example File

declarative/text/textselection/textselection.qml

     /****************************************************************************
     **
     ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
     ** All rights reserved.
     ** Contact: Nokia Corporation (qt-info@nokia.com)
     **
     ** This file is part of the examples of the Qt Toolkit.
     **
     ** $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

     Rectangle {
         id: editor
         color: "lightGrey"
         width: 640; height: 480

         Rectangle {
             color: "white"
             anchors.fill: parent
             anchors.margins: 20

             BorderImage {
                 id: startHandle
                 source: "pics/startHandle.sci"
                 opacity: 0.0
                 width: 10
                 x: edit.positionToRectangle(edit.selectionStart).x - flick.contentX-width
                 y: edit.positionToRectangle(edit.selectionStart).y - flick.contentY
                 height: edit.positionToRectangle(edit.selectionStart).height
             }

             BorderImage {
                 id: endHandle
                 source: "pics/endHandle.sci"
                 opacity: 0.0
                 width: 10
                 x: edit.positionToRectangle(edit.selectionEnd).x - flick.contentX
                 y: edit.positionToRectangle(edit.selectionEnd).y - flick.contentY
                 height: edit.positionToRectangle(edit.selectionEnd).height
             }

             Flickable {
                 id: flick

                 anchors.fill: parent
                 contentWidth: edit.paintedWidth
                 contentHeight: edit.paintedHeight
                 interactive: true
                 clip: true

                 function ensureVisible(r) {
                     if (contentX >= r.x)
                         contentX = r.x;
                     else if (contentX+width <= r.x+r.width)
                         contentX = r.x+r.width-width;
                     if (contentY >= r.y)
                         contentY = r.y;
                     else if (contentY+height <= r.y+r.height)
                         contentY = r.y+r.height-height;
                 }

                 TextEdit {
                     id: edit
                     width: flick.width
                     height: flick.height
                     focus: true
                     wrapMode: TextEdit.Wrap

                     onCursorRectangleChanged: flick.ensureVisible(cursorRectangle)

                     text: "<h1>Text Selection</h1>"
                         +"<p>This example is a whacky text selection mechanisms, showing how these can be implemented in the TextEdit element, to cater for whatever style is appropriate for the target platform."
                         +"<p><b>Press-and-hold</b> to select a word, then drag the selection handles."
                         +"<p><b>Drag outside the selection</b> to scroll the text."
                         +"<p><b>Click inside the selection</b> to cut/copy/paste/cancel selection."
                         +"<p>It's too whacky to let you paste if there is no current selection."

                     MouseArea {
                         property string drag: ""
                         property int pressPos

                         x: -startHandle.width
                         y: 0
                         width: parent.width+startHandle.width+endHandle.width
                         height: parent.height

                         onPressAndHold: {
                             if (editor.state == "") {
                                 edit.cursorPosition = edit.positionAt(mouse.x+x,mouse.y+y);
                                 edit.selectWord();
                                 editor.state = "selection"
                             }
                         }

                         onClicked: {
                             if (editor.state == "") {
                                 edit.cursorPosition = edit.positionAt(mouse.x+x,mouse.y+y);
                                 if (!edit.focus)
                                     edit.focus = true;
                                 edit.openSoftwareInputPanel();
                             }
                         }

                         function hitHandle(h,x,y) {
                             return x>=h.x+flick.contentX && x<h.x+flick.contentX+h.width && y>=h.y+flick.contentY && y<h.y+flick.contentY+h.height
                         }

                         onPressed: {
                             if (editor.state == "selection") {
                                 if (hitHandle(startHandle,mouse.x+x,mouse.y+y)) {
                                     drag = "start"
                                     flick.interactive = false
                                 } else if (hitHandle(endHandle,mouse.x+x,mouse.y+y)) {
                                     drag = "end"
                                     flick.interactive = false
                                 } else {
                                     var pos = edit.positionAt(mouse.x+x,mouse.y+y);
                                     if (pos >= edit.selectionStart && pos <= edit.selectionEnd) {
                                         drag = "selection"
                                         flick.interactive = false
                                     } else {
                                         drag = ""
                                         flick.interactive = true
                                     }
                                 }
                             }
                         }

                         onReleased: {
                             if (editor.state == "selection") {
                                 if (drag == "selection") {
                                     editor.state = "menu"
                                 }
                                 drag = ""
                             }
                             flick.interactive = true
                         }

                         onPositionChanged: {
                             if (editor.state == "selection" && drag != "") {
                                 if (drag == "start") {
                                     var pos = edit.positionAt(mouse.x+x+startHandle.width/2,mouse.y+y);
                                     var e = edit.selectionEnd;
                                     if (e < pos)
                                         e = pos;
                                     edit.select(pos,e);
                                 } else if (drag == "end") {
                                     var pos = edit.positionAt(mouse.x+x-endHandle.width/2,mouse.y+y);
                                     var s = edit.selectionStart;
                                     if (s > pos)
                                         s = pos;
                                     edit.select(s,pos);
                                 }
                             }
                         }
                     }
                 }
             }

             Item {
                 id: menu
                 opacity: 0.0
                 width: 100
                 height: 120
                 anchors.centerIn: parent

                 Rectangle {
                     border.width: 1
                     border.color: "darkBlue"
                     radius: 15
                     color: "#806080FF"
                     anchors.fill: parent
                 }

                 Column {
                     anchors.centerIn: parent
                     spacing: 8

                     Rectangle {
                         border.width: 1
                         border.color: "darkBlue"
                         color: "#ff7090FF"
                         width: 60
                         height: 16

                         Text { anchors.centerIn: parent; text: "Cut" }

                         MouseArea {
                             anchors.fill: parent
                             onClicked: { edit.cut(); editor.state = "" }
                         }
                     }

                     Rectangle {
                         border.width: 1
                         border.color: "darkBlue"
                         color: "#ff7090FF"
                         width: 60
                         height: 16

                         Text { anchors.centerIn: parent; text: "Copy" }

                         MouseArea {
                             anchors.fill: parent
                             onClicked: { edit.copy(); editor.state = "selection" }
                         }
                     }

                     Rectangle {
                         border.width: 1
                         border.color: "darkBlue"
                         color: "#ff7090FF"
                         width: 60
                         height: 16

                         Text { anchors.centerIn: parent; text: "Paste" }

                         MouseArea {
                             anchors.fill: parent
                             onClicked: { edit.paste(); edit.cursorPosition = edit.selectionEnd; editor.state = "" }
                         }
                     }

                     Rectangle {
                         border.width: 1
                         border.color: "darkBlue"
                         color: "#ff7090FF"
                         width: 60
                         height: 16

                         Text { anchors.centerIn: parent; text: "Deselect" }

                         MouseArea {
                             anchors.fill: parent
                             onClicked: {
                                 edit.cursorPosition = edit.selectionEnd;
                                 edit.deselect();
                                 editor.state = ""
                             }
                         }
                     }
                 }
             }
         }

         states: [
             State {
                 name: "selection"
                 PropertyChanges { target: startHandle; opacity: 1.0 }
                 PropertyChanges { target: endHandle; opacity: 1.0 }
             },
             State {
                 name: "menu"
                 PropertyChanges { target: startHandle; opacity: 0.5 }
                 PropertyChanges { target: endHandle; opacity: 0.5 }
                 PropertyChanges { target: menu; opacity: 1.0 }
             }
         ]
     }