En esta página

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:

QColumnView, QHeaderView, QListView, QTableView y QTreeView

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 &region)
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&current, 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:

TeclasFuncionalidad
Teclas de flechaCambia el elemento actual y lo selecciona.
Ctrl + teclas de flechaCambia el elemento actual, pero no lo selecciona.
Mayús + teclas de flechaCambia el elemento actual y lo selecciona. Los elementos seleccionados anteriormente no se deseleccionan.
Ctrl+EspacioActiva o desactiva la selección del elemento actual.
Tabulador/Tabulador hacia atrásCambia el elemento actual al siguiente o al anterior.
Inicio/FinSelecciona el primer/último elemento del modelo.
Re Pág/Av PágDesplaza las filas mostradas hacia arriba o hacia abajo según el número de filas visibles en la vista.
Ctrl+ASelecciona 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.

Nota: Si heredas de `QAbstractItemView` y pretendes actualizar el contenido del área de visualización, debes utilizar `viewport->update()` en lugar de ` update()`, ya que todas las operaciones de dibujo tienen lugar en el área de visualizació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,

ConstanteValorDescripción
QAbstractItemView::MoveUp0Ir al elemento situado encima del elemento actual.
QAbstractItemView::MoveDown1Ir al elemento situado debajo del actual.
QAbstractItemView::MoveLeft2Ir al elemento situado a la izquierda del elemento actual.
QAbstractItemView::MoveRight3Ir al elemento situado a la derecha del actual.
QAbstractItemView::MoveHome4Ir al elemento de la esquina superior izquierda.
QAbstractItemView::MoveEnd5Ir al elemento de la esquina inferior derecha.
QAbstractItemView::MovePageUp6Desplázate una página hacia arriba, por encima del elemento actual.
QAbstractItemView::MovePageDown7Desplázate una página hacia abajo, por debajo del elemento actual.
QAbstractItemView::MoveNext8Ir al elemento que sigue al actual.
QAbstractItemView::MovePrevious9Ir 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).

ConstanteValorDescripción
QAbstractItemView::NoDragDrop0No admite la función de arrastrar y soltar.
QAbstractItemView::DragOnly1La vista admite el arrastre de sus propios elementos
QAbstractItemView::DropOnly2La vista admite la colocación
QAbstractItemView::DragDrop3La vista admite tanto arrastrar como soltar
QAbstractItemView::InternalMove4La 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:

ConstanteValorDescripción
QAbstractItemView::OnItem0El elemento se soltará sobre el índice.
QAbstractItemView::AboveItem1El elemento se soltará por encima del índice.
QAbstractItemView::BelowItem2El elemento se colocará por debajo del índice.
QAbstractItemView::OnViewport3El 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.

ConstanteValorDescripción
QAbstractItemView::NoEditTriggers0No es posible la edición.
QAbstractItemView::CurrentChanged1La edición comienza cada vez que cambia el elemento actual.
QAbstractItemView::DoubleClicked2La edición comienza al hacer doble clic en un elemento.
QAbstractItemView::SelectedClicked4La edición comienza al hacer clic en un elemento ya seleccionado.
QAbstractItemView::EditKeyPressed8La edición comienza cuando se pulsa la tecla de edición de la plataforma sobre un elemento.
QAbstractItemView::AnyKeyPressed16La edición comienza al pulsar cualquier tecla sobre un elemento.
QAbstractItemView::AllEditTriggers31La 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

ConstanteValorDescripción
QAbstractItemView::EnsureVisible0Desplaza la vista para garantizar que el elemento sea visible.
QAbstractItemView::PositionAtTop1Desplázate para situar el elemento en la parte superior de la ventana de visualización.
QAbstractItemView::PositionAtBottom2Desplázate para situar el elemento en la parte inferior de la ventana de visualización.
QAbstractItemView::PositionAtCenter3Desplá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.

ConstanteValorDescripción
QAbstractItemView::ScrollPerItem0La vista desplazará el contenido un elemento cada vez.
QAbstractItemView::ScrollPerPixel1La vista desplazará el contenido píxel a píxel.

enum QAbstractItemView::SelectionBehavior

ConstanteValorDescripción
QAbstractItemView::SelectItems0Selección de elementos individuales.
QAbstractItemView::SelectRows1Selección exclusiva de filas.
QAbstractItemView::SelectColumns2Selección exclusiva de columnas.

enum QAbstractItemView::SelectionMode

Esta enumeración indica cómo responde la vista a las selecciones del usuario:

ConstanteValorDescripción
QAbstractItemView::SingleSelection1Cuando 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::ContiguousSelection4Cuando 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::ExtendedSelection3Cuando 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::MultiSelection2Cuando 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::NoSelection0No 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.

ConstanteValorDescripción
QAbstractItemView::NoState0Este es el estado por defecto.
QAbstractItemView::DraggingState1El usuario está arrastrando elementos.
QAbstractItemView::DragSelectingState2El usuario está seleccionando elementos.
QAbstractItemView::EditingState3El usuario está editando un elemento en un editor de widgets.
QAbstractItemView::ExpandingState4El usuario está abriendo una rama de elementos.
QAbstractItemView::CollapsingState5El usuario está cerrando una rama de elementos.
QAbstractItemView::AnimatingState6La 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:

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 &current, 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); });
Para ver más ejemplos y enfoques, consulta «Conexión a ranuras sobrecargadas».

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 &region)

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

setIndexWidget(index, new QLineEdit);
...
setIndexWidget(index, new QTextEdit);

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.