Qt 4.8
Public Types | Signals | Public Functions | Protected Functions | Private Functions | Properties | Friends | List of all members
QListView Class Reference

The QListView class provides a list or icon view onto a model. More...

#include <qlistview.h>

Inheritance diagram for QListView:
QAbstractItemView QAbstractScrollArea QFrame QWidget QObject QPaintDevice QComboBoxListView QFileDialogListView QFontListView QListWidget QSidebar QUndoView

Public Types

enum  Flow { LeftToRight, TopToBottom }
 
enum  LayoutMode { SinglePass, Batched }
 
enum  Movement { Static, Free, Snap }
 
enum  ResizeMode { Fixed, Adjust }
 
enum  ViewMode { ListMode, IconMode }
 
- Public Types inherited from QAbstractItemView
enum  DragDropMode {
  NoDragDrop, DragOnly, DropOnly, DragDrop,
  InternalMove
}
 Describes the various drag and drop events the view can act upon. More...
 
enum  EditTrigger {
  NoEditTriggers = 0, CurrentChanged = 1, DoubleClicked = 2, SelectedClicked = 4,
  EditKeyPressed = 8, AnyKeyPressed = 16, AllEditTriggers = 31
}
 This enum describes actions which will initiate item editing. More...
 
enum  ScrollHint { EnsureVisible, PositionAtTop, PositionAtBottom, PositionAtCenter }
 
enum  ScrollMode { ScrollPerItem, ScrollPerPixel }
 
enum  SelectionBehavior { SelectItems, SelectRows, SelectColumns }
 
enum  SelectionMode {
  NoSelection, SingleSelection, MultiSelection, ExtendedSelection,
  ContiguousSelection
}
 This enum indicates how the view responds to user selections: More...
 
- Public Types inherited from QFrame
enum  Shadow { Plain = 0x0010, Raised = 0x0020, Sunken = 0x0030 }
 This enum type defines the types of shadow that are used to give a 3D effect to frames. More...
 
enum  Shape {
  NoFrame = 0, Box = 0x0001, Panel = 0x0002, WinPanel = 0x0003,
  HLine = 0x0004, VLine = 0x0005, StyledPanel = 0x0006
}
 This enum type defines the shapes of frame available. More...
 
enum  StyleMask { Shadow_Mask = 0x00f0, Shape_Mask = 0x000f }
 This enum defines two constants that can be used to extract the two components of frameStyle(): More...
 
- Public Types inherited from QWidget
enum  RenderFlag { DrawWindowBackground = 0x1, DrawChildren = 0x2, IgnoreMask = 0x4 }
 This enum describes how to render the widget when calling QWidget::render(). More...
 
- Public Types inherited from QPaintDevice
enum  PaintDeviceMetric {
  PdmWidth = 1, PdmHeight, PdmWidthMM, PdmHeightMM,
  PdmNumColors, PdmDepth, PdmDpiX, PdmDpiY,
  PdmPhysicalDpiX, PdmPhysicalDpiY
}
 

Signals

void indexesMoved (const QModelIndexList &indexes)
 This signal is emitted when the specified indexes are moved in the view. More...
 
- Signals inherited from QAbstractItemView
void activated (const QModelIndex &index)
 This signal is emitted when the item specified by index is activated by the user. More...
 
void clicked (const QModelIndex &index)
 This signal is emitted when a mouse button is clicked. More...
 
void doubleClicked (const QModelIndex &index)
 This signal is emitted when a mouse button is double-clicked. More...
 
void entered (const QModelIndex &index)
 This signal is emitted when the mouse cursor enters the item specified by index. More...
 
void pressed (const QModelIndex &index)
 This signal is emitted when a mouse button is pressed. More...
 
void viewportEntered ()
 This signal is emitted when the mouse cursor enters the viewport. More...
 
- Signals inherited from QWidget
void customContextMenuRequested (const QPoint &pos)
 This signal is emitted when the widget's contextMenuPolicy is Qt::CustomContextMenu, and the user has requested a context menu on the widget. More...
 
- Signals inherited from QObject
void destroyed (QObject *=0)
 This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More...
 

Public Functions

int batchSize () const
 
void clearPropertyFlags ()
 Clears the QListView-specific property flags. More...
 
void doItemsLayout ()
 Layout the items according to the flow and wrapping properties. More...
 
Flow flow () const
 
QSize gridSize () const
 
QModelIndex indexAt (const QPoint &p) const
 Reimplemented Function More...
 
bool isRowHidden (int row) const
 Returns true if the row is hidden; otherwise returns false. More...
 
bool isSelectionRectVisible () const
 
bool isWrapping () const
 
LayoutMode layoutMode () const
 
int modelColumn () const
 
Movement movement () const
 
 QListView (QWidget *parent=0)
 Creates a new QListView with the given parent to view a model. More...
 
void reset ()
 
ResizeMode resizeMode () const
 
void scrollTo (const QModelIndex &index, ScrollHint hint=EnsureVisible)
 Reimplemented Function More...
 
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 setRootIndex (const QModelIndex &index)
 
void setRowHidden (int row, bool hide)
 If hide is true, the given row will be hidden; otherwise the row will be shown. More...
 
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
 
QRect visualRect (const QModelIndex &index) const
 Reimplemented Function More...
 
bool wordWrap () const
 
 ~QListView ()
 Destroys the view. More...
 
- Public Functions inherited from QAbstractItemView
bool alternatingRowColors () const
 
int autoScrollMargin () const
 
void closePersistentEditor (const QModelIndex &index)
 Closes the persistent editor for the item at the given index. More...
 
QModelIndex currentIndex () const
 Returns the model index of the current item. More...
 
Qt::DropAction defaultDropAction () const
 
DragDropMode dragDropMode () const
 
bool dragDropOverwriteMode () const
 
bool dragEnabled () const
 
EditTriggers editTriggers () const
 
bool hasAutoScroll () const
 
ScrollMode horizontalScrollMode () const
 
QSize iconSize () const
 
QWidgetindexWidget (const QModelIndex &index) const
 Returns the widget for the item at the given index. More...
 
virtual QVariant inputMethodQuery (Qt::InputMethodQuery query) const
 Reimplemented Function More...
 
QAbstractItemDelegateitemDelegate () const
 Returns the item delegate used by this view and model. More...
 
QAbstractItemDelegateitemDelegate (const QModelIndex &index) const
 Returns the item delegate used by this view and model for the given index. More...
 
QAbstractItemDelegateitemDelegateForColumn (int column) const
 Returns the item delegate used by this view and model for the given column. More...
 
QAbstractItemDelegateitemDelegateForRow (int row) const
 Returns the item delegate used by this view and model for the given row, or 0 if no delegate has been assigned. More...
 
virtual void keyboardSearch (const QString &search)
 Moves to and selects the item best matching the string search. More...
 
QAbstractItemModelmodel () const
 Returns the model that this view is presenting. More...
 
void openPersistentEditor (const QModelIndex &index)
 Opens a persistent editor on the item at the given index. More...
 
 QAbstractItemView (QWidget *parent=0)
 Constructs an abstract item view with the given parent. More...
 
QModelIndex rootIndex () const
 Returns the model index of the model's root item. More...
 
QAbstractItemView::SelectionBehavior selectionBehavior () const
 
QAbstractItemView::SelectionMode selectionMode () const
 
QItemSelectionModelselectionModel () const
 Returns the current selection model. More...
 
void setAlternatingRowColors (bool enable)
 
void setAutoScroll (bool enable)
 
void setAutoScrollMargin (int margin)
 
void setDefaultDropAction (Qt::DropAction dropAction)
 
void setDragDropMode (DragDropMode behavior)
 
void setDragDropOverwriteMode (bool overwrite)
 
void setDragEnabled (bool enable)
 
void setDropIndicatorShown (bool enable)
 
void setEditTriggers (EditTriggers triggers)
 
void setHorizontalScrollMode (ScrollMode mode)
 
void setIconSize (const QSize &size)
 
void setIndexWidget (const QModelIndex &index, QWidget *widget)
 Sets the given widget on the item at the given index, passing the ownership of the widget to the viewport. More...
 
void setItemDelegate (QAbstractItemDelegate *delegate)
 Sets the item delegate for this view and its model to delegate. More...
 
void setItemDelegateForColumn (int column, QAbstractItemDelegate *delegate)
 Sets the given item delegate used by this view and model for the given column. More...
 
void setItemDelegateForRow (int row, QAbstractItemDelegate *delegate)
 Sets the given item delegate used by this view and model for the given row. More...
 
virtual void setModel (QAbstractItemModel *model)
 Sets the model for the view to present. More...
 
void setSelectionBehavior (QAbstractItemView::SelectionBehavior behavior)
 
void setSelectionMode (QAbstractItemView::SelectionMode mode)
 
virtual void setSelectionModel (QItemSelectionModel *selectionModel)
 Sets the current selection model to the given selectionModel. More...
 
void setTabKeyNavigation (bool enable)
 
void setTextElideMode (Qt::TextElideMode mode)
 
void setVerticalScrollMode (ScrollMode mode)
 
bool showDropIndicator () const
 
virtual int sizeHintForColumn (int column) const
 Returns the width size hint for the specified column or -1 if there is no model. More...
 
QSize sizeHintForIndex (const QModelIndex &index) const
 Returns the size hint for the item with the specified index or an invalid size for invalid indexes. More...
 
virtual int sizeHintForRow (int row) const
 Returns the height size hint for the specified row or -1 if there is no model. More...
 
bool tabKeyNavigation () const
 
Qt::TextElideMode textElideMode () const
 
ScrollMode verticalScrollMode () const
 
 ~QAbstractItemView ()
 Destroys the view. More...
 
- Public Functions inherited from QAbstractScrollArea
void addScrollBarWidget (QWidget *widget, Qt::Alignment alignment)
 Adds widget as a scroll bar widget in the location specified by alignment. More...
 
QWidgetcornerWidget () const
 Returns the widget in the corner between the two scroll bars. More...
 
QScrollBarhorizontalScrollBar () const
 Returns the horizontal scroll bar. More...
 
Qt::ScrollBarPolicy horizontalScrollBarPolicy () const
 
QSize maximumViewportSize () const
 Returns the size of the viewport as if the scroll bars had no valid scrolling range. More...
 
QSize minimumSizeHint () const
 Reimplemented Function More...
 
 QAbstractScrollArea (QWidget *parent=0)
 Constructs a viewport. More...
 
QWidgetList scrollBarWidgets (Qt::Alignment alignment)
 Returns a list of the currently set scroll bar widgets. More...
 
void setCornerWidget (QWidget *widget)
 Sets the widget in the corner between the two scroll bars to be widget. More...
 
void setHorizontalScrollBar (QScrollBar *scrollbar)
 Replaces the existing horizontal scroll bar with scrollBar, and sets all the former scroll bar's slider properties on the new scroll bar. More...
 
void setHorizontalScrollBarPolicy (Qt::ScrollBarPolicy)
 
void setVerticalScrollBar (QScrollBar *scrollbar)
 Replaces the existing vertical scroll bar with scrollBar, and sets all the former scroll bar's slider properties on the new scroll bar. More...
 
void setVerticalScrollBarPolicy (Qt::ScrollBarPolicy)
 
void setViewport (QWidget *widget)
 Sets the viewport to be the given widget. More...
 
QSize sizeHint () const
 Reimplemented Function More...
 
QScrollBarverticalScrollBar () const
 Returns the vertical scroll bar. More...
 
Qt::ScrollBarPolicy verticalScrollBarPolicy () const
 
QWidgetviewport () const
 Returns the viewport widget. More...
 
 ~QAbstractScrollArea ()
 Destroys the viewport. More...
 
- Public Functions inherited from QFrame
QRect frameRect () const
 
Shadow frameShadow () const
 
Shape frameShape () const
 
int frameStyle () const
 Returns the frame style. More...
 
int frameWidth () const
 
int lineWidth () const
 
int midLineWidth () const
 
 QFrame (QWidget *parent=0, Qt::WindowFlags f=0)
 Constructs a frame widget with frame style NoFrame and a 1-pixel frame width. More...
 
void setFrameRect (const QRect &)
 em>Reimplemented Function More...
 
void setFrameShadow (Shadow)
 
void setFrameShape (Shape)
 
void setFrameStyle (int)
 Sets the frame style to style. More...
 
void setLineWidth (int)
 
void setMidLineWidth (int)
 
QSize sizeHint () const
 em>Reimplemented Function More...
 
 ~QFrame ()
 Destroys the frame. More...
 
- Public Functions inherited from QWidget
bool acceptDrops () const
 
QString accessibleDescription () const
 
QString accessibleName () const
 
QList< QAction * > actions () const
 Returns the (possibly empty) list of this widget's actions. More...
 
void activateWindow ()
 Sets the top-level widget containing this widget to be the active window. More...
 
void addAction (QAction *action)
 Appends the action action to this widget's list of actions. More...
 
void addActions (QList< QAction *> actions)
 Appends the actions actions to this widget's list of actions. More...
 
void adjustSize ()
 Adjusts the size of the widget to fit its contents. More...
 
bool autoFillBackground () const
 
QPalette::ColorRole backgroundRole () const
 Returns the background role of the widget. More...
 
QSize baseSize () const
 
QWidgetchildAt (int x, int y) const
 Returns the visible child widget at the position ({x}, {y}) in the widget's coordinate system. More...
 
QWidgetchildAt (const QPoint &p) const
 Returns the visible child widget at point p in the widget's own coordinate system. More...
 
QRect childrenRect () const
 
QRegion childrenRegion () const
 
void clearFocus ()
 Takes keyboard input focus from the widget. More...
 
void clearMask ()
 Removes any mask set by setMask(). More...
 
QMargins contentsMargins () const
 The contentsMargins function returns the widget's contents margins. More...
 
QRect contentsRect () const
 Returns the area inside the widget's margins. More...
 
Qt::ContextMenuPolicy contextMenuPolicy () const
 
void createWinId ()
 
QCursor cursor () const
 
int devType () const
 
WId effectiveWinId () const
 Returns the effective window system identifier of the widget, i. More...
 
void ensurePolished () const
 Ensures that the widget has been polished by QStyle (i.e., has a proper font and palette). More...
 
Qt::FocusPolicy focusPolicy () const
 
QWidgetfocusProxy () const
 Returns the focus proxy, or 0 if there is no focus proxy. More...
 
QWidgetfocusWidget () const
 Returns the last child of this widget that setFocus had been called on. More...
 
const QFontfont () const
 
QFontInfo fontInfo () const
 Returns the font info for the widget's current font. More...
 
QFontMetrics fontMetrics () const
 Returns the font metrics for the widget's current font. More...
 
QPalette::ColorRole foregroundRole () const
 Returns the foreground role. More...
 
QRect frameGeometry () const
 
QSize frameSize () const
 
const QRectgeometry () const
 
void getContentsMargins (int *left, int *top, int *right, int *bottom) const
 Returns the widget's contents margins for left, top, right, and bottom. More...
 
HDC getDC () const
 Returns the window system handle of the widget, for low-level access. More...
 
void grabGesture (Qt::GestureType type, Qt::GestureFlags flags=Qt::GestureFlags())
 Subscribes the widget to a given gesture with specific flags. More...
 
void grabKeyboard ()
 Grabs the keyboard input. More...
 
void grabMouse ()
 Grabs the mouse input. More...
 
void grabMouse (const QCursor &)
 
int grabShortcut (const QKeySequence &key, Qt::ShortcutContext context=Qt::WindowShortcut)
 Adds a shortcut to Qt's shortcut system that watches for the given key sequence in the given context. More...
 
QGraphicsEffectgraphicsEffect () const
 The graphicsEffect function returns a pointer to the widget's graphics effect. More...
 
QGraphicsProxyWidgetgraphicsProxyWidget () const
 Returns the proxy widget for the corresponding embedded widget in a graphics view; otherwise returns 0. More...
 
bool hasFocus () const
 
bool hasMouseTracking () const
 
int height () const
 
virtual int heightForWidth (int) const
 Returns the preferred height for this widget, given the width w. More...
 
QInputContextinputContext ()
 This function returns the QInputContext for this widget. More...
 
Qt::InputMethodHints inputMethodHints () const
 
void insertAction (QAction *before, QAction *action)
 Inserts the action action to this widget's list of actions, before the action before. More...
 
void insertActions (QAction *before, QList< QAction *> actions)
 Inserts the actions actions to this widget's list of actions, before the action before. More...
 
WId internalWinId () const
 Returns the window system identifier of the widget, or 0 if the widget is not created yet. More...
 
bool isActiveWindow () const
 
bool isAncestorOf (const QWidget *child) const
 Returns true if this widget is a parent, (or grandparent and so on to any level), of the given child, and both widgets are within the same window; otherwise returns false. More...
 
bool isEnabled () const
 
bool isEnabledTo (QWidget *) const
 Returns true if this widget would become enabled if ancestor is enabled; otherwise returns false. More...
 
bool isEnabledToTLW () const
 This function is deprecated. More...
 
bool isFullScreen () const
 
bool isHidden () const
 Returns true if the widget is hidden, otherwise returns false. More...
 
bool isLeftToRight () const
 
bool isMaximized () const
 
bool isMinimized () const
 
bool isModal () const
 
bool isRightToLeft () const
 
bool isTopLevel () const
 Use isWindow() instead. More...
 
bool isVisible () const
 
bool isVisibleTo (QWidget *) const
 Returns true if this widget would become visible if ancestor is shown; otherwise returns false. More...
 
bool isWindow () const
 Returns true if the widget is an independent window, otherwise returns false. More...
 
bool isWindowModified () const
 
QLayoutlayout () const
 Returns the layout manager that is installed on this widget, or 0 if no layout manager is installed. More...
 
Qt::LayoutDirection layoutDirection () const
 
QLocale locale () const
 
Qt::HANDLE macCGHandle () const
 Returns the CoreGraphics handle of the widget. More...
 
Qt::HANDLE macQDHandle () const
 Returns the QuickDraw handle of the widget. More...
 
QPoint mapFrom (QWidget *, const QPoint &) const
 Translates the widget coordinate pos from the coordinate system of parent to this widget's coordinate system. More...
 
QPoint mapFromGlobal (const QPoint &) const
 Translates the global screen coordinate pos to widget coordinates. More...
 
QPoint mapFromParent (const QPoint &) const
 Translates the parent widget coordinate pos to widget coordinates. More...
 
QPoint mapTo (QWidget *, const QPoint &) const
 Translates the widget coordinate pos to the coordinate system of parent. More...
 
QPoint mapToGlobal (const QPoint &) const
 Translates the widget coordinate pos to global screen coordinates. More...
 
QPoint mapToParent (const QPoint &) const
 Translates the widget coordinate pos to a coordinate in the parent widget. More...
 
QRegion mask () const
 Returns the mask currently set on a widget. More...
 
int maximumHeight () const
 
QSize maximumSize () const
 
int maximumWidth () const
 
int minimumHeight () const
 
QSize minimumSize () const
 
int minimumWidth () const
 
void move (int x, int y)
 This corresponds to move(QPoint(x, y)). More...
 
void move (const QPoint &)
 
QWidgetnativeParentWidget () const
 Returns the native parent for this widget, i. More...
 
QWidgetnextInFocusChain () const
 Returns the next widget in this widget's focus chain. More...
 
QRect normalGeometry () const
 
void overrideWindowFlags (Qt::WindowFlags type)
 Sets the window flags for the widget to flags, without telling the window system. More...
 
void overrideWindowState (Qt::WindowStates state)
 
QPaintEnginepaintEngine () const
 Returns the widget's paint engine. More...
 
const QPalettepalette () const
 
QWidgetparentWidget () const
 Returns the parent of this widget, or 0 if it does not have any parent widget. More...
 
QPoint pos () const
 
QWidgetpreviousInFocusChain () const
 The previousInFocusChain function returns the previous widget in this widget's focus chain. More...
 
 QWidget (QWidget *parent=0, Qt::WindowFlags f=0)
 Constructs a widget which is a child of parent, with widget flags set to f. More...
 
QRect rect () const
 
void releaseDC (HDC) const
 Releases the HDC hdc acquired by a previous call to getDC(). More...
 
void releaseKeyboard ()
 Releases the keyboard grab. More...
 
void releaseMouse ()
 Releases the mouse grab. More...
 
void releaseShortcut (int id)
 Removes the shortcut with the given id from Qt's shortcut system. More...
 
void removeAction (QAction *action)
 Removes the action action from this widget's list of actions. More...
 
void render (QPaintDevice *target, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren))
 Renders the sourceRegion of this widget into the target using renderFlags to determine how to render. More...
 
void render (QPainter *painter, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren))
 Renders the widget into the painter's QPainter::device(). More...
 
void repaint (int x, int y, int w, int h)
 This version repaints a rectangle (x, y, w, h) inside the widget. More...
 
void repaint (const QRect &)
 This version repaints a rectangle rect inside the widget. More...
 
void repaint (const QRegion &)
 This version repaints a region rgn inside the widget. More...
 
void resize (int w, int h)
 This corresponds to resize(QSize(w, h)). More...
 
void resize (const QSize &)
 
bool restoreGeometry (const QByteArray &geometry)
 Restores the geometry and state top-level widgets stored in the byte array geometry. More...
 
QByteArray saveGeometry () const
 Saves the current geometry and state for top-level widgets. More...
 
void scroll (int dx, int dy)
 Scrolls the widget including its children dx pixels to the right and dy downward. More...
 
void scroll (int dx, int dy, const QRect &)
 This version only scrolls r and does not move the children of the widget. More...
 
void setAcceptDrops (bool on)
 
void setAccessibleDescription (const QString &description)
 
void setAccessibleName (const QString &name)
 
void setAttribute (Qt::WidgetAttribute, bool on=true)
 Sets the attribute attribute on this widget if on is true; otherwise clears the attribute. More...
 
void setAutoFillBackground (bool enabled)
 
void setBackgroundRole (QPalette::ColorRole)
 Sets the background role of the widget to role. More...
 
void setBaseSize (const QSize &)
 
void setBaseSize (int basew, int baseh)
 This corresponds to setBaseSize(QSize(basew, baseh)). More...
 
void setContentsMargins (int left, int top, int right, int bottom)
 Sets the margins around the contents of the widget to have the sizes left, top, right, and bottom. More...
 
void setContentsMargins (const QMargins &margins)
 The setContentsMargins function sets the margins around the widget's contents. More...
 
void setContextMenuPolicy (Qt::ContextMenuPolicy policy)
 
void setCursor (const QCursor &)
 
void setFixedHeight (int h)
 Sets both the minimum and maximum heights of the widget to h without changing the widths. More...
 
void setFixedSize (const QSize &)
 Sets both the minimum and maximum sizes of the widget to s, thereby preventing it from ever growing or shrinking. More...
 
void setFixedSize (int w, int h)
 Sets the width of the widget to w and the height to h. More...
 
void setFixedWidth (int w)
 Sets both the minimum and maximum width of the widget to w without changing the heights. More...
 
void setFocus (Qt::FocusReason reason)
 Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. More...
 
void setFocusPolicy (Qt::FocusPolicy policy)
 
void setFocusProxy (QWidget *)
 Sets the widget's focus proxy to widget w. More...
 
void setFont (const QFont &)
 Use the single-argument overload instead. More...
 
void setForegroundRole (QPalette::ColorRole)
 Sets the foreground role of the widget to role. More...
 
void setGeometry (int x, int y, int w, int h)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.This corresponds to setGeometry(QRect(x, y, w, h)). More...
 
void setGeometry (const QRect &)
 
void setGraphicsEffect (QGraphicsEffect *effect)
 The setGraphicsEffect function is for setting the widget's graphics effect. More...
 
void setInputContext (QInputContext *)
 This function sets the input context context on this widget. More...
 
void setInputMethodHints (Qt::InputMethodHints hints)
 
void setLayout (QLayout *)
 Sets the layout manager for this widget to layout. More...
 
void setLayoutDirection (Qt::LayoutDirection direction)
 
void setLocale (const QLocale &locale)
 
void setMask (const QBitmap &)
 Causes only the pixels of the widget for which bitmap has a corresponding 1 bit to be visible. More...
 
void setMask (const QRegion &)
 Causes only the parts of the widget which overlap region to be visible. More...
 
void setMaximumHeight (int maxh)
 
void setMaximumSize (const QSize &)
 
void setMaximumSize (int maxw, int maxh)
 This function corresponds to setMaximumSize(QSize(maxw, maxh)). More...
 
void setMaximumWidth (int maxw)
 
void setMinimumHeight (int minh)
 
void setMinimumSize (const QSize &)
 
void setMinimumSize (int minw, int minh)
 This function corresponds to setMinimumSize(QSize(minw, minh)). More...
 
void setMinimumWidth (int minw)
 
void setMouseTracking (bool enable)
 
void setPalette (const QPalette &)
 Use the single-argument overload instead. More...
 
void setParent (QWidget *parent)
 Sets the parent of the widget to parent, and resets the window flags. More...
 
void setParent (QWidget *parent, Qt::WindowFlags f)
 This function also takes widget flags, f as an argument. More...
 
void setShortcutAutoRepeat (int id, bool enable=true)
 If enable is true, auto repeat of the shortcut with the given id is enabled; otherwise it is disabled. More...
 
void setShortcutEnabled (int id, bool enable=true)
 If enable is true, the shortcut with the given id is enabled; otherwise the shortcut is disabled. More...
 
void setSizeIncrement (const QSize &)
 
void setSizeIncrement (int w, int h)
 Sets the x (width) size increment to w and the y (height) size increment to h. More...
 
void setSizePolicy (QSizePolicy)
 
void setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)
 Sets the size policy of the widget to horizontal and vertical, with standard stretch and no height-for-width. More...
 
void setStatusTip (const QString &)
 
void setStyle (QStyle *)
 Sets the widget's GUI style to style. More...
 
void setToolTip (const QString &)
 
void setUpdatesEnabled (bool enable)
 
void setupUi (QWidget *widget)
 Sets up the user interface for the specified widget. More...
 
void setWhatsThis (const QString &)
 
void setWindowFilePath (const QString &filePath)
 
void setWindowFlags (Qt::WindowFlags type)
 
void setWindowIcon (const QIcon &icon)
 
void setWindowIconText (const QString &)
 
void setWindowModality (Qt::WindowModality windowModality)
 
void setWindowOpacity (qreal level)
 
void setWindowRole (const QString &)
 Sets the window's role to role. More...
 
void setWindowState (Qt::WindowStates state)
 Sets the window state to windowState. More...
 
void setWindowSurface (QWindowSurface *surface)
 Sets the window surface to be the surface specified. More...
 
QSize size () const
 
QSize sizeIncrement () const
 
QSizePolicy sizePolicy () const
 
void stackUnder (QWidget *)
 Places the widget under w in the parent widget's stack. More...
 
QString statusTip () const
 
QStylestyle () const
 
QString styleSheet () const
 
bool testAttribute (Qt::WidgetAttribute) const
 Returns true if attribute attribute is set on this widget; otherwise returns false. More...
 
QString toolTip () const
 
QWidgettopLevelWidget () const
 
bool underMouse () const
 Returns true if the widget is under the mouse cursor; otherwise returns false. More...
 
void ungrabGesture (Qt::GestureType type)
 Unsubscribes the widget from a given gesture type. More...
 
void unsetCursor ()
 
void unsetLayoutDirection ()
 
void unsetLocale ()
 
void update (int x, int y, int w, int h)
 This version updates a rectangle (x, y, w, h) inside the widget. More...
 
void update (const QRect &)
 This version updates a rectangle rect inside the widget. More...
 
void update (const QRegion &)
 This version repaints a region rgn inside the widget. More...
 
void updateGeometry ()
 Notifies the layout system that this widget has changed and may need to change geometry. More...
 
bool updatesEnabled () const
 
QRegion visibleRegion () const
 Returns the unobscured region where paint events can occur. More...
 
QString whatsThis () const
 
int width () const
 
QWidgetwindow () const
 Returns the window for this widget, i.e. More...
 
QString windowFilePath () const
 
Qt::WindowFlags windowFlags () const
 Window flags are a combination of a type (e. More...
 
QIcon windowIcon () const
 
QString windowIconText () const
 
Qt::WindowModality windowModality () const
 
qreal windowOpacity () const
 
QString windowRole () const
 Returns the window's role, or an empty string. More...
 
Qt::WindowStates windowState () const
 Returns the current window state. More...
 
QWindowSurfacewindowSurface () const
 Returns the QWindowSurface this widget will be drawn into. More...
 
QString windowTitle () const
 
Qt::WindowType windowType () const
 Returns the window type of this widget. More...
 
WId winId () const
 Returns the window system identifier of the widget. More...
 
int x () const
 
const QX11Infox11Info () const
 Returns information about the configuration of the X display used to display the widget. More...
 
Qt::HANDLE x11PictureHandle () const
 Returns the X11 Picture handle of the widget for XRender support. More...
 
int y () const
 
 ~QWidget ()
 Destroys the widget. More...
 
- Public Functions inherited from QObject
bool blockSignals (bool b)
 If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More...
 
const QObjectListchildren () const
 Returns a list of child objects. More...
 
bool connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0)
 
bool disconnect (const QObject *receiver, const char *member=0)
 
void dumpObjectInfo ()
 Dumps information about signal connections, etc. More...
 
void dumpObjectTree ()
 Dumps a tree of children to the debug output. More...
 
QList< QByteArraydynamicPropertyNames () const
 Returns the names of all properties that were dynamically added to the object using setProperty(). More...
 
virtual bool eventFilter (QObject *, QEvent *)
 Filters events if this object has been installed as an event filter for the watched object. More...
 
template<typename T >
findChild (const QString &aName=QString()) const
 Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More...
 
template<typename T >
QList< T > findChildren (const QString &aName=QString()) const
 Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More...
 
template<typename T >
QList< T > findChildren (const QRegExp &re) const
 
bool inherits (const char *classname) const
 Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More...
 
void installEventFilter (QObject *)
 Installs an event filter filterObj on this object. More...
 
bool isWidgetType () const
 Returns true if the object is a widget; otherwise returns false. More...
 
void killTimer (int id)
 Kills the timer with timer identifier, id. More...
 
virtual const QMetaObjectmetaObject () const
 Returns a pointer to the meta-object of this object. More...
 
void moveToThread (QThread *thread)
 Changes the thread affinity for this object and its children. More...
 
QString objectName () const
 
QObjectparent () const
 Returns a pointer to the parent object. More...
 
QVariant property (const char *name) const
 Returns the value of the object's name property. More...
 
Q_INVOKABLE QObject (QObject *parent=0)
 Constructs an object with parent object parent. More...
 
void removeEventFilter (QObject *)
 Removes an event filter object obj from this object. More...
 
void setObjectName (const QString &name)
 
void setParent (QObject *)
 Makes the object a child of parent. More...
 
bool setProperty (const char *name, const QVariant &value)
 Sets the value of the object's name property to value. More...
 
void setUserData (uint id, QObjectUserData *data)
 
bool signalsBlocked () const
 Returns true if signals are blocked; otherwise returns false. More...
 
int startTimer (int interval)
 Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More...
 
QThreadthread () const
 Returns the thread in which the object lives. More...
 
QObjectUserDatauserData (uint id) const
 
virtual ~QObject ()
 Destroys the object, deleting all its child objects. More...
 
- Public Functions inherited from QPaintDevice
int colorCount () const
 
int depth () const
 
int height () const
 
int heightMM () const
 
int logicalDpiX () const
 
int logicalDpiY () const
 
QT_DEPRECATED int numColors () const
 
bool paintingActive () const
 
int physicalDpiX () const
 
int physicalDpiY () const
 
int width () const
 
int widthMM () const
 
virtual ~QPaintDevice ()
 

Protected Functions

QSize contentsSize () const
 
void currentChanged (const QModelIndex &current, const QModelIndex &previous)
 Reimplemented Function More...
 
void dataChanged (const QModelIndex &topLeft, const QModelIndex &bottomRight)
 Reimplemented Function More...
 
void dragLeaveEvent (QDragLeaveEvent *e)
 Reimplemented Function More...
 
void dragMoveEvent (QDragMoveEvent *e)
 Reimplemented Function More...
 
void dropEvent (QDropEvent *e)
 Reimplemented Function More...
 
bool event (QEvent *e)
 Reimplemented Function More...
 
int horizontalOffset () const
 Reimplemented Function More...
 
void internalDrag (Qt::DropActions supportedActions)
 Called whenever the user starts dragging items and the items are movable, enabling internal dragging and dropping of items. More...
 
void internalDrop (QDropEvent *e)
 Called whenever items from the view is dropped on the viewport. More...
 
bool isIndexHidden (const QModelIndex &index) const
 Reimplemented Function More...
 
void mouseMoveEvent (QMouseEvent *e)
 Reimplemented Function More...
 
void mouseReleaseEvent (QMouseEvent *e)
 Reimplemented Function More...
 
QModelIndex moveCursor (CursorAction cursorAction, Qt::KeyboardModifiers modifiers)
 Reimplemented Function More...
 
void paintEvent (QPaintEvent *e)
 Reimplemented Function More...
 
 QListView (QListViewPrivate &, QWidget *parent=0)
 
QRect rectForIndex (const QModelIndex &index) const
 Returns the rectangle of the item at position index in the model. More...
 
void resizeContents (int width, int height)
 Resize the internal contents to width and height and set the scroll bar ranges accordingly. More...
 
void resizeEvent (QResizeEvent *e)
 Reimplemented Function More...
 
void rowsAboutToBeRemoved (const QModelIndex &parent, int start, int end)
 Reimplemented Function More...
 
void rowsInserted (const QModelIndex &parent, int start, int end)
 Reimplemented Function More...
 
void scrollContentsBy (int dx, int dy)
 Scroll the view contents by dx and dy. More...
 
QModelIndexList selectedIndexes () const
 Reimplemented Function More...
 
void selectionChanged (const QItemSelection &selected, const QItemSelection &deselected)
 Reimplemented Function More...
 
void setPositionForIndex (const QPoint &position, const QModelIndex &index)
 Sets the contents position of the item at index in the model to the given position. More...
 
void setSelection (const QRect &rect, QItemSelectionModel::SelectionFlags command)
 Reimplemented Function More...
 
void startDrag (Qt::DropActions supportedActions)
 Reimplemented Function More...
 
void timerEvent (QTimerEvent *e)
 Reimplemented Function More...
 
void updateGeometries ()
 Reimplemented Function More...
 
int verticalOffset () const
 Reimplemented Function More...
 
QStyleOptionViewItem viewOptions () const
 Reimplemented Function More...
 
QRegion visualRegionForSelection (const QItemSelection &selection) const
 Since 4. More...
 
- Protected Functions inherited from QAbstractItemView
QPoint dirtyRegionOffset () const
 Returns the offset of the dirty regions in the view. More...
 
void doAutoScroll ()
 
void dragEnterEvent (QDragEnterEvent *event)
 This function is called with the given event when a drag and drop operation enters the widget. More...
 
DropIndicatorPosition dropIndicatorPosition () const
 Returns the position of the drop indicator in relation to the closest item. More...
 
virtual bool edit (const QModelIndex &index, EditTrigger trigger, QEvent *event)
 Starts editing the item at index, creating an editor if necessary, and returns true if the view's State is now EditingState; otherwise returns false. More...
 
void executeDelayedItemsLayout ()
 Executes the scheduled layouts without waiting for the event processing to begin. More...
 
void focusInEvent (QFocusEvent *event)
 This function is called with the given event when the widget obtains the focus. More...
 
bool focusNextPrevChild (bool next)
 Reimplemented Function More...
 
void focusOutEvent (QFocusEvent *event)
 This function is called with the given event when the widget looses the focus. More...
 
int horizontalStepsPerItem () const
 Returns the horizontal scroll bar's steps per item. More...
 
void inputMethodEvent (QInputMethodEvent *event)
 Reimplemented Function More...
 
void keyPressEvent (QKeyEvent *event)
 This function is called with the given event when a key event is sent to the widget. More...
 
void mouseDoubleClickEvent (QMouseEvent *event)
 This function is called with the given event when a mouse button is double clicked inside the widget. More...
 
void mousePressEvent (QMouseEvent *event)
 This function is called with the given event when a mouse button is pressed while the cursor is inside the widget. More...
 
 QAbstractItemView (QAbstractItemViewPrivate &, QWidget *parent=0)
 
void scheduleDelayedItemsLayout ()
 Schedules a layout of the items in the view to be executed when the event processing starts. More...
 
void scrollDirtyRegion (int dx, int dy)
 Prepares the view for scrolling by ({dx},{dy}) pixels by moving the dirty regions in the opposite direction. More...
 
virtual QItemSelectionModel::SelectionFlags selectionCommand (const QModelIndex &index, const QEvent *event=0) const
 Returns the SelectionFlags to be used when updating a selection with to include the index specified. More...
 
void setDirtyRegion (const QRegion &region)
 Marks the given region as dirty and schedules it to be updated. More...
 
void setHorizontalStepsPerItem (int steps)
 Sets the horizontal scroll bar's steps per item to steps. More...
 
void setState (State state)
 Sets the item view's state to the given state. More...
 
void setVerticalStepsPerItem (int steps)
 Sets the vertical scroll bar's steps per item to steps. More...
 
void startAutoScroll ()
 
State state () const
 Returns the item view's state. More...
 
void stopAutoScroll ()
 
int verticalStepsPerItem () const
 Returns the vertical scroll bar's steps per item. More...
 
bool viewportEvent (QEvent *event)
 This function is used to handle tool tips, and What's This? mode, if the given event is a QEvent::ToolTip,or a QEvent::WhatsThis. More...
 
- Protected Functions inherited from QAbstractScrollArea
void contextMenuEvent (QContextMenuEvent *)
 This event handler can be reimplemented in a subclass to receive context menu events for the viewport() widget. More...
 
void dragEnterEvent (QDragEnterEvent *)
 This event handler can be reimplemented in a subclass to receive drag enter events (passed in event), for the viewport() widget. More...
 
void dragLeaveEvent (QDragLeaveEvent *)
 This event handler can be reimplemented in a subclass to receive drag leave events (passed in event), for the viewport() widget. More...
 
void dragMoveEvent (QDragMoveEvent *)
 This event handler can be reimplemented in a subclass to receive drag move events (passed in event), for the viewport() widget. More...
 
void dropEvent (QDropEvent *)
 This event handler can be reimplemented in a subclass to receive drop events (passed in event), for the viewport() widget. More...
 
bool event (QEvent *)
 Reimplemented Function More...
 
void keyPressEvent (QKeyEvent *)
 This function is called with key event e when key presses occur. More...
 
void mouseDoubleClickEvent (QMouseEvent *)
 This event handler can be reimplemented in a subclass to receive mouse double click events for the viewport() widget. More...
 
void mouseMoveEvent (QMouseEvent *)
 This event handler can be reimplemented in a subclass to receive mouse move events for the viewport() widget. More...
 
void mousePressEvent (QMouseEvent *)
 This event handler can be reimplemented in a subclass to receive mouse press events for the viewport() widget. More...
 
void mouseReleaseEvent (QMouseEvent *)
 This event handler can be reimplemented in a subclass to receive mouse release events for the viewport() widget. More...
 
void paintEvent (QPaintEvent *)
 This event handler can be reimplemented in a subclass to receive paint events (passed in event), for the viewport() widget. More...
 
 QAbstractScrollArea (QAbstractScrollAreaPrivate &dd, QWidget *parent=0)
 Creates a new QAbstractScrollAreaPrivate, dd with the given parent. More...
 
void resizeEvent (QResizeEvent *)
 This event handler can be reimplemented in a subclass to receive resize events (passed in event), for the viewport() widget. More...
 
void setViewportMargins (int left, int top, int right, int bottom)
 Sets the margins around the scrolling area to left, top, right and bottom. More...
 
void setViewportMargins (const QMargins &margins)
 Sets margins around the scrolling area. More...
 
void wheelEvent (QWheelEvent *)
 This event handler can be reimplemented in a subclass to receive wheel events for the viewport() widget. More...
 
- Protected Functions inherited from QFrame
void changeEvent (QEvent *)
 This event handler can be reimplemented to handle state changes. More...
 
void drawFrame (QPainter *)
 em>Reimplemented Function More...
 
bool event (QEvent *e)
 Reimplemented Function More...
 
void paintEvent (QPaintEvent *)
 This event handler can be reimplemented in a subclass to receive paint events passed in event. More...
 
 QFrame (QFramePrivate &dd, QWidget *parent=0, Qt::WindowFlags f=0)
 
- Protected Functions inherited from QWidget
virtual void actionEvent (QActionEvent *)
 This event handler is called with the given event whenever the widget's actions are changed. More...
 
virtual void closeEvent (QCloseEvent *)
 This event handler is called with the given event when Qt receives a window close request for a top-level widget from the window system. More...
 
void create (WId=0, bool initializeWindow=true, bool destroyOldWindow=true)
 Creates a new widget window if window is 0, otherwise sets the widget's window to window. More...
 
void destroy (bool destroyWindow=true, bool destroySubWindows=true)
 Frees up window system resources. More...
 
virtual void enabledChange (bool)
 
virtual void enterEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive widget enter events which are passed in the event parameter. More...
 
bool focusNextChild ()
 Finds a new widget to give the keyboard focus to, as appropriate for Tab, and returns true if it can find a new widget, or false if it can't. More...
 
bool focusPreviousChild ()
 Finds a new widget to give the keyboard focus to, as appropriate for Shift+Tab, and returns true if it can find a new widget, or false if it can't. More...
 
virtual void fontChange (const QFont &)
 
virtual void hideEvent (QHideEvent *)
 This event handler can be reimplemented in a subclass to receive widget hide events. More...
 
virtual void keyReleaseEvent (QKeyEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive key release events for the widget. More...
 
virtual void languageChange ()
 
virtual void leaveEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive widget leave events which are passed in the event parameter. More...
 
virtual bool macEvent (EventHandlerCallRef, EventRef)
 This special event handler can be reimplemented in a subclass to receive native Macintosh events. More...
 
int metric (PaintDeviceMetric) const
 Internal implementation of the virtual QPaintDevice::metric() function. More...
 
virtual void moveEvent (QMoveEvent *)
 This event handler can be reimplemented in a subclass to receive widget move events which are passed in the event parameter. More...
 
virtual void paletteChange (const QPalette &)
 
 QWidget (QWidgetPrivate &d, QWidget *parent, Qt::WindowFlags f)
 
virtual bool qwsEvent (QWSEvent *)
 This special event handler can be reimplemented in a subclass to receive native Qt for Embedded Linux events which are passed in the event parameter. More...
 
void resetInputContext ()
 This function can be called on the widget that currently has focus to reset the input method operating on it. More...
 
virtual void showEvent (QShowEvent *)
 This event handler can be reimplemented in a subclass to receive widget show events which are passed in the event parameter. More...
 
virtual void styleChange (QStyle &)
 
virtual void tabletEvent (QTabletEvent *)
 This event handler, for event event, can be reimplemented in a subclass to receive tablet events for the widget. More...
 
virtual void windowActivationChange (bool)
 
virtual bool winEvent (MSG *message, long *result)
 This special event handler can be reimplemented in a subclass to receive native Windows events which are passed in the message parameter. More...
 
virtual bool x11Event (XEvent *)
 This special event handler can be reimplemented in a subclass to receive native X11 events passed in the event parameter. More...
 
- Protected Functions inherited from QObject
virtual void childEvent (QChildEvent *)
 This event handler can be reimplemented in a subclass to receive child events. More...
 
virtual void connectNotify (const char *signal)
 This virtual function is called when something has been connected to signal in this object. More...
 
virtual void customEvent (QEvent *)
 This event handler can be reimplemented in a subclass to receive custom events. More...
 
virtual void disconnectNotify (const char *signal)
 This virtual function is called when something has been disconnected from signal in this object. More...
 
 QObject (QObjectPrivate &dd, QObject *parent=0)
 
int receivers (const char *signal) const
 Returns the number of receivers connected to the signal. More...
 
QObjectsender () const
 Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More...
 
int senderSignalIndex () const
 
- Protected Functions inherited from QPaintDevice
 QPaintDevice ()
 

Private Functions

int visualIndex (const QModelIndex &index) const
 

Properties

int batchSize
 the number of items laid out in each batch if layoutMode is set to Batched More...
 
Flow flow
 which direction the items layout should flow. More...
 
QSize gridSize
 the size of the layout grid More...
 
bool isWrapping
 whether the items layout should wrap. More...
 
LayoutMode layoutMode
 determines whether the layout of items should happen immediately or be delayed. More...
 
int modelColumn
 the column in the model that is visible More...
 
Movement movement
 whether the items can be moved freely, are snapped to a grid, or cannot be moved at all. More...
 
ResizeMode resizeMode
 whether the items are laid out again when the view is resized. More...
 
bool selectionRectVisible
 if the selection rectangle should be visible More...
 
int spacing
 the space around the items in the layout More...
 
bool uniformItemSizes
 whether all items in the listview have the same size More...
 
ViewMode viewMode
 the view mode of the QListView. More...
 
bool wordWrap
 the item text word-wrapping policy More...
 

Friends

class QAccessibleItemView
 

Additional Inherited Members

- Public Slots inherited from QAbstractItemView
void clearSelection ()
 Deselects all selected items. More...
 
void edit (const QModelIndex &index)
 Starts editing the item corresponding to the given index if it is editable. More...
 
void scrollToBottom ()
 Scrolls the view to the bottom. More...
 
void scrollToTop ()
 Scrolls the view to the top. More...
 
virtual void selectAll ()
 Selects all items in the view. More...
 
void setCurrentIndex (const QModelIndex &index)
 Sets the current item to be the item at index. More...
 
void update (const QModelIndex &index)
 Updates the area occupied by the given index. More...
 
- Public Slots inherited from QWidget
bool close ()
 Closes this widget. More...
 
void hide ()
 Hides the widget. More...
 
void lower ()
 Lowers the widget to the bottom of the parent widget's stack. More...
 
void raise ()
 Raises this widget to the top of the parent widget's stack. More...
 
void repaint ()
 Repaints the widget directly by calling paintEvent() immediately, unless updates are disabled or the widget is hidden. More...
 
void setDisabled (bool)
 Disables widget input events if disable is true; otherwise enables input events. More...
 
void setEnabled (bool)
 
void setFocus ()
 Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. More...
 
void setHidden (bool hidden)
 Convenience function, equivalent to setVisible(!hidden). More...
 
QT_MOC_COMPAT void setShown (bool shown)
 Use setVisible(shown) instead. More...
 
void setStyleSheet (const QString &styleSheet)
 
virtual void setVisible (bool visible)
 
void setWindowModified (bool)
 
void setWindowTitle (const QString &)
 
void show ()
 Shows the widget and its child widgets. More...
 
void showFullScreen ()
 Shows the widget in full-screen mode. More...
 
void showMaximized ()
 Shows the widget maximized. More...
 
void showMinimized ()
 Shows the widget minimized, as an icon. More...
 
void showNormal ()
 Restores the widget after it has been maximized or minimized. More...
 
void update ()
 Updates the widget unless updates are disabled or the widget is hidden. More...
 
- Public Slots inherited from QObject
void deleteLater ()
 Schedules this object for deletion. More...
 
- Static Public Functions inherited from QWidget
static QWidgetfind (WId)
 Returns a pointer to the widget with window identifer/handle id. More...
 
static QWidgetkeyboardGrabber ()
 Returns the widget that is currently grabbing the keyboard input. More...
 
static QWidgetmouseGrabber ()
 Returns the widget that is currently grabbing the mouse input. More...
 
static void setTabOrder (QWidget *, QWidget *)
 Puts the second widget after the first widget in the focus order. More...
 
- Static Public Functions inherited from QObject
static bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More...
 
static bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 Disconnects signal in object sender from method in object receiver. More...
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static uint registerUserData ()
 
static QString tr (const char *sourceText, const char *comment=0, int n=-1)
 
static QString trUtf8 (const char *sourceText, const char *comment=0, int n=-1)
 
- Static Public Functions inherited from QPaintDevice
static QWSDisplayqwsDisplay ()
 
- Static Public Variables inherited from QObject
static const QMetaObject staticMetaObject
 This variable stores the meta-object for the class. More...
 
- Protected Types inherited from QAbstractItemView
enum  CursorAction {
  MoveUp, MoveDown, MoveLeft, MoveRight,
  MoveHome, MoveEnd, MovePageUp, MovePageDown,
  MoveNext, MovePrevious
}
 This enum describes the different ways to navigate between items,. More...
 
enum  DropIndicatorPosition { OnItem, AboveItem, BelowItem, OnViewport }
 This enum indicates the position of the drop indicator in relation to the index at the current mouse position: More...
 
enum  State {
  NoState, DraggingState, DragSelectingState, EditingState,
  ExpandingState, CollapsingState, AnimatingState
}
 Describes the different states the view can be in. More...
 
- Protected Slots inherited from QAbstractItemView
virtual void closeEditor (QWidget *editor, QAbstractItemDelegate::EndEditHint hint)
 Closes the given editor, and releases it. More...
 
virtual void commitData (QWidget *editor)
 Commit the data in the editor to the model. More...
 
virtual void editorDestroyed (QObject *editor)
 This function is called when the given editor has been destroyed. More...
 
virtual void horizontalScrollbarAction (int action)
 
virtual void horizontalScrollbarValueChanged (int value)
 
virtual void updateEditorData ()
 Updates the data shown in the open editor widgets in the view. More...
 
virtual void updateEditorGeometries ()
 Updates the geometry of the open editor widgets in the view. More...
 
virtual void verticalScrollbarAction (int action)
 
virtual void verticalScrollbarValueChanged (int value)
 
- Protected Slots inherited from QAbstractScrollArea
void setupViewport (QWidget *viewport)
 This slot is called by QAbstractScrollArea after setViewport(viewport) has been called. More...
 
- Protected Slots inherited from QWidget
void updateMicroFocus ()
 Updates the widget's micro focus. More...
 
- Protected Variables inherited from QObject
QScopedPointer< QObjectDatad_ptr
 
- Protected Variables inherited from QPaintDevice
ushort painters
 
- Static Protected Variables inherited from QObject
static const QMetaObject staticQtMetaObject
 

Detailed Description

The QListView class provides a list or icon view onto a model.

A QListView presents items stored in a model, either as a simple non-hierarchical list, or as a collection of icons. This class is used to provide lists and icon views that were previously provided by the QListBox and QIconView classes, but using the more flexible approach provided by Qt's model/view architecture.

The QListView class is one of the Model/View Classes and is part of Qt's Model/View Programming{model/view framework}.

This view does not display horizontal or vertical headers; to display a list of items with a horizontal header, use QTreeView instead.

QListView implements the interfaces defined by the QAbstractItemView class to allow it to display data provided by models derived from the QAbstractItemModel class.

Items in a list view can be displayed using one of two view modes: In ListMode , the items are displayed in the form of a simple list; in IconMode , the list view takes the form of an icon view in which the items are displayed with icons like files in a file manager. By default, the list view is in ListMode . To change the view mode, use the setViewMode() function, and to determine the current view mode, use viewMode().

Items in these views are laid out in the direction specified by the flow() of the list view. The items may be fixed in place, or allowed to move, depending on the view's movement() state.

If the items in the model cannot be completely laid out in the direction of flow, they can be wrapped at the boundary of the view widget; this depends on isWrapping(). This property is useful when the items are being represented by an icon view.

The resizeMode() and layoutMode() govern how and when the items are laid out. Items are spaced according to their spacing(), and can exist within a notional grid of size specified by gridSize(). The items can be rendered as large or small icons depending on their iconSize().

windowsxp-listview.png
Screenshot of a Windows XP style list view
macintosh-listview.png
Screenshot of a Macintosh style table view
plastique-listview.png
Screenshot of a Plastique style table view
A Windows XP Style Widget Gallery{Windows XP style} list view. A Macintosh Style Widget Gallery{Macintosh style} list view. A Plastique Style Widget Gallery{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, QListWidget

Definition at line 57 of file qlistview.h.

Enumerations

◆ Flow

  • LeftToRight The items are laid out in the view from the left to the right.
  • TopToBottom The items are laid out in the view from the top to the bottom.
Enumerator
LeftToRight 
TopToBottom 

Definition at line 77 of file qlistview.h.

◆ LayoutMode

  • SinglePass The items are laid out all at once.
  • Batched The items are laid out in batches of batchSize items.
    See also
    batchSize
Enumerator
SinglePass 
Batched 

Definition at line 79 of file qlistview.h.

◆ Movement

  • Static The items cannot be moved by the user.
  • Free The items can be moved freely by the user.
  • Snap The items snap to the specified grid when moved; see setGridSize().
Enumerator
Static 
Free 
Snap 

Definition at line 76 of file qlistview.h.

◆ ResizeMode

  • Fixed The items will only be laid out the first time the view is shown.
  • Adjust The items will be laid out every time the view is resized.
Enumerator
Fixed 
Adjust 

Definition at line 78 of file qlistview.h.

◆ ViewMode

  • ListMode The items are laid out using TopToBottom flow, with Small size and Static movement
  • IconMode The items are laid out using LeftToRight flow, with Large size and Free movement
Enumerator
ListMode 
IconMode 

Definition at line 80 of file qlistview.h.

Constructors and Destructors

◆ QListView() [1/2]

QListView::QListView ( QWidget parent = 0)
explicit

Creates a new QListView with the given parent to view a model.

Use setModel() to set the model.

Definition at line 185 of file qlistview.cpp.

186  : QAbstractItemView(*new QListViewPrivate, parent)
187 {
191  Q_D(QListView); // We rely on a qobject_cast for PM_DefaultFrameWidth to change
192  d->updateStyledFrameWidths(); // hence we have to force an update now that the object has been constructed
193 }
double d
Definition: qnumeric_p.h:62
QAbstractItemView(QWidget *parent=0)
Constructs an abstract item view with the given parent.
void setSelectionMode(QAbstractItemView::SelectionMode mode)
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
void setViewMode(ViewMode mode)
Definition: qlistview.cpp:490
void setAttribute(Qt::WidgetAttribute, bool on=true)
Sets the attribute attribute on this widget if on is true; otherwise clears the attribute.
Definition: qwidget.cpp:11087

◆ ~QListView()

QListView::~QListView ( )

Destroys the view.

Definition at line 211 of file qlistview.cpp.

212 {
213 }

◆ QListView() [2/2]

QListView::QListView ( QListViewPrivate dd,
QWidget parent = 0 
)
protected
Warning
This function is not part of the public interface.

Definition at line 198 of file qlistview.cpp.

199  : QAbstractItemView(dd, parent)
200 {
204  Q_D(QListView); // We rely on a qobject_cast for PM_DefaultFrameWidth to change
205  d->updateStyledFrameWidths(); // hence we have to force an update now that the object has been constructed
206 }
double d
Definition: qnumeric_p.h:62
QAbstractItemView(QWidget *parent=0)
Constructs an abstract item view with the given parent.
void setSelectionMode(QAbstractItemView::SelectionMode mode)
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
void setViewMode(ViewMode mode)
Definition: qlistview.cpp:490
void setAttribute(Qt::WidgetAttribute, bool on=true)
Sets the attribute attribute on this widget if on is true; otherwise clears the attribute.
Definition: qwidget.cpp:11087

Functions

◆ batchSize()

int QListView::batchSize ( ) const

Referenced by setBatchSize().

◆ clearPropertyFlags()

void QListView::clearPropertyFlags ( )

Clears the QListView-specific property flags.

See viewMode.

Properties inherited from QAbstractItemView are not covered by the property flags. Specifically, dragEnabled and acceptsDrops are computed by QListView when calling setMovement() or setViewMode().

Definition at line 554 of file qlistview.cpp.

555 {
556  Q_D(QListView);
557  d->modeProperties = 0;
558 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ contentsSize()

QSize QListView::contentsSize ( ) const
protected
Warning
This function is not part of the public interface.

Definition at line 759 of file qlistview.cpp.

Referenced by QComboBoxListView::resizeEvent(), setSelection(), and updateGeometries().

760 {
761  Q_D(const QListView);
762  return d->contentsSize();
763 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ currentChanged()

void QListView::currentChanged ( const QModelIndex current,
const QModelIndex previous 
)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 3242 of file qlistview.cpp.

Referenced by QFontListView::currentChanged(), QSidebar::init(), and QSidebar::selectUrl().

3243 {
3244 #ifndef QT_NO_ACCESSIBILITY
3245  if (QAccessible::isActive()) {
3246  if (current.isValid()) {
3247  int entry = visualIndex(current) + 1;
3248 #ifdef Q_WS_X11
3250 #else
3252 #endif
3253  }
3254  }
3255 #endif
3256  QAbstractItemView::currentChanged(current, previous);
3257 }
static void updateAccessibility(QObject *, int who, Event reason)
Notifies accessibility clients about a change in object&#39;s accessibility information.
QWidget * viewport() const
Returns the viewport widget.
virtual void currentChanged(const QModelIndex &current, const QModelIndex &previous)
This slot is called when a new item becomes the current item.
int visualIndex(const QModelIndex &index) const
Definition: qlistview.cpp:3291
bool isValid() const
Returns true if this model index is valid; otherwise returns false.
static bool isActive()
Returns true if an accessibility implementation has been requested during the runtime of the applicat...

◆ dataChanged()

void QListView::dataChanged ( const QModelIndex topLeft,
const QModelIndex bottomRight 
)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 768 of file qlistview.cpp.

769 {
770  d_func()->commonListView->dataChanged(topLeft, bottomRight);
771  QAbstractItemView::dataChanged(topLeft, bottomRight);
772 }
virtual void dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight)
This slot is called when items are changed in the model.

◆ doItemsLayout()

void QListView::doItemsLayout ( )
virtual

Layout the items according to the flow and wrapping properties.

Warning
This function is not part of the public interface.

Reimplemented from QAbstractItemView.

Definition at line 1507 of file qlistview.cpp.

1508 {
1509  Q_D(QListView);
1510  // showing the scroll bars will trigger a resize event,
1511  // so we set the state to expanding to avoid
1512  // triggering another layout
1513  QAbstractItemView::State oldState = state();
1515  if (d->model->columnCount(d->root) > 0) { // no columns means no contents
1516  d->resetBatchStartRow();
1517  if (layoutMode() == SinglePass)
1518  d->doItemsLayout(d->model->rowCount(d->root)); // layout everything
1519  else if (!d->batchLayoutTimer.isActive()) {
1520  if (!d->doItemsLayout(d->batchSize)) // layout is done
1521  d->batchLayoutTimer.start(0, this); // do a new batch as fast as possible
1522  }
1523  }
1525  setState(oldState); // restoring the oldState
1526 }
double d
Definition: qnumeric_p.h:62
virtual void doItemsLayout()
This function is intended to lay out the items in the view.
#define Q_D(Class)
Definition: qglobal.h:2482
LayoutMode layoutMode() const
State
Describes the different states the view can be in.
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
State state() const
Returns the item view&#39;s state.
void setState(State state)
Sets the item view&#39;s state to the given state.

◆ dragLeaveEvent()

void QListView::dragLeaveEvent ( QDragLeaveEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 908 of file qlistview.cpp.

909 {
910  if (!d_func()->commonListView->filterDragLeaveEvent(e))
912 }
void dragLeaveEvent(QDragLeaveEvent *event)
This function is called when the item being dragged leaves the view.

◆ dragMoveEvent()

void QListView::dragMoveEvent ( QDragMoveEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 893 of file qlistview.cpp.

894 {
895  Q_D(QListView);
896  if (!d->commonListView->filterDragMoveEvent(e)) {
898  static_cast<QListModeViewBase *>(d->commonListView)->dragMoveEvent(e);
899  else
901  }
902 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
void dragMoveEvent(QDragMoveEvent *event)
This function is called continuously with the given event during a drag and drop operation over the w...
Flow flow() const
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
ViewMode viewMode() const

◆ dropEvent()

void QListView::dropEvent ( QDropEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Reimplemented in QListWidget.

Definition at line 917 of file qlistview.cpp.

Referenced by QListWidget::addItems(), and QListWidget::dropEvent().

918 {
919  if (!d_func()->commonListView->filterDropEvent(e))
921 }
void dropEvent(QDropEvent *event)
This function is called with the given event when a drop event occurs over the widget.

◆ event()

bool QListView::event ( QEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Reimplemented in QListWidget.

Definition at line 1693 of file qlistview.cpp.

Referenced by QListWidget::addItems(), QSidebar::event(), and QListWidget::event().

1694 {
1695  return QAbstractItemView::event(e);
1696 }
bool event(QEvent *event)
Reimplemented Function

◆ flow()

Flow QListView::flow ( ) const

Referenced by dragMoveEvent(), paintEvent(), and setFlow().

◆ gridSize()

QSize QListView::gridSize ( ) const

Referenced by setGridSize(), and setSelection().

◆ horizontalOffset()

int QListView::horizontalOffset ( ) const
protectedvirtual

Reimplemented Function

Implements QAbstractItemView.

Definition at line 1127 of file qlistview.cpp.

Referenced by indexAt(), mouseMoveEvent(), paintEvent(), and setSelection().

1128 {
1129  return d_func()->commonListView->horizontalOffset();
1130 }

◆ indexAt()

QModelIndex QListView::indexAt ( const QPoint p) const
virtual

Reimplemented Function

Implements QAbstractItemView.

Definition at line 1112 of file qlistview.cpp.

Referenced by QListWidget::itemAt(), and QSidebar::showContextMenu().

1113 {
1114  Q_D(const QListView);
1115  QRect rect(p.x() + horizontalOffset(), p.y() + verticalOffset(), 1, 1);
1116  const QVector<QModelIndex> intersectVector = d->intersectingSet(rect);
1117  QModelIndex index = intersectVector.count() > 0
1118  ? intersectVector.last() : QModelIndex();
1119  if (index.isValid() && visualRect(index).contains(p))
1120  return index;
1121  return QModelIndex();
1122 }
double d
Definition: qnumeric_p.h:62
int horizontalOffset() const
Reimplemented Function
Definition: qlistview.cpp:1127
int verticalOffset() const
Reimplemented Function
Definition: qlistview.cpp:1135
#define Q_D(Class)
Definition: qglobal.h:2482
bool isValid() const
Returns true if this model index is valid; otherwise returns false.
QRect rect() const
bool contains(const QPoint &p, bool proper=false) const
Returns true if the given point is inside or on the edge of the rectangle, otherwise returns false...
Definition: qrect.cpp:1101
QRect visualRect(const QModelIndex &index) const
Reimplemented Function
Definition: qlistview.cpp:588
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
The QModelIndex class is used to locate data in a data model.
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
int y() const
Returns the y coordinate of this point.
Definition: qpoint.h:131
quint16 index
int x() const
Returns the x coordinate of this point.
Definition: qpoint.h:128

◆ indexesMoved

void QListView::indexesMoved ( const QModelIndexList indexes)
signal

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

Since
4.2

◆ internalDrag()

void QListView::internalDrag ( Qt::DropActions  supportedActions)
protected

Called whenever the user starts dragging items and the items are movable, enabling internal dragging and dropping of items.

Warning
This function is not part of the public interface.

Definition at line 956 of file qlistview.cpp.

957 {
958  // ### Qt5: remove that function
959  Q_UNUSED(supportedActions);
960 }
#define Q_UNUSED(x)
Indicates to the compiler that the parameter with the specified name is not used in the body of a fun...
Definition: qglobal.h:1729

◆ internalDrop()

void QListView::internalDrop ( QDropEvent event)
protected

Called whenever items from the view is dropped on the viewport.

Warning
This function is not part of the public interface.

The event provides additional information.

Definition at line 941 of file qlistview.cpp.

942 {
943  // ### Qt5: remove that function
944  Q_UNUSED(event);
945 }
#define Q_UNUSED(x)
Indicates to the compiler that the parameter with the specified name is not used in the body of a fun...
Definition: qglobal.h:1729

◆ isIndexHidden()

bool QListView::isIndexHidden ( const QModelIndex index) const
protectedvirtual

Reimplemented Function

Implements QAbstractItemView.

Definition at line 1568 of file qlistview.cpp.

Referenced by selectedIndexes().

1569 {
1570  Q_D(const QListView);
1571  return (d->isHidden(index.row())
1572  && (index.parent() == d->root)
1573  && index.column() == d->column);
1574 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
QModelIndex parent() const
Returns the parent of the model index, or QModelIndex() if it has no parent.
int row() const
Returns the row this model index refers to.
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
int column() const
Returns the column this model index refers to.

◆ isRowHidden()

bool QListView::isRowHidden ( int  row) const

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

Definition at line 563 of file qlistview.cpp.

Referenced by QListWidget::isItemHidden().

564 {
565  Q_D(const QListView);
566  return d->isHidden(row);
567 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ isSelectionRectVisible()

bool QListView::isSelectionRectVisible ( ) const

Definition at line 1684 of file qlistview.cpp.

1685 {
1686  Q_D(const QListView);
1687  return d->isSelectionRectVisible();
1688 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ isWrapping()

bool QListView::isWrapping ( ) const

Referenced by setWrapping().

◆ layoutMode()

LayoutMode QListView::layoutMode ( ) const

Referenced by doItemsLayout(), and setLayoutMode().

◆ modelColumn()

int QListView::modelColumn ( ) const

Referenced by setModelColumn().

◆ mouseMoveEvent()

void QListView::mouseMoveEvent ( QMouseEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 812 of file qlistview.cpp.

813 {
814  if (!isVisible())
815  return;
816  Q_D(QListView);
818  if (state() == DragSelectingState
819  && d->showElasticBand
820  && d->selectionMode != SingleSelection
821  && d->selectionMode != NoSelection) {
822  QRect rect(d->pressedPosition, e->pos() + QPoint(horizontalOffset(), verticalOffset()));
823  rect = rect.normalized();
824  d->viewport->update(d->mapToViewport(rect.united(d->elasticBand)));
825  d->elasticBand = rect;
826  }
827 }
double d
Definition: qnumeric_p.h:62
int horizontalOffset() const
Reimplemented Function
Definition: qlistview.cpp:1127
void mouseMoveEvent(QMouseEvent *event)
This function is called with the given event when a mouse move event is sent to the widget...
bool isVisible() const
Definition: qwidget.h:1005
QRect normalized() const
Returns a normalized rectangle; i.e., a rectangle that has a non-negative width and height...
Definition: qrect.cpp:322
int verticalOffset() const
Reimplemented Function
Definition: qlistview.cpp:1135
#define Q_D(Class)
Definition: qglobal.h:2482
const QPoint & pos() const
Returns the position of the mouse cursor, relative to the widget that received the event...
Definition: qevent.h:95
QRect rect() const
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
The QPoint class defines a point in the plane using integer precision.
Definition: qpoint.h:53
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
State state() const
Returns the item view&#39;s state.

◆ mouseReleaseEvent()

void QListView::mouseReleaseEvent ( QMouseEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 832 of file qlistview.cpp.

833 {
834  Q_D(QListView);
836  // #### move this implementation into a dynamic class
837  if (d->showElasticBand && d->elasticBand.isValid()) {
838  d->viewport->update(d->mapToViewport(d->elasticBand));
839  d->elasticBand = QRect();
840  }
841 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
void mouseReleaseEvent(QMouseEvent *event)
This function is called with the given event when a mouse button is released, after a mouse press eve...

◆ moveCursor()

QModelIndex QListView::moveCursor ( CursorAction  cursorAction,
Qt::KeyboardModifiers  modifiers 
)
protectedvirtual

Reimplemented Function

Implements QAbstractItemView.

Definition at line 1143 of file qlistview.cpp.

1144 {
1145  Q_D(QListView);
1146  Q_UNUSED(modifiers);
1147 
1148  QModelIndex current = currentIndex();
1149  if (!current.isValid()) {
1150  int rowCount = d->model->rowCount(d->root);
1151  if (!rowCount)
1152  return QModelIndex();
1153  int row = 0;
1154  while (row < rowCount && d->isHiddenOrDisabled(row))
1155  ++row;
1156  if (row >= rowCount)
1157  return QModelIndex();
1158  return d->model->index(row, d->column, d->root);
1159  }
1160 
1161  const QRect initialRect = rectForIndex(current);
1162  QRect rect = initialRect;
1163  if (rect.isEmpty()) {
1164  return d->model->index(0, d->column, d->root);
1165  }
1166  if (d->gridSize().isValid()) rect.setSize(d->gridSize());
1167 
1168  QSize contents = d->contentsSize();
1169  QVector<QModelIndex> intersectVector;
1170 
1171  switch (cursorAction) {
1172  case MoveLeft:
1173  while (intersectVector.isEmpty()) {
1174  rect.translate(-rect.width(), 0);
1175  if (rect.right() <= 0)
1176  return current;
1177  if (rect.left() < 0)
1178  rect.setLeft(0);
1179  intersectVector = d->intersectingSet(rect);
1180  d->removeCurrentAndDisabled(&intersectVector, current);
1181  }
1182  return d->closestIndex(initialRect, intersectVector);
1183  case MoveRight:
1184  while (intersectVector.isEmpty()) {
1185  rect.translate(rect.width(), 0);
1186  if (rect.left() >= contents.width())
1187  return current;
1188  if (rect.right() > contents.width())
1189  rect.setRight(contents.width());
1190  intersectVector = d->intersectingSet(rect);
1191  d->removeCurrentAndDisabled(&intersectVector, current);
1192  }
1193  return d->closestIndex(initialRect, intersectVector);
1194  case MovePageUp:
1195  // move current by (visibileRowCount - 1) items.
1196  // rect.translate(0, -rect.height()); will happen in the switch fallthrough for MoveUp.
1197  rect.moveTop(rect.top() - d->viewport->height() + 2 * rect.height());
1198  if (rect.top() < rect.height())
1199  rect.moveTop(rect.height());
1200  case MovePrevious:
1201  case MoveUp:
1202  while (intersectVector.isEmpty()) {
1203  rect.translate(0, -rect.height());
1204  if (rect.bottom() <= 0) {
1205 #ifdef QT_KEYPAD_NAVIGATION
1206  if (QApplication::keypadNavigationEnabled()) {
1207  int row = d->batchStartRow() - 1;
1208  while (row >= 0 && d->isHiddenOrDisabled(row))
1209  --row;
1210  if (row >= 0)
1211  return d->model->index(row, d->column, d->root);
1212  }
1213 #endif
1214  return current;
1215  }
1216  if (rect.top() < 0)
1217  rect.setTop(0);
1218  intersectVector = d->intersectingSet(rect);
1219  d->removeCurrentAndDisabled(&intersectVector, current);
1220  }
1221  return d->closestIndex(initialRect, intersectVector);
1222  case MovePageDown:
1223  // move current by (visibileRowCount - 1) items.
1224  // rect.translate(0, rect.height()); will happen in the switch fallthrough for MoveDown.
1225  rect.moveTop(rect.top() + d->viewport->height() - 2 * rect.height());
1226  if (rect.bottom() > contents.height() - rect.height())
1227  rect.moveBottom(contents.height() - rect.height());
1228  case MoveNext:
1229  case MoveDown:
1230  while (intersectVector.isEmpty()) {
1231  rect.translate(0, rect.height());
1232  if (rect.top() >= contents.height()) {
1233 #ifdef QT_KEYPAD_NAVIGATION
1234  if (QApplication::keypadNavigationEnabled()) {
1235  int rowCount = d->model->rowCount(d->root);
1236  int row = 0;
1237  while (row < rowCount && d->isHiddenOrDisabled(row))
1238  ++row;
1239  if (row < rowCount)
1240  return d->model->index(row, d->column, d->root);
1241  }
1242 #endif
1243  return current;
1244  }
1245  if (rect.bottom() > contents.height())
1246  rect.setBottom(contents.height());
1247  intersectVector = d->intersectingSet(rect);
1248  d->removeCurrentAndDisabled(&intersectVector, current);
1249  }
1250  return d->closestIndex(initialRect, intersectVector);
1251  case MoveHome:
1252  return d->model->index(0, d->column, d->root);
1253  case MoveEnd:
1254  return d->model->index(d->batchStartRow() - 1, d->column, d->root);}
1255 
1256  return current;
1257 }
double d
Definition: qnumeric_p.h:62
void setBottom(int pos)
Sets the bottom edge of the rectangle to the given y coordinate.
Definition: qrect.h:267
int left() const
Returns the x-coordinate of the rectangle&#39;s left edge.
Definition: qrect.h:240
int width() const
Returns the width of the rectangle.
Definition: qrect.h:303
int height() const
Returns the height of the rectangle.
Definition: qrect.h:306
int bottom() const
Returns the y-coordinate of the rectangle&#39;s bottom edge.
Definition: qrect.h:249
void moveBottom(int pos)
Moves the rectangle vertically, leaving the rectangle&#39;s bottom edge at the given y coordinate...
Definition: qrect.h:362
#define Q_D(Class)
Definition: qglobal.h:2482
QRect rectForIndex(const QModelIndex &index) const
Returns the rectangle of the item at position index in the model.
Definition: qlistview.cpp:1265
int width() const
Returns the width.
Definition: qsize.h:126
void setTop(int pos)
Sets the top edge of the rectangle to the given y coordinate.
Definition: qrect.h:261
void setRight(int pos)
Sets the right edge of the rectangle to the given x coordinate.
Definition: qrect.h:264
void setSize(const QSize &s)
Sets the size of the rectangle to the given size.
Definition: qrect.h:448
QModelIndex currentIndex() const
Returns the model index of the current item.
bool isValid() const
Returns true if this model index is valid; otherwise returns false.
QRect rect() const
bool isEmpty() const
Returns true if the rectangle is empty, otherwise returns false.
Definition: qrect.h:234
int top() const
Returns the y-coordinate of the rectangle&#39;s top edge.
Definition: qrect.h:243
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
int right() const
Returns the x-coordinate of the rectangle&#39;s right edge.
Definition: qrect.h:246
void setLeft(int pos)
Sets the left edge of the rectangle to the given x coordinate.
Definition: qrect.h:258
The QModelIndex class is used to locate data in a data model.
int height() const
Returns the height.
Definition: qsize.h:129
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53
bool isEmpty() const
Returns true if the vector has size 0; otherwise returns false.
Definition: qvector.h:139
void moveTop(int pos)
Moves the rectangle vertically, leaving the rectangle&#39;s top edge at the given y coordinate.
Definition: qrect.h:353
void translate(int dx, int dy)
Moves the rectangle dx along the x axis and dy along the y axis, relative to the current position...
Definition: qrect.h:312
#define Q_UNUSED(x)
Indicates to the compiler that the parameter with the specified name is not used in the body of a fun...
Definition: qglobal.h:1729

◆ movement()

Movement QListView::movement ( ) const

Referenced by setMovement().

◆ paintEvent()

void QListView::paintEvent ( QPaintEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QWidget.

Reimplemented in QComboBoxListView.

Definition at line 996 of file qlistview.cpp.

Referenced by QComboBoxListView::paintEvent().

997 {
998  Q_D(QListView);
999  if (!d->itemDelegate)
1000  return;
1001  QStyleOptionViewItemV4 option = d->viewOptionsV4();
1002  QPainter painter(d->viewport);
1003 
1004  const QVector<QModelIndex> toBeRendered = d->intersectingSet(e->rect().translated(horizontalOffset(), verticalOffset()), false);
1005 
1006  const QModelIndex current = currentIndex();
1007  const QModelIndex hover = d->hover;
1008  const QAbstractItemModel *itemModel = d->model;
1009  const QItemSelectionModel *selections = d->selectionModel;
1010  const bool focus = (hasFocus() || d->viewport->hasFocus()) && current.isValid();
1011  const bool alternate = d->alternatingColors;
1012  const QStyle::State state = option.state;
1013  const QAbstractItemView::State viewState = this->state();
1014  const bool enabled = (state & QStyle::State_Enabled) != 0;
1015 
1016  bool alternateBase = false;
1017  int previousRow = -2; // trigger the alternateBase adjustment on first pass
1018 
1019  int maxSize = (flow() == TopToBottom)
1020  ? qMax(viewport()->size().width(), d->contentsSize().width()) - 2 * d->spacing()
1021  : qMax(viewport()->size().height(), d->contentsSize().height()) - 2 * d->spacing();
1022 
1024  for (QVector<QModelIndex>::const_iterator it = toBeRendered.constBegin(); it != end; ++it) {
1025  Q_ASSERT((*it).isValid());
1026  option.rect = visualRect(*it);
1027 
1028  if (flow() == TopToBottom)
1029  option.rect.setWidth(qMin(maxSize, option.rect.width()));
1030  else
1031  option.rect.setHeight(qMin(maxSize, option.rect.height()));
1032 
1033  option.state = state;
1034  if (selections && selections->isSelected(*it))
1035  option.state |= QStyle::State_Selected;
1036  if (enabled) {
1038  if ((itemModel->flags(*it) & Qt::ItemIsEnabled) == 0) {
1039  option.state &= ~QStyle::State_Enabled;
1040  cg = QPalette::Disabled;
1041  } else {
1042  cg = QPalette::Normal;
1043  }
1044  option.palette.setCurrentColorGroup(cg);
1045  }
1046  if (focus && current == *it) {
1047  option.state |= QStyle::State_HasFocus;
1048  if (viewState == EditingState)
1049  option.state |= QStyle::State_Editing;
1050  }
1051  if (*it == hover)
1052  option.state |= QStyle::State_MouseOver;
1053  else
1054  option.state &= ~QStyle::State_MouseOver;
1055 
1056  if (alternate) {
1057  int row = (*it).row();
1058  if (row != previousRow + 1) {
1059  // adjust alternateBase according to rows in the "gap"
1060  if (!d->hiddenRows.isEmpty()) {
1061  for (int r = qMax(previousRow + 1, 0); r < row; ++r) {
1062  if (!d->isHidden(r))
1063  alternateBase = !alternateBase;
1064  }
1065  } else {
1066  alternateBase = (row & 1) != 0;
1067  }
1068  }
1069  if (alternateBase) {
1071  } else {
1072  option.features &= ~QStyleOptionViewItemV2::Alternate;
1073  }
1074 
1075  // draw background of the item (only alternate row). rest of the background
1076  // is provided by the delegate
1077  QStyle::State oldState = option.state;
1078  option.state &= ~QStyle::State_Selected;
1079  style()->drawPrimitive(QStyle::PE_PanelItemViewRow, &option, &painter, this);
1080  option.state = oldState;
1081 
1082  alternateBase = !alternateBase;
1083  previousRow = row;
1084  }
1085 
1086  d->delegateForIndex(*it)->paint(&painter, option, *it);
1087  }
1088 
1089 #ifndef QT_NO_DRAGANDDROP
1090  d->commonListView->paintDragDrop(&painter);
1091 #endif
1092 
1093 #ifndef QT_NO_RUBBERBAND
1094  // #### move this implementation into a dynamic class
1095  if (d->showElasticBand && d->elasticBand.isValid()) {
1097  opt.initFrom(this);
1099  opt.opaque = false;
1100  opt.rect = d->mapToViewport(d->elasticBand, false).intersected(
1101  d->viewport->rect().adjusted(-16, -16, 16, 16));
1102  painter.save();
1103  style()->drawControl(QStyle::CE_RubberBand, &opt, &painter);
1104  painter.restore();
1105  }
1106 #endif
1107 }
The QPainter class performs low-level painting on widgets and other paint devices.
Definition: qpainter.h:86
double d
Definition: qnumeric_p.h:62
int horizontalOffset() const
Reimplemented Function
Definition: qlistview.cpp:1127
bool enabled
whether the widget is enabled
Definition: qwidget.h:157
The QItemSelectionModel class keeps track of a view&#39;s selected items.
void setHeight(int h)
Sets the height of the rectangle to the given height.
Definition: qrect.h:445
Q_DECL_CONSTEXPR const T & qMin(const T &a, const T &b)
Definition: qglobal.h:1215
QSize size() const
QStyle::State state
the style flags that are used when drawing the control
Definition: qstyleoption.h:88
#define it(className, varName)
const_iterator constEnd() const
Returns a const STL-style iterator pointing to the imaginary item after the last item in the vector...
Definition: qvector.h:252
The QStyleOptionViewItemV4 class is used to describe the parameters necessary for drawing a frame in ...
Definition: qstyleoption.h:609
int verticalOffset() const
Reimplemented Function
Definition: qlistview.cpp:1135
QRect translated(int dx, int dy) const
Returns a copy of the rectangle that is translated dx along the x axis and dy along the y axis...
Definition: qrect.h:328
int width() const
Returns the width of the rectangle.
Definition: qrect.h:303
int height() const
Returns the height of the rectangle.
Definition: qrect.h:306
bool hasFocus() const
Definition: qwidget.cpp:6583
#define Q_ASSERT(cond)
Definition: qglobal.h:1823
#define Q_D(Class)
Definition: qglobal.h:2482
int height() const
Q_DECL_CONSTEXPR const T & qMax(const T &a, const T &b)
Definition: qglobal.h:1217
QStyle * style() const
Definition: qwidget.cpp:2742
The QStyleOptionViewItemV2 class is used to describe the parameters necessary for drawing a frame in ...
Definition: qstyleoption.h:562
ColorGroup
Definition: qpalette.h:92
bool focus
whether this widget (or its focus proxy) has the keyboard input focus
Definition: qwidget.h:188
QWidget * viewport() const
Returns the viewport widget.
virtual Qt::ItemFlags flags(const QModelIndex &index) const
Returns the item flags for the given index.
void setCurrentColorGroup(ColorGroup cg)
Set the palette&#39;s current color group to cg.
Definition: qpalette.h:105
const_iterator constBegin() const
Returns a const STL-style iterator pointing to the first item in the vector.
Definition: qvector.h:249
int width() const
Returns the width.
Definition: qsize.h:126
ViewItemFeatures features
a bitwise OR of the features that describe this view item
Definition: qstyleoption.h:577
bool isSelected(const QModelIndex &index) const
Returns true if the given model item index is selected.
void initFrom(const QWidget *w)
Definition: qstyleoption.h:99
virtual void drawPrimitive(PrimitiveElement pe, const QStyleOption *opt, QPainter *p, const QWidget *w=0) const =0
Draws the given primitive element with the provided painter using the style options specified by opti...
Flow flow() const
QModelIndex currentIndex() const
Returns the model index of the current item.
State
Describes the different states the view can be in.
QSize size
the size of the widget excluding any window frame
Definition: qwidget.h:165
bool opaque
whether the rubber band is required to be drawn in an opaque style
Definition: qstyleoption.h:676
The QStyleOptionRubberBand class is used to describe the parameters needed for drawing a rubber band...
Definition: qstyleoption.h:669
bool isValid() const
Returns true if this model index is valid; otherwise returns false.
The QAbstractItemModel class provides the abstract interface for item model classes.
QPalette palette
the palette that should be used when painting the control
Definition: qstyleoption.h:92
QRect visualRect(const QModelIndex &index) const
Reimplemented Function
Definition: qlistview.cpp:588
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
State
Definition: qaudio.h:59
The QModelIndex class is used to locate data in a data model.
virtual void drawControl(ControlElement element, const QStyleOption *opt, QPainter *p, const QWidget *w=0) const =0
Draws the given element with the provided painter with the style options specified by option...
The QStyle class is an abstract base class that encapsulates the look and feel of a GUI...
Definition: qstyle.h:68
void setWidth(int w)
Sets the width of the rectangle to the given width.
Definition: qrect.h:442
if(void) toggleToolbarShown
QRubberBand::Shape shape
the shape of the rubber band
Definition: qstyleoption.h:675
State state() const
Returns the item view&#39;s state.
const QRect & rect() const
Returns the rectangle that needs to be updated.
Definition: qevent.h:305
static const KeyPair *const end
QRect rect
the area that should be used for various calculations and painting
Definition: qstyleoption.h:90

◆ rectForIndex()

QRect QListView::rectForIndex ( const QModelIndex index) const
protected

Returns the rectangle of the item at position index in the model.

The rectangle is in contents coordinates.

See also
visualRect()

Definition at line 1265 of file qlistview.cpp.

Referenced by moveCursor(), setSelection(), and visualRect().

1266 {
1267  return d_func()->rectForIndex(index);
1268 }

◆ reset()

void QListView::reset ( )
virtual
Warning
This function is not part of the public interface.

Reimplemented from QAbstractItemView.

Definition at line 704 of file qlistview.cpp.

705 {
706  Q_D(QListView);
707  d->clear();
708  d->hiddenRows.clear();
710 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
virtual void reset()
Reset the internal state of the view.
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ resizeContents()

void QListView::resizeContents ( int  width,
int  height 
)
protected

Resize the internal contents to width and height and set the scroll bar ranges accordingly.

Warning
This function is not part of the public interface.

Definition at line 750 of file qlistview.cpp.

Referenced by QComboBoxListView::resizeEvent().

751 {
752  Q_D(QListView);
753  d->setContentsSize(width, height);
754 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
int height() const
int width() const
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ resizeEvent()

void QListView::resizeEvent ( QResizeEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Reimplemented in QComboBoxListView.

Definition at line 862 of file qlistview.cpp.

Referenced by QComboBoxListView::resizeEvent().

863 {
864  Q_D(QListView);
865  if (d->delayedPendingLayout)
866  return;
867 
868  QSize delta = e->size() - e->oldSize();
869 
870  if (delta.isNull())
871  return;
872 
873  bool listWrap = (d->viewMode == ListMode) && d->wrapItemText;
874  bool flowDimensionChanged = (d->flow == LeftToRight && delta.width() != 0)
875  || (d->flow == TopToBottom && delta.height() != 0);
876 
877  // We post a delayed relayout in the following cases :
878  // - we're wrapping
879  // - the state is NoState, we're adjusting and the size has changed in the flowing direction
880  if (listWrap
881  || (state() == NoState && d->resizeMode == Adjust && flowDimensionChanged)) {
882  d->doDelayedItemsLayout(100); // wait 1/10 sec before starting the layout
883  } else {
885  }
886 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
int width() const
Returns the width.
Definition: qsize.h:126
const QSize & oldSize() const
Returns the old size of the widget.
Definition: qevent.h:356
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
void resizeEvent(QResizeEvent *event)
This function is called with the given event when a resize event is sent to the widget.
const QSize & size() const
Returns the new size of the widget.
Definition: qevent.h:355
int height() const
Returns the height.
Definition: qsize.h:129
State state() const
Returns the item view&#39;s state.
bool isNull() const
Returns true if both the width and height is 0; otherwise returns false.
Definition: qsize.h:117
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53

◆ resizeMode()

ResizeMode QListView::resizeMode ( ) const

Referenced by setResizeMode().

◆ rowsAboutToBeRemoved()

void QListView::rowsAboutToBeRemoved ( const QModelIndex parent,
int  start,
int  end 
)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 789 of file qlistview.cpp.

790 {
791  Q_D(QListView);
792  // if the parent is above d->root in the tree, nothing will happen
794  if (parent == d->root) {
795  QSet<QPersistentModelIndex>::iterator it = d->hiddenRows.begin();
796  while (it != d->hiddenRows.end()) {
797  int hiddenRow = it->row();
798  if (hiddenRow >= start && hiddenRow <= end) {
799  it = d->hiddenRows.erase(it);
800  } else {
801  ++it;
802  }
803  }
804  }
805  d->clear();
806  d->doDelayedItemsLayout();
807 }
double d
Definition: qnumeric_p.h:62
virtual void rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)
This slot is called when rows are about to be removed.
#define it(className, varName)
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
static const KeyPair *const end

◆ rowsInserted()

void QListView::rowsInserted ( const QModelIndex parent,
int  start,
int  end 
)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 777 of file qlistview.cpp.

778 {
779  Q_D(QListView);
780  // ### be smarter about inserted items
781  d->clear();
782  d->doDelayedItemsLayout();
783  QAbstractItemView::rowsInserted(parent, start, end);
784 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
virtual void rowsInserted(const QModelIndex &parent, int start, int end)
This slot is called when rows are inserted.
static const KeyPair *const end

◆ scrollContentsBy()

void QListView::scrollContentsBy ( int  dx,
int  dy 
)
protectedvirtual

Scroll the view contents by dx and dy.

Warning
This function is not part of the public interface.

Reimplemented from QAbstractScrollArea.

Definition at line 734 of file qlistview.cpp.

735 {
736  Q_D(QListView);
737  d->delayedAutoScroll.stop(); // auto scroll was canceled by the user scrolling
738  d->commonListView->scrollContentsBy(dx, dy, d->state == QListView::DragSelectingState);
739 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ scrollTo()

void QListView::scrollTo ( const QModelIndex index,
ScrollHint  hint = EnsureVisible 
)
virtual

Reimplemented Function

Implements QAbstractItemView.

Definition at line 597 of file qlistview.cpp.

Referenced by QListWidget::scrollToItem().

598 {
599  Q_D(QListView);
600 
601  if (index.parent() != d->root || index.column() != d->column)
602  return;
603 
604  const QRect rect = visualRect(index);
605  if (hint == EnsureVisible && d->viewport->rect().contains(rect)) {
606  d->viewport->update(rect);
607  return;
608  }
609 
610  if (d->flow == QListView::TopToBottom || d->isWrapping()) // vertical
611  verticalScrollBar()->setValue(d->verticalScrollToValue(index, rect, hint));
612 
613  if (d->flow == QListView::LeftToRight || d->isWrapping()) // horizontal
614  horizontalScrollBar()->setValue(d->horizontalScrollToValue(index, rect, hint));
615 }
double d
Definition: qnumeric_p.h:62
QScrollBar * verticalScrollBar() const
Returns the vertical scroll bar.
#define Q_D(Class)
Definition: qglobal.h:2482
QModelIndex parent() const
Returns the parent of the model index, or QModelIndex() if it has no parent.
QRect rect() const
QRect visualRect(const QModelIndex &index) const
Reimplemented Function
Definition: qlistview.cpp:588
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
QScrollBar * horizontalScrollBar() const
Returns the horizontal scroll bar.
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
int column() const
Returns the column this model index refers to.

◆ selectedIndexes()

QModelIndexList QListView::selectedIndexes ( ) const
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 1482 of file qlistview.cpp.

Referenced by QListWidget::dropEvent().

1483 {
1484  Q_D(const QListView);
1485  if (!d->selectionModel)
1486  return QModelIndexList();
1487 
1488  QModelIndexList viewSelected = d->selectionModel->selectedIndexes();
1489  for (int i = 0; i < viewSelected.count(); ++i) {
1490  const QModelIndex &index = viewSelected.at(i);
1491  if (!isIndexHidden(index) && index.parent() == d->root && index.column() == d->column)
1492  ++i;
1493  else
1494  viewSelected.removeAt(i);
1495  }
1496  return viewSelected;
1497 }
double d
Definition: qnumeric_p.h:62
int count(const T &t) const
Returns the number of occurrences of value in the list.
Definition: qlist.h:891
bool isIndexHidden(const QModelIndex &index) const
Reimplemented Function
Definition: qlistview.cpp:1568
#define Q_D(Class)
Definition: qglobal.h:2482
QModelIndex parent() const
Returns the parent of the model index, or QModelIndex() if it has no parent.
const T & at(int i) const
Returns the item at index position i in the list.
Definition: qlist.h:468
QList< QModelIndex > QModelIndexList
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
The QModelIndex class is used to locate data in a data model.
quint16 index
int column() const
Returns the column this model index refers to.
void removeAt(int i)
Removes the item at index position i.
Definition: qlist.h:480

◆ selectionChanged()

void QListView::selectionChanged ( const QItemSelection selected,
const QItemSelection deselected 
)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 3262 of file qlistview.cpp.

3264 {
3265 #ifndef QT_NO_ACCESSIBILITY
3266  if (QAccessible::isActive()) {
3267  // ### does not work properly for selection ranges.
3268  QModelIndex sel = selected.indexes().value(0);
3269  if (sel.isValid()) {
3270  int entry = visualIndex(sel) + 1;
3271 #ifdef Q_WS_X11
3273 #else
3275 #endif
3276  }
3277  QModelIndex desel = deselected.indexes().value(0);
3278  if (desel.isValid()) {
3279  int entry = visualIndex(desel) + 1;
3280 #ifdef Q_WS_X11
3282 #else
3284 #endif
3285  }
3286  }
3287 #endif
3288  QAbstractItemView::selectionChanged(selected, deselected);
3289 }
static void updateAccessibility(QObject *, int who, Event reason)
Notifies accessibility clients about a change in object&#39;s accessibility information.
QWidget * viewport() const
Returns the viewport widget.
int visualIndex(const QModelIndex &index) const
Definition: qlistview.cpp:3291
T value(int i) const
Returns the value at index position i in the list.
Definition: qlist.h:661
bool isValid() const
Returns true if this model index is valid; otherwise returns false.
static bool isActive()
Returns true if an accessibility implementation has been requested during the runtime of the applicat...
virtual void selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)
This slot is called when the selection is changed.
The QModelIndex class is used to locate data in a data model.
QModelIndexList indexes() const
Returns a list of model indexes that correspond to the selected items.

◆ setBatchSize()

void QListView::setBatchSize ( int  batchSize)

Definition at line 424 of file qlistview.cpp.

425 {
426  Q_D(QListView);
427  if (batchSize <= 0) {
428  qWarning("Invalid batchSize (%d)", batchSize);
429  return;
430  }
431  d->batchSize = batchSize;
432 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
Q_CORE_EXPORT void qWarning(const char *,...)
int batchSize() const
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setFlow()

void QListView::setFlow ( Flow  flow)

Definition at line 276 of file qlistview.cpp.

277 {
278  Q_D(QListView);
279  d->modeProperties |= uint(QListViewPrivate::Flow);
280  d->flow = flow;
281  d->doDelayedItemsLayout();
282 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
Flow flow() const
unsigned int uint
Definition: qglobal.h:996
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setGridSize()

void QListView::setGridSize ( const QSize size)

Definition at line 458 of file qlistview.cpp.

459 {
460  Q_D(QListView);
461  d->modeProperties |= uint(QListViewPrivate::GridSize);
462  d->setGridSize(size);
463  d->doDelayedItemsLayout();
464 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
unsigned int uint
Definition: qglobal.h:996
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setLayoutMode()

void QListView::setLayoutMode ( LayoutMode  mode)

Definition at line 366 of file qlistview.cpp.

367 {
368  Q_D(QListView);
369  d->layoutMode = mode;
370 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setModelColumn()

void QListView::setModelColumn ( int  column)

Definition at line 1586 of file qlistview.cpp.

Referenced by QCompleter::popup(), and QComboBox::setModelColumn().

1587 {
1588  Q_D(QListView);
1589  if (column < 0 || column >= d->model->columnCount(d->root))
1590  return;
1591  d->column = column;
1592  d->doDelayedItemsLayout();
1593 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setMovement()

void QListView::setMovement ( Movement  movement)

Definition at line 236 of file qlistview.cpp.

237 {
238  Q_D(QListView);
239  d->modeProperties |= uint(QListViewPrivate::Movement);
240  d->movement = movement;
241 
242 #ifndef QT_NO_DRAGANDDROP
243  bool movable = (movement != Static);
244  setDragEnabled(movable);
245  d->viewport->setAcceptDrops(movable);
246 #endif
247  d->doDelayedItemsLayout();
248 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
unsigned int uint
Definition: qglobal.h:996
void setDragEnabled(bool enable)
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
Movement movement() const

◆ setPositionForIndex()

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

Sets the contents position of the item at index in the model to the given position.

Since
4.1

If the list view's movement mode is Static or its view mode is ListView, this function will have no effect.

Definition at line 1281 of file qlistview.cpp.

1282 {
1283  Q_D(QListView);
1284  if (d->movement == Static
1285  || !d->isIndexValid(index)
1286  || index.parent() != d->root
1287  || index.column() != d->column)
1288  return;
1289 
1290  d->executePostedLayout();
1291  d->commonListView->setPositionForIndex(position, index);
1292 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
QModelIndex parent() const
Returns the parent of the model index, or QModelIndex() if it has no parent.
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
int column() const
Returns the column this model index refers to.

◆ setResizeMode()

void QListView::setResizeMode ( ResizeMode  mode)

Definition at line 337 of file qlistview.cpp.

Referenced by QFileDialogListView::init().

338 {
339  Q_D(QListView);
340  d->modeProperties |= uint(QListViewPrivate::ResizeMode);
341  d->resizeMode = mode;
342 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
unsigned int uint
Definition: qglobal.h:996
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setRootIndex()

void QListView::setRootIndex ( const QModelIndex index)
virtual
Warning
This function is not part of the public interface.

Reimplemented from QAbstractItemView.

Definition at line 715 of file qlistview.cpp.

Referenced by QColumnView::createColumn().

716 {
717  Q_D(QListView);
718  d->column = qBound(0, d->column, d->model->columnCount(index) - 1);
720  // sometimes we get an update before reset() is called
721  d->clear();
722  d->hiddenRows.clear();
723 }
double d
Definition: qnumeric_p.h:62
virtual void setRootIndex(const QModelIndex &index)
Sets the root item to the item at the given index.
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
Q_DECL_CONSTEXPR const T & qBound(const T &min, const T &val, const T &max)
Definition: qglobal.h:1219

◆ setRowHidden()

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

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

Definition at line 573 of file qlistview.cpp.

Referenced by QListWidget::setItemHidden().

574 {
575  Q_D(QListView);
576  const bool hidden = d->isHidden(row);
577  if (hide && !hidden)
578  d->commonListView->appendHiddenRow(row);
579  else if (!hide && hidden)
580  d->commonListView->removeHiddenRow(row);
581  d->doDelayedItemsLayout();
582  d->viewport->update();
583 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
void hide()
Hides the widget.
Definition: qwidget.h:501
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setSelection()

void QListView::setSelection ( const QRect rect,
QItemSelectionModel::SelectionFlags  command 
)
protectedvirtual

Reimplemented Function

Implements QAbstractItemView.

Definition at line 1297 of file qlistview.cpp.

1298 {
1299  Q_D(QListView);
1300  if (!d->selectionModel)
1301  return;
1302 
1303  // if we are wrapping, we can only selecte inside the contents rectangle
1304  int w = qMax(d->contentsSize().width(), d->viewport->width());
1305  int h = qMax(d->contentsSize().height(), d->viewport->height());
1306  if (d->wrap && !QRect(0, 0, w, h).intersects(rect))
1307  return;
1308 
1309  QItemSelection selection;
1310 
1311  if (rect.width() == 1 && rect.height() == 1) {
1312  const QVector<QModelIndex> intersectVector = d->intersectingSet(rect.translated(horizontalOffset(), verticalOffset()));
1313  QModelIndex tl;
1314  if (!intersectVector.isEmpty())
1315  tl = intersectVector.last(); // special case for mouse press; only select the top item
1316  if (tl.isValid() && d->isIndexEnabled(tl))
1317  selection.select(tl, tl);
1318  } else {
1319  if (state() == DragSelectingState) { // visual selection mode (rubberband selection)
1320  selection = d->selection(rect.translated(horizontalOffset(), verticalOffset()));
1321  } else { // logical selection mode (key and mouse click selection)
1322  QModelIndex tl, br;
1323  // get the first item
1324  const QRect topLeft(rect.left() + horizontalOffset(), rect.top() + verticalOffset(), 1, 1);
1325  QVector<QModelIndex> intersectVector = d->intersectingSet(topLeft);
1326  if (!intersectVector.isEmpty())
1327  tl = intersectVector.last();
1328  // get the last item
1329  const QRect bottomRight(rect.right() + horizontalOffset(), rect.bottom() + verticalOffset(), 1, 1);
1330  intersectVector = d->intersectingSet(bottomRight);
1331  if (!intersectVector.isEmpty())
1332  br = intersectVector.last();
1333 
1334  // get the ranges
1335  if (tl.isValid() && br.isValid()
1336  && d->isIndexEnabled(tl)
1337  && d->isIndexEnabled(br)) {
1338  QRect first = rectForIndex(tl);
1339  QRect last = rectForIndex(br);
1340  QRect middle;
1341  if (d->flow == LeftToRight) {
1342  QRect &top = first;
1343  QRect &bottom = last;
1344  // if bottom is above top, swap them
1345  if (top.center().y() > bottom.center().y()) {
1346  QRect tmp = top;
1347  top = bottom;
1348  bottom = tmp;
1349  }
1350  // if the rect are on differnet lines, expand
1351  if (top.top() != bottom.top()) {
1352  // top rectangle
1353  if (isRightToLeft())
1354  top.setLeft(0);
1355  else
1356  top.setRight(contentsSize().width());
1357  // bottom rectangle
1358  if (isRightToLeft())
1359  bottom.setRight(contentsSize().width());
1360  else
1361  bottom.setLeft(0);
1362  } else if (top.left() > bottom.right()) {
1363  if (isRightToLeft())
1364  bottom.setLeft(top.right());
1365  else
1366  bottom.setRight(top.left());
1367  } else {
1368  if (isRightToLeft())
1369  top.setLeft(bottom.right());
1370  else
1371  top.setRight(bottom.left());
1372  }
1373  // middle rectangle
1374  if (top.bottom() < bottom.top()) {
1375  if (gridSize().isValid() && !gridSize().isNull())
1376  middle.setTop(top.top() + gridSize().height());
1377  else
1378  middle.setTop(top.bottom() + 1);
1379  middle.setLeft(qMin(top.left(), bottom.left()));
1380  middle.setBottom(bottom.top() - 1);
1381  middle.setRight(qMax(top.right(), bottom.right()));
1382  }
1383  } else { // TopToBottom
1384  QRect &left = first;
1385  QRect &right = last;
1386  if (left.center().x() > right.center().x())
1387  qSwap(left, right);
1388 
1389  int ch = contentsSize().height();
1390  if (left.left() != right.left()) {
1391  // left rectangle
1392  if (isRightToLeft())
1393  left.setTop(0);
1394  else
1395  left.setBottom(ch);
1396 
1397  // top rectangle
1398  if (isRightToLeft())
1399  right.setBottom(ch);
1400  else
1401  right.setTop(0);
1402  // only set middle if the
1403  middle.setTop(0);
1404  middle.setBottom(ch);
1405  if (gridSize().isValid() && !gridSize().isNull())
1406  middle.setLeft(left.left() + gridSize().width());
1407  else
1408  middle.setLeft(left.right() + 1);
1409  middle.setRight(right.left() - 1);
1410  } else if (left.bottom() < right.top()) {
1411  left.setBottom(right.top() - 1);
1412  } else {
1413  right.setBottom(left.top() - 1);
1414  }
1415  }
1416 
1417  // do the selections
1418  QItemSelection topSelection = d->selection(first);
1419  QItemSelection middleSelection = d->selection(middle);
1420  QItemSelection bottomSelection = d->selection(last);
1421  // merge
1422  selection.merge(topSelection, QItemSelectionModel::Select);
1423  selection.merge(middleSelection, QItemSelectionModel::Select);
1424  selection.merge(bottomSelection, QItemSelectionModel::Select);
1425  }
1426  }
1427  }
1428 
1429  d->selectionModel->select(selection, command);
1430 }
double d
Definition: qnumeric_p.h:62
int horizontalOffset() const
Reimplemented Function
Definition: qlistview.cpp:1127
void merge(const QItemSelection &other, QItemSelectionModel::SelectionFlags command)
Merges the other selection with this QItemSelection using the command given.
void setBottom(int pos)
Sets the bottom edge of the rectangle to the given y coordinate.
Definition: qrect.h:267
Q_DECL_CONSTEXPR const T & qMin(const T &a, const T &b)
Definition: qglobal.h:1215
QSize contentsSize() const
Definition: qlistview.cpp:759
int verticalOffset() const
Reimplemented Function
Definition: qlistview.cpp:1135
int left() const
Returns the x-coordinate of the rectangle&#39;s left edge.
Definition: qrect.h:240
QRect translated(int dx, int dy) const
Returns a copy of the rectangle that is translated dx along the x axis and dy along the y axis...
Definition: qrect.h:328
int width() const
Returns the width of the rectangle.
Definition: qrect.h:303
int height() const
Returns the height of the rectangle.
Definition: qrect.h:306
int bottom() const
Returns the y-coordinate of the rectangle&#39;s bottom edge.
Definition: qrect.h:249
#define Q_D(Class)
Definition: qglobal.h:2482
Q_CORE_EXPORT QTextStream & right(QTextStream &s)
Q_DECL_CONSTEXPR const T & qMax(const T &a, const T &b)
Definition: qglobal.h:1217
QRect rectForIndex(const QModelIndex &index) const
Returns the rectangle of the item at position index in the model.
Definition: qlistview.cpp:1265
int width() const
Returns the width.
Definition: qsize.h:126
int width() const
void setTop(int pos)
Sets the top edge of the rectangle to the given y coordinate.
Definition: qrect.h:261
void setRight(int pos)
Sets the right edge of the rectangle to the given x coordinate.
Definition: qrect.h:264
void select(const QModelIndex &topLeft, const QModelIndex &bottomRight)
Adds the items in the range that extends from the top-left model item, specified by the topLeft index...
bool isValid() const
Returns true if this model index is valid; otherwise returns false.
void qSwap(T &value1, T &value2)
Definition: qglobal.h:2181
QPoint center() const
Returns the center point of the rectangle.
Definition: qrect.h:300
QSize gridSize() const
int top() const
Returns the y-coordinate of the rectangle&#39;s top edge.
Definition: qrect.h:243
The QItemSelection class manages information about selected items in a model.
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
int right() const
Returns the x-coordinate of the rectangle&#39;s right edge.
Definition: qrect.h:246
void setLeft(int pos)
Sets the left edge of the rectangle to the given x coordinate.
Definition: qrect.h:258
T & last()
Returns a reference to the last item in the vector.
Definition: qvector.h:262
The QModelIndex class is used to locate data in a data model.
int height() const
Returns the height.
Definition: qsize.h:129
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
bool isValid() const
Returns true if both the width and height is equal to or greater than 0; otherwise returns false...
Definition: qsize.h:123
State state() const
Returns the item view&#39;s state.
int y() const
Returns the y coordinate of this point.
Definition: qpoint.h:131
bool isNull() const
Returns true if both the width and height is 0; otherwise returns false.
Definition: qsize.h:117
bool isRightToLeft() const
Definition: qwidget.h:428
bool isEmpty() const
Returns true if the vector has size 0; otherwise returns false.
Definition: qvector.h:139
bool intersects(const QRect &r) const
Returns true if this rectangle intersects with the given rectangle (i.
Definition: qrect.cpp:1429
int x() const
Returns the x coordinate of this point.
Definition: qpoint.h:128
Q_CORE_EXPORT QTextStream & left(QTextStream &s)
static bool isNull(const QVariant::Private *d)
Definition: qvariant.cpp:300

◆ setSelectionRectVisible()

void QListView::setSelectionRectVisible ( bool  show)

Definition at line 1677 of file qlistview.cpp.

1678 {
1679  Q_D(QListView);
1680  d->modeProperties |= uint(QListViewPrivate::SelectionRectVisible);
1681  d->setSelectionRectVisible(show);
1682 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
unsigned int uint
Definition: qglobal.h:996
void show()
Shows the widget and its child widgets.
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setSpacing()

void QListView::setSpacing ( int  space)

Definition at line 397 of file qlistview.cpp.

398 {
399  Q_D(QListView);
400  d->modeProperties |= uint(QListViewPrivate::Spacing);
401  d->setSpacing(space);
402  d->doDelayedItemsLayout();
403 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
unsigned int uint
Definition: qglobal.h:996
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setUniformItemSizes()

void QListView::setUniformItemSizes ( bool  enable)

Definition at line 1615 of file qlistview.cpp.

Referenced by QSidebar::init(), and QFontComboBox::QFontComboBox().

1616 {
1617  Q_D(QListView);
1618  d->uniformItemSizes = enable;
1619 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setViewMode()

void QListView::setViewMode ( ViewMode  mode)

Definition at line 490 of file qlistview.cpp.

Referenced by QListView().

491 {
492  Q_D(QListView);
493  if (d->commonListView && d->viewMode == mode)
494  return;
495  d->viewMode = mode;
496 
497  delete d->commonListView;
498  if (mode == ListMode) {
499  d->commonListView = new QListModeViewBase(this, d);
500  if (!(d->modeProperties & QListViewPrivate::Wrap))
501  d->setWrapping(false);
502  if (!(d->modeProperties & QListViewPrivate::Spacing))
503  d->setSpacing(0);
504  if (!(d->modeProperties & QListViewPrivate::GridSize))
505  d->setGridSize(QSize());
506  if (!(d->modeProperties & QListViewPrivate::Flow))
507  d->flow = TopToBottom;
508  if (!(d->modeProperties & QListViewPrivate::Movement))
509  d->movement = Static;
510  if (!(d->modeProperties & QListViewPrivate::ResizeMode))
511  d->resizeMode = Fixed;
512  if (!(d->modeProperties & QListViewPrivate::SelectionRectVisible))
513  d->showElasticBand = false;
514  } else {
515  d->commonListView = new QIconModeViewBase(this, d);
516  if (!(d->modeProperties & QListViewPrivate::Wrap))
517  d->setWrapping(true);
518  if (!(d->modeProperties & QListViewPrivate::Spacing))
519  d->setSpacing(0);
520  if (!(d->modeProperties & QListViewPrivate::GridSize))
521  d->setGridSize(QSize());
522  if (!(d->modeProperties & QListViewPrivate::Flow))
523  d->flow = LeftToRight;
524  if (!(d->modeProperties & QListViewPrivate::Movement))
525  d->movement = Free;
526  if (!(d->modeProperties & QListViewPrivate::ResizeMode))
527  d->resizeMode = Fixed;
528  if (!(d->modeProperties & QListViewPrivate::SelectionRectVisible))
529  d->showElasticBand = true;
530  }
531 
532 #ifndef QT_NO_DRAGANDDROP
533  bool movable = (d->movement != Static);
534  setDragEnabled(movable);
535  setAcceptDrops(movable);
536 #endif
537  d->clear();
538  d->doDelayedItemsLayout();
539 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
friend class QListModeViewBase
void setDragEnabled(bool enable)
void setAcceptDrops(bool on)
Definition: qwidget.cpp:3534
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53

◆ setWordWrap()

void QListView::setWordWrap ( bool  on)

Definition at line 1644 of file qlistview.cpp.

1645 {
1646  Q_D(QListView);
1647  if (d->wrapItemText == on)
1648  return;
1649  d->wrapItemText = on;
1650  d->doDelayedItemsLayout();
1651 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ setWrapping()

void QListView::setWrapping ( bool  enable)

Definition at line 308 of file qlistview.cpp.

Referenced by QFileDialogListView::init().

309 {
310  Q_D(QListView);
311  d->modeProperties |= uint(QListViewPrivate::Wrap);
312  d->setWrapping(enable);
313  d->doDelayedItemsLayout();
314 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
unsigned int uint
Definition: qglobal.h:996
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ spacing()

int QListView::spacing ( ) const

Referenced by setSpacing().

◆ startDrag()

void QListView::startDrag ( Qt::DropActions  supportedActions)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 926 of file qlistview.cpp.

927 {
928  if (!d_func()->commonListView->filterStartDrag(supportedActions))
929  QAbstractItemView::startDrag(supportedActions);
930 }
virtual void startDrag(Qt::DropActions supportedActions)
Starts a drag by calling drag->exec() using the given supportedActions.

◆ timerEvent()

void QListView::timerEvent ( QTimerEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 846 of file qlistview.cpp.

847 {
848  Q_D(QListView);
849  if (e->timerId() == d->batchLayoutTimer.timerId()) {
850  if (d->doItemsLayout(d->batchSize)) { // layout is done
851  d->batchLayoutTimer.stop();
853  d->viewport->update();
854  }
855  }
857 }
double d
Definition: qnumeric_p.h:62
void timerEvent(QTimerEvent *event)
This function is called with the given event when a timer event is sent to the widget.
#define Q_D(Class)
Definition: qglobal.h:2482
int timerId() const
Returns the unique timer identifier, which is the same identifier as returned from QObject::startTime...
Definition: qcoreevent.h:346
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
void updateGeometries()
Reimplemented Function
Definition: qlistview.cpp:1531

◆ uniformItemSizes()

bool QListView::uniformItemSizes ( ) const

Referenced by setUniformItemSizes().

◆ updateGeometries()

void QListView::updateGeometries ( )
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Definition at line 1531 of file qlistview.cpp.

Referenced by timerEvent().

1532 {
1533  Q_D(QListView);
1534  if (geometry().isEmpty() || d->model->rowCount(d->root) <= 0 || d->model->columnCount(d->root) <= 0) {
1535  horizontalScrollBar()->setRange(0, 0);
1536  verticalScrollBar()->setRange(0, 0);
1537  } else {
1538  QModelIndex index = d->model->index(0, d->column, d->root);
1539  QStyleOptionViewItemV4 option = d->viewOptionsV4();
1540  QSize step = d->itemSize(option, index);
1541  d->commonListView->updateHorizontalScrollBar(step);
1542  d->commonListView->updateVerticalScrollBar(step);
1543  }
1544 
1546 
1547  // if the scroll bars are turned off, we resize the contents to the viewport
1548  if (d->movement == Static && !d->isWrapping()) {
1549  d->layoutChildren(); // we need the viewport size to be updated
1550  if (d->flow == TopToBottom) {
1552  d->setContentsSize(viewport()->width(), contentsSize().height());
1553  horizontalScrollBar()->setRange(0, 0); // we see all the contents anyway
1554  }
1555  } else { // LeftToRight
1557  d->setContentsSize(contentsSize().width(), viewport()->height());
1558  verticalScrollBar()->setRange(0, 0); // we see all the contents anyway
1559  }
1560  }
1561  }
1562 
1563 }
double d
Definition: qnumeric_p.h:62
QSize contentsSize() const
Definition: qlistview.cpp:759
The QStyleOptionViewItemV4 class is used to describe the parameters necessary for drawing a frame in ...
Definition: qstyleoption.h:609
QScrollBar * verticalScrollBar() const
Returns the vertical scroll bar.
Qt::ScrollBarPolicy horizontalScrollBarPolicy() const
#define Q_D(Class)
Definition: qglobal.h:2482
int height() const
void setRange(int min, int max)
Sets the slider&#39;s minimum to min and its maximum to max.
QWidget * viewport() const
Returns the viewport widget.
static bool isEmpty(const char *str)
int width() const
Qt::ScrollBarPolicy verticalScrollBarPolicy() const
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
The QModelIndex class is used to locate data in a data model.
QScrollBar * horizontalScrollBar() const
Returns the horizontal scroll bar.
quint16 index
virtual void updateGeometries()
Updates the geometry of the child widgets of the view.
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53
const QRect & geometry() const

◆ verticalOffset()

int QListView::verticalOffset ( ) const
protectedvirtual

Reimplemented Function

Implements QAbstractItemView.

Definition at line 1135 of file qlistview.cpp.

Referenced by indexAt(), mouseMoveEvent(), paintEvent(), and setSelection().

1136 {
1137  return d_func()->commonListView->verticalOffset();
1138 }

◆ viewMode()

ViewMode QListView::viewMode ( ) const

Referenced by dragMoveEvent(), and setViewMode().

◆ viewOptions()

QStyleOptionViewItem QListView::viewOptions ( ) const
protectedvirtual

Reimplemented Function

Reimplemented from QAbstractItemView.

Reimplemented in QComboBoxListView.

Definition at line 967 of file qlistview.cpp.

Referenced by QComboBoxListView::viewOptions().

968 {
969  Q_D(const QListView);
971  if (!d->iconSize.isValid()) { // otherwise it was already set in abstractitemview
972  int pm = (d->viewMode == ListMode
975  option.decorationSize = QSize(pm, pm);
976  }
977  if (d->viewMode == IconMode) {
978  option.showDecorationSelected = false;
981  } else {
983  }
984 
985  if (d->gridSize().isValid()) {
986  option.rect.setSize(d->gridSize());
987  }
988 
989  return option;
990 }
double d
Definition: qnumeric_p.h:62
virtual QStyleOptionViewItem viewOptions() const
Returns a QStyleOptionViewItem structure populated with the view&#39;s palette, font, state...
virtual int pixelMetric(PixelMetric metric, const QStyleOption *option=0, const QWidget *widget=0) const =0
Returns the value of the given pixel metric.
Position decorationPosition
the position of the decoration for the item
Definition: qstyleoption.h:550
#define Q_D(Class)
Definition: qglobal.h:2482
QStyle * style() const
Definition: qwidget.cpp:2742
void setSize(const QSize &s)
Sets the size of the rectangle to the given size.
Definition: qrect.h:448
bool showDecorationSelected
whether the decoration should be highlighted on selected items
Definition: qstyleoption.h:553
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
Qt::Alignment displayAlignment
the alignment of the display value for the item
Definition: qstyleoption.h:547
QSize decorationSize
the size of the decoration for the item
Definition: qstyleoption.h:551
The QSize class defines the size of a two-dimensional object using integer point precision.
Definition: qsize.h:53
The QStyleOptionViewItem class is used to describe the parameters used to draw an item in a view widg...
Definition: qstyleoption.h:539
QRect rect
the area that should be used for various calculations and painting
Definition: qstyleoption.h:90

◆ visualIndex()

int QListView::visualIndex ( const QModelIndex index) const
private

Definition at line 3291 of file qlistview.cpp.

3292 {
3293  Q_D(const QListView);
3294  d->executePostedLayout();
3295  QListViewItem itm = d->indexToListViewItem(index);
3296  int visualIndex = d->commonListView->itemIndex(itm);
3297  for (int row = 0; row <= index.row() && visualIndex >= 0; row++) {
3298  if (d->isHidden(row))
3299  visualIndex--;
3300  }
3301  return visualIndex;
3302 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
int row() const
Returns the row this model index refers to.
int visualIndex(const QModelIndex &index) const
Definition: qlistview.cpp:3291
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ visualRect()

QRect QListView::visualRect ( const QModelIndex index) const
virtual

Reimplemented Function

Implements QAbstractItemView.

Definition at line 588 of file qlistview.cpp.

Referenced by indexAt(), paintEvent(), scrollTo(), QListWidget::visualItemRect(), and visualRegionForSelection().

589 {
590  Q_D(const QListView);
591  return d->mapToViewport(rectForIndex(index));
592 }
double d
Definition: qnumeric_p.h:62
#define Q_D(Class)
Definition: qglobal.h:2482
QRect rectForIndex(const QModelIndex &index) const
Returns the rectangle of the item at position index in the model.
Definition: qlistview.cpp:1265
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57

◆ visualRegionForSelection()

QRegion QListView::visualRegionForSelection ( const QItemSelection selection) const
protectedvirtual

Since 4.

Reimplemented Function

7, the returned region only contains rectangles intersecting (or included in) the viewport.

Implements QAbstractItemView.

Definition at line 1441 of file qlistview.cpp.

1442 {
1443  Q_D(const QListView);
1444  // ### NOTE: this is a potential bottleneck in non-static mode
1445  int c = d->column;
1446  QRegion selectionRegion;
1447  const QRect &viewportRect = d->viewport->rect();
1448  for (int i = 0; i < selection.count(); ++i) {
1449  if (!selection.at(i).isValid())
1450  continue;
1451  QModelIndex parent = selection.at(i).topLeft().parent();
1452  //we only display the children of the root in a listview
1453  //we're not interested in the other model indexes
1454  if (parent != d->root)
1455  continue;
1456  int t = selection.at(i).topLeft().row();
1457  int b = selection.at(i).bottomRight().row();
1458  if (d->viewMode == IconMode || d->isWrapping()) { // in non-static mode, we have to go through all selected items
1459  for (int r = t; r <= b; ++r) {
1460  const QRect &rect = visualRect(d->model->index(r, c, parent));
1461  if (viewportRect.intersects(rect))
1462  selectionRegion += rect;
1463  }
1464  } else { // in static mode, we can optimize a bit
1465  while (t <= b && d->isHidden(t)) ++t;
1466  while (b >= t && d->isHidden(b)) --b;
1467  const QModelIndex top = d->model->index(t, c, parent);
1468  const QModelIndex bottom = d->model->index(b, c, parent);
1469  QRect rect(visualRect(top).topLeft(),
1470  visualRect(bottom).bottomRight());
1471  if (viewportRect.intersects(rect))
1472  selectionRegion += rect;
1473  }
1474  }
1475 
1476  return selectionRegion;
1477 }
double d
Definition: qnumeric_p.h:62
unsigned char c[8]
Definition: qnumeric_p.h:62
QModelIndex bottomRight() const
Returns the index for the item located at the bottom-right corner of the selection range...
bool isValid() const
Returns true if the selection range is valid; otherwise returns false.
int count(const T &t) const
Returns the number of occurrences of value in the list.
Definition: qlist.h:891
#define Q_D(Class)
Definition: qglobal.h:2482
QModelIndex parent() const
Returns the parent of the model index, or QModelIndex() if it has no parent.
bool isHidden() const
Returns true if the widget is hidden, otherwise returns false.
Definition: qwidget.h:1008
QModelIndex topLeft() const
Returns the index for the item located at the top-left corner of the selection range.
int row() const
Returns the row this model index refers to.
const T & at(int i) const
Returns the item at index position i in the list.
Definition: qlist.h:468
The QRegion class specifies a clip region for a painter.
Definition: qregion.h:68
QRect rect() const
QRect visualRect(const QModelIndex &index) const
Reimplemented Function
Definition: qlistview.cpp:588
The QListView class provides a list or icon view onto a model.
Definition: qlistview.h:57
QObject * parent() const
Returns a pointer to the parent object.
Definition: qobject.h:273
The QModelIndex class is used to locate data in a data model.
The QRect class defines a rectangle in the plane using integer precision.
Definition: qrect.h:58
bool intersects(const QRect &r) const
Returns true if this rectangle intersects with the given rectangle (i.
Definition: qrect.cpp:1429

◆ wordWrap()

bool QListView::wordWrap ( ) const

Referenced by setWordWrap().

Friends and Related Functions

◆ QAccessibleItemView

friend class QAccessibleItemView
friend

Definition at line 190 of file qlistview.h.

Properties

◆ batchSize

int QListView::batchSize
private

the number of items laid out in each batch if layoutMode is set to Batched

The default value is 100.

Since
4.2

Definition at line 71 of file qlistview.h.

◆ flow

QListView::Flow QListView::flow
private

which direction the items layout should flow.

If this property is LeftToRight , the items will be laid out left to right. If the isWrapping property is true, the layout will wrap when it reaches the right side of the visible area. If this property is TopToBottom , the items will be laid out from the top of the visible area, wrapping when it reaches the bottom.

Setting this property when the view is visible will cause the items to be laid out again.

By default, this property is set to TopToBottom .

See also
viewMode

Definition at line 62 of file qlistview.h.

◆ gridSize

QSize QListView::gridSize
private

the size of the layout grid

This property is the size of the grid in which the items are laid out. The default is an empty size which means that there is no grid and the layout is not done in a grid. Setting this property to a non-empty size switches on the grid layout. (When a grid layout is in force the spacing property is ignored.)

Setting this property when the view is visible will cause the items to be laid out again.

See also
viewMode

Definition at line 67 of file qlistview.h.

◆ isWrapping

bool QListView::isWrapping
private

whether the items layout should wrap.

This property holds whether the layout should wrap when there is no more space in the visible area. The point at which the layout wraps depends on the flow property.

Setting this property when the view is visible will cause the items to be laid out again.

By default, this property is false.

See also
viewMode

Definition at line 63 of file qlistview.h.

◆ layoutMode

QListView::LayoutMode QListView::layoutMode
private

determines whether the layout of items should happen immediately or be delayed.

This property holds the layout mode for the items. When the mode is SinglePass (the default), the items are laid out all in one go. When the mode is Batched , the items are laid out in batches of batchSize items, while processing events. This makes it possible to instantly view and interact with the visible items while the rest are being laid out.

See also
viewMode

Definition at line 65 of file qlistview.h.

◆ modelColumn

int QListView::modelColumn
private

the column in the model that is visible

By default, this property contains 0, indicating that the first column in the model will be shown.

Definition at line 69 of file qlistview.h.

◆ movement

QListView::Movement QListView::movement
private

whether the items can be moved freely, are snapped to a grid, or cannot be moved at all.

This property determines how the user can move the items in the view. Static means that the items can't be moved the user. Free means that the user can drag and drop the items to any position in the view. Snap means that the user can drag and drop the items, but only to the positions in a notional grid signified by the gridSize property.

Setting this property when the view is visible will cause the items to be laid out again.

By default, this property is set to Static .

See also
gridSize, resizeMode, viewMode

Definition at line 61 of file qlistview.h.

◆ resizeMode

QListView::ResizeMode QListView::resizeMode
private

whether the items are laid out again when the view is resized.

If this property is Adjust , the items will be laid out again when the view is resized. If the value is Fixed , the items will not be laid out when the view is resized.

By default, this property is set to Fixed .

See also
movement, gridSize, viewMode

Definition at line 64 of file qlistview.h.

◆ selectionRectVisible

QListView::selectionRectVisible
private

if the selection rectangle should be visible

Since
4.3

If this property is true then the selection rectangle is visible; otherwise it will be hidden.

Note
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.

By default, this property is false.

Definition at line 73 of file qlistview.h.

◆ spacing

int QListView::spacing
private

the space around the items in the layout

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

Setting this property when the view is visible will cause the items to be laid out again.

By default, this property contains a value of 0.

See also
viewMode

Definition at line 66 of file qlistview.h.

Referenced by QComboBoxPrivateContainer::spacing().

◆ uniformItemSizes

bool QListView::uniformItemSizes
private

whether all items in the listview have the same size

Since
4.1

This property should only be set to true if it is guaranteed that all items in the view have the same size. This enables the view to do some optimizations for performance purposes.

By default, this property is false.

Definition at line 70 of file qlistview.h.

◆ viewMode

QListView::ViewMode QListView::viewMode
private

the view mode of the QListView.

This property will change the other unset properties to conform with the set view mode. 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).

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

Definition at line 68 of file qlistview.h.

◆ wordWrap

bool QListView::wordWrap
private

the item text word-wrapping policy

Since
4.2

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.

Please note that even if wrapping is enabled, the cell will not be expanded to make room for the text. It will print ellipsis for text that cannot be shown, according to the view's QAbstractItemView::textElideMode.

Definition at line 72 of file qlistview.h.


The documentation for this class was generated from the following files: