1 /****************************************************************************
2 **
3 ** Copyright (C) 2015 The Qt Company Ltd.
4 ** Contact: http://www.qt.io/licensing/
5 **
6 ** This file is part of the documentation of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:BSD$
9 ** You may use this file under the terms of the BSD license as follows:
10 **
11 ** "Redistribution and use in source and binary forms, with or without
12 ** modification, are permitted provided that the following conditions are
13 ** met:
14 **   * Redistributions of source code must retain the above copyright
15 **     notice, this list of conditions and the following disclaimer.
16 **   * Redistributions in binary form must reproduce the above copyright
17 **     notice, this list of conditions and the following disclaimer in
18 **     the documentation and/or other materials provided with the
19 **     distribution.
20 **   * Neither the name of The Qt Company Ltd nor the names of its
21 **     contributors may be used to endorse or promote products derived
22 **     from this software without specific prior written permission.
23 **
24 **
25 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26 ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
27 ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
28 ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
29 ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
30 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
31 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
32 ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
33 ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
34 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
35 ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
36 **
37 ** $QT_END_LICENSE$
38 **
39 ****************************************************************************/
40 
41 //! [3]
42 #include "foo.moc"
43 //! [3]
44 
45 
46 //! [4]
47 #ifndef Q_MOC_RUN
48     ...
49 #endif
50 //! [4]
51 
52 
53 //! [5]
54 class SomeTemplate<int> : public QFrame
55 {
56     Q_OBJECT
57     ...
58 
59 signals:
60     void mySignal(int);
61 };
62 //! [5]
63 
64 
65 //! [6]
66 // correct
67 class SomeClass : public QObject, public OtherClass
68 {
69     ...
70 };
71 //! [6]
72 
73 
74 //! [7]
75 class SomeClass : public QObject
76 {
77     Q_OBJECT
78 
79 public slots:
80     void apply(void (*apply)(List *, void *), char *); // WRONG
81 };
82 //! [7]
83 
84 
85 //! [8]
86 typedef void (*ApplyFunction)(List *, void *);
87 
88 class SomeClass : public QObject
89 {
90     Q_OBJECT
91 
92 public slots:
93     void apply(ApplyFunction, char *);
94 };
95 //! [8]
96 
97 
98 //! [9]
99 class MyClass : public QObject
100 {
101     Q_OBJECT
102 
103     enum Error {
104         ConnectionRefused,
105         RemoteHostClosed,
106         UnknownError
107     };
108 
109 signals:
110     void stateChanged(MyClass::Error error);
111 };
112 //! [9]
113 
114 
115 //! [10]
116 #ifdef ultrix
117 #define SIGNEDNESS(a) unsigned a
118 #else
119 #define SIGNEDNESS(a) a
120 #endif
121 
122 class Whatever : public QObject
123 {
124     Q_OBJECT
125 
126 signals:
127     void someSignal(SIGNEDNESS(int));
128 };
129 //! [10]
130 
131 
132 //! [11]
133 class A
134 {
135 public:
136     class B
137     {
138         Q_OBJECT
139 
140     public slots:   // WRONG
141         void b();
142     };
143 };
144 //! [11]
145