/**************************************************************************** ** ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/legal ** ** This file is part of the Qt Quick Controls module 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 Digia Plc 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 2.2 /*! \qmltype TableViewColumn \inqmlmodule QtQuick.Controls \since 5.1 \ingroup viewitems \brief Used to define columns in a \l TableView. \image tableview.png TableViewColumn represents a column within a TableView. It provides properties to decide how the data in that column is presented. \qml TableView { TableViewColumn { role: "title"; title: "Title"; width: 100 } TableViewColumn { role: "author"; title: "Author"; width: 200 } model: libraryModel } \endqml \sa TableView */ QtObject { /*! \internal */ property Item __view: null /*! \internal */ property int __index: -1 /*! The title text of the column. */ property string title /*! The model \c role of the column. */ property string role /*! The current width of the column The default value depends on platform. If only one column is defined, the width expands to the viewport. */ property int width: (__view && __view.columnCount === 1) ? __view.viewport.width : 160 /*! The visible status of the column. */ property bool visible: true /*! Determines if the column should be resizable. \since QtQuick.Controls 1.1 */ property bool resizable: true /*! Determines if the column should be movable. The default value is \c true. \note A non-movable column may get indirectly moved if adjacent columns are movable. \since QtQuick.Controls 1.1 */ property bool movable: true /*! \qmlproperty enumeration TableViewColumn::elideMode The text elide mode of the column. Allowed values are: \list \li Text.ElideNone \li Text.ElideLeft \li Text.ElideMiddle \li Text.ElideRight - the default \endlist \sa {QtQuick::}{Text::elide} */ property int elideMode: Text.ElideRight /*! \qmlproperty enumeration TableViewColumn::horizontalAlignment The horizontal text alignment of the column. Allowed values are: \list \li Text.AlignLeft - the default \li Text.AlignRight \li Text.AlignHCenter \li Text.AlignJustify \endlist \sa {QtQuick::}{Text::horizontalAlignment} */ property int horizontalAlignment: Text.AlignLeft /*! The delegate of the column. This can be used to set the \l TableView::itemDelegate for a specific column. In the delegate you have access to the following special properties: \list \li styleData.selected - if the item is currently selected \li styleData.value - the value or text for this item \li styleData.textColor - the default text color for an item \li styleData.row - the index of the row \li styleData.column - the index of the column \li styleData.elideMode - the elide mode of the column \li styleData.textAlignment - the horizontal text alignment of the column \endlist */ property Component delegate Accessible.role: Accessible.ColumnHeader /*! Resizes the column so that the implicitWidth of the contents on every row will fit. \since QtQuick.Controls 1.2 */ function resizeToContents() { var minWidth = 0 var listdata = __view.__listView.children[0] for (var i = 0; __index < 0 && i < __view.__columns.length; ++i) if (__view.__columns[i] === this) __index = i for (var row = 0 ; row < listdata.children.length ; ++row) { var item = listdata.children[row] ? listdata.children[row].rowItem : undefined if (item && item.children[1] && item.children[1].children[__index] && item.children[1].children[__index].children[0] && item.children[1].children[__index].children[0].hasOwnProperty("implicitWidth")) minWidth = Math.max(minWidth, item.children[1].children[__index].children[0].implicitWidth) } if (minWidth) width = minWidth } }