blob: 939b9f3934eb3cfc9b3e6a8d6440428e2e09300f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
/****************************************************************************
**
** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 3 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL3 included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 3 requirements
** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 2.0 or (at your option) the GNU General
** Public license version 3 or any later version approved by the KDE Free
** Qt Foundation. The licenses are as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-2.0.html and
** https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include <QtCore/qmetaobject.h>
#include <QtCore/qtimer.h>
#include "qmediacontrol.h"
#include "qmediacontrol_p.h"
QT_BEGIN_NAMESPACE
/*!
\class QMediaControl
\inmodule QtMultimedia
\ingroup multimedia
\ingroup multimedia_control
\ingroup multimedia_core
\brief The QMediaControl class provides a base interface for media service controls.
Media controls provide an interface to individual features provided by a
media service. Most services implement a principal control which exposes
the core functionality of the service and a number of optional controls which
expose any additional functionality.
A pointer to a control implemented by a media service can be obtained using
the \l {QMediaService::requestControl()} member of QMediaService. If the
service doesn't implement a control it will instead return a null pointer.
\snippet multimedia-snippets/media.cpp Request control
Alternatively if the IId of the control has been declared using
Q_MEDIA_DECLARE_CONTROL the template version of
QMediaService::requestControl() can be used to request the service without
explicitly passing the IId or using qobject_cast().
\snippet multimedia-snippets/media.cpp Request control templated
Most application code will not interface directly with a media service's
controls, instead the QMediaObject which owns the service acts as an
intermediary between one or more controls and the application.
\sa QMediaService, QMediaObject
*/
/*!
\macro Q_MEDIA_DECLARE_CONTROL(Class, IId)
\relates QMediaControl
The Q_MEDIA_DECLARE_CONTROL macro declares an \a IId for a \a Class that
inherits from QMediaControl.
Declaring an IId for a QMediaControl allows an instance of that control to
be requested from QMediaService::requestControl() without explicitly
passing the IId.
\snippet multimedia-snippets/media.cpp Request control templated
\sa QMediaService::requestControl()
*/
/*!
Destroys a media control.
*/
QMediaControl::~QMediaControl()
{
delete d_ptr;
}
/*!
Constructs a media control with the given \a parent.
*/
QMediaControl::QMediaControl(QObject *parent)
: QObject(parent)
, d_ptr(new QMediaControlPrivate)
{
d_ptr->q_ptr = this;
}
/*!
\internal
*/
QMediaControl::QMediaControl(QMediaControlPrivate &dd, QObject *parent)
: QObject(parent)
, d_ptr(&dd)
{
d_ptr->q_ptr = this;
}
#include "moc_qmediacontrol.cpp"
QT_END_NAMESPACE
|
