redo way simpler ToolBarLayout

This commit is contained in:
Marco Martin 2011-11-09 16:10:36 +01:00
parent 4dd35da400
commit 9cc6656fb6

View File

@ -1,42 +1,22 @@
/****************************************************************************
**
** 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 Qt Components project.
**
** $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$
**
****************************************************************************/
/*
* Copyright (C) 2011 by Marco Martin <mart@kde.org>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU Library General Public License as
* published by the Free Software Foundation; either version 2, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Library General Public License for more details
*
* You should have received a copy of the GNU Library General Public
* License along with this program; if not, write to the
* Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
// ToolBarLayout is a container for items on a toolbar that automatically
// implements an appropriate layout for its children.
@ -44,268 +24,43 @@
import QtQuick 1.1
import "." 0.1
Item {
id: root
implicitWidth: parent.width
implicitHeight: parent.height
Row {
id: root
visible: false
Connections {
target: privateStyle
onLayoutParametersChanged: internal.layoutChildren()
}
Connections {
target: screen
onCurrentOrientationChanged: internal.layoutChildren()
Item {
id: spacer
width: 10
height: 10
}
QtObject {
id: internal
objectName: "internal"
property bool portrait: screen.width < screen.height
// These are the dynamic layout parameters used by the toolbar layout.
property real defaultHeightToolBar: portrait ?
privateStyle.toolBarHeightPortrait : privateStyle.toolBarHeightLandscape
property real defaultHeightToolButton: privateStyle.toolBarHeightLandscape
property real outerMarginHorizontal: portrait ?
0 : (2 * platformStyle.paddingLarge)
property real outerMarginButtonRowLong: portrait ?
platformStyle.paddingLarge : (3 * platformStyle.paddingLarge)
property real innerSpacingTextButtonSingle: portrait ?
platformStyle.paddingMedium + (3 * platformStyle.paddingLarge) : (3 * platformStyle.paddingLarge)
property real innerSpacingTextButtonDouble: portrait ?
platformStyle.paddingSmall : (3 * platformStyle.paddingLarge)
property real innerSpacingButtonRowTwoChildren: portrait ?
platformStyle.paddingMedium : (3 * platformStyle.paddingLarge)
property real innerSpacingButtonRowLong: portrait ?
platformStyle.paddingMedium : platformStyle.paddingLarge
property real centerSpacingTextButtonDouble: platformStyle.paddingLarge
function isIconButton(item) {
return item.hasOwnProperty("iconSource")
&& item.hasOwnProperty("text")
&& item.text == ""
}
function isTextToolButton(item) {
// ToolButton has both iconSource and flat property,
// Button only has iconSource
return (item.hasOwnProperty("iconSource")
&& item.iconSource == ""
&& item.hasOwnProperty("flat"))
}
function isButtonRow(item) {
return item.hasOwnProperty("checkedButton")
}
function buttonWidth(child) {
if ((isTextToolButton(child)) || !(child.hasOwnProperty("implicitWidth"))) {
// ImplicitWidth for the ToolButton returns wrong value right after
// orientation change, and also we want to override its own
// layout width calculation, so use the actual width
return child.width
}
return child.implicitWidth
}
function centerOffset(outerLength, innerLength) {
// calculate the offset of the leading edge of a centered child item
return Math.floor((outerLength - innerLength) / 2.0)
}
function widthTextButtonSingle(leftMargin, innerSpacing) {
// calculate the remaining width for a centered item
var outerContents = leftMargin + innerSpacing
return root.width - (outerContents * 2)
}
function widthTextButtonDouble(leftMargin, innerSpacing, centerSpacing) {
// calculate the space available when there are two items with a center
// margin, and share it between the two
var outerContents = leftMargin + innerSpacing
return Math.round((root.width - (outerContents * 2) - centerSpacing) / 2.0)
}
function widthButtonRowLong(leftButton, rightButton, itemMargin, innerSpacing, outerMargin) {
// calculate the width of a long button row, which is used in the case that there are more
// than three icons. If either left or right button is present, allocate the itemMargin to
// ensure that there is sufficient space; otherwise we can use the special
// outerMargin value
var leftContents = leftButton ? itemMargin + innerSpacing : outerMargin
var rightContents = rightButton ? itemMargin + innerSpacing : outerMargin
return root.width - leftContents - rightContents
}
function layoutChildren() {
var numChildren = children.length
if (parent == null || root.width == 0 || numChildren == 0)
return
for (var i = 0; i < numChildren; ++i) {
// make sure all the children have correct parent, height, and y
children[i].parent = root
if (isButtonRow(children[i])) {
var buttonRow = children[i]
// ButtonRow frame height is always tool bar's height in
// landscape, regardless of the current orientation, so we need
// to override the heights of the buttons within (because it's a
// Row, so its height is based on its children)
for (var j = 0; j < buttonRow.children.length; ++j) {
buttonRow.children[j].implicitHeight = defaultHeightToolButton
}
}
// child's vertical center always goes to middle of the toolbar
var childHeight = children[i].hasOwnProperty("implicitHeight") ?
children[i].implicitHeight : children[i].height
children[i].y = root.y + centerOffset(root.implicitHeight, childHeight)
}
// detect whether we have left and or right items. we need to lay out
// the remaining children (that are not left or right items) whether they
// are tool buttons, text buttons or a button row
var leftItem = isIconButton(children[0]) ?
children[0] : undefined
var rightItem = isIconButton(children[numChildren-1]) ?
children[numChildren-1] : undefined
var childrenRemaining = numChildren - (leftItem != undefined ? 1 : 0) - (rightItem != undefined ? 1 : 0)
var firstRemainingIndex = leftItem != undefined ? 1 : 0
var lastRemainingIndex = rightItem != undefined ? (numChildren - 2) : (numChildren - 1)
// precalculate the margins for the left and right items, we will work
// out child sizes assuming they are present
var leftMargin = outerMarginHorizontal + defaultHeightToolBar
var rightMargin = root.width - leftMargin
// In the case of a lone remaining chlld, or in the case of 2 text
// buttons, we need to override the width
var overrideChildWidth = 0
for (var p = firstRemainingIndex; p <= lastRemainingIndex; p++) {
var child = children[p]
overrideChildWidth = buttonWidth(child)
// If necessary, we calculate and override the width first before we
// can calculate the x positions
if ((isTextToolButton(child) && childrenRemaining == 1)
|| (isButtonRow(child) && child.children.length == 1)) {
// we treat a button row with a single item like a single tool button,
// but in landscape, calculate size as if there were two buttons
overrideChildWidth = portrait ?
widthTextButtonSingle(leftMargin, innerSpacingTextButtonSingle) :
widthTextButtonDouble(leftMargin, innerSpacingTextButtonDouble, innerSpacingTextButtonDouble)
} else if (isTextToolButton(child) && childrenRemaining == 2) {
// special case of margins for two text buttons
overrideChildWidth = widthTextButtonDouble(
leftMargin, innerSpacingTextButtonDouble, centerSpacingTextButtonDouble)
} else if (isButtonRow(child) && ((child.children.length == 2)
|| (child.children.length > 2 && leftItem != undefined && rightItem != undefined))) {
// there are special margins if the button row has two children,
// or if it has more than two children and there is a left and
// a right item
overrideChildWidth = widthTextButtonSingle(
leftMargin, innerSpacingButtonRowTwoChildren)
} else if (isButtonRow(child) && child.children.length > 2) {
// the long button row has special margins, which are used on
// either side if the side icon button is missing on that side. If the item is present,
// the leftMargin can be used on either side to leave space for either icon button
overrideChildWidth = widthButtonRowLong(
leftItem != undefined,
rightItem != undefined,
leftMargin,
innerSpacingButtonRowLong,
outerMarginButtonRowLong)
}
child.width = overrideChildWidth
}
if (numChildren == 1) {
var loneChild = children[0]
var loneChildWidth = buttonWidth(loneChild)
if (isButtonRow(loneChild)) {
loneChildWidth = overrideChildWidth
}
if (isIconButton(loneChild))
loneChild.x = outerMarginHorizontal
else
loneChild.x = centerOffset(root.width, loneChildWidth)
property bool layouting: false
function layoutChildren()
{
var numChildren = root.children.length
if (layouting || parent == null ||
root.width == 0 || numChildren < 2) {
return
}
// we can easily calculate the positions of the left and right items,
// but if they are missing then correct the margins
if (leftItem != undefined){
leftItem.x = outerMarginHorizontal
} else {
leftMargin = 0
}
if (rightItem != undefined){
rightItem.x = root.width - defaultHeightToolBar - outerMarginHorizontal
} else {
rightMargin = root.width
}
layouting = true
spacer.parent = null
if (!childrenRemaining)
return;
spacer.width = root.parent.width - root.childrenRect.width
if (childrenRemaining == 1) {
var loneChild = children[firstRemainingIndex]
var loneChildWidth = buttonWidth(loneChild)
if (isButtonRow(loneChild)) {
// ButtonRow should have the override width (but it won't have
// been updated yet)
loneChildWidth = overrideChildWidth
}
// lone child is always centered, unless it's a long button row on
// one side only
if (isButtonRow(loneChild) && loneChild.children.length >= 3
&& ((leftItem == undefined) != (rightItem == undefined))) {
loneChild.x = (leftItem != undefined) ?
(leftMargin + innerSpacingButtonRowLong) : outerMarginButtonRowLong
} else {
loneChild.x = centerOffset(root.width, loneChildWidth)
}
} else if (childrenRemaining == 2 && isTextToolButton(children[firstRemainingIndex])) {
// text buttons are distributed around the center with a center spacing
var midPoint = Math.floor(root.width / 2.0)
var halfSpacing = Math.round(platformStyle.paddingLarge / 2.0)
children[firstRemainingIndex].x = midPoint - halfSpacing - buttonWidth(children[firstRemainingIndex])
children[firstRemainingIndex + 1].x = midPoint + halfSpacing
} else {
// icon buttons are deployed evenly in the remaining space,
// but we need to ensure that the spacings are integer values,
// and share the rounding error to ensure that they are centered
var remainingSpace = rightMargin - leftMargin
var spacingNotRounded = remainingSpace
for (var p = 0; p < childrenRemaining; p++) {
var nextChild = children[leftItem != undefined ? p + 1 : p]
spacingNotRounded -= buttonWidth(nextChild)
}
spacingNotRounded /= (childrenRemaining + 1)
var spacing = Math.floor(spacingNotRounded)
var totalRoundingError = (spacingNotRounded - spacing) * (childrenRemaining + 1)
var curPos = leftMargin + Math.floor(totalRoundingError / 2.0)
for (var p = 0; p < childrenRemaining; p++) {
var nextChild = children[leftItem != undefined ? p + 1 : p]
curPos += spacing
nextChild.x = curPos
curPos += buttonWidth(nextChild)
}
}
var last = root.children[numChildren-2]
last.parent = null
spacer.parent = root
last.parent = root
layouting = false
}
}
Component.onCompleted: internal.layoutChildren()
onParentChanged: internal.layoutChildren()
onChildrenChanged: internal.layoutChildren()
onImplicitWidthChanged: internal.layoutChildren()
onImplicitHeightChanged: internal.layoutChildren()
onWidthChanged: internal.layoutChildren()
}