QAbstractItemView Class
La clase `QAbstractItemView` proporciona la funcionalidad básica para las clases de vista de elementos. Más información...
| Encabezado: | #include <QAbstractItemView> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QAbstractScrollArea |
| Heredado por: |
Tipos públicos
| enum | DragDropMode { NoDragDrop, DragOnly, DropOnly, DragDrop, InternalMove } |
| enum | EditTrigger { NoEditTriggers, CurrentChanged, DoubleClicked, SelectedClicked, EditKeyPressed, …, AllEditTriggers } |
| flags | EditTriggers |
| enum | ScrollHint { EnsureVisible, PositionAtTop, PositionAtBottom, PositionAtCenter } |
| enum | ScrollMode { ScrollPerItem, ScrollPerPixel } |
| enum | SelectionBehavior { SelectItems, SelectRows, SelectColumns } |
| enum | SelectionMode { SingleSelection, ContiguousSelection, ExtendedSelection, MultiSelection, NoSelection } |
Propiedades
|
|
Funciones públicas
| QAbstractItemView(QWidget *parent = nullptr) | |
| virtual | ~QAbstractItemView() |
| bool | alternatingRowColors() const |
| int | autoScrollMargin() const |
| void | closePersistentEditor(const QModelIndex &index) |
| QModelIndex | currentIndex() const |
| Qt::DropAction | defaultDropAction() const |
| QAbstractItemView::DragDropMode | dragDropMode() const |
| bool | dragDropOverwriteMode() const |
| bool | dragEnabled() const |
| QAbstractItemView::EditTriggers | editTriggers() const |
| bool | hasAutoScroll() const |
| QAbstractItemView::ScrollMode | horizontalScrollMode() const |
| QSize | iconSize() const |
| virtual QModelIndex | indexAt(const QPoint &point) const = 0 |
| QWidget * | indexWidget(const QModelIndex &index) const |
| bool | isPersistentEditorOpen(const QModelIndex &index) const |
| QAbstractItemDelegate * | itemDelegate() const |
| QAbstractItemDelegate * | itemDelegateForColumn(int column) const |
(since 6.0) virtual QAbstractItemDelegate * | itemDelegateForIndex(const QModelIndex &index) const |
| QAbstractItemDelegate * | itemDelegateForRow(int row) const |
| virtual void | keyboardSearch(const QString &search) |
| Qt::MatchFlags | keyboardSearchFlags() const |
| QAbstractItemModel * | model() const |
| void | openPersistentEditor(const QModelIndex &index) |
| void | resetHorizontalScrollMode() |
| void | resetVerticalScrollMode() |
| QModelIndex | rootIndex() const |
| virtual void | scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible) = 0 |
| QAbstractItemView::SelectionBehavior | selectionBehavior() const |
| QAbstractItemView::SelectionMode | selectionMode() const |
| QItemSelectionModel * | selectionModel() const |
| void | setAlternatingRowColors(bool enable) |
| void | setAutoScroll(bool enable) |
| void | setAutoScrollMargin(int margin) |
| void | setDefaultDropAction(Qt::DropAction dropAction) |
| void | setDragDropMode(QAbstractItemView::DragDropMode behavior) |
| void | setDragDropOverwriteMode(bool overwrite) |
| void | setDragEnabled(bool enable) |
| void | setDropIndicatorShown(bool enable) |
| void | setEditTriggers(QAbstractItemView::EditTriggers triggers) |
| void | setHorizontalScrollMode(QAbstractItemView::ScrollMode mode) |
| void | setIconSize(const QSize &size) |
| void | setIndexWidget(const QModelIndex &index, QWidget *widget) |
| void | setItemDelegate(QAbstractItemDelegate *delegate) |
| void | setItemDelegateForColumn(int column, QAbstractItemDelegate *delegate) |
| void | setItemDelegateForRow(int row, QAbstractItemDelegate *delegate) |
| void | setKeyboardSearchFlags(Qt::MatchFlags searchFlags) |
| virtual void | setModel(QAbstractItemModel *model) |
| void | setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior) |
| void | setSelectionMode(QAbstractItemView::SelectionMode mode) |
| virtual void | setSelectionModel(QItemSelectionModel *selectionModel) |
| void | setTabKeyNavigation(bool enable) |
| void | setTextElideMode(Qt::TextElideMode mode) |
| void | setUpdateThreshold(int threshold) |
| void | setVerticalScrollMode(QAbstractItemView::ScrollMode mode) |
| bool | showDropIndicator() const |
| virtual int | sizeHintForColumn(int column) const |
| QSize | sizeHintForIndex(const QModelIndex &index) const |
| virtual int | sizeHintForRow(int row) const |
| bool | tabKeyNavigation() const |
| Qt::TextElideMode | textElideMode() const |
| int | updateThreshold() const |
| QAbstractItemView::ScrollMode | verticalScrollMode() const |
| virtual QRect | visualRect(const QModelIndex &index) const = 0 |
Funciones públicas reimplementadas
| virtual QVariant | inputMethodQuery(Qt::InputMethodQuery query) const override |
Ranuras públicas
| void | clearSelection() |
| void | edit(const QModelIndex &index) |
| virtual void | reset() |
| void | scrollToBottom() |
| void | scrollToTop() |
| virtual void | selectAll() |
| void | setCurrentIndex(const QModelIndex &index) |
| virtual void | setRootIndex(const QModelIndex &index) |
| void | update(const QModelIndex &index) |
Señales
| void | activated(const QModelIndex &index) |
| void | clicked(const QModelIndex &index) |
| void | doubleClicked(const QModelIndex &index) |
| void | entered(const QModelIndex &index) |
| void | iconSizeChanged(const QSize &size) |
| void | pressed(const QModelIndex &index) |
| void | viewportEntered() |
Tipos protegidos
| enum | CursorAction { MoveUp, MoveDown, MoveLeft, MoveRight, MoveHome, …, MovePrevious } |
| enum | DropIndicatorPosition { OnItem, AboveItem, BelowItem, OnViewport } |
| enum | State { NoState, DraggingState, DragSelectingState, EditingState, ExpandingState, …, AnimatingState } |
Funciones protegidas
| QPoint | dirtyRegionOffset() const |
| QAbstractItemView::DropIndicatorPosition | dropIndicatorPosition() const |
| virtual bool | edit(const QModelIndex &index, QAbstractItemView::EditTrigger trigger, QEvent *event) |
| void | executeDelayedItemsLayout() |
| virtual int | horizontalOffset() const = 0 |
(since 6.0) virtual void | initViewItemOption(QStyleOptionViewItem *option) const |
| virtual bool | isIndexHidden(const QModelIndex &index) const = 0 |
| virtual QModelIndex | moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers) = 0 |
| void | scheduleDelayedItemsLayout() |
| void | scrollDirtyRegion(int dx, int dy) |
| virtual QModelIndexList | selectedIndexes() const |
| virtual QItemSelectionModel::SelectionFlags | selectionCommand(const QModelIndex &index, const QEvent *event = nullptr) const |
| void | setDirtyRegion(const QRegion ®ion) |
| virtual void | setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags) = 0 |
| void | setState(QAbstractItemView::State state) |
| virtual void | startDrag(Qt::DropActions supportedActions) |
| QAbstractItemView::State | state() const |
| virtual int | verticalOffset() const = 0 |
| virtual QRegion | visualRegionForSelection(const QItemSelection &selection) const = 0 |
Funciones protegidas reimplementadas
| virtual void | dragEnterEvent(QDragEnterEvent *event) override |
| virtual void | dragLeaveEvent(QDragLeaveEvent *event) override |
| virtual void | dragMoveEvent(QDragMoveEvent *event) override |
| virtual void | dropEvent(QDropEvent *event) override |
| virtual bool | event(QEvent *event) override |
| virtual bool | eventFilter(QObject *object, QEvent *event) override |
| virtual void | focusInEvent(QFocusEvent *event) override |
| virtual bool | focusNextPrevChild(bool next) override |
| virtual void | focusOutEvent(QFocusEvent *event) override |
| virtual void | inputMethodEvent(QInputMethodEvent *event) override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | mouseDoubleClickEvent(QMouseEvent *event) override |
| virtual void | mouseMoveEvent(QMouseEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | mouseReleaseEvent(QMouseEvent *event) override |
| virtual void | resizeEvent(QResizeEvent *event) override |
| virtual void | timerEvent(QTimerEvent *event) override |
| virtual bool | viewportEvent(QEvent *event) override |
| virtual QSize | viewportSizeHint() const override |
Slots protegidos
| virtual void | closeEditor(QWidget*editor, QAbstractItemDelegate::EndEditHint hint) |
| virtual void | commitData(QWidget*editor) |
| virtual void | currentChanged(const QModelIndex¤t, const QModelIndex&previous) |
| virtual void | dataChanged(const QModelIndex&topLeft, const QModelIndex&bottomRight, const QList<int>&roles = QList<int>()) |
| virtual void | editorDestroyed(QObject*editor) |
| virtual void | rowsAboutToBeRemoved(const QModelIndex&parent, int start, int end) |
| virtual void | rowsInserted(const QModelIndex&parent, int start, int end) |
| virtual void | selectionChanged(const QItemSelection&selected, const QItemSelection&deselected) |
| virtual void | updateGeometries() |
Descripción detallada
La clase `QAbstractItemView` es la clase base de todas las vistas estándar que utilizan un ` QAbstractItemModel`. `QAbstractItemView` es una clase abstracta y no puede instanciarse por sí misma. Proporciona una interfaz estándar para interactuar con los modelos a través del mecanismo de señales y ranuras, lo que permite que las subclases se mantengan actualizadas con los cambios en sus modelos. Esta clase proporciona soporte estándar para la navegación con el teclado y el ratón, el desplazamiento por la ventana gráfica, la edición de elementos y las selecciones. La navegación con el teclado implementa esta funcionalidad:
| Teclas | Funcionalidad |
|---|---|
| Teclas de flecha | Cambia el elemento actual y lo selecciona. |
| Ctrl + teclas de flecha | Cambia el elemento actual, pero no lo selecciona. |
| Mayús + teclas de flecha | Cambia el elemento actual y lo selecciona. Los elementos seleccionados anteriormente no se deseleccionan. |
| Ctrl+Espacio | Activa o desactiva la selección del elemento actual. |
| Tabulador/Tabulador hacia atrás | Cambia el elemento actual al siguiente o al anterior. |
| Inicio/Fin | Selecciona el primer/último elemento del modelo. |
| Re Pág/Av Pág | Desplaza las filas mostradas hacia arriba o hacia abajo según el número de filas visibles en la vista. |
| Ctrl+A | Selecciona todos los elementos del modelo. |
Ten en cuenta que la tabla anterior da por supuesto que la clase « selection mode » permite estas operaciones. Por ejemplo, no se pueden seleccionar elementos si el modo de selección es « QAbstractItemView::NoSelection ».
La clase `QAbstractItemView` es una de las clases de modelo/vista y forma parte del marco de trabajo de modelo/vista de Qt.
Las clases de vista que heredan de `QAbstractItemView` solo tienen que implementar su propia funcionalidad específica de la vista, como dibujar elementos, devolver la geometría de los elementos, buscar elementos, etc.
QAbstractItemView proporciona slots comunes como edit() y setCurrentIndex(). También se proporcionan muchos slots protegidos, entre los que se incluyen dataChanged(), rowsInserted(), rowsAboutToBeRemoved(), selectionChanged() y currentChanged().
El elemento raíz se obtiene mediante rootIndex(), y el elemento actual mediante currentIndex(). Para asegurarse de que un elemento está visible, utilice scrollTo().
Algunas de las funciones de `QAbstractItemView` están relacionadas con el desplazamiento, por ejemplo, ` setHorizontalScrollMode()` y ` setVerticalScrollMode()`. Para establecer el rango de las barras de desplazamiento, puede, por ejemplo, reimplementar la función ` resizeEvent()` de la vista:
void MyView::resizeEvent(QResizeEvent *event) {
horizontalScrollBar()->setRange(0, realWidth - width());
...
}Ten en cuenta que el rango no se actualiza hasta que se muestra el widget.
Hay otras funciones relacionadas con el control de la selección; por ejemplo, ` setSelectionMode()` y ` setSelectionBehavior()`. Esta clase proporciona un modelo de selección predeterminado con el que trabajar (`selectionModel()`), pero este se puede sustituir utilizando ` setSelectionModel()` con una instancia de ` QItemSelectionModel`.
Para tener un control total sobre la visualización y la edición de los elementos, se puede especificar un delegado mediante ` setItemDelegate()`.
`QAbstractItemView` proporciona numerosas funciones protegidas. Algunas se refieren a la edición, por ejemplo, ` edit()` y ` commitData()`, mientras que otras son manejadores de eventos de teclado y ratón.
Véase también Clases de vista, Programación Modelo/Vista y QAbstractItemModel.
Documentación sobre los tipos de miembros
enum QAbstractItemView::CursorAction
Esta enumeración describe las diferentes formas de desplazarse entre los elementos,
| Constante | Valor | Descripción |
|---|---|---|
QAbstractItemView::MoveUp | 0 | Ir al elemento situado encima del elemento actual. |
QAbstractItemView::MoveDown | 1 | Ir al elemento situado debajo del actual. |
QAbstractItemView::MoveLeft | 2 | Ir al elemento situado a la izquierda del elemento actual. |
QAbstractItemView::MoveRight | 3 | Ir al elemento situado a la derecha del actual. |
QAbstractItemView::MoveHome | 4 | Ir al elemento de la esquina superior izquierda. |
QAbstractItemView::MoveEnd | 5 | Ir al elemento de la esquina inferior derecha. |
QAbstractItemView::MovePageUp | 6 | Desplázate una página hacia arriba, por encima del elemento actual. |
QAbstractItemView::MovePageDown | 7 | Desplázate una página hacia abajo, por debajo del elemento actual. |
QAbstractItemView::MoveNext | 8 | Ir al elemento que sigue al actual. |
QAbstractItemView::MovePrevious | 9 | Ir al elemento anterior al actual. |
Véase también moveCursor().
enum QAbstractItemView::DragDropMode
Describe los distintos eventos de arrastrar y soltar a los que puede responder la vista. De forma predeterminada, la vista no admite el arrastre ni el soltar (NoDragDrop).
| Constante | Valor | Descripción |
|---|---|---|
QAbstractItemView::NoDragDrop | 0 | No admite la función de arrastrar y soltar. |
QAbstractItemView::DragOnly | 1 | La vista admite el arrastre de sus propios elementos |
QAbstractItemView::DropOnly | 2 | La vista admite la colocación |
QAbstractItemView::DragDrop | 3 | La vista admite tanto arrastrar como soltar |
QAbstractItemView::InternalMove | 4 | La vista solo admite operaciones de desplazamiento (no de copia) desde sí misma. |
Ten en cuenta que el modelo utilizado debe admitir operaciones de arrastrar y soltar.
Véase también ` setDragDropMode()` y «Uso de arrastrar y soltar con vistas de elementos».
enum QAbstractItemView::DropIndicatorPosition
Esta enumeración indica la posición del indicador de soltar en relación con el índice en la posición actual del ratón:
| Constante | Valor | Descripción |
|---|---|---|
QAbstractItemView::OnItem | 0 | El elemento se soltará sobre el índice. |
QAbstractItemView::AboveItem | 1 | El elemento se soltará por encima del índice. |
QAbstractItemView::BelowItem | 2 | El elemento se colocará por debajo del índice. |
QAbstractItemView::OnViewport | 3 | El elemento se colocará en una región de la ventana gráfica en la que no haya elementos. La forma en que cada vista gestiona los elementos colocados en la ventana gráfica depende del comportamiento del modelo subyacente que se esté utilizando. |
enum QAbstractItemView::EditTrigger
flags QAbstractItemView::EditTriggers
Esta enumeración describe las acciones que dan inicio a la edición de un elemento.
| Constante | Valor | Descripción |
|---|---|---|
QAbstractItemView::NoEditTriggers | 0 | No es posible la edición. |
QAbstractItemView::CurrentChanged | 1 | La edición comienza cada vez que cambia el elemento actual. |
QAbstractItemView::DoubleClicked | 2 | La edición comienza al hacer doble clic en un elemento. |
QAbstractItemView::SelectedClicked | 4 | La edición comienza al hacer clic en un elemento ya seleccionado. |
QAbstractItemView::EditKeyPressed | 8 | La edición comienza cuando se pulsa la tecla de edición de la plataforma sobre un elemento. |
QAbstractItemView::AnyKeyPressed | 16 | La edición comienza al pulsar cualquier tecla sobre un elemento. |
QAbstractItemView::AllEditTriggers | 31 | La edición comienza con todas las acciones anteriores. |
El tipo `EditTriggers` es una definición de tipo para `QFlags<EditTrigger>`. Almacena una combinación OR de valores de `EditTrigger`.
enum QAbstractItemView::ScrollHint
| Constante | Valor | Descripción |
|---|---|---|
QAbstractItemView::EnsureVisible | 0 | Desplaza la vista para garantizar que el elemento sea visible. |
QAbstractItemView::PositionAtTop | 1 | Desplázate para situar el elemento en la parte superior de la ventana de visualización. |
QAbstractItemView::PositionAtBottom | 2 | Desplázate para situar el elemento en la parte inferior de la ventana de visualización. |
QAbstractItemView::PositionAtCenter | 3 | Desplázate para situar el elemento en el centro de la ventana gráfica. |
enum QAbstractItemView::ScrollMode
Describe cómo debe comportarse la barra de desplazamiento. Al establecer el modo de desplazamiento en «ScrollPerPixel», el tamaño del paso único se ajustará automáticamente, a menos que se haya establecido explícitamente mediante la función « setSingleStep()». El ajuste automático puede restablecerse estableciendo el tamaño del paso único en -1.
| Constante | Valor | Descripción |
|---|---|---|
QAbstractItemView::ScrollPerItem | 0 | La vista desplazará el contenido un elemento cada vez. |
QAbstractItemView::ScrollPerPixel | 1 | La vista desplazará el contenido píxel a píxel. |
enum QAbstractItemView::SelectionBehavior
| Constante | Valor | Descripción |
|---|---|---|
QAbstractItemView::SelectItems | 0 | Selección de elementos individuales. |
QAbstractItemView::SelectRows | 1 | Selección exclusiva de filas. |
QAbstractItemView::SelectColumns | 2 | Selección exclusiva de columnas. |
enum QAbstractItemView::SelectionMode
Esta enumeración indica cómo responde la vista a las selecciones del usuario:
| Constante | Valor | Descripción |
|---|---|---|
QAbstractItemView::SingleSelection | 1 | Cuando el usuario selecciona un elemento, cualquier elemento que ya estuviera seleccionado queda deseleccionado. El usuario puede deseleccionar el elemento seleccionado pulsando la tecla Ctrl al hacer clic en él. |
QAbstractItemView::ContiguousSelection | 4 | Cuando el usuario selecciona un elemento de la forma habitual, la selección se desactiva y se selecciona el nuevo elemento. Sin embargo, si el usuario pulsa la tecla Mayús mientras hace clic en un elemento, todos los elementos situados entre el elemento actual y el elemento en el que se ha hecho clic quedan seleccionados o deseleccionados, dependiendo del estado del elemento en el que se ha hecho clic. |
QAbstractItemView::ExtendedSelection | 3 | Cuando el usuario selecciona un elemento de la forma habitual, la selección se desactiva y se selecciona el nuevo elemento. Sin embargo, si el usuario pulsa la tecla Ctrl al hacer clic en un elemento, el elemento en el que se ha hecho clic cambia de estado y el resto de elementos permanecen inalterados. Si el usuario pulsa la tecla Mayús mientras hace clic en un elemento, todos los elementos situados entre el elemento actual y el elemento en el que se ha hecho clic se seleccionan o deseleccionan, dependiendo del estado del elemento en el que se ha hecho clic. Se pueden seleccionar varios elementos arrastrando el ratón sobre ellos. |
QAbstractItemView::MultiSelection | 2 | Cuando el usuario selecciona un elemento de la forma habitual, se alterna el estado de selección de ese elemento y los demás elementos no se ven afectados. Se pueden alternar varios elementos arrastrando el ratón sobre ellos. |
QAbstractItemView::NoSelection | 0 | No se pueden seleccionar elementos. |
Los modos más utilizados son «SingleSelection» y «ExtendedSelection».
enum QAbstractItemView::State
Describe los diferentes estados en los que puede encontrarse la vista. Por lo general, esto solo resulta interesante cuando se vuelve a implementar una vista propia.
| Constante | Valor | Descripción |
|---|---|---|
QAbstractItemView::NoState | 0 | Este es el estado por defecto. |
QAbstractItemView::DraggingState | 1 | El usuario está arrastrando elementos. |
QAbstractItemView::DragSelectingState | 2 | El usuario está seleccionando elementos. |
QAbstractItemView::EditingState | 3 | El usuario está editando un elemento en un editor de widgets. |
QAbstractItemView::ExpandingState | 4 | El usuario está abriendo una rama de elementos. |
QAbstractItemView::CollapsingState | 5 | El usuario está cerrando una rama de elementos. |
QAbstractItemView::AnimatingState | 6 | La vista del elemento está realizando una animación. |
Documentación de propiedades
alternatingRowColors : bool
Esta propiedad determina si se dibuja el fondo utilizando colores alternos
Si esta propiedad es « true », el fondo del elemento se dibujará utilizando « QPalette::Base » y « QPalette::AlternateBase »; en caso contrario, el fondo se dibujará utilizando el color « QPalette::Base ».
Por defecto, esta propiedad tiene el valor « false ».
Funciones de acceso:
| bool | alternatingRowColors() const |
| void | setAlternatingRowColors(bool enable) |
autoScroll : bool
Esta propiedad indica si está activado el desplazamiento automático en los eventos de arrastre
Si esta propiedad se establece en «true» (valor predeterminado), el « QAbstractItemView » desplaza automáticamente el contenido de la vista si el usuario arrastra el cursor a menos de 16 píxeles del borde de la ventana de visualización. Si cambia el elemento actual, la vista se desplazará automáticamente para garantizar que el elemento actual quede totalmente visible.
Esta propiedad solo funciona si la ventana de visualización admite sueltas. El desplazamiento automático se desactiva estableciendo esta propiedad en «false».
Funciones de acceso:
| bool | hasAutoScroll() const |
| void | setAutoScroll(bool enable) |
autoScrollMargin : int
Esta propiedad indica el tamaño del área cuando se activa el desplazamiento automático
Esta propiedad controla el tamaño de la zona situada en el borde de la ventana gráfica que activa el desplazamiento automático. El valor por defecto es de 16 píxeles.
Funciones de acceso:
| int | autoScrollMargin() const |
| void | setAutoScrollMargin(int margin) |
defaultDropAction : Qt::DropAction
Esta propiedad contiene la acción de soltar que se utilizará por defecto en QAbstractItemView::drag().
Si no se establece esta propiedad, la acción de soltar será CopyAction siempre que las acciones admitidas soporten CopyAction.
Funciones de acceso:
| Qt::DropAction | defaultDropAction() const |
| void | setDefaultDropAction(Qt::DropAction dropAction) |
Véase también showDropIndicator y dragDropOverwriteMode.
dragDropMode : DragDropMode
Esta propiedad contiene el evento de arrastrar y soltar al que responderá la vista
Funciones de acceso:
| QAbstractItemView::DragDropMode | dragDropMode() const |
| void | setDragDropMode(QAbstractItemView::DragDropMode behavior) |
Véase también showDropIndicator y dragDropOverwriteMode.
dragDropOverwriteMode : bool
Esta propiedad controla el comportamiento de arrastrar y soltar de la vista
Si su valor es true, los datos seleccionados sobrescribirán los datos del elemento existente al soltarlos, mientras que al mover los datos se borrará el elemento. Si su valor es false, los datos seleccionados se insertarán como un nuevo elemento al soltarlos. Al mover los datos, el elemento también se elimina.
El valor por defecto es « false », al igual que en las subclases « QListView » y « QTreeView ». En la subclase « QTableView », por el contrario, la propiedad se ha establecido en « true ».
Nota: Esto no pretende impedir la sobrescritura de elementos. La implementación de flags() del modelo debería encargarse de ello al no devolver Qt::ItemIsDropEnabled.
Funciones de acceso:
| bool | dragDropOverwriteMode() const |
| void | setDragDropOverwriteMode(bool overwrite) |
Véase también dragDropMode.
dragEnabled : bool
Esta propiedad indica si la vista admite el arrastre de sus propios elementos
Funciones de acceso:
| bool | dragEnabled() const |
| void | setDragEnabled(bool enable) |
Véase también showDropIndicator, DragDropMode, dragDropOverwriteMode y acceptDrops.
editTriggers : EditTriggers
Esta propiedad determina qué acciones activarán la edición de un elemento
Esta propiedad es una selección de indicadores definidos en EditTrigger, combinados mediante el operador «OR». La vista solo iniciará la edición de un elemento si la acción realizada está configurada en esta propiedad.
El valor por defecto es:
- para QTableView: DoubleClicked|AnyKeyPressed
- para todas las demás vistas: DoubleClicked|EditKeyPressed
Funciones de acceso:
| QAbstractItemView::EditTriggers | editTriggers() const |
| void | setEditTriggers(QAbstractItemView::EditTriggers triggers) |
horizontalScrollMode : ScrollMode
cómo se desplaza el contenido de la vista en sentido horizontal
Esta propiedad controla cómo la vista desplaza su contenido horizontalmente. El desplazamiento puede realizarse por píxel o por elemento. Su valor por defecto proviene del estilo a través de la indicación de estilo « QStyle::SH_ItemView_ScrollMode ».
Funciones de acceso:
| QAbstractItemView::ScrollMode | horizontalScrollMode() const |
| void | setHorizontalScrollMode(QAbstractItemView::ScrollMode mode) |
| void | resetHorizontalScrollMode() |
iconSize : QSize
Esta propiedad contiene el tamaño de los iconos de los elementos
Si se configura esta propiedad cuando la vista está visible, se volverá a organizar la disposición de los elementos.
Funciones de acceso:
| QSize | iconSize() const |
| void | setIconSize(const QSize &size) |
Señal de notificador:
| void | iconSizeChanged(const QSize &size) |
[since 6.11] keyboardSearchFlags : Qt::MatchFlags
Esta propiedad determina cómo la implementación predeterminada de ` keyboardSearch()` compara la cadena proporcionada con los datos del modelo.
El valor por defecto es ` Qt::MatchStartsWith|Qt::MatchWrap`.
Esta enumeración se introdujo en Qt 6.11.
Funciones de acceso:
| Qt::MatchFlags | keyboardSearchFlags() const |
| void | setKeyboardSearchFlags(Qt::MatchFlags searchFlags) |
Véase también ` keyboardSearch()` y ` QAbstractItemModel::match()`.
selectionBehavior : SelectionBehavior
Esta propiedad determina qué comportamiento de selección utiliza la vista
Esta propiedad indica si las selecciones se realizan por elementos individuales, filas o columnas.
Funciones de Access:
| QAbstractItemView::SelectionBehavior | selectionBehavior() const |
| void | setSelectionBehavior(QAbstractItemView::SelectionBehavior behavior) |
Véase también SelectionMode y SelectionBehavior.
selectionMode : SelectionMode
Esta propiedad indica en qué modo de selección funciona la vista
Esta propiedad controla si el usuario puede seleccionar uno o varios elementos y, en el caso de selecciones de varios elementos, si la selección debe ser un rango continuo de elementos.
Funciones de Access:
| QAbstractItemView::SelectionMode | selectionMode() const |
| void | setSelectionMode(QAbstractItemView::SelectionMode mode) |
Véase también SelectionMode y SelectionBehavior.
showDropIndicator : bool
Esta propiedad determina si se muestra el indicador de soltar al arrastrar y soltar elementos.
Funciones de Access:
| bool | showDropIndicator() const |
| void | setDropIndicatorShown(bool enable) |
Véase también dragEnabled, DragDropMode, dragDropOverwriteMode y acceptDrops.
tabKeyNavigation : bool
Esta propiedad indica si está habilitada la navegación por elementos mediante las teclas Tab y Retroceso.
Funciones de acceso:
| bool | tabKeyNavigation() const |
| void | setTabKeyNavigation(bool enable) |
textElideMode : Qt::TextElideMode
Esta propiedad indica la posición de los «...» en el texto omitido.
El valor por defecto para todas las vistas de elementos es Qt::ElideRight.
Funciones de acceso:
| Qt::TextElideMode | textElideMode() const |
| void | setTextElideMode(Qt::TextElideMode mode) |
[since 6.9] updateThreshold : int
Esta propiedad almacena el número de índices modificados para activar directamente una actualización completa de la vista dentro de ` dataChanged()`.
El algoritmo de dataChanged() intenta minimizar la necesidad de una actualización completa de la vista calculando si los índices modificados son visibles o no. En el caso de modelos muy grandes, con muchos cambios importantes, esto podría llevar más tiempo que la propia actualización, por lo que resulta contraproducente. Esta propiedad permite controlar el algoritmo para que omita la comprobación y active directamente una actualización completa cuando el número de índices modificados supere el valor indicado.
El valor por defecto es 200.
Esta enumeración se introdujo en Qt 6.9.
Funciones de acceso:
| int | updateThreshold() const |
| void | setUpdateThreshold(int threshold) |
Véase también dataChanged().
verticalScrollMode : ScrollMode
cómo se desplaza el contenido de la vista en sentido vertical
Esta propiedad controla cómo la vista desplaza su contenido verticalmente. El desplazamiento puede realizarse por píxel o por elemento. Su valor por defecto proviene del estilo a través de la indicación de estilo « QStyle::SH_ItemView_ScrollMode ».
Funciones de acceso:
| QAbstractItemView::ScrollMode | verticalScrollMode() const |
| void | setVerticalScrollMode(QAbstractItemView::ScrollMode mode) |
| void | resetVerticalScrollMode() |
Documentación de las funciones de miembro
[explicit] QAbstractItemView::QAbstractItemView(QWidget *parent = nullptr)
Crea una vista de elemento abstracta con el ` parent` indicado.
[virtual noexcept] QAbstractItemView::~QAbstractItemView()
Arruina la vista.
[signal] void QAbstractItemView::activated(const QModelIndex &index)
Esta señal se emite cuando el usuario activa el elemento especificado por index. La forma de activar los elementos depende de la plataforma; por ejemplo, haciendo clic una o dos veces sobre el elemento, o pulsando la tecla «Retorno» o «Intro» cuando el elemento está seleccionado.
Véase también clicked(), doubleClicked(), entered() y pressed().
[slot] void QAbstractItemView::clearSelection()
Deselecciona todos los elementos seleccionados. El índice actual no se modificará.
Véase también setSelection() y selectAll().
[signal] void QAbstractItemView::clicked(const QModelIndex &index)
Esta señal se emite al hacer clic con el botón izquierdo del ratón. El elemento sobre el que se ha hecho clic se especifica mediante index. La señal solo se emite cuando el índice es válido.
Véase también activated(), doubleClicked(), entered() y pressed().
[virtual protected slot] void QAbstractItemView::closeEditor(QWidget *editor, QAbstractItemDelegate::EndEditHint hint)
Cierra el objeto « editor » indicado y libera su referencia. El parámetro « hint » se utiliza para especificar cómo debe responder la vista al finalizar la operación de edición. Por ejemplo, la indicación puede especificar que se abra para su edición el siguiente elemento de la vista.
Véase también edit() y commitData().
void QAbstractItemView::closePersistentEditor(const QModelIndex &index)
Cierra el editor persistente del elemento situado en la dirección index.
Véase también openPersistentEditor() y isPersistentEditorOpen().
[virtual protected slot] void QAbstractItemView::commitData(QWidget *editor)
Incorpora los datos del archivo « editor » al modelo.
Véase también closeEditor().
[virtual protected slot] void QAbstractItemView::currentChanged(const QModelIndex ¤t, const QModelIndex &previous)
Esta ranura se activa cuando un nuevo elemento se convierte en el elemento actual. El elemento actual anterior se especifica mediante el índice previous, y el nuevo elemento mediante el índice current.
Si quieres saber más sobre los cambios en los elementos, consulta la señal dataChanged().
QModelIndex QAbstractItemView::currentIndex() const
Devuelve el índice del modelo del elemento actual.
Véase también setCurrentIndex().
[virtual protected slot] void QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())
Esta ranura se activa cuando se modifican en el modelo los elementos con el « roles » especificado. Los elementos modificados son aquellos que se encuentran en el rango comprendido entre topLeft y bottomRight, ambos inclusive. Si solo se modifica un elemento, topLeft == bottomRight.
El roles que se ha modificado puede ser un contenedor vacío (lo que significa que todo ha cambiado) o un contenedor no vacío con el subconjunto de roles que se han modificado.
Nota: dataChanged() no tiene en cuenta Qt::ToolTipRole en las vistas proporcionadas por Qt.
[protected] QPoint QAbstractItemView::dirtyRegionOffset() const
Devuelve el desplazamiento de las regiones modificadas en la vista.
Si utilizas ` scrollDirtyRegion()` e implementas ` paintEvent()` en una subclase de ` QAbstractItemView`, debes trasladar el área indicada por el evento de pintura con el desplazamiento devuelto por esta función.
Véanse también scrollDirtyRegion() y setDirtyRegion().
[signal] void QAbstractItemView::doubleClicked(const QModelIndex &index)
Esta señal se emite al hacer doble clic con el ratón. El elemento sobre el que se ha realizado el doble clic se especifica mediante ` index`. La señal solo se emite cuando el índice es válido.
Véase también clicked() y activated().
[override virtual protected] void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event)
Reimplementa: QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event).
Esta función se invoca con el objeto event proporcionado cuando una operación de arrastrar y soltar entra en el widget. Si el arrastre se realiza sobre un lugar válido para soltar (por ejemplo, sobre un elemento que admite soltar), el evento se acepta; en caso contrario, se ignora.
Véase también dropEvent() y startDrag().
[override virtual protected] void QAbstractItemView::dragLeaveEvent(QDragLeaveEvent *event)
Reimplementa: QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event).
Esta función se invoca cuando el elemento que se está arrastrando sale de la vista. El objeto event describe el estado de la operación de arrastrar y soltar.
[override virtual protected] void QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)
Reimplementa: QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event).
Esta función se invoca continuamente con el objeto event proporcionado durante una operación de arrastrar y soltar sobre el widget. Puede provocar que la vista se desplace si, por ejemplo, el usuario arrastra una selección hacia el borde derecho o inferior de la vista. En este caso, el evento se aceptará; de lo contrario, se ignorará.
Véanse también dropEvent() y startDrag().
[override virtual protected] void QAbstractItemView::dropEvent(QDropEvent *event)
Reimplementa: QAbstractScrollArea::dropEvent(QDropEvent *event).
Esta función se invoca con el objeto ` event ` proporcionado cuando se produce un evento de suelta sobre el widget. Si el modelo acepta la posición del evento, este se acepta; de lo contrario, se ignora.
Véase también startDrag().
[protected] QAbstractItemView::DropIndicatorPosition QAbstractItemView::dropIndicatorPosition() const
Devuelve la posición del indicador de arrastre en relación con el elemento más cercano.
[slot] void QAbstractItemView::edit(const QModelIndex &index)
Comienza a editar el elemento correspondiente al index indicado, siempre que sea editable.
Ten en cuenta que esta función no modifica el índice actual. Dado que el índice actual define los elementos siguientes y anteriores que se van a editar, es posible que los usuarios observen que la navegación mediante el teclado no funciona como se esperaba. Para garantizar un comportamiento de navegación coherente, llama a setCurrentIndex() antes de esta función con el mismo índice del modelo.
Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:
// Connect using qOverload:
connect(sender, &SenderClass::signal,
abstractItemView, qOverload(&QAbstractItemView::edit));
// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
abstractItemView, [receiver = abstractItemView](const QModelIndex &index) { receiver->edit(index); }); Véase también QModelIndex::flags().
[virtual protected] bool QAbstractItemView::edit(const QModelIndex &index, QAbstractItemView::EditTrigger trigger, QEvent *event)
Comienza a editar el elemento en index, creando un editor si es necesario, y devuelve true si el State de la vista es ahora EditingState; en caso contrario, devuelve false.
La acción que ha provocado el proceso de edición se describe mediante trigger, y el evento asociado se especifica mediante event.
La edición se puede forzar especificando que trigger sea QAbstractItemView::AllEditTriggers.
Véase también closeEditor().
[virtual protected slot] void QAbstractItemView::editorDestroyed(QObject *editor)
Esta función se invoca cuando se ha destruido el objeto ` editor ` indicado.
Véase también closeEditor().
[signal] void QAbstractItemView::entered(const QModelIndex &index)
Esta señal se emite cuando el cursor del ratón entra en el elemento especificado por index. Para que esta función funcione, es necesario que el seguimiento del ratón esté activado.
Véanse también viewportEntered(), activated(), clicked(), doubleClicked() y pressed().
[override virtual protected] bool QAbstractItemView::event(QEvent *event)
Reimplementa: ` QAbstractScrollArea::event(QEvent *event)`.
[override virtual protected] bool QAbstractItemView::eventFilter(QObject *object, QEvent *event)
Reimplementa: QObject::eventFilter(QObject *watched, QEvent *event).
[protected] void QAbstractItemView::executeDelayedItemsLayout()
Ejecuta los diseños programados sin esperar a que comience el procesamiento de eventos.
Véase también scheduleDelayedItemsLayout().
[override virtual protected] void QAbstractItemView::focusInEvent(QFocusEvent *event)
Reimplementa: QWidget::focusInEvent(QFocusEvent *event).
Esta función se invoca con el objeto ` event ` proporcionado cuando el widget obtiene el foco. Por defecto, el evento se ignora.
Véase también setFocus() y focusOutEvent().
[override virtual protected] bool QAbstractItemView::focusNextPrevChild(bool next)
Reimplementa: ` QWidget::focusNextPrevChild` (`bool next`).
[override virtual protected] void QAbstractItemView::focusOutEvent(QFocusEvent *event)
Reimplementa: QWidget::focusOutEvent(QFocusEvent *event).
Esta función se invoca con el objeto ` event ` proporcionado cuando el widget pierde el foco. Por defecto, el evento se ignora.
Véase también clearFocus() y focusInEvent().
[pure virtual protected] int QAbstractItemView::horizontalOffset() const
Devuelve el desplazamiento horizontal de la vista.
En la clase base, se trata de una función virtual pura.
Véase también ` verticalOffset()`.
[pure virtual] QModelIndex QAbstractItemView::indexAt(const QPoint &point) const
Devuelve el índice del modelo del elemento situado en las coordenadas de la ventana gráfica point.
En la clase base, esta es una función virtual pura.
Véase también visualRect().
QWidget *QAbstractItemView::indexWidget(const QModelIndex &index) const
Devuelve el widget correspondiente al elemento situado en la dirección index.
Véase también setIndexWidget().
[virtual protected, since 6.0] void QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const
Inicializa la estructura ` option ` con la paleta, la fuente, el estado, las alineaciones, etc., de la vista.
Nota: Las implementaciones de este método deben comprobar el ` version ` de la estructura recibida, rellenar todos los miembros que la implementación conozca y establecer el miembro `version` en el valor compatible con la implementación antes de devolver el resultado.
Esta función se introdujo en Qt 6.0.
[override virtual protected] void QAbstractItemView::inputMethodEvent(QInputMethodEvent *event)
Reimplementa: ` QWidget::inputMethodEvent(QInputMethodEvent *event)`.
[override virtual] QVariant QAbstractItemView::inputMethodQuery(Qt::InputMethodQuery query) const
Reimplementa: ` QWidget::inputMethodQuery` (conste `Qt::InputMethodQuery query`).
[pure virtual protected] bool QAbstractItemView::isIndexHidden(const QModelIndex &index) const
Devuelve « true » si el elemento al que hace referencia el « index » dado está oculto en la vista; en caso contrario, devuelve « false ».
Ocultar elementos es una característica específica de la vista. Por ejemplo, en TableView se puede marcar una columna como oculta o una fila en TreeView.
En la clase base, se trata de una función virtual pura.
bool QAbstractItemView::isPersistentEditorOpen(const QModelIndex &index) const
Devuelve si hay un editor persistente abierto para el elemento en el índice index.
Véanse también openPersistentEditor() y closePersistentEditor().
QAbstractItemDelegate *QAbstractItemView::itemDelegate() const
Devuelve el delegado de elemento utilizado por esta vista y este modelo. Puede ser uno establecido mediante ` setItemDelegate()` o el predeterminado.
Véase también setItemDelegate().
QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const
Devuelve el delegado de elementos utilizado por esta vista y este modelo para el ` column` especificado. Se puede llamar a ` itemDelegate()` para obtener un puntero al delegado actual correspondiente a un índice determinado.
Véanse también setItemDelegateForColumn(), itemDelegateForRow() y itemDelegate().
[virtual, since 6.0] QAbstractItemDelegate *QAbstractItemView::itemDelegateForIndex(const QModelIndex &index) const
Devuelve el delegado de elemento utilizado por esta vista y este modelo para el ` index` dado.
Esta función se introdujo en Qt 6.0.
Véase también setItemDelegate(), setItemDelegateForRow() y setItemDelegateForColumn().
QAbstractItemDelegate *QAbstractItemView::itemDelegateForRow(int row) const
Devuelve el delegado de elemento utilizado por esta vista y este modelo para el row dado, o nullptr si no se ha asignado ningún delegado. Puedes llamar a itemDelegate() para obtener un puntero al delegado actual para un índice dado.
Véase también setItemDelegateForRow(), itemDelegateForColumn() y setItemDelegate().
[override virtual protected] void QAbstractItemView::keyPressEvent(QKeyEvent *event)
Reimplementa: QAbstractScrollArea::keyPressEvent(QKeyEvent *e).
Esta función se invoca con el objeto event dado cuando se envía un evento de tecla al widget. La implementación por defecto gestiona los movimientos básicos del cursor, por ejemplo, Arriba, Abajo, Izquierda, Derecha, Inicio, Avanzar página y Retroceder página; se emite la señal activated() si el índice actual es válido y se pulsa la tecla de activación (por ejemplo, Intro o Retorno, dependiendo de la plataforma). Esta función es donde se inicia la edición al pulsar una tecla, por ejemplo, si se pulsa F2.
Véase también edit(), moveCursor(), keyboardSearch() y tabKeyNavigation.
[virtual] void QAbstractItemView::keyboardSearch(const QString &search)
Se desplaza hasta el elemento que mejor se ajusta a la cadena « search » y lo selecciona. Si no se encuentra ningún elemento, no ocurre nada.
En la implementación por defecto, la búsqueda se reinicia si search está vacío o si el intervalo de tiempo transcurrido desde la última búsqueda ha superado QApplication::keyboardInputInterval().
QAbstractItemModel *QAbstractItemView::model() const
Devuelve el modelo que presenta esta vista.
Véase también setModel().
[override virtual protected] void QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)
Reimplementa: QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).
Esta función se invoca con el objeto ` event ` proporcionado cuando se realiza un doble clic con el ratón dentro del widget. Si el doble clic se produce sobre un elemento válido, emite la señal ` doubleClicked()` y llama a ` edit()` sobre dicho elemento.
[override virtual protected] void QAbstractItemView::mouseMoveEvent(QMouseEvent *event)
Reimplementa: QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).
Esta función se invoca con el objeto ` event ` proporcionado cuando se envía un evento de movimiento del ratón al widget. Si hay una selección en curso y se desplazan nuevos elementos sobre ella, la selección se amplía; si hay un arrastre en curso, este continúa.
[override virtual protected] void QAbstractItemView::mousePressEvent(QMouseEvent *event)
Reimplementa: ` QAbstractScrollArea::mousePressEvent(QMouseEvent *e)`.
Esta función se invoca con el objeto ` event ` proporcionado cuando se pulsa un botón del ratón mientras el cursor se encuentra dentro del widget. Si se pulsa un elemento válido, este se convierte en el elemento actual. Esta función emite la señal ` pressed()`.
[override virtual protected] void QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)
Reimplementa: QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).
Esta función se invoca con el objeto ` event ` proporcionado cuando se suelta un botón del ratón, tras un evento de pulsación del ratón en el widget. Si un usuario pulsa el ratón dentro de tu widget y, a continuación, arrastra el ratón a otra ubicación antes de soltar el botón, tu widget recibe el evento de liberación. La función emitirá la señal ` clicked()` si se estaba pulsando un elemento.
[pure virtual protected] QModelIndex QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)
Devuelve un objeto ` QModelIndex ` que apunta al siguiente objeto de la vista, en función del ` cursorAction ` proporcionado y de los modificadores de teclado especificados en ` modifiers`.
En la clase base, se trata de una función virtual pura.
void QAbstractItemView::openPersistentEditor(const QModelIndex &index)
Abre un editor persistente en el elemento situado en la dirección index. Si no existe ningún editor, el delegado creará uno nuevo.
Véase también closePersistentEditor() y isPersistentEditorOpen().
[signal] void QAbstractItemView::pressed(const QModelIndex &index)
Esta señal se emite cuando se pulsa un botón del ratón. El elemento sobre el que se ha pulsado el ratón se especifica mediante ` index`. La señal solo se emite cuando el índice es válido.
Utiliza la función QGuiApplication::mouseButtons() para obtener el estado de los botones del ratón.
Véanse también activated(), clicked(), doubleClicked() y entered().
[virtual slot] void QAbstractItemView::reset()
Restablece el estado interno de la vista.
Advertencia: Esta función restablecerá los editores abiertos, las posiciones de las barras de desplazamiento, las selecciones, etc. Los cambios existentes no se guardarán. Si deseas guardar tus cambios al restablecer la vista, puedes reimplementar esta función, guardar tus cambios y, a continuación, llamar a la implementación de la superclase.
[override virtual protected] void QAbstractItemView::resizeEvent(QResizeEvent *event)
Reimplementa: QAbstractScrollArea::resizeEvent(QResizeEvent *event).
Esta función se invoca con el objeto event proporcionado cuando se envía un evento de cambio de tamaño al widget.
Véase también QWidget::resizeEvent().
QModelIndex QAbstractItemView::rootIndex() const
Devuelve el índice del elemento raíz del modelo. El elemento raíz es el elemento padre de los elementos de nivel superior de la vista. El elemento raíz puede no ser válido.
Véase también ` setRootIndex()`.
[virtual protected slot] void QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)
Esta función se invoca cuando se van a eliminar filas. Las filas eliminadas son aquellas que se encuentran bajo el parent especificado, desde start hasta end, ambos inclusive.
Véase también rowsInserted().
[virtual protected slot] void QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end)
Este método se invoca cuando se insertan filas. Las nuevas filas son aquellas que se encuentran bajo el parent especificado, comprendidas entre start y end, ambos inclusive. La implementación de la clase base llama a fetchMore() en el modelo para comprobar si hay más datos.
Véase también rowsAboutToBeRemoved().
[protected] void QAbstractItemView::scheduleDelayedItemsLayout()
Programa un diseño de los elementos de la vista que se ejecutará cuando comience el procesamiento de eventos.
Aunque se llame a scheduleDelayedItemsLayout() varias veces antes de que se procesen los eventos, la vista solo realizará el diseño una vez.
Véase también ` executeDelayedItemsLayout()`.
[protected] void QAbstractItemView::scrollDirtyRegion(int dx, int dy)
Prepara la vista para el desplazamiento en (dx,dy) píxeles moviendo las regiones modificadas en la dirección opuesta. Solo es necesario llamar a esta función si estás implementando un área de visualización con desplazamiento en tu subclase de vista.
Si implementas scrollContentsBy() en una subclase de QAbstractItemView, llama a esta función antes de llamar a QWidget::scroll() en el área de visualización. Como alternativa, basta con llamar a update().
Véase también scrollContentsBy(), dirtyRegionOffset() y setDirtyRegion().
[pure virtual] void QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)
Desplaza la vista si es necesario para garantizar que el elemento situado en index sea visible. La vista intentará colocar el elemento según el hint indicado.
En la clase base, se trata de una función virtual pura.
[slot] void QAbstractItemView::scrollToBottom()
Desplaza la vista hasta la parte inferior.
Véase también scrollTo() y scrollToTop().
[slot] void QAbstractItemView::scrollToTop()
Desplaza la vista hasta la parte superior.
Véase también scrollTo() y scrollToBottom().
[virtual slot] void QAbstractItemView::selectAll()
Selecciona todos los elementos de la vista. Esta función utilizará el comportamiento de selección establecido en la vista a la hora de seleccionar.
Véase también setSelection(), selectedIndexes() y clearSelection().
[virtual protected] QModelIndexList QAbstractItemView::selectedIndexes() const
Esta función de conveniencia devuelve una lista con todos los índices de los elementos seleccionados y no ocultos de la vista. La lista no contiene duplicados y no está ordenada.
Véase también QItemSelectionModel::selectedIndexes().
[virtual protected slot] void QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)
Esta función se invoca cuando se modifica la selección. La selección anterior (que puede estar vacía) se especifica mediante ` deselected`, y la nueva selección mediante ` selected`.
Véase también setSelection().
[virtual protected] QItemSelectionModel::SelectionFlags QAbstractItemView::selectionCommand(const QModelIndex &index, const QEvent *event = nullptr) const
Devuelve los SelectionFlags que se utilizarán al actualizar un modelo de selección para el index especificado. El resultado depende del selectionMode() actual y del evento de entrada del usuario event, que puede ser nullptr.
Reimplementa esta función para definir tu propio comportamiento de selección.
Véase también setSelection().
QItemSelectionModel *QAbstractItemView::selectionModel() const
Devuelve el modelo de selección actual.
Véase también setSelectionModel() y selectedIndexes().
[slot] void QAbstractItemView::setCurrentIndex(const QModelIndex &index)
Establece el elemento actual como el elemento de index.
A menos que el modo de selección actual sea « NoSelection », el elemento también queda seleccionado. Ten en cuenta que esta función también actualiza la posición inicial para cualquier nueva selección que realice el usuario.
Para establecer un elemento como elemento actual sin seleccionarlo, llama a
selectionModel()->setCurrentIndex(index, QItemSelectionModel::NoUpdate);
Véase también currentIndex(), currentChanged() y selectionMode.
[protected] void QAbstractItemView::setDirtyRegion(const QRegion ®ion)
Marca el objeto ` region ` dado como «sucio» y programa su actualización. Solo es necesario llamar a esta función si estás implementando tu propia subclase de vista.
Véanse también « scrollDirtyRegion()» y « dirtyRegionOffset()».
void QAbstractItemView::setIndexWidget(const QModelIndex &index, QWidget *widget)
Establece el « widget » indicado en el elemento situado en la « index » especificada, transfiriendo la propiedad del widget a la ventana gráfica.
Si index no es válido (por ejemplo, si se pasa el índice raíz), esta función no hará nada.
La propiedad autoFillBackground del widget especificado debe estar establecida en true; de lo contrario, el fondo del widget será transparente, mostrando tanto los datos del modelo como el elemento en el index especificado.
Nota: La vista asume la propiedad del widget. Esto significa que, si el widget de índice A se sustituye por el widget de índice B, el widget de índice A se eliminará. Por ejemplo, en el fragmento de código siguiente, el objeto QLineEdit se eliminará.
Esta función solo debe utilizarse para mostrar contenido estático dentro del área visible correspondiente a un elemento de datos. Si desea mostrar contenido dinámico personalizado o implementar un widget de editor personalizado, cree una subclase de QStyledItemDelegate.
Véase también indexWidget() y Clases delegadas.
void QAbstractItemView::setItemDelegate(QAbstractItemDelegate *delegate)
Establece el delegado de elementos de esta vista y su modelo en delegate. Esto resulta útil si deseas tener un control total sobre la edición y la visualización de los elementos.
Cualquier delegado existente se eliminará, pero no se borrará. QAbstractItemView no asume la propiedad de delegate.
Advertencia: Nose debe compartir la misma instancia de un delegado entre vistas. Hacerlo puede provocar un comportamiento de edición incorrecto o poco intuitivo, ya que cada vista conectada a un delegado determinado puede recibir la señal ` closeEditor()` e intentar acceder, modificar o cerrar un editor que ya se haya cerrado.
Véase también itemDelegate().
void QAbstractItemView::setItemDelegateForColumn(int column, QAbstractItemDelegate *delegate)
Establece el elemento delegate especificado, utilizado por esta vista y este modelo para el elemento column especificado. Todos los elementos de column serán dibujados y gestionados por delegate en lugar de utilizar el delegado predeterminado (es decir, itemDelegate()).
Cualquier delegado de columna existente para column se eliminará, pero no se borrará. QAbstractItemView no asume la propiedad de delegate.
Nota: Si se ha asignado un delegado tanto a una fila como a una columna, el delegado de fila tendrá prioridad y gestionará el índice de la celda de intersección.
Advertencia: Nose debe compartir la misma instancia de un delegado entre vistas. Hacerlo puede provocar un comportamiento de edición incorrecto o poco intuitivo, ya que cada vista conectada a un delegado determinado puede recibir la señal ` closeEditor()` e intentar acceder, modificar o cerrar un editor que ya se haya cerrado.
Véase también itemDelegateForColumn(), setItemDelegateForRow() y itemDelegate().
void QAbstractItemView::setItemDelegateForRow(int row, QAbstractItemDelegate *delegate)
Establece el elemento especificado delegate utilizado por esta vista y este modelo para el elemento especificado row. Todos los elementos de row serán dibujados y gestionados por delegate en lugar de utilizar el delegado predeterminado (es decir, itemDelegate()).
Cualquier delegado de fila existente para row se eliminará, pero no se borrará. QAbstractItemView no asume la propiedad de delegate.
Nota: Si se ha asignado un delegado tanto a una fila como a una columna, el delegado de fila (es decir, este delegado) tendrá prioridad y gestionará el índice de la celda de intersección.
Advertencia: Nose debe compartir la misma instancia de un delegado entre vistas. Hacerlo puede provocar un comportamiento de edición incorrecto o poco intuitivo, ya que cada vista conectada a un delegado determinado puede recibir la señal closeEditor() e intentar acceder, modificar o cerrar un editor que ya se haya cerrado.
Véase también itemDelegateForRow(), setItemDelegateForColumn() y itemDelegate().
[virtual] void QAbstractItemView::setModel(QAbstractItemModel *model)
Establece el modelo de selección ( model ) que se mostrará en la vista.
Esta función creará y establecerá un nuevo modelo de selección, sustituyendo cualquier modelo que se hubiera establecido previamente con setSelectionModel(). Sin embargo, el modelo de selección anterior no se eliminará, ya que puede ser compartido entre varias vistas. Recomendamos eliminar el modelo de selección anterior si ya no es necesario. Esto se hace con el siguiente código:
QItemSelectionModel *m = view->selectionModel();
view->setModel(new model);
delete m;Si tanto el modelo antiguo como el modelo de selección antiguo carecen de padres, o si sus padres son objetos de larga duración, puede ser preferible llamar a sus funciones ` deleteLater()` para eliminarlos explícitamente.
La vista no asume la propiedad del modelo a menos que sea el objeto padre del modelo, ya que este puede ser compartido entre muchas vistas diferentes.
Véanse también ` model()`, ` selectionModel()` y ` setSelectionModel()`.
[virtual slot] void QAbstractItemView::setRootIndex(const QModelIndex &index)
Establece como elemento raíz el elemento situado en la dirección index.
Véase también rootIndex().
[pure virtual protected] void QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)
Aplica la selección flags a los elementos que se encuentran dentro del rectángulo o que son tocados por él, rect.
Al implementar tu propia vista de elementos (itemview), setSelection debe llamar a selectionModel()->select(selection, flags), donde selection es o bien un QModelIndex vacío, o bien un QItemSelection que contiene todos los elementos que se encuentran en rect.
Véase también selectionCommand() y selectedIndexes().
[virtual] void QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)
Establece el modelo de selección actual en el selectionModel especificado.
Ten en cuenta que, si llamas a ` setModel()` después de esta función, el ` selectionModel ` indicado será sustituido por uno creado por la vista.
Nota: Corresponde a la aplicación eliminar el modelo de selección antiguo si ya no es necesario; es decir, si no lo están utilizando otras vistas. Esto ocurrirá automáticamente cuando se elimine su objeto padre. Sin embargo, si no tiene un objeto padre, o si este es un objeto de larga duración, puede ser preferible llamar a su función ` deleteLater()` para eliminarlo explícitamente.
Véase también selectionModel(), setModel() y clearSelection().
[protected] void QAbstractItemView::setState(QAbstractItemView::State state)
Establece el estado de la vista del elemento en el valor dado state.
Véase también state().
[virtual] int QAbstractItemView::sizeHintForColumn(int column) const
Devuelve la sugerencia de ancho para el ` column ` especificado o -1 si no hay ningún modelo.
Esta función se utiliza en vistas con un encabezado horizontal para determinar la sugerencia de tamaño de una sección del encabezado en función del contenido del objeto ` column` proporcionado.
Véase también sizeHintForRow().
QSize QAbstractItemView::sizeHintForIndex(const QModelIndex &index) const
Devuelve la indicación de tamaño del elemento con el index especificado, o un tamaño no válido en el caso de índices no válidos.
Véase también sizeHintForRow() y sizeHintForColumn().
[virtual] int QAbstractItemView::sizeHintForRow(int row) const
Devuelve la sugerencia de altura para el elemento row especificado, o -1 si no hay ningún modelo.
La altura devuelta se calcula utilizando las indicaciones de tamaño de los elementos del ` row` dado; es decir, el valor devuelto es la altura máxima entre los elementos. Ten en cuenta que, para controlar la altura de una fila, debes reimplementar la función ` QAbstractItemDelegate::sizeHint()`.
Esta función se utiliza en vistas con un encabezado vertical para determinar la indicación de tamaño de una sección de encabezado en función del contenido del elemento ` row` proporcionado.
Véase también sizeHintForColumn().
[virtual protected] void QAbstractItemView::startDrag(Qt::DropActions supportedActions)
Inicia un arrastre llamando a drag->exec() utilizando el ` supportedActions` proporcionado.
[protected] QAbstractItemView::State QAbstractItemView::state() const
Devuelve el estado de la vista del elemento.
Véase también setState().
[override virtual protected] void QAbstractItemView::timerEvent(QTimerEvent *event)
Reimplementa: QObject::timerEvent(QTimerEvent *event).
Esta función se invoca con el objeto event proporcionado cuando se envía un evento de temporizador al widget.
Véase también QObject::timerEvent().
[slot] void QAbstractItemView::update(const QModelIndex &index)
Actualiza el área ocupada por el objeto « index » indicado.
[virtual protected slot] void QAbstractItemView::updateGeometries()
Actualiza la geometría de los widgets secundarios de la vista.
[pure virtual protected] int QAbstractItemView::verticalOffset() const
Devuelve el desplazamiento vertical de la vista.
En la clase base, se trata de una función virtual pura.
Véase también horizontalOffset().
[signal] void QAbstractItemView::viewportEntered()
Esta señal se emite cuando el cursor del ratón entra en el área de visualización. Para que esta función funcione, es necesario tener activado el seguimiento del ratón.
Véase también entered().
[override virtual protected] bool QAbstractItemView::viewportEvent(QEvent *event)
Reimplementa: QAbstractScrollArea::viewportEvent(QEvent *event).
Esta función se utiliza para gestionar las descripciones emergentes y el modo «¿Qué es esto?», si el objeto ` event ` proporcionado es un ` QEvent::ToolTip` o un ` QEvent::WhatsThis`. Transmite todos los demás eventos al controlador `viewportEvent()` de su clase base.
Devuelve ` true ` si se ha reconocido y procesado ` event `; en caso contrario, devuelve ` false`.
[override virtual protected] QSize QAbstractItemView::viewportSizeHint() const
Reimplementa: ` QAbstractScrollArea::viewportSizeHint()` const.
[pure virtual] QRect QAbstractItemView::visualRect(const QModelIndex &index) const
Devuelve el rectángulo de la ventana gráfica que ocupa el elemento en index.
Si tu elemento se muestra en varias áreas, entonces `visualRect` debería devolver el área principal que contiene el índice y no el área completa que dicho índice pueda abarcar, tocar o en la que se dibuje.
En la clase base, se trata de una función virtual pura.
Véase también ` indexAt()` y ` visualRegionForSelection()`.
[pure virtual protected] QRegion QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const
Devuelve la región de la ventana gráfica correspondiente a los elementos de la ` selection` indicada.
En la clase base, se trata de una función virtual pura.
Véanse también « visualRect()» y « selectedIndexes()».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.