roleItemDelegate.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2025 MAK Technologies
** All rights reserved.
*******************************************************************************/
 
//! \file roleItemDelegate.h
//! \ingroup vreManager
//! \brief Role item delegate for VREngage Manager
//!
//! This file defines the DtRoleItemDelegate class, which is responsible for
//! providing a customized editor (combobox) for role selection in the VREngage Manager.
 
#pragma once
 
#include "vreManager/export.h"
 
#include <QStyledItemDelegate>
#include <QComboBox>
 
class QComboBox;
 
namespace makVre
{
//! \brief Custom item delegate for role selection
//!
//! This delegate provides a combobox editor for selecting roles in the VREngage
//! Manager interface. It handles the creation, population, and manipulation of the
//! combobox editor for role selection cells in the manager's table view.
class VREMANAGER_DLL DtRoleItemDelegate : public QStyledItemDelegate
{
   Q_OBJECT
public:
   //! \brief Constructor
   //! \param parent The parent object
   //!
   //! Initializes a new role item delegate with the specified parent.
   DtRoleItemDelegate(QObject* parent = 0);
 
   //! \brief Destructor
   //!
   //! Cleans up resources used by the role item delegate.
   virtual ~DtRoleItemDelegate() override;
 
   //! \brief Creates a combobox editor for role selection
   //! \param parent The parent widget
   //! \param option The style options to use when drawing the editor
   //! \param index The model index of the item being edited
   //! \return A combobox widget configured for role selection
   //!
   //! Creates and configures a combobox editor for selecting roles.
   virtual QWidget* createEditor(
      QWidget* parent, const QStyleOptionViewItem& option, const QModelIndex& index) const override;
 
   //! \brief Destroys the editor when editing is finished
   //! \param editor The editor widget to destroy
   //! \param index The model index of the item that was being edited
   //!
   //! Handles cleanup of the editor widget when editing is complete.
   virtual void destroyEditor(QWidget* editor, const QModelIndex& index) const override;
 
   //! \brief Sets the editor data based on the model index
   //! \param editor The editor widget to update
   //! \param index The model index containing the data to edit
   //!
   //! Populates the editor with data from the model.
   virtual void setEditorData(QWidget* editor, const QModelIndex& index) const override;
 
   //! \brief Updates the model with data from the editor
   //! \param editor The editor widget containing the updated data
   //! \param model The model to update
   //! \param index The model index to update
   //!
   //! Transfers the data from the editor back to the model when editing is complete.
   virtual void setModelData(QWidget* editor, QAbstractItemModel* model, const QModelIndex& index) const override;
 
protected slots:
   //! \brief Handles combobox activation
   //! \param index The index of the activated item
   //!
   //! Called when an item in the combobox is activated/selected.
   virtual void onActivated(int index);
 
protected:
   //! \brief The combobox editor widget
   //!
   //! Maintains a reference to the currently active combobox editor.
   //! Declared mutable to allow modification in const methods.
   mutable QComboBox* myEditor;
};
 
} // namespace makVre