VirtualBox

source: vbox/trunk/src/VBox/Frontends/VirtualBox/src/globals/UIQObjectStuff.h@ 104158

Last change on this file since 104158 was 98103, checked in by vboxsync, 23 months ago

Copyright year updates by scm.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 2.6 KB
Line 
1/* $Id: UIQObjectStuff.h 98103 2023-01-17 14:15:46Z vboxsync $ */
2/** @file
3 * VBox Qt GUI - UIQObjectStuff class declaration.
4 */
5
6/*
7 * Copyright (C) 2020-2023 Oracle and/or its affiliates.
8 *
9 * This file is part of VirtualBox base platform packages, as
10 * available from https://www.virtualbox.org.
11 *
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation, in version 3 of the
15 * License.
16 *
17 * This program is distributed in the hope that it will be useful, but
18 * WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 * General Public License for more details.
21 *
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, see <https://www.gnu.org/licenses>.
24 *
25 * SPDX-License-Identifier: GPL-3.0-only
26 */
27
28#ifndef FEQT_INCLUDED_SRC_globals_UIQObjectStuff_h
29#define FEQT_INCLUDED_SRC_globals_UIQObjectStuff_h
30#ifndef RT_WITHOUT_PRAGMA_ONCE
31# pragma once
32#endif
33
34/* Qt includes: */
35#include <QObject>
36#include <QPointer>
37#include <QVariant>
38
39/* GUI includes: */
40#include "UILibraryDefs.h"
41
42/** Guard block which sets/clears QObject property on RAII basis. */
43class SHARED_LIBRARY_STUFF UIQObjectPropertySetter : public QObject
44{
45 Q_OBJECT;
46
47signals:
48
49 /** Notify listeners that we are about to be destroyed.
50 * @note This signal is emitted one call-stack frame earlier
51 * than QObject::destroyed(QObject *obj = Q_NULLPTR),
52 * so we still can use info stored in this object. */
53 void sigAboutToBeDestroyed();
54
55public:
56
57 /** Constructs guard block which sets for @a pObject a property with certain @a strPropertyName and @a value. */
58 UIQObjectPropertySetter(QObject *pObject, const QString &strPropertyName, const QVariant &value);
59 /** Constructs guard block which sets for @a objects a property with certain @a strPropertyName and @a value. */
60 UIQObjectPropertySetter(const QList<QObject*> &objects, const QString &strPropertyName, const QVariant &value);
61
62 /** Destructs guard block clearing previously set property for good. */
63 virtual ~UIQObjectPropertySetter() RT_OVERRIDE;
64
65private:
66
67 /** Inits properties. */
68 void init();
69 /** Deinits properties. */
70 void deinit();
71
72 /** Holds the list of live QObject pointers. */
73 QList<QPointer<QObject> > m_objects;
74 /** Holds the property name. */
75 QString m_strPropertyName;
76 /** Holds the property value. */
77 QVariant m_value;
78};
79
80#endif /* !FEQT_INCLUDED_SRC_globals_UIQObjectStuff_h */
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette