Материал из Wiki.crossplatform.ru

Текущая версия на 07:52, 14 ноября 2008

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] Описание класса QListView
^{[модуль QtGui ]}

Класс QListView является представлением в виде списка или значка в модели. Далее...

 #include <QListView>

Унаследован от QAbstractItemView.

Наследуются от него QListWidget и QUndoView.

• Список всех членов включая унаследованные

[править] Открытые типы

• enum Flow { LeftToRight, TopToBottom }

• enum LayoutMode { SinglePass, Batched }
• enum Movement { Static, Free, Snap }
• enum ResizeMode { Fixed, Adjust }
• enum ViewMode { ListMode, IconMode }

[править] Свойства

• 14 свойства унаследованных от QAbstractItemView
• 2 свойства унаследованных от QAbstractScrollArea
• 6 свойства унаследованных от QFrame

• 56 свойства унаследованных от QWidget
• 1 свойство унаследованное от QObject

[править] Открытые функции

• QListView ( QWidget * parent = 0 )

• ~QListView ()
• int batchSize () const
• void clearPropertyFlags ()
• Flow flow () const

• QSize gridSize () const
• bool isRowHidden ( int row ) const
• bool isSelectionRectVisible () const

• bool isWrapping () const
• LayoutMode layoutMode () const
• int modelColumn () const
• Movement movement () const

• ResizeMode resizeMode () const
• void setBatchSize ( int batchSize )
• void setFlow ( Flow flow )

• void setGridSize ( const QSize & size )
• void setLayoutMode ( LayoutMode mode )

• void setModelColumn ( int column )
• void setMovement ( Movement movement )
• void setResizeMode ( ResizeMode mode )

• void setRowHidden ( int row, bool hide )
• void setSelectionRectVisible ( bool show )

• void setSpacing ( int space )
• void setUniformItemSizes ( bool enable )
• void setViewMode ( ViewMode mode )

• void setWordWrap ( bool on )
• void setWrapping ( bool enable )
• int spacing () const

• bool uniformItemSizes () const
• ViewMode viewMode () const
• bool wordWrap () const

• 52 открытых функций унаследованных от QAbstractItemView
• 15 открытых функций унаследованных от QAbstractScrollArea
• 13 открытых функций унаследованных от QFrame
• 201 открытых функций унаследованных от QWidget
• 29 открытых функций унаследованных от QObject
• 12 открытых функций унаследованных от QPaintDevice

[править] Сигналы

• void indexesMoved ( const QModelIndexList & indexes )

• 6 сигнала унаследованных от QAbstractItemView

• 1 сигнал унаследованный от QWidget
• 1 сигнал унаследованный от QObject

[править] Защищенные функции

• QRect rectForIndex ( const QModelIndex & index ) const

• void setPositionForIndex ( const QPoint & position, const QModelIndex & index )

• 33 защищенных функций унаследованных от QAbstractItemView

• 16 защищенных функций унаследованных от QAbstractScrollArea
• 38 защищенных функций унаследованных от QWidget
• 7 защищенных функций унаследованных от QObject
• 1 защищенная функция унаследованна от QPaintDevice

[править] Дополнительные унаследованные члены

• 9 открытых слотов унаследованных от QAbstractItemView

• 19 открытых слотов унаследованных от QWidget
• 1 открытый слот унаследованный от QObject
• 4 статических открытых члена унаследованных от QWidget
• 5 статических открытых члена унаследованных от QObject
• 8 защищенных слотов унаследованных от QAbstractItemView
• 1 защищенный слот унаследованный от QAbstractScrollArea

• 1 защищенный слот унаследованный от QWidget

[править] Подробное описание

Класс QListView является представлением в виде списка или значка в модели.

QListView представляет записи, хранящиеся в модели, в виде простого, не иерархического, списка, или совокупности значков. Данный класс используется для представления в виде списка и значка там, где раньше использовались классы QListBox и QIconView, но использует более гибкий подход, предоставляемый архитектурой Qt модель/представление .

Класс QListView является одним из Классов Модель/Представление и частью Qt структуры модель/представление.

Это представление не отображает горизонтальных и вертикальных заголовков; чтобы отображать список элементов с горизонтальным заголовком, используйте QTreeView, взамен.

QListView реализует интерфейсы, определенные в классе QAbstractItemView, чтобы позволить ему отображать данные предоставляемые моделями, произошедшими от класса QAbstractItemModel.

Элементы в представлении могут быть отображены используя один из двух режимов: В ListMode, элементы отображаются в форме простого списка; в IconMode, представление принимает форму icon view в которой элементы отображаются со значками подобным файлам в фаловом менеджере. По умолчанию, представление находится в ListMode. Чтобы изменить режим представления, используйте функцию setViewMode(), и чтобы определить текущий режим представления, используйте viewMode().

Элементы в этих представлениях размещаются в направлении определенном функцией представления flow(). Элементы могут быть зафиксированы на месте, или разрешены для перемещения, в зависимости от состояния movement() представления.

Если элементы в модели не могут быть полностью размещены по направлению к размещения, они могут быть перенесены у границы виджета представления; это зависит от isWrapping(). Это свойство полезно, когда элементы представленны в виде значков.

Функции resizeMode() и layoutMode() управляют как и когда элементы размещаются. Элементы расположены в соответствии с их spacing(), и могут существовать в пределах воображаемой сетки с шагом определенным gridSize(). Элементы могут быть отрисованы как большие или маленькие значки в зависимости от их iconSize().

		Файл:Plastique-listview.png
A Windows XP style list view.	A Macintosh style list view.	A Plastique style list view.

[править] Improving Performance

It is possible to give the view hints about the data it is handling in order to improve its performance when displaying large numbers of items. One approach that can be taken for views that are intended to display items with equal sizes is to set the uniformItemSizes property to true.

See also View Classes, QTreeView, QTableView, and QListWidget.

[править] Описание типов членов

[править]

enum QListView::Flow

[править]

enum QListView::LayoutMode

See also batchSize.

[править]

enum QListView::Movement

[править]

enum QListView::ResizeMode

[править]

enum QListView::ViewMode

[править] Описание свойств

[править]

batchSize : int

This property holds the number of items laid out in each batch if layoutMode is set to Batched.

The default value is 100.

This property was introduced in Qt 4.2.

Функции доступа:

• int batchSize () const
• void setBatchSize ( int batchSize )

[править]

flow : Flow

Это свойство содержит значение, в каком направлении должно происходить расположение.

Если это свойство равно LeftToRight, элементы будут размещены с лева на право. Если свойство isWrapping истинно, размещение будет переносится, когда оно достигнет правой стороны видимой области. Если это свойство равно TopToBottom, элементы будут размещены сверху видимой области, переносясь, когда оно достигнет низа.

Установка этого свойства, когда представление видимо приведет к размещению элементов снова.

Функции доступа:

• Flow flow () const
• void setFlow ( Flow flow )

See also viewMode.

[править]

gridSize : QSize

Это свойство содержит шаг сетки размещения

Это свойство есть шаг сетки, в которой размещаются элементы. По умолчанию размер пустой, что означает, что нет сетки и размещение делается не по сетке. Установка этого свойства в непустой размер приводит к размещению по сетке. (Когда размещение по сетке в силе, свойство spacing игнорируется.)

Установка этого свойства, когда представление видимо приведет к размещению элементов снова.

Функции доступа:

• QSize gridSize () const
• void setGridSize ( const QSize & size )

See also viewMode.

[править]

isWrapping : bool

Это свойство указывает, могут ли элементы переноситься при размещении.

Это свойство указывает, должно ли размещение переносится, когда нет больше места в видимой области. Точка в которой размещение переносится зависит от свойства flow.

Установка этого свойства, когда представление видимо приведет к размещению элементов снова.

Функции доступа:

• bool isWrapping () const
• void setWrapping ( bool enable )

See also viewMode.

[править]

layoutMode : LayoutMode

Это свойство указывает должно ли размещение элементов происходить немедленно или должно быть отложено.

Это свойство содержит режим размещения для элементов. Когда режим SinglePass (по умолчанию), элементы размещаются все сразу. When the mode is Batched, the items are laid out in batches of batchSize items, while processing events. Это делает возможным немедленно просматривать и взаимодействовать с видимыми элементами, в то время пока остальные размещаются.

Функции доступа:

• LayoutMode layoutMode () const
• void setLayoutMode ( LayoutMode mode )

See also viewMode.

[править]

modelColumn : int

Это свойство содержит номер колонки в модели, которая отображается.

Функции доступа:

• int modelColumn () const
• void setModelColumn ( int column )

[править]

movement : Movement

Это свойство указывает могут ли элементы быть свободно перемещены, привязаны ли к сетке, или не могут быть перемещены вообще.

Это свойство определяет, как пользователь может перемещать элементы в представлении. Static означает, что элементы не могут быть перемещены пользователем. Free означает, что пользователь может перетаскивать элементы в любую позицию в представлении. Snap означает, что пользователь может перетаскивать элементы, но только в позиции в воображаемой сетки заданной свойством gridSize.

Установка этого свойства, когда представление видимо приведет к размещению элементов снова.

Функции доступа:

• Movement movement () const
• void setMovement ( Movement movement )

See also gridSize and viewMode.

[править]

resizeMode : ResizeMode

Это свойство указывает должны ли элементы размещатся снова, когда представление изменяет размер.

Если это свойство Adjust, элементы будут размещатся снова, когда представление изменяет размер. Если значение Fixed, элементы не будут размещатся, когда представление изменяет размер.

Функции доступа:

• ResizeMode resizeMode () const
• void setResizeMode ( ResizeMode mode )

See also viewMode.

[править]

selectionRectVisible : bool

This property holds if the selection rectangle should be visible.

If this property is true then the selection rectangle is visible; otherwise it will be hidden. Note that the selection rectangle will only be visible if the selection mode is in a mode where more than one item can be selected, i.e. it will not draw a selection rectangle if the selection mode is QAbstractItemView::SingleSelection.

This property was introduced in Qt 4.3.

Функции доступа:

• bool isSelectionRectVisible () const
• void setSelectionRectVisible ( bool show )

[править]

spacing : int

Это свойство содержит расстояние между элементами в размещении.

This property is the size of the empty space that is padded around an item in the layout.

Установка этого свойства, когда представление видимо приведет к размещению элементов снова.

Функции доступа:

• int spacing () const
• void setSpacing ( int space )

See also viewMode.

[править]

uniformItemSizes : bool

Это свойство указывает имеют ли все элементы в представлении одинаковый размер.

This property should only be set to true if it is guaranteed that all items in the view have the same size. Это позволяет представлению делать одинаковую оптимизацию.

Это свойство было введено в Qt 4.1.

Функции доступа:

• bool uniformItemSizes () const
• void setUniformItemSizes ( bool enable )

[править]

viewMode : ViewMode

Это свойство содержит режим отображения QListView.

Это свойство изменит другие неустановленные свойства, чтобы соответствовать установленному режиму отображения. QListView-specific properties that have already been set will not be changed, unless clearPropertyFlags() has been called.

Setting the view mode will enable or disable drag and drop based on the selected movement. For ListMode, the default movement is Static (drag and drop disabled); for IconMode, the default movement is Free (drag and drop enabled).

Функции доступа:

• ViewMode viewMode () const
• void setViewMode ( ViewMode mode )

See also isWrapping, spacing, gridSize, flow, movement, and resizeMode.

[править]

wordWrap : bool

This property holds the item text word-wrapping policy.

If this property is true then the item text is wrapped where necessary at word-breaks; otherwise it is not wrapped at all. This property is false by default.

This property was introduced in Qt 4.2.

Функции доступа:

• bool wordWrap () const
• void setWordWrap ( bool on )

[править] Описание функций-членов

[править]

QListView::QListView ( QWidget * parent = 0 )

Создает новый QListView с заданным родителем parent, чтобы представить модель. Используйте setModel(), чтобы установить модель.

[править]

QListView::~QListView ()

Разрушает представление.

[править]

void QListView::clearPropertyFlags ()

Clears the QListView-specific property flags. See viewMode.

Свойства inherited from QAbstractItemView are not covered by the property flags. Specifically, dragEnabled and acceptDrops are computed by QListView when calling setMovement() or setViewMode().

[править]

void QListView::indexesMoved ( const QModelIndexList & indexes ) [signal]

This signal is emitted when the specified indexes are moved in the view.

This function was introduced in Qt 4.2.

[править]

bool QListView::isRowHidden ( int row ) const

Returns true if the row is hidden; otherwise returns false.

[править]

QRect QListView::rectForIndex ( const QModelIndex & index ) const [protected]

Возвращает прямоугольник элемента в позиции index в модели. Прямоугольник находится в координатах содержимого.

See also visualRect().

[править]

void QListView::setPositionForIndex ( const QPoint & position, const QModelIndex & index ) [protected]

Устанавливает положение содержимого элемента модели с индексом index в позицию заданную с помощью position. Если режим перемещения представления Static, то эта функция не имеет эфекта.

Эта функция была введена в Qt 4.1.

[править]

void QListView::setRowHidden ( int row, bool hide )

If hide is true, the given row will be hidden; otherwise the row will be shown.

См. также isRowHidden().