qskinny/src/controls/QskComboBox.h
2023-07-04 12:54:59 +02:00

119 lines
3.1 KiB
C++

/******************************************************************************
* QSkinny - Copyright (C) 2016 Uwe Rathmann
* SPDX-License-Identifier: BSD-3-Clause
*****************************************************************************/
#ifndef QSK_COMBO_BOX_H
#define QSK_COMBO_BOX_H
#include "QskControl.h"
#include <qstringlist.h>
class QskTextOptions;
class QskLabelData;
class QUrl;
class QSK_EXPORT QskComboBox : public QskControl
{
Q_OBJECT
Q_PROPERTY( QVector< QskLabelData > options READ options
WRITE setOptions NOTIFY optionsChanged )
Q_PROPERTY( int currentIndex READ currentIndex
WRITE setCurrentIndex NOTIFY currentIndexChanged )
Q_PROPERTY( QString currentText READ currentText
NOTIFY currentIndexChanged )
Q_PROPERTY( int count READ count )
Q_PROPERTY( QString placeholderText READ placeholderText
WRITE setPlaceholderText NOTIFY placeholderTextChanged )
Q_PROPERTY( int indexInPopup READ indexInPopup
NOTIFY indexInPopupChanged )
Q_PROPERTY( bool pressed READ isPressed
WRITE setPressed NOTIFY pressedChanged FINAL )
using Inherited = QskControl;
public:
QSK_SUBCONTROLS( Panel, Icon, Text, StatusIndicator )
QSK_STATES( Pressed, PopupOpen )
QskComboBox( QQuickItem* parent = nullptr );
~QskComboBox() override;
void setPressed( bool on );
bool isPressed() const;
void setPopupOpen( bool );
bool isPopupOpen() const;
void setTextOptions( const QskTextOptions& );
QskTextOptions textOptions() const;
int addOption( const QUrl&, const QString& );
int addOption( const QString&, const QString& );
int addOption( const QskLabelData& );
void setOptions( const QVector< QskLabelData >& );
void setOptions( const QStringList& );
QVector< QskLabelData > options() const;
QskLabelData optionAt( int ) const;
void clear();
int currentIndex() const;
QString currentText() const;
// "highlightedIndex" ( see Qt's combo boxes ) is not very intuitive
virtual int indexInPopup() const;
int count() const;
QString textAt( int ) const;
QString placeholderText() const;
void setPlaceholderText( const QString& );
public Q_SLOTS:
void setCurrentIndex( int );
Q_SIGNALS:
void pressed();
void released();
void pressedChanged( bool );
void currentIndexChanged( int );
void indexInPopupChanged( int );
void optionsChanged();
void placeholderTextChanged( const QString& );
protected:
void mousePressEvent( QMouseEvent* ) override;
void mouseReleaseEvent( QMouseEvent* ) override;
void keyPressEvent( QKeyEvent* ) override;
void keyReleaseEvent( QKeyEvent* ) override;
void wheelEvent( QWheelEvent* ) override;
/*
open/close a menu - needs to be overloaded when using a custom popup
don't forget to modify indexInPopup/indexInPopupChanged as well
*/
virtual void openPopup();
virtual void closePopup();
private:
class PrivateData;
std::unique_ptr< PrivateData > m_data;
};
#endif