Advance Wayland and KDE package bring-up
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
@@ -0,0 +1,298 @@
|
||||
/*
|
||||
This file is part of the KDE Libraries
|
||||
SPDX-FileCopyrightText: 1999-2001 Mirko Boehm <mirko@kde.org>
|
||||
SPDX-FileCopyrightText: 1999-2001 Espen Sand <espen@kde.org>
|
||||
SPDX-FileCopyrightText: 1999-2001 Holger Freyther <freyther@kde.org>
|
||||
SPDX-FileCopyrightText: 2005-2006 Olivier Goffart <ogoffart at kde.org>
|
||||
SPDX-FileCopyrightText: 2006 Tobias Koenig <tokoe@kde.org>
|
||||
|
||||
SPDX-License-Identifier: LGPL-2.0-or-later
|
||||
*/
|
||||
#ifndef KPAGEDIALOG_H
|
||||
#define KPAGEDIALOG_H
|
||||
|
||||
#include <QDialog>
|
||||
#include <QDialogButtonBox>
|
||||
#include <kpagewidget.h>
|
||||
#include <memory>
|
||||
|
||||
class KPageDialogPrivate;
|
||||
|
||||
/**
|
||||
* @class KPageDialog kpagedialog.h KPageDialog
|
||||
*
|
||||
* @short A dialog base class which can handle multiple pages.
|
||||
*
|
||||
* This class provides a dialog base class which handles multiple
|
||||
* pages and allows the user to switch between these pages in
|
||||
* different ways.
|
||||
*
|
||||
* Currently, @p Auto, @p Plain, @p List, @p Tree and @p Tabbed face
|
||||
* types are available (cmp. KPageView).
|
||||
*
|
||||
* By default a QDialogButtonBox is added to the dialog with two buttons,
|
||||
* OK (@c QDialogButtonBox::Ok) and Cancel (@c QDialogButtonBox::Cancel).
|
||||
* You can customize which buttons are added to the dialog by using any of the
|
||||
* available buttons-related methods.
|
||||
*
|
||||
* Note that if there is a QDialogButtonBox (either the one added by default, or
|
||||
* one you added manually) some logical connections are created:
|
||||
* - @c QDialogButtonBox::accepted() is connected to @c QDialog::accept()
|
||||
* - @c QDialogButtonBox::rejected() is connected to @c QDialog::reject()
|
||||
* this means that you shouldn't create these connections again (otherwise you
|
||||
* would end up receiving two duplicate accepted() signals for example).
|
||||
*
|
||||
* <b>Example:</b>\n
|
||||
*
|
||||
* @code
|
||||
* UrlDialog::UrlDialog( QWidget *parent )
|
||||
* : KPageDialog( parent )
|
||||
* {
|
||||
* setFaceType(List);
|
||||
*
|
||||
* QLabel *label = new QLabel("Test Page");
|
||||
* addPage(label, i18n("My Test Page"));
|
||||
*
|
||||
* label = new QLabel("Second Test Page");
|
||||
* KPageWidgetItem *page = new KPageWidgetItem(label, i18n("My Second Test Page"));
|
||||
* page->setHeader(i18n("My header string"));
|
||||
* page->setIcon(QIcon::fromTheme("file"));
|
||||
*
|
||||
* addPage(page);
|
||||
*
|
||||
* // Change the buttons added to the dialog
|
||||
* setStandardButtons(QDialogButtonBox::Ok | QDialogButtonBox::Apply | QDialogButtonBox::Cancel);
|
||||
*
|
||||
* // Alternatively you can create a QDialogButtonBox, add the buttons you want to it,
|
||||
* // then add that button box to the dialog
|
||||
* QDialogButtonBox *btnBox = new QDialogButtonBox(QDialogButtonBox::Ok | QDialogButtonBox::Apply | QDialogButtonBox::Cancel,
|
||||
* Qt::Horizontal,
|
||||
* this);
|
||||
* setButtonBox(btnBox);
|
||||
* }
|
||||
* @endcode
|
||||
*
|
||||
* @author Tobias Koenig (tokoe@kde.org)
|
||||
*/
|
||||
class KWIDGETSADDONS_EXPORT KPageDialog : public QDialog
|
||||
{
|
||||
Q_OBJECT
|
||||
Q_DECLARE_PRIVATE(KPageDialog)
|
||||
|
||||
public:
|
||||
/**
|
||||
* The face types supported.
|
||||
*/
|
||||
enum FaceType {
|
||||
/**
|
||||
* A dialog with a face based on the structure of the available pages.
|
||||
* If only a single page is added, the dialog behaves like
|
||||
* in @c Plain mode, with multiple pages without sub pages
|
||||
* it behaves like in @c List mode and like in @c Tree mode otherwise.
|
||||
*/
|
||||
Auto = KPageView::Auto,
|
||||
/**
|
||||
* A normal dialog
|
||||
*/
|
||||
Plain = KPageView::Plain,
|
||||
/**
|
||||
* A dialog with an icon list on the left side and a
|
||||
* representation of the contents on the right side
|
||||
*/
|
||||
List = KPageView::List,
|
||||
/**
|
||||
* A dialog with a tree on the left side and a
|
||||
* representation of the contents on the right side
|
||||
*/
|
||||
Tree = KPageView::Tree,
|
||||
/**
|
||||
* A dialog with a tab bar above the representation
|
||||
* of the contents
|
||||
*/
|
||||
Tabbed = KPageView::Tabbed,
|
||||
/**
|
||||
* A dialog with an flat list with small icons on the left side
|
||||
* and a representation of the contents on the right side
|
||||
*/
|
||||
FlatList = KPageView::FlatList,
|
||||
};
|
||||
|
||||
public:
|
||||
/**
|
||||
* Creates a new page dialog.
|
||||
*/
|
||||
explicit KPageDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags());
|
||||
|
||||
/**
|
||||
* Destroys the page dialog.
|
||||
*/
|
||||
~KPageDialog() override;
|
||||
|
||||
/**
|
||||
* Sets the face type of the dialog.
|
||||
*/
|
||||
void setFaceType(FaceType faceType);
|
||||
|
||||
/**
|
||||
* Adds a new top level page to the dialog.
|
||||
*
|
||||
* @param widget The widget of the page.
|
||||
* @param name The name which is displayed in the navigation view.
|
||||
*
|
||||
* @returns The associated KPageWidgetItem.
|
||||
*/
|
||||
KPageWidgetItem *addPage(QWidget *widget, const QString &name);
|
||||
|
||||
/**
|
||||
* Adds a new top level page to the dialog.
|
||||
*
|
||||
* @param item The KPageWidgetItem which describes the page.
|
||||
*/
|
||||
void addPage(KPageWidgetItem *item);
|
||||
|
||||
/**
|
||||
* Inserts a new page in the dialog.
|
||||
*
|
||||
* @param before The new page will be insert before this KPageWidgetItem
|
||||
* on the same level in hierarchy.
|
||||
* @param widget The widget of the page.
|
||||
* @param name The name which is displayed in the navigation view.
|
||||
*
|
||||
* @returns The associated KPageWidgetItem.
|
||||
*/
|
||||
KPageWidgetItem *insertPage(KPageWidgetItem *before, QWidget *widget, const QString &name);
|
||||
|
||||
/**
|
||||
* Inserts a new page in the dialog.
|
||||
*
|
||||
* @param before The new page will be insert before this KPageWidgetItem
|
||||
* on the same level in hierarchy.
|
||||
*
|
||||
* @param item The KPageWidgetItem which describes the page.
|
||||
*/
|
||||
void insertPage(KPageWidgetItem *before, KPageWidgetItem *item);
|
||||
|
||||
/**
|
||||
* Inserts a new sub page in the dialog.
|
||||
*
|
||||
* @param parent The new page will be insert as child of this KPageWidgetItem.
|
||||
* @param widget The widget of the page.
|
||||
* @param name The name which is displayed in the navigation view.
|
||||
*
|
||||
* @returns The associated KPageWidgetItem.
|
||||
*/
|
||||
KPageWidgetItem *addSubPage(KPageWidgetItem *parent, QWidget *widget, const QString &name);
|
||||
|
||||
/**
|
||||
* Inserts a new sub page in the dialog.
|
||||
*
|
||||
* @param parent The new page will be insert as child of this KPageWidgetItem.
|
||||
*
|
||||
* @param item The KPageWidgetItem which describes the page.
|
||||
*/
|
||||
void addSubPage(KPageWidgetItem *parent, KPageWidgetItem *item);
|
||||
|
||||
/**
|
||||
* Removes the page associated with the given KPageWidgetItem.
|
||||
*/
|
||||
void removePage(KPageWidgetItem *item);
|
||||
|
||||
/**
|
||||
* Sets the page which is associated with the given KPageWidgetItem to
|
||||
* be the current page and emits the currentPageChanged() signal.
|
||||
*/
|
||||
void setCurrentPage(KPageWidgetItem *item);
|
||||
|
||||
/**
|
||||
* Returns the KPageWidgetItem for the current page or a null pointer if there is no
|
||||
* current page.
|
||||
*/
|
||||
KPageWidgetItem *currentPage() const;
|
||||
|
||||
/**
|
||||
* Sets the collection of standard buttons displayed by this dialog.
|
||||
*/
|
||||
void setStandardButtons(QDialogButtonBox::StandardButtons buttons);
|
||||
|
||||
/**
|
||||
* Returns the QPushButton corresponding to the standard button which, or a null pointer if the standard
|
||||
* button doesn't exist in this dialog.
|
||||
*/
|
||||
QPushButton *button(QDialogButtonBox::StandardButton which) const;
|
||||
|
||||
/**
|
||||
* Set an action button.
|
||||
*/
|
||||
void addActionButton(QAbstractButton *button);
|
||||
|
||||
Q_SIGNALS:
|
||||
/**
|
||||
* This signal is emitted whenever the current page has changed.
|
||||
*
|
||||
* @param current The new current page or a null pointer if no current page is available.
|
||||
* @param before The page that was current before the new current page has changed.
|
||||
*/
|
||||
void currentPageChanged(KPageWidgetItem *current, KPageWidgetItem *before);
|
||||
|
||||
/**
|
||||
* This signal is emitted whenever a page has been removed.
|
||||
*
|
||||
* @param page The page which has been removed
|
||||
*/
|
||||
void pageRemoved(KPageWidgetItem *page);
|
||||
|
||||
protected:
|
||||
/**
|
||||
* This constructor can be used by subclasses to provide a custom page widget.
|
||||
*
|
||||
* \param widget The KPageWidget object will be reparented to this object, so you can create
|
||||
* it without parent and you are not allowed to delete it.
|
||||
*/
|
||||
KPageDialog(KPageWidget *widget, QWidget *parent, Qt::WindowFlags flags = Qt::WindowFlags());
|
||||
KWIDGETSADDONS_NO_EXPORT KPageDialog(KPageDialogPrivate &dd, KPageWidget *widget, QWidget *parent, Qt::WindowFlags flags = Qt::WindowFlags());
|
||||
|
||||
/**
|
||||
* Returns the page widget of the dialog or a null pointer if no page widget is set.
|
||||
*/
|
||||
KPageWidget *pageWidget();
|
||||
|
||||
/**
|
||||
* Returns the page widget of the dialog or a null pointer if no page widget is set.
|
||||
*/
|
||||
const KPageWidget *pageWidget() const;
|
||||
|
||||
/**
|
||||
* Set the page widget of the dialog.
|
||||
*
|
||||
* @note the previous pageWidget will be deleted.
|
||||
*
|
||||
* @param widget The KPageWidget object will be reparented to this object, so you can create
|
||||
* it without parent and you are not allowed to delete it.
|
||||
*/
|
||||
void setPageWidget(KPageWidget *widget);
|
||||
|
||||
/**
|
||||
* Returns the button box of the dialog or a null pointer if no button box is set.
|
||||
*/
|
||||
QDialogButtonBox *buttonBox();
|
||||
|
||||
/**
|
||||
* Returns the button box of the dialog or a null pointer if no button box is set.
|
||||
*/
|
||||
const QDialogButtonBox *buttonBox() const;
|
||||
|
||||
/**
|
||||
* Set the button box of the dialog
|
||||
*
|
||||
* @note the previous buttonBox will be deleted.
|
||||
*
|
||||
* @param box The QDialogButtonBox object will be reparented to this object, so you can create
|
||||
* it without parent and you are not allowed to delete it.
|
||||
*/
|
||||
void setButtonBox(QDialogButtonBox *box);
|
||||
|
||||
protected:
|
||||
std::unique_ptr<class KPageDialogPrivate> const d_ptr;
|
||||
};
|
||||
|
||||
#endif
|
||||
Reference in New Issue
Block a user