LibrePCB Developers Documentation
Loading...
Searching...
No Matches
Public Types | Public Member Functions | Private Types | Private Member Functions | Private Attributes | List of all members
EditableListModel< T, TYPE > Class Template Referencefinal

A generic QAbstractTableModel subclass to view and edit list of various data types. More...

#include <editablelistmodel.h>

Inherits QAbstractTableModel.

+ Collaboration diagram for EditableListModel< T, TYPE >:

Public Types

enum  Column
 

Public Member Functions

 EditableListModel (const EditableListModel &other) noexcept=delete
 
 EditableListModel (QObject *parent=nullptr) noexcept
 
 ~EditableListModel () noexcept
 
const T & getValues () const noexcept
 
void setDefaultValue (const ValueType &value) noexcept
 
void setPlaceholderText (const QString &text) noexcept
 
void setValues (const T &values) noexcept
 
void setChoices (const T &choices) noexcept
 
void setDisplayText (const ValueType &value, const QString &text) noexcept
 
void setIcon (const ValueType &value, const QIcon &icon) noexcept
 
void add (const QPersistentModelIndex &itemIndex) noexcept
 
void remove (const QPersistentModelIndex &itemIndex) noexcept
 
void moveUp (const QPersistentModelIndex &itemIndex) noexcept
 
void moveDown (const QPersistentModelIndex &itemIndex) noexcept
 
int rowCount (const QModelIndex &parent=QModelIndex()) const override
 
int columnCount (const QModelIndex &parent=QModelIndex()) const override
 
QVariant data (const QModelIndex &index, int role=Qt::DisplayRole) const override
 
QVariant headerData (int section, Qt::Orientation orientation, int role=Qt::DisplayRole) const override
 
Qt::ItemFlags flags (const QModelIndex &index) const override
 
bool setData (const QModelIndex &index, const QVariant &value, int role=Qt::EditRole) override
 
EditableListModel & operator= (const EditableListModel &rhs) noexcept
 

Private Types

typedef T::value_type ValueType
 

Private Member Functions

QString getDisplayText (const Uuid &value) const noexcept
 
QString getDisplayText (const QUrl &value) const noexcept
 
QString getDisplayText (const QString &value) const noexcept
 
QVariant getDataForValue (const Uuid &value) const noexcept
 
QVariant getDataForValue (const QUrl &value) const noexcept
 
QVariant getDataForValue (const QString &value) const noexcept
 
std::optional< Uuid > convertInputValue (const QVariant &input, const std::optional< Uuid > &tag) const noexcept
 
std::optional< QString > convertInputValue (const QVariant &input, const std::optional< QString > &tag) const noexcept
 
std::optional< QUrl > convertInputValue (const QVariant &input, const std::optional< QUrl > &tag) const noexcept
 
void updateComboBoxItems () noexcept
 

Private Attributes

T mChoices
 
T mValues
 
std::optional< ValueType > mDefaultValue
 
std::optional< ValueType > mNewValue
 
QString mPlaceholderText
 
QHash< ValueType, QString > mDisplayTexts
 
QHash< ValueType, QIcon > mIcons
 
ComboBoxDelegate::Items mComboBoxItems
 

Detailed Description

template<typename T, EditableListModelType TYPE = EditableListModelType::DEFAULT>
class librepcb::editor::EditableListModel< T, TYPE >

A generic QAbstractTableModel subclass to view and edit list of various data types.

This class is similar to QStringListModel, but supports various other item types than QString.

Special Features:

  • Adds an additional column and row to allow modifying the model with librepcb::editor::EditableTableWidget.
  • Automatic pretty printing and input validation for various data types:
    • Locales, e.g. "de_DE" -> "Deutsch (Deutschland)"
    • URLs
  • Optionally providing a QComboBox to choose from a predefined set of values (setChoices()). Values are automatically sorted by their text.
  • Support custom display text (setDisplayText()).
  • Support icons (setIcon()).
  • Duplicate values are revoked.

Member Typedef Documentation

◆ ValueType

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
typedef T::value_type ValueType
private

Member Enumeration Documentation

◆ Column

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
enum Column
Enumerator
COLUMN_TEXT 
COLUMN_ACTIONS 
_COLUMN_COUNT 

Constructor & Destructor Documentation

◆ EditableListModel() [1/2]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
EditableListModel ( const EditableListModel< T, TYPE > &  other)
deletenoexcept

◆ EditableListModel() [2/2]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
EditableListModel ( QObject *  parent = nullptr)
inlineexplicitnoexcept

◆ ~EditableListModel()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
~EditableListModel ( )
inlinenoexcept

Member Function Documentation

◆ getValues()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
const T & getValues ( ) const
inlinenoexcept

◆ setDefaultValue()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void setDefaultValue ( const ValueType &  value)
inlinenoexcept

◆ setPlaceholderText()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void setPlaceholderText ( const QString &  text)
inlinenoexcept

◆ setValues()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void setValues ( const T &  values)
inlinenoexcept

◆ setChoices()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void setChoices ( const T &  choices)
inlinenoexcept
+ Here is the call graph for this function:

◆ setDisplayText()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void setDisplayText ( const ValueType &  value,
const QString &  text 
)
inlinenoexcept

◆ setIcon()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void setIcon ( const ValueType &  value,
const QIcon &  icon 
)
inlinenoexcept

◆ add()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void add ( const QPersistentModelIndex &  itemIndex)
inlinenoexcept

◆ remove()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void remove ( const QPersistentModelIndex &  itemIndex)
inlinenoexcept

◆ moveUp()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void moveUp ( const QPersistentModelIndex &  itemIndex)
inlinenoexcept

◆ moveDown()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void moveDown ( const QPersistentModelIndex &  itemIndex)
inlinenoexcept

◆ rowCount()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
int rowCount ( const QModelIndex &  parent = QModelIndex()) const
inlineoverride

◆ columnCount()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
int columnCount ( const QModelIndex &  parent = QModelIndex()) const
inlineoverride

◆ data()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QVariant data ( const QModelIndex &  index,
int  role = Qt::DisplayRole 
) const
inlineoverride
+ Here is the call graph for this function:

◆ headerData()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QVariant headerData ( int  section,
Qt::Orientation  orientation,
int  role = Qt::DisplayRole 
) const
inlineoverride

◆ flags()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
Qt::ItemFlags flags ( const QModelIndex &  index) const
inlineoverride

◆ setData()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
bool setData ( const QModelIndex &  index,
const QVariant &  value,
int  role = Qt::EditRole 
)
inlineoverride
+ Here is the call graph for this function:

◆ operator=()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
EditableListModel & operator= ( const EditableListModel< T, TYPE > &  rhs)
noexcept

◆ getDisplayText() [1/3]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QString getDisplayText ( const Uuid &  value) const
inlineprivatenoexcept
+ Here is the caller graph for this function:

◆ getDisplayText() [2/3]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QString getDisplayText ( const QUrl &  value) const
inlineprivatenoexcept

◆ getDisplayText() [3/3]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QString getDisplayText ( const QString &  value) const
inlineprivatenoexcept
+ Here is the call graph for this function:

◆ getDataForValue() [1/3]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QVariant getDataForValue ( const Uuid &  value) const
inlineprivatenoexcept
+ Here is the caller graph for this function:

◆ getDataForValue() [2/3]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QVariant getDataForValue ( const QUrl &  value) const
inlineprivatenoexcept

◆ getDataForValue() [3/3]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QVariant getDataForValue ( const QString &  value) const
inlineprivatenoexcept

◆ convertInputValue() [1/3]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
std::optional< Uuid > convertInputValue ( const QVariant &  input,
const std::optional< Uuid > &  tag 
) const
inlineprivatenoexcept
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ convertInputValue() [2/3]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
std::optional< QString > convertInputValue ( const QVariant &  input,
const std::optional< QString > &  tag 
) const
inlineprivatenoexcept

◆ convertInputValue() [3/3]

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
std::optional< QUrl > convertInputValue ( const QVariant &  input,
const std::optional< QUrl > &  tag 
) const
inlineprivatenoexcept

◆ updateComboBoxItems()

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
void updateComboBoxItems ( )
inlineprivatenoexcept
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Member Data Documentation

◆ mChoices

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
T mChoices
private

◆ mValues

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
T mValues
private

◆ mDefaultValue

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
std::optional<ValueType> mDefaultValue
private

◆ mNewValue

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
std::optional<ValueType> mNewValue
private

◆ mPlaceholderText

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QString mPlaceholderText
private

◆ mDisplayTexts

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QHash<ValueType, QString> mDisplayTexts
private

◆ mIcons

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
QHash<ValueType, QIcon> mIcons
private

◆ mComboBoxItems

template<typename T , EditableListModelType TYPE = EditableListModelType::DEFAULT>
ComboBoxDelegate::Items mComboBoxItems
private
The documentation for this class was generated from the following file: