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

The QListWidget class provides an item-based list widget. More...

#include <qlistwidget.h>

Inheritance diagram for QListWidget:
QListView QAbstractItemView QAbstractScrollArea QFrame QWidget QObject QPaintDevice

Public Slots

void clear ()
 Removes all items and selections in the view. More...
 
void scrollToItem (const QListWidgetItem *item, QAbstractItemView::ScrollHint hint=EnsureVisible)
 Scrolls the view if necessary to ensure that the item is visible. More...
 
- 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...
 

Signals

void currentItemChanged (QListWidgetItem *current, QListWidgetItem *previous)
 This signal is emitted whenever the current item changes. More...
 
void currentRowChanged (int currentRow)
 This signal is emitted whenever the current item changes. More...
 
void currentTextChanged (const QString &currentText)
 This signal is emitted whenever the current item changes. More...
 
void itemActivated (QListWidgetItem *item)
 This signal is emitted when the item is activated. More...
 
void itemChanged (QListWidgetItem *item)
 This signal is emitted whenever the data of item has changed. More...
 
void itemClicked (QListWidgetItem *item)
 This signal is emitted with the specified item when a mouse button is clicked on an item in the widget. More...
 
void itemDoubleClicked (QListWidgetItem *item)
 This signal is emitted with the specified item when a mouse button is double clicked on an item in the widget. More...
 
void itemEntered (QListWidgetItem *item)
 This signal is emitted when the mouse cursor enters an item. More...
 
void itemPressed (QListWidgetItem *item)
 This signal is emitted with the specified item when a mouse button is pressed on an item in the widget. More...
 
void itemSelectionChanged ()
 This signal is emitted whenever the selection changes. More...
 
- Signals inherited from QListView
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

void addItem (const QString &label)
 Inserts an item with the text label at the end of the list widget. More...
 
void addItem (QListWidgetItem *item)
 Inserts the item at the end of the list widget. More...
 
void addItems (const QStringList &labels)
 Inserts items with the text labels at the end of the list widget. More...
 
void closePersistentEditor (QListWidgetItem *item)
 Closes the persistent editor for the given item. More...
 
int count () const
 
QListWidgetItemcurrentItem () const
 Returns the current item. More...
 
int currentRow () const
 
void dropEvent (QDropEvent *event)
 Reimplemented Function More...
 
void editItem (QListWidgetItem *item)
 Starts editing the item if it is editable. More...
 
QList< QListWidgetItem * > findItems (const QString &text, Qt::MatchFlags flags) const
 Finds items with the text that matches the string text using the given flags. More...
 
void insertItem (int row, QListWidgetItem *item)
 Inserts the item at the position in the list given by row. More...
 
void insertItem (int row, const QString &label)
 Inserts an item with the text label in the list widget at the position given by row. More...
 
void insertItems (int row, const QStringList &labels)
 Inserts items from the list of labels into the list, starting at the given row. More...
 
bool isItemHidden (const QListWidgetItem *item) const
 Returns true if the item is explicitly hidden; otherwise returns false. More...
 
bool isItemSelected (const QListWidgetItem *item) const
 Returns true if item is selected; otherwise returns false. More...
 
bool isSortingEnabled () const
 
QListWidgetItemitem (int row) const
 Returns the item that occupies the given row in the list if one has been set; otherwise returns 0. More...
 
QListWidgetItemitemAt (const QPoint &p) const
 Returns a pointer to the item at the coordinates p. More...
 
QListWidgetItemitemAt (int x, int y) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a pointer to the item at the coordinates (x, y). More...
 
QWidgetitemWidget (QListWidgetItem *item) const
 Returns the widget displayed in the given item. More...
 
void openPersistentEditor (QListWidgetItem *item)
 Opens an editor for the given item. More...
 
 QListWidget (QWidget *parent=0)
 Constructs an empty QListWidget with the given parent. More...
 
void removeItemWidget (QListWidgetItem *item)
 
int row (const QListWidgetItem *item) const
 Returns the row containing the given item. More...
 
QList< QListWidgetItem * > selectedItems () const
 Returns a list of all selected items in the list widget. More...
 
void setCurrentItem (QListWidgetItem *item)
 Sets the current item to item. More...
 
void setCurrentItem (QListWidgetItem *item, QItemSelectionModel::SelectionFlags command)
 Set the current item to item, using the given command. More...
 
void setCurrentRow (int row)
 
void setCurrentRow (int row, QItemSelectionModel::SelectionFlags command)
 
void setItemHidden (const QListWidgetItem *item, bool hide)
 If hide is true, the item will be hidden; otherwise it will be shown. More...
 
void setItemSelected (const QListWidgetItem *item, bool select)
 Selects or deselects the given item depending on whether select is true of false. More...
 
void setItemWidget (QListWidgetItem *item, QWidget *widget)
 Sets the widget to be displayed in the give item. More...
 
void setSortingEnabled (bool enable)
 
void sortItems (Qt::SortOrder order=Qt::AscendingOrder)
 Sorts all the items in the list widget according to the specified order. More...
 
QListWidgetItemtakeItem (int row)
 Removes and returns the item from the given row in the list widget; otherwise returns 0. More...
 
QRect visualItemRect (const QListWidgetItem *item) const
 Returns the rectangle on the viewport occupied by the item at item. More...
 
 ~QListWidget ()
 Destroys the list widget and all its items. More...
 
- Public Functions inherited from QListView
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...
 
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

virtual bool dropMimeData (int index, const QMimeData *data, Qt::DropAction action)
 Handles data supplied by an external drag and drop operation that ended with the given action in the given index. More...
 
bool event (QEvent *e)
 Reimplemented Function More...
 
QModelIndex indexFromItem (QListWidgetItem *item) const
 Returns the QModelIndex assocated with the given item. More...
 
QListWidgetItemitemFromIndex (const QModelIndex &index) const
 Returns a pointer to the QListWidgetItem assocated with the given index. More...
 
QList< QListWidgetItem * > items (const QMimeData *data) const
 Returns a list of pointers to the items contained in the data object. More...
 
virtual QMimeDatamimeData (const QList< QListWidgetItem *> items) const
 Returns an object that contains a serialized description of the specified items. More...
 
virtual QStringList mimeTypes () const
 Returns a list of MIME types that can be used to describe a list of listwidget items. More...
 
virtual Qt::DropActions supportedDropActions () const
 Returns the drop actions supported by this view. More...
 
- Protected Functions inherited from QListView
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...
 
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

void setModel (QAbstractItemModel *model)
 
Qt::SortOrder sortOrder () const
 

Properties

int count
 the number of items in the list including any hidden items. More...
 
int currentRow
 the row of the current item. More...
 
bool sortingEnabled
 whether sorting is enabled More...
 

Friends

class QListModel
 
class QListWidgetItem
 

Additional Inherited Members

- Public Types inherited from QListView
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
}
 
- 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 QListWidget class provides an item-based list widget.

QListWidget is a convenience class that provides a list view similar to the one supplied by QListView, but with a classic item-based interface for adding and removing items. QListWidget uses an internal model to manage each QListWidgetItem in the list.

For a more flexible list view widget, use the QListView class with a standard model.

List widgets are constructed in the same way as other widgets:

QListWidget *listWidget = new QListWidget(this);

The selectionMode() of a list widget determines how many of the items in the list can be selected at the same time, and whether complex selections of items can be created. This can be set with the setSelectionMode() function.

There are two ways to add items to the list: they can be constructed with the list widget as their parent widget, or they can be constructed with no parent widget and added to the list later. If a list widget already exists when the items are constructed, the first method is easier to use:

new QListWidgetItem(tr("Oak"), listWidget);
new QListWidgetItem(tr("Fir"), listWidget);
new QListWidgetItem(tr("Pine"), listWidget);

If you need to insert a new item into the list at a particular position, then it should be constructed without a parent widget. The insertItem() function should then be used to place it within the list. The list widget will take ownership of the item.

newItem->setText(itemText);
listWidget->insertItem(row, newItem);

For multiple items, insertItems() can be used instead. The number of items in the list is found with the count() function. To remove items from the list, use takeItem().

The current item in the list can be found with currentItem(), and changed with setCurrentItem(). The user can also change the current item by navigating with the keyboard or clicking on a different item. When the current item changes, the currentItemChanged() signal is emitted with the new current item and the item that was previously current.

windowsxp-listview.png
Screenshot of a Windows XP style list widget
macintosh-listview.png
Screenshot of a Macintosh style table widget
plastique-listview.png
Screenshot of a Plastique style table widget
A Windows XP Style Widget Gallery{Windows XP style} list widget. A Macintosh Style Widget Gallery{Macintosh style} list widget. A Plastique Style Widget Gallery{Plastique style} list widget.
See also
QListWidgetItem, QListView, QTreeView, {Model/View Programming}, {Config Dialog Example}

Definition at line 202 of file qlistwidget.h.

Constructors and Destructors

◆ QListWidget()

QListWidget::QListWidget ( QWidget parent = 0)
explicit

Constructs an empty QListWidget with the given parent.

Definition at line 1458 of file qlistwidget.cpp.

1459  : QListView(*new QListWidgetPrivate(), parent)
1460 {
1461  Q_D(QListWidget);
1462  d->setup();
1463 }
QListView(QWidget *parent=0)
Creates a new QListView with the given parent to view a model.
Definition: qlistview.cpp:185
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482

◆ ~QListWidget()

QListWidget::~QListWidget ( )

Destroys the list widget and all its items.

Definition at line 1469 of file qlistwidget.cpp.

1470 {
1471 }

Functions

◆ addItem() [1/2]

void QListWidget::addItem ( const QString label)
inline

Inserts an item with the text label at the end of the list widget.

Definition at line 220 of file qlistwidget.h.

220 { insertItem(count(), label); }
void insertItem(int row, QListWidgetItem *item)
Inserts the item at the position in the list given by row.
int count() const

◆ addItem() [2/2]

void QListWidget::addItem ( QListWidgetItem item)
inline

Inserts the item at the end of the list widget.

Warning
A QListWidgetItem can only be added to a QListWidget once. Adding the same QListWidgetItem multiple times to a QListWidget will result in undefined behavior.
See also
insertItem()

Definition at line 311 of file qlistwidget.h.

312 { insertItem(count(), aitem); }
void insertItem(int row, QListWidgetItem *item)
Inserts the item at the position in the list given by row.
int count() const

◆ addItems()

void QListWidget::addItems ( const QStringList labels)
inline

Inserts items with the text labels at the end of the list widget.

See also
insertItems()

Definition at line 222 of file qlistwidget.h.

222 { insertItems(count(), labels); }
int count() const
void insertItems(int row, const QStringList &labels)
Inserts items from the list of labels into the list, starting at the given row.

◆ clear

void QListWidget::clear ( )
slot

Removes all items and selections in the view.

Warning
All items will be permanently deleted.

Definition at line 1903 of file qlistwidget.cpp.

1904 {
1905  Q_D(QListWidget);
1906  selectionModel()->clear();
1907  d->listModel()->clear();
1908 }
double d
Definition: qnumeric_p.h:62
virtual void clear()
Clears the selection model.
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
QItemSelectionModel * selectionModel() const
Returns the current selection model.

◆ closePersistentEditor()

void QListWidget::closePersistentEditor ( QListWidgetItem item)

Closes the persistent editor for the given item.

See also
openPersistentEditor()

Definition at line 1748 of file qlistwidget.cpp.

1749 {
1750  Q_D(QListWidget);
1751  QModelIndex index = d->listModel()->index(item);
1753 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
The QModelIndex class is used to locate data in a data model.
quint16 index
void closePersistentEditor(const QModelIndex &index)
Closes the persistent editor for the item at the given index.

◆ count()

int QListWidget::count ( ) const

Referenced by dropEvent(), and takeItem().

◆ currentItem()

QListWidgetItem * QListWidget::currentItem ( ) const

Returns the current item.

Definition at line 1575 of file qlistwidget.cpp.

1576 {
1577  Q_D(const QListWidget);
1578  return d->listModel()->at(currentIndex().row());
1579 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
QModelIndex currentIndex() const
Returns the model index of the current item.
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ currentItemChanged

void QListWidget::currentItemChanged ( QListWidgetItem current,
QListWidgetItem previous 
)
signal

This signal is emitted whenever the current item changes.

previous is the item that previously had the focus; current is the new current item.

◆ currentRow()

int QListWidget::currentRow ( ) const

Referenced by setCurrentItem().

◆ currentRowChanged

void QListWidget::currentRowChanged ( int  currentRow)
signal

This signal is emitted whenever the current item changes.

currentRow is the row of the current item. If there is no current item, the currentRow is -1.

◆ currentTextChanged

void QListWidget::currentTextChanged ( const QString currentText)
signal

This signal is emitted whenever the current item changes.

currentText is the text data in the current item. If there is no current item, the currentText is invalid.

◆ dropEvent()

void QListWidget::dropEvent ( QDropEvent event)
virtual

Reimplemented Function

Reimplemented from QListView.

Definition at line 1957 of file qlistwidget.cpp.

1957  {
1958  Q_D(QListWidget);
1959  if (event->source() == this && d->movement != Static) {
1960  QListView::dropEvent(event);
1961  return;
1962  }
1963 
1964  if (event->source() == this && (event->dropAction() == Qt::MoveAction ||
1966  QModelIndex topIndex;
1967  int col = -1;
1968  int row = -1;
1969  if (d->dropOn(event, &row, &col, &topIndex)) {
1970  QList<QModelIndex> selIndexes = selectedIndexes();
1971  QList<QPersistentModelIndex> persIndexes;
1972  for (int i = 0; i < selIndexes.count(); i++)
1973  persIndexes.append(selIndexes.at(i));
1974 
1975  if (persIndexes.contains(topIndex))
1976  return;
1977  qSort(persIndexes); // The dropped items will remain in the same visual order.
1978 
1979  QPersistentModelIndex dropRow = model()->index(row, col, topIndex);
1980 
1981  int r = row == -1 ? count() : (dropRow.row() >= 0 ? dropRow.row() : row);
1982  for (int i = 0; i < persIndexes.count(); ++i) {
1983  const QPersistentModelIndex &pIndex = persIndexes.at(i);
1984  d->listModel()->move(pIndex.row(), r);
1985  r = pIndex.row() + 1; // Dropped items are inserted contiguously and in the right order.
1986  }
1987 
1988  event->accept();
1989  // Don't want QAbstractItemView to delete it because it was "moved" we already did it
1990  event->setDropAction(Qt::CopyAction);
1991  }
1992  }
1993 
1994  QListView::dropEvent(event);
1995 }
double d
Definition: qnumeric_p.h:62
int row() const
Returns the row this persistent model index refers to.
DragDropMode dragDropMode() const
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
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
int count() const
virtual QModelIndex index(int row, int column, const QModelIndex &parent=QModelIndex()) const =0
Returns the index of the item in the model specified by the given row, column and parent index...
void append(const T &t)
Inserts value at the end of the list.
Definition: qlist.h:507
QBool contains(const T &t) const
Returns true if the list contains an occurrence of value; otherwise returns false.
Definition: qlist.h:880
const T & at(int i) const
Returns the item at index position i in the list.
Definition: qlist.h:468
void qSort(RandomAccessIterator start, RandomAccessIterator end)
Definition: qalgorithms.h:177
The QPersistentModelIndex class is used to locate data in a data model.
QWidget * source() const
If the source of the drag operation is a widget in this application, this function returns that sourc...
Definition: qevent.cpp:2739
The QModelIndex class is used to locate data in a data model.
QModelIndexList selectedIndexes() const
Reimplemented Function
Definition: qlistview.cpp:1482
int row(const QListWidgetItem *item) const
Returns the row containing the given item.
QAbstractItemModel * model() const
Returns the model that this view is presenting.
void dropEvent(QDropEvent *e)
Reimplemented Function
Definition: qlistview.cpp:917

◆ dropMimeData()

bool QListWidget::dropMimeData ( int  index,
const QMimeData data,
Qt::DropAction  action 
)
protectedvirtual

Handles data supplied by an external drag and drop operation that ended with the given action in the given index.

Returns true if data and action can be handled by the model; otherwise returns false.

See also
supportedDropActions()

Definition at line 1942 of file qlistwidget.cpp.

Referenced by QListModel::dropMimeData().

1943 {
1944  QModelIndex idx;
1945  int row = index;
1946  int column = 0;
1948  // QAbstractListModel::dropMimeData will overwrite on the index if row == -1 and column == -1
1949  idx = model()->index(row, column);
1950  row = -1;
1951  column = -1;
1952  }
1953  return d_func()->listModel()->QAbstractListModel::dropMimeData(data, action , row, column, idx);
1954 }
DropIndicatorPosition dropIndicatorPosition() const
Returns the position of the drop indicator in relation to the closest item.
virtual QModelIndex index(int row, int column, const QModelIndex &parent=QModelIndex()) const =0
Returns the index of the item in the model specified by the given row, column and parent index...
The QModelIndex class is used to locate data in a data model.
quint16 index
int row(const QListWidgetItem *item) const
Returns the row containing the given item.
QAbstractItemModel * model() const
Returns the model that this view is presenting.

◆ editItem()

void QListWidget::editItem ( QListWidgetItem item)

Starts editing the item if it is editable.

Definition at line 1724 of file qlistwidget.cpp.

1725 {
1726  Q_D(QListWidget);
1727  edit(d->listModel()->index(item));
1728 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
void edit(const QModelIndex &index)
Starts editing the item corresponding to the given index if it is editable.

◆ event()

bool QListWidget::event ( QEvent e)
protectedvirtual

Reimplemented Function

Reimplemented from QListView.

Definition at line 2055 of file qlistwidget.cpp.

2056 {
2057  return QListView::event(e);
2058 }
bool event(QEvent *e)
Reimplemented Function
Definition: qlistview.cpp:1693

◆ findItems()

QList< QListWidgetItem * > QListWidget::findItems ( const QString text,
Qt::MatchFlags  flags 
) const

Finds items with the text that matches the string text using the given flags.

Definition at line 1850 of file qlistwidget.cpp.

1851 {
1852  Q_D(const QListWidget);
1853  QModelIndexList indexes = d->listModel()->match(model()->index(0, 0, QModelIndex()),
1854  Qt::DisplayRole, text, -1, flags);
1856  for (int i = 0; i < indexes.size(); ++i)
1857  items.append(d->listModel()->at(indexes.at(i).row()));
1858  return items;
1859 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
void append(const T &t)
Inserts value at the end of the list.
Definition: qlist.h:507
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
QList< QListWidgetItem * > items(const QMimeData *data) const
Returns a list of pointers to the items contained in the data object.
The QModelIndex class is used to locate data in a data model.
int size() const
Returns the number of items in the list.
Definition: qlist.h:137
quint16 index
QAbstractItemModel * model() const
Returns the model that this view is presenting.

◆ indexFromItem()

QModelIndex QListWidget::indexFromItem ( QListWidgetItem item) const
protected

Returns the QModelIndex assocated with the given item.

Definition at line 2026 of file qlistwidget.cpp.

2027 {
2028  Q_D(const QListWidget);
2029  return d->listModel()->index(item);
2030 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482

◆ insertItem() [1/2]

void QListWidget::insertItem ( int  row,
QListWidgetItem item 
)

Inserts the item at the position in the list given by row.

See also
addItem()

Definition at line 1507 of file qlistwidget.cpp.

1508 {
1509  Q_D(QListWidget);
1510  if (item && !item->view)
1511  d->listModel()->insert(row, item);
1512 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
QListWidget * view
Definition: qlistwidget.h:168
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ insertItem() [2/2]

void QListWidget::insertItem ( int  row,
const QString label 
)

Inserts an item with the text label in the list widget at the position given by row.

See also
addItem()

Definition at line 1521 of file qlistwidget.cpp.

1522 {
1523  Q_D(QListWidget);
1524  d->listModel()->insert(row, new QListWidgetItem(label));
1525 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
friend class QListWidgetItem
Definition: qlistwidget.h:209
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ insertItems()

void QListWidget::insertItems ( int  row,
const QStringList labels 
)

Inserts items from the list of labels into the list, starting at the given row.

See also
insertItem(), addItem()

Definition at line 1534 of file qlistwidget.cpp.

1535 {
1536  Q_D(QListWidget);
1537  d->listModel()->insert(row, labels);
1538 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ isItemHidden()

bool QListWidget::isItemHidden ( const QListWidgetItem item) const

Returns true if the item is explicitly hidden; otherwise returns false.

This function is deprecated. Use QListWidgetItem::isHidden() instead.

Definition at line 1868 of file qlistwidget.cpp.

1869 {
1870  return isRowHidden(row(item));
1871 }
int row(const QListWidgetItem *item) const
Returns the row containing the given item.
bool isRowHidden(int row) const
Returns true if the row is hidden; otherwise returns false.
Definition: qlistview.cpp:563

◆ isItemSelected()

bool QListWidget::isItemSelected ( const QListWidgetItem item) const

Returns true if item is selected; otherwise returns false.

This function is deprecated. Use QListWidgetItem::isSelected() instead.

Definition at line 1799 of file qlistwidget.cpp.

1800 {
1801  Q_D(const QListWidget);
1802  QModelIndex index = d->listModel()->index(const_cast<QListWidgetItem*>(item));
1803  return selectionModel()->isSelected(index);
1804 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
QItemSelectionModel * selectionModel() const
Returns the current selection model.
bool isSelected(const QModelIndex &index) const
Returns true if the given model item index is selected.
The QModelIndex class is used to locate data in a data model.
quint16 index

◆ isSortingEnabled()

bool QListWidget::isSortingEnabled ( ) const

Definition at line 1705 of file qlistwidget.cpp.

Referenced by QListModel::insert().

1706 {
1707  Q_D(const QListWidget);
1708  return d->sortingEnabled;
1709 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482

◆ item()

QListWidgetItem * QListWidget::item ( int  row) const

Returns the item that occupies the given row in the list if one has been set; otherwise returns 0.

See also
row()

Definition at line 1480 of file qlistwidget.cpp.

Referenced by QListWidgetItem::setFont().

1481 {
1482  Q_D(const QListWidget);
1483  if (row < 0 || row >= d->model->rowCount())
1484  return 0;
1485  return d->listModel()->at(row);
1486 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ itemActivated

void QListWidget::itemActivated ( QListWidgetItem item)
signal

This signal is emitted when the item is activated.

The item is activated when the user clicks or double clicks on it, depending on the system configuration. It is also activated when the user presses the activation key (on Windows and X11 this is the Return key, on Mac OS X it is Ctrl+0).

◆ itemAt() [1/2]

QListWidgetItem * QListWidget::itemAt ( const QPoint p) const

Returns a pointer to the item at the coordinates p.

The coordinates are relative to the list widget's QAbstractScrollArea::viewport().

Definition at line 1648 of file qlistwidget.cpp.

1649 {
1650  Q_D(const QListWidget);
1651  return d->listModel()->at(indexAt(p).row());
1652 
1653 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
QModelIndex indexAt(const QPoint &p) const
Reimplemented Function
Definition: qlistview.cpp:1112
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ itemAt() [2/2]

QListWidgetItem * QListWidget::itemAt ( int  x,
int  y 
) const
inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a pointer to the item at the coordinates (x, y).

The coordinates are relative to the list widget's QAbstractScrollArea::viewport().

Definition at line 314 of file qlistwidget.h.

315 { return itemAt(QPoint(ax, ay)); }
QListWidgetItem * itemAt(const QPoint &p) const
Returns a pointer to the item at the coordinates p.
The QPoint class defines a point in the plane using integer precision.
Definition: qpoint.h:53

◆ itemChanged

void QListWidget::itemChanged ( QListWidgetItem item)
signal

This signal is emitted whenever the data of item has changed.

◆ itemClicked

void QListWidget::itemClicked ( QListWidgetItem item)
signal

This signal is emitted with the specified item when a mouse button is clicked on an item in the widget.

See also
itemPressed(), itemDoubleClicked()

◆ itemDoubleClicked

void QListWidget::itemDoubleClicked ( QListWidgetItem item)
signal

This signal is emitted with the specified item when a mouse button is double clicked on an item in the widget.

See also
itemClicked(), itemPressed()

◆ itemEntered

void QListWidget::itemEntered ( QListWidgetItem item)
signal

This signal is emitted when the mouse cursor enters an item.

The item is the item entered. This signal is only emitted when mouseTracking is turned on, or when a mouse button is pressed while moving into an item.

See also
QWidget::setMouseTracking()

◆ itemFromIndex()

QListWidgetItem * QListWidget::itemFromIndex ( const QModelIndex index) const
protected

Returns a pointer to the QListWidgetItem assocated with the given index.

Definition at line 2036 of file qlistwidget.cpp.

2037 {
2038  Q_D(const QListWidget);
2039  if (d->isIndexValid(index))
2040  return d->listModel()->at(index.row());
2041  return 0;
2042 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
int row() const
Returns the row this model index refers to.

◆ itemPressed

void QListWidget::itemPressed ( QListWidgetItem item)
signal

This signal is emitted with the specified item when a mouse button is pressed on an item in the widget.

See also
itemClicked(), itemDoubleClicked()

◆ items()

QList< QListWidgetItem * > QListWidget::items ( const QMimeData data) const
protected

Returns a list of pointers to the items contained in the data object.

If the object was not created by a QListWidget in the same process, the list is empty.

Definition at line 2014 of file qlistwidget.cpp.

Referenced by findItems(), and selectedItems().

2015 {
2017  if (lwd)
2018  return lwd->items;
2019  return QList<QListWidgetItem*>();
2020 }
T * qobject_cast(QObject *object)
Definition: qobject.h:375
QList< QListWidgetItem * > items
Definition: qlistwidget.cpp:59
QWidgetData * data
Definition: qwidget.h:815
The QList class is a template class that provides lists.
Definition: qdatastream.h:62

◆ itemSelectionChanged

void QListWidget::itemSelectionChanged ( )
signal

This signal is emitted whenever the selection changes.

See also
selectedItems(), QListWidgetItem::isSelected(), currentItemChanged()

◆ itemWidget()

QWidget * QListWidget::itemWidget ( QListWidgetItem item) const

Returns the widget displayed in the given item.

Since
4.1

Definition at line 1763 of file qlistwidget.cpp.

1764 {
1765  Q_D(const QListWidget);
1766  QModelIndex index = d->listModel()->index(item);
1767  return QAbstractItemView::indexWidget(index);
1768 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
QWidget * indexWidget(const QModelIndex &index) const
Returns the widget for the item at the given index.
The QModelIndex class is used to locate data in a data model.
quint16 index

◆ mimeData()

QMimeData * QListWidget::mimeData ( const QList< QListWidgetItem *>  items) const
protectedvirtual

Returns an object that contains a serialized description of the specified items.

The format used to describe the items is obtained from the mimeTypes() function.

If the list of items is empty, 0 is returned instead of a serialized empty list.

Definition at line 1929 of file qlistwidget.cpp.

Referenced by QListModel::mimeData().

1930 {
1931  return d_func()->listModel()->internalMimeData();
1932 }

◆ mimeTypes()

QStringList QListWidget::mimeTypes ( ) const
protectedvirtual

Returns a list of MIME types that can be used to describe a list of listwidget items.

See also
mimeData()

Definition at line 1916 of file qlistwidget.cpp.

Referenced by QListModel::mimeTypes().

1917 {
1918  return d_func()->listModel()->QAbstractListModel::mimeTypes();
1919 }

◆ openPersistentEditor()

void QListWidget::openPersistentEditor ( QListWidgetItem item)

Opens an editor for the given item.

The editor remains open after editing.

See also
closePersistentEditor()

Definition at line 1736 of file qlistwidget.cpp.

1737 {
1738  Q_D(QListWidget);
1739  QModelIndex index = d->listModel()->index(item);
1741 }
double d
Definition: qnumeric_p.h:62
void openPersistentEditor(const QModelIndex &index)
Opens a persistent editor on the item at the given index.
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
The QModelIndex class is used to locate data in a data model.
quint16 index

◆ removeItemWidget()

void QListWidget::removeItemWidget ( QListWidgetItem item)
inline
Since
4.3

Removes the widget set on the given item.

Definition at line 308 of file qlistwidget.h.

309 { setItemWidget(aItem, 0); }
void setItemWidget(QListWidgetItem *item, QWidget *widget)
Sets the widget to be displayed in the give item.

◆ row()

int QListWidget::row ( const QListWidgetItem item) const

Returns the row containing the given item.

See also
item()

Definition at line 1494 of file qlistwidget.cpp.

Referenced by currentItem(), dropEvent(), dropMimeData(), isItemHidden(), itemAt(), setCurrentItem(), and setItemHidden().

1495 {
1496  Q_D(const QListWidget);
1497  return d->listModel()->index(const_cast<QListWidgetItem*>(item)).row();
1498 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482

◆ scrollToItem

void QListWidget::scrollToItem ( const QListWidgetItem item,
QAbstractItemView::ScrollHint  hint = EnsureVisible 
)
slot

Scrolls the view if necessary to ensure that the item is visible.

hint specifies where the item should be located after the operation.

Definition at line 1891 of file qlistwidget.cpp.

1892 {
1893  Q_D(QListWidget);
1894  QModelIndex index = d->listModel()->index(const_cast<QListWidgetItem*>(item));
1895  QListView::scrollTo(index, hint);
1896 }
double d
Definition: qnumeric_p.h:62
void scrollTo(const QModelIndex &index, ScrollHint hint=EnsureVisible)
Reimplemented Function
Definition: qlistview.cpp:597
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
The QModelIndex class is used to locate data in a data model.
quint16 index

◆ selectedItems()

QList< QListWidgetItem * > QListWidget::selectedItems ( ) const

Returns a list of all selected items in the list widget.

Definition at line 1835 of file qlistwidget.cpp.

1836 {
1837  Q_D(const QListWidget);
1840  for (int i = 0; i < indexes.count(); ++i)
1841  items.append(d->listModel()->at(indexes.at(i).row()));
1842  return items;
1843 }
double d
Definition: qnumeric_p.h:62
QModelIndexList selectedIndexes() const
Returns a list of all selected model item indexes.
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
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
void append(const T &t)
Inserts value at the end of the list.
Definition: qlist.h:507
QItemSelectionModel * selectionModel() const
Returns the current selection model.
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
QList< QListWidgetItem * > items(const QMimeData *data) const
Returns a list of pointers to the items contained in the data object.

◆ setCurrentItem() [1/2]

void QListWidget::setCurrentItem ( QListWidgetItem item)

Sets the current item to item.

Unless the selection mode is QAbstractItemView::NoSelection, the item is also be selected.

Definition at line 1588 of file qlistwidget.cpp.

1589 {
1590  setCurrentRow(row(item));
1591 }
void setCurrentRow(int row)
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ setCurrentItem() [2/2]

void QListWidget::setCurrentItem ( QListWidgetItem item,
QItemSelectionModel::SelectionFlags  command 
)

Set the current item to item, using the given command.

Since
4.4

Definition at line 1600 of file qlistwidget.cpp.

1601 {
1602  setCurrentRow(row(item), command);
1603 }
void setCurrentRow(int row)
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ setCurrentRow() [1/2]

void QListWidget::setCurrentRow ( int  row)

Definition at line 1620 of file qlistwidget.cpp.

Referenced by setCurrentItem().

1621 {
1622  Q_D(QListWidget);
1623  QModelIndex index = d->listModel()->index(row);
1624  if (d->selectionMode == SingleSelection)
1626  else if (d->selectionMode == NoSelection)
1628  else
1630 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
void setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)
Sets the model item index to be the current item, and emits currentChanged().
QItemSelectionModel * selectionModel() const
Returns the current selection model.
The QModelIndex class is used to locate data in a data model.
quint16 index
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ setCurrentRow() [2/2]

void QListWidget::setCurrentRow ( int  row,
QItemSelectionModel::SelectionFlags  command 
)
Since
4.4

Sets the current row to be the given row, using the given command,

Definition at line 1637 of file qlistwidget.cpp.

1638 {
1639  Q_D(QListWidget);
1640  d->selectionModel->setCurrentIndex(d->listModel()->index(row), command);
1641 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ setItemHidden()

void QListWidget::setItemHidden ( const QListWidgetItem item,
bool  hide 
)

If hide is true, the item will be hidden; otherwise it will be shown.

This function is deprecated. Use QListWidgetItem::setHidden() instead.

Definition at line 1880 of file qlistwidget.cpp.

1881 {
1882  setRowHidden(row(item), hide);
1883 }
void setRowHidden(int row, bool hide)
If hide is true, the given row will be hidden; otherwise the row will be shown.
Definition: qlistview.cpp:573
void hide()
Hides the widget.
Definition: qwidget.h:501
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ setItemSelected()

void QListWidget::setItemSelected ( const QListWidgetItem item,
bool  select 
)

Selects or deselects the given item depending on whether select is true of false.

This function is deprecated. Use QListWidgetItem::setSelected() instead.

Definition at line 1814 of file qlistwidget.cpp.

1815 {
1816  Q_D(QListWidget);
1817  QModelIndex index = d->listModel()->index(const_cast<QListWidgetItem*>(item));
1818 
1819  if (d->selectionMode == SingleSelection) {
1820  selectionModel()->select(index, select
1823  } else if (d->selectionMode != NoSelection) {
1824  selectionModel()->select(index, select
1827  }
1828 
1829 }
double d
Definition: qnumeric_p.h:62
int select(int, fd_set *, fd_set *, fd_set *, struct timeval *)
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
QItemSelectionModel * selectionModel() const
Returns the current selection model.
virtual void select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)
Selects the model item index using the specified command, and emits selectionChanged().
The QModelIndex class is used to locate data in a data model.
quint16 index

◆ setItemWidget()

void QListWidget::setItemWidget ( QListWidgetItem item,
QWidget widget 
)

Sets the widget to be displayed in the give item.

Since
4.1

This function should only be used to display static content in the place of a list widget item. If you want to display custom dynamic content or implement a custom editor widget, use QListView and subclass QItemDelegate instead.

See also
{Delegate Classes}

Definition at line 1785 of file qlistwidget.cpp.

1786 {
1787  Q_D(QListWidget);
1788  QModelIndex index = d->listModel()->index(item);
1789  QAbstractItemView::setIndexWidget(index, widget);
1790 }
double d
Definition: qnumeric_p.h:62
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 view...
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
The QModelIndex class is used to locate data in a data model.
quint16 index

◆ setModel()

void QListWidget::setModel ( QAbstractItemModel model)
privatevirtual
Warning
This function is not part of the public interface.

Reimplemented from QAbstractItemView.

Definition at line 2047 of file qlistwidget.cpp.

2048 {
2049  Q_ASSERT(!"QListWidget::setModel() - Changing the model of the QListWidget is not allowed.");
2050 }
#define Q_ASSERT(cond)
Definition: qglobal.h:1823

◆ setSortingEnabled()

void QListWidget::setSortingEnabled ( bool  enable)

Definition at line 1699 of file qlistwidget.cpp.

1700 {
1701  Q_D(QListWidget);
1702  d->sortingEnabled = enable;
1703 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482

◆ sortItems()

void QListWidget::sortItems ( Qt::SortOrder  order = Qt::AscendingOrder)

Sorts all the items in the list widget according to the specified order.

Definition at line 1679 of file qlistwidget.cpp.

1680 {
1681  Q_D(QListWidget);
1682  d->sortOrder = order;
1683  d->listModel()->sort(0, order);
1684 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482

◆ sortOrder()

Qt::SortOrder QListWidget::sortOrder ( ) const
private
Warning
This function is not part of the public interface.

Definition at line 1714 of file qlistwidget.cpp.

Referenced by QListModel::insert().

1715 {
1716  Q_D(const QListWidget);
1717  return d->sortOrder;
1718 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482

◆ supportedDropActions()

Qt::DropActions QListWidget::supportedDropActions ( ) const
protectedvirtual

Returns the drop actions supported by this view.

See also
Qt::DropActions

Definition at line 2002 of file qlistwidget.cpp.

Referenced by QListModel::supportedDropActions().

2003 {
2004  Q_D(const QListWidget);
2005  return d->listModel()->QAbstractListModel::supportedDropActions() | Qt::MoveAction;
2006 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482

◆ takeItem()

QListWidgetItem * QListWidget::takeItem ( int  row)

Removes and returns the item from the given row in the list widget; otherwise returns 0.

Items removed from a list widget will not be managed by Qt, and will need to be deleted manually.

See also
insertItem(), addItem()

Definition at line 1550 of file qlistwidget.cpp.

1551 {
1552  Q_D(QListWidget);
1553  if (row < 0 || row >= d->model->rowCount())
1554  return 0;
1555  return d->listModel()->take(row);
1556 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
int row(const QListWidgetItem *item) const
Returns the row containing the given item.

◆ visualItemRect()

QRect QListWidget::visualItemRect ( const QListWidgetItem item) const

Returns the rectangle on the viewport occupied by the item at item.

Definition at line 1669 of file qlistwidget.cpp.

1670 {
1671  Q_D(const QListWidget);
1672  QModelIndex index = d->listModel()->index(const_cast<QListWidgetItem*>(item));
1673  return visualRect(index);
1674 }
double d
Definition: qnumeric_p.h:62
The QListWidget class provides an item-based list widget.
Definition: qlistwidget.h:202
#define Q_D(Class)
Definition: qglobal.h:2482
QRect visualRect(const QModelIndex &index) const
Reimplemented Function
Definition: qlistview.cpp:588
The QModelIndex class is used to locate data in a data model.
quint16 index

Friends and Related Functions

◆ QListModel

friend class QListModel
friend

Definition at line 210 of file qlistwidget.h.

◆ QListWidgetItem

friend class QListWidgetItem
friend

Definition at line 209 of file qlistwidget.h.

Referenced by insertItem().

Properties

◆ count

int QListWidget::count
private

the number of items in the list including any hidden items.

Definition at line 205 of file qlistwidget.h.

◆ currentRow

int QListWidget::currentRow
private

the row of the current item.

Depending on the current selection mode, the row may also be selected.

Definition at line 206 of file qlistwidget.h.

◆ sortingEnabled

QListWidget::sortingEnabled
private

whether sorting is enabled

Since
4.2

If this property is true, sorting is enabled for the list; if the property is false, sorting is not enabled.

The default value is false.

Definition at line 207 of file qlistwidget.h.


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