blob: f2f0722c2c6f90c822f76225edfde586f9974494 (
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
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
QTest::newRow("Wiki valid email 7") << QUrl("mailto:abc+mailbox/department=shipping@example.com"856
857
// S60 email client considers the next URL invalid, even ity should be valid
QTest::newRow("Wiki valid email 8") << QUrl("mailto:!#$%&'*+-/=?^_`.{|}~@example.com") << true; // all of these characters are allowed
QTest::newRow("Wiki valid email 9") << QUrl("mailto:\"abc@def\"@example.com") << true; // anything goes inside quotation marks
QTest::newRow("Wiki valid email 10") << QUrl("mailto:\"Fred \\\"quota\\\" Bloggs\"@example.com") << true; // however, quotes need escaping
// RFC invalid e-mail addresses
// These return true even though they are invalid, but check that user is notified about invalid URL in mail application
QTest::newRow("Wiki invalid email 1") << QUrl("mailto:Abc.example.com") << true; // character @ is missing
QTest::newRow("Wiki invalid email 2") << QUrl("mailto:Abc.@example.com") << true; // character dot(.) is last in local part
QTest::newRow("Wiki invalid email 3") << QUrl("mailto:Abc..123@example.com") << true; // character dot(.) is double
QTest::newRow("Wiki invalid email 4") << QUrl("mailto:A@b@c@example.com") << true; // only one @ is allowed outside quotations marks
QTest::newRow("Wiki invalid email 5") << QUrl("mailto:()[]\\;:,<>@example.com") << true; // none of the characters before the @ is allowed outside quotation marks
QTest::newRow("Basic") << QUrl("mailto:test@nokia.com") << true;
QTest::newRow("BasicSeveralAddr") << QUrl("mailto:test@nokia.com,test2@nokia.com,test3@nokia.com") << true;
QTest::newRow("BasicAndSubject") << QUrl("mailto:test@nokia.com?subject=hello nokia") << true;
QTest::newRow("BasicAndTo") << QUrl("mailto:test@nokia.com?to=test2@nokia.com") << true;
QTest::newRow("BasicAndCc") << QUrl("mailto:test@nokia.com?cc=mycc@address.com") << true;
QTest::newRow("BasicAndBcc") << QUrl("mailto:test@nokia.com?bcc=mybcc@address.com") << true;
QTest::newRow("BasicAndBody") << QUrl("mailto:test@nokia.com?body=Test email message body") << true;
// RFC examples, these are actually invalid because there is not host defined
// Check that user is notified about invalid URL in mail application
QTest::newRow("RFC2368 Example 1") << QUrl::fromEncoded("mailto:addr1%2C%20addr2") << true;
QTest::newRow("RFC2368 Example 2") << QUrl::fromEncoded("mailto:?to=addr1%2C%20addr2") << true;
QTest::newRow("RFC2368 Example 3") << QUrl("mailto:addr1?to=addr2") << true;
QTest::newRow("RFC2368 Example 4") << QUrl("mailto:joe@example.com?cc=bob@example.com&body=hello") << true;
QTest::newRow("RFC2368 Example 5") << QUrl("mailto:?to=joe@example.com&cc=bob@example.com&body=hello") << true;
QTest::newRow("RFC2368 Example 6") << QUrl("mailto:foobar@example.com?In-Reply-To=%3c3469A91.D10AF4C@example.com") << true; // OpaqueData
QTest::newRow("RFC2368 Example 7") << QUrl::fromEncoded("mailto:infobot@example.com?body=send%20current-issue%0D%0Asend%20index") << true;
QTest::newRow("RFC2368 Example 8") << QUrl::fromEncoded("mailto:infobot@example.com?body=send%20current-issue") << true;
QTest::newRow("RFC2368 Example 9") << QUrl("mailto:infobot@example.com?subject=current-issue") << true;
QTest::newRow("RFC2368 Example 10") << QUrl("mailto:chris@example.com") << true;
//QTest::newRow("RFC2368 Example 11 - illegal chars") << QUrl("mailto:joe@example.com?cc=bob@example.com?body=hello") << false;
QTest::newRow("RFC2368 Example 12") << QUrl::fromEncoded("mailto:gorby%25kremvax@example.com") << true; // encoded reserved chars '%'
QTest::newRow("RFC2368 Example 13") << QUrl::fromEncoded("mailto:unlikely%3Faddress@example.com?blat=foop") << true; // encoded reserved chars `?'
}
void tst_qdesktopservices::openMailtoUrl()
{
#ifndef RUN_MANUAL_TESTS
QSKIP("Test disabled -- only for manual purposes", SkipAll);
#endif
QFETCH(QUrl, url);
QFETCH(bool, result);
QCOMPARE(QDesktopServices::openUrl(url), result);
QTest::qWait(5000);
}
void tst_qdesktopservices::openFileUrl_data()
{
QTest::addColumn<QUrl>("url");
QTest::addColumn<bool>("result");
// Text files
QTest::newRow("DOS text file") << QUrl("file:///c:/data/others/dosfile.txt") << true;
QTest::newRow("No EOF text file") << QUrl("file:///c:/data/others/noendofline.txt") << true;
QTest::newRow("text file") << QUrl("file:///c:/data/others/testfile.txt") << true;
QTest::newRow("text file with space") << QUrl("file:///c:/data/others/test file.txt") << true;
// Images
QTest::newRow("BMP image") << QUrl("file:///c:/data/images/image.bmp") << true;
QTest::newRow("GIF image") << QUrl("file:///c:/data/images/image.gif") << true;
QTest::newRow("JPG image") << QUrl("file:///c:/data/images/image.jpg") << true;
QTest::newRow("PNG image") << QUrl("file:///c:/data/images/image.png") << true;
// Audio
QTest::newRow("MP4 audio") << QUrl("file:///c:/data/sounds/aac-only.mp4") << true;
QTest::newRow("3GP audio") << QUrl("file:///c:/data/sounds/audio_3gpp.3gp") << true;
// Video
QTest::newRow("MP4 video") << QUrl("file:///c:/data/videos/vid-mpeg4-22k.mp4") << true;
// Installs
QTest::newRow("SISX") << QUrl("file:///c:/data/installs/ErrRd.sisx") << true;
// Errors
QTest::newRow("File does not exist") << QUrl("file:///c:/thisfileneverexists.txt") << false;
}
void tst_qdesktopservices::openFileUrl()
{
#ifndef RUN_MANUAL_TESTS
QSKIP("Test disabled -- only for manual purposes", SkipAll);
#endif
QFETCH(QUrl, url);
QFETCH(bool, result);
QCOMPARE(QDesktopServices::openUrl(url), result);
QTest::qWait(5000);
}
void tst_qdesktopservices::openMultipleFileUrls()
{
#ifndef RUN_MANUAL_TESTS
QSKIP("Test disabled -- only for manual purposes", SkipAll);
#endif
QCOMPARE(QDesktopServices::openUrl(QUrl("file:///c:/data/images/image.bmp")), true);
QCOMPARE(QDesktopServices::openUrl(QUrl("file:///c:/data/images/image.png")), true);
QCOMPARE(QDesktopServices::openUrl(QUrl("file:///c:/data/others/noendofline.txt")), true);
QCOMPARE(QDesktopServices::openUrl(QUrl("file:///c:/data/installs/ErrRd.sisx")), true);
}
#endif
class MyUrlHandler : public QObject
{
Q_OBJECT
public:
QUrl lastHandledUrl;
public slots:
inline void handle(const QUrl &url) {
lastHandledUrl = url;
}
};
void tst_qdesktopservices::handlers()
{
MyUrlHandler fooHandler;
MyUrlHandler barHandler;
QDesktopServices::setUrlHandler(QString("foo"), &fooHandler, "handle");
QDesktopServices::setUrlHandler(QString("bar"), &barHandler, "handle");
QUrl fooUrl("foo://blub/meh");
QUrl barUrl("bar://hmm/hmmmm");
QVERIFY(QDesktopServices::openUrl(fooUrl));
QVERIFY(QDesktopServices::openUrl(barUrl));
QCOMPARE(fooHandler.lastHandledUrl.toString(), fooUrl.toString());
QCOMPARE(barHandler.lastHandledUrl.toString(), barUrl.toString());
}
Q_DECLARE_METATYPE(QDesktopServices::StandardLocation)
void tst_qdesktopservices::storageLocation_data()
{
QTest::addColumn<QDesktopServices::StandardLocation>("location");
QTest::newRow("DesktopLocation") << QDesktopServices::DesktopLocation;
QTest::newRow("DocumentsLocation") << QDesktopServices::DocumentsLocation;
QTest::newRow("FontsLocation") << QDesktopServices::FontsLocation;
QTest::newRow("ApplicationsLocation") << QDesktopServices::ApplicationsLocation;
QTest::newRow("MusicLocation") << QDesktopServices::MusicLocation;
QTest::newRow("MoviesLocation") << QDesktopServices::MoviesLocation;
QTest::newRow("PicturesLocation") << QDesktopServices::PicturesLocation;
QTest::newRow("TempLocation") << QDesktopServices::TempLocation;
QTest::newRow("HomeLocation") << QDesktopServices::HomeLocation;
QTest::newRow("DataLocation") << QDesktopServices::DataLocation;
}
void tst_qdesktopservices::storageLocation()
{
QFETCH(QDesktopServices::StandardLocation, location);
#ifdef Q_OS_SYMBIAN
QString storageLocation = QDesktopServices::storageLocation(location);
QString displayName = QDesktopServices::displayName(location);
//qDebug( "displayName: %s", displayName );
storageLocation = storageLocation.toLower();
displayName = displayName.toLower();
QString drive = QDir::currentPath().left(2).toLower();
if( drive == "z:" )
drive = "c:";
switch(location) {
case QDesktopServices::DesktopLocation:
QCOMPARE( storageLocation, drive + QString("/data") );
break;
case QDesktopServices::DocumentsLocation:
QCOMPARE( storageLocation, drive + QString("/data") );
break;
case QDesktopServices::FontsLocation:
// Currently point always to ROM
QCOMPARE( storageLocation, QString("z:/resource/fonts") );
break;
case QDesktopServices::ApplicationsLocation:
#ifdef Q_CC_NOKIAX86
QCOMPARE( storageLocation, QString("z:/sys/bin") );
#else
QCOMPARE( storageLocation, drive + QString("/sys/bin") );
#endif
break;
case QDesktopServices::MusicLocation:
QCOMPARE( storageLocation, drive + QString("/data/sounds") );
break;
case QDesktopServices::MoviesLocation:
QCOMPARE( storageLocation, drive + QString("/data/videos") );
break;
case QDesktopServices::PicturesLocation:
QCOMPARE( storageLocation, drive + QString("/data/images") );
break;
case QDesktopServices::TempLocation:
QCOMPARE( storageLocation, QDir::tempPath().toLower());
break;
case QDesktopServices::HomeLocation:
QCOMPARE( storageLocation, QDir::homePath().toLower());
break;
case QDesktopServices::DataLocation:
// Just check the folder not the drive
QCOMPARE( storageLocation.mid(2), QDir::currentPath().mid(2).toLower());
break;
default:
QCOMPARE( storageLocation, QString() );
break;
}
#else
QDesktopServices::storageLocation(location);
QDesktopServices::displayName(location);
#endif
}
void tst_qdesktopservices::storageLocationDoesNotEndWithSlash_data()
{
storageLocation_data();
}
void tst_qdesktopservices::storageLocationDoesNotEndWithSlash()
{
// Currently all desktop locations return their storage location
// with "Unix-style" paths (i.e. they use a slash, not backslash).
QFETCH(QDesktopServices::StandardLocation, location);
QString loc = QDesktopServices::storageLocation(location);
if (loc.size() > 1) // workaround for unlikely case of locations that return '/'
QCOMPARE(loc.endsWith(QLatin1Char('/')), false);
}
QTEST_MAIN(tst_qdesktopservices)
#include "tst_qdesktopservices.moc"
|
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
/****************************************************************************
**
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the QtGui module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include <qmenubar.h>
#include <qstyle.h>
#include <qlayout.h>
#include <qapplication.h>
#include <qdesktopwidget.h>
#ifndef QT_NO_ACCESSIBILITY
# include <qaccessible.h>
#endif
#include <qpainter.h>
#include <qstylepainter.h>
#include <qevent.h>
#include <qmainwindow.h>
#include <qtoolbar.h>
#include <qtoolbutton.h>
#include <qwhatsthis.h>
#ifndef QT_NO_MENUBAR
#ifdef QT3_SUPPORT
#include <private/qaction_p.h>
#include <qmenudata.h>
#endif
#include "qmenu_p.h"
#include "qmenubar_p.h"
#include "qdebug.h"
#ifdef Q_WS_WINCE
extern bool qt_wince_is_mobile(); //defined in qguifunctions_wce.cpp
#endif
QT_BEGIN_NAMESPACE
class QMenuBarExtension : public QToolButton
{
public:
explicit QMenuBarExtension(QWidget *parent);
QSize sizeHint() const;
void paintEvent(QPaintEvent *);
};
QMenuBarExtension::QMenuBarExtension(QWidget *parent)
: QToolButton(parent)
{
setObjectName(QLatin1String("qt_menubar_ext_button"));
setAutoRaise(true);
#ifndef QT_NO_MENU
setPopupMode(QToolButton::InstantPopup);
#endif
setIcon(style()->standardIcon(QStyle::SP_ToolBarHorizontalExtensionButton, 0, parentWidget()));
}
void QMenuBarExtension::paintEvent(QPaintEvent *)
{
QStylePainter p(this);
QStyleOptionToolButton opt;
initStyleOption(&opt);
// We do not need to draw both extention arrows
opt.features &= ~QStyleOptionToolButton::HasMenu;
p.drawComplexControl(QStyle::CC_ToolButton, opt);
}
QSize QMenuBarExtension::sizeHint() const
{
int ext = style()->pixelMetric(QStyle::PM_ToolBarExtensionExtent, 0, parentWidget());
return QSize(ext, ext);
}
/*!
\internal
*/
QAction *QMenuBarPrivate::actionAt(QPoint p) const
{
for(int i = 0; i < actions.size(); ++i) {
if(actionRect(actions.at(i)).contains(p))
return actions.at(i);
}
return 0;
}
QRect QMenuBarPrivate::menuRect(bool extVisible) const
{
Q_Q(const QMenuBar);
int hmargin = q->style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, 0, q);
QRect result = q->rect();
result.adjust(hmargin, 0, -hmargin, 0);
if (extVisible) {
if (q->isRightToLeft())
result.setLeft(result.left() + extension->sizeHint().width());
else
result.setWidth(result.width() - extension->sizeHint().width());
}
if (leftWidget && leftWidget->isVisible()) {
QSize sz = leftWidget->sizeHint();
if (q->isRightToLeft())
result.setRight(result.right() - sz.width());
else
result.setLeft(result.left() + sz.width());
}
if (rightWidget && rightWidget->isVisible()) {
QSize sz = rightWidget->sizeHint();
if (q->isRightToLeft())
result.setLeft(result.left() + sz.width());
else
result.setRight(result.right() - sz.width());
}
return result;
}
bool QMenuBarPrivate::isVisible(QAction *action)
{
return !hiddenActions.contains(action);
}
void QMenuBarPrivate::updateGeometries()
{
Q_Q(QMenuBar);
if(!itemsDirty)
return;
int q_width = q->width()-(q->style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, 0, q)*2);
int q_start = -1;
if(leftWidget || rightWidget) {
int vmargin = q->style()->pixelMetric(QStyle::PM_MenuBarVMargin, 0, q)
+ q->style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, 0, q);
int hmargin = q->style()->pixelMetric(QStyle::PM_MenuBarHMargin, 0, q)
+ q->style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, 0, q);
if (leftWidget && leftWidget->isVisible()) {
QSize sz = leftWidget->sizeHint();
q_width -= sz.width();
q_start = sz.width();
QPoint pos(hmargin, (q->height() - leftWidget->height()) / 2);
QRect vRect = QStyle::visualRect(q->layoutDirection(), q->rect(), QRect(pos, sz));
leftWidget->setGeometry(vRect);
}
if (rightWidget && rightWidget->isVisible()) {
QSize sz = rightWidget->sizeHint();
q_width -= sz.width();
QPoint pos(q->width() - sz.width() - hmargin, vmargin);
QRect vRect = QStyle::visualRect(q->layoutDirection(), q->rect(), QRect(pos, sz));
rightWidget->setGeometry(vRect);
}
}
#ifdef Q_WS_MAC
if(q->isNativeMenuBar()) {//nothing to see here folks, move along..
itemsDirty = false;
return;
}
#endif
calcActionRects(q_width, q_start);
currentAction = 0;
#ifndef QT_NO_SHORTCUT
if(itemsDirty) {
for(int j = 0; j < shortcutIndexMap.size(); ++j)
q->releaseShortcut(shortcutIndexMap.value(j));
shortcutIndexMap.resize(0); // faster than clear
for(int i = 0; i < actions.count(); i++)
shortcutIndexMap.append(q->grabShortcut(QKeySequence::mnemonic(actions.at(i)->text())));
}
#endif
itemsDirty = false;
hiddenActions.clear();
//this is the menu rectangle without any extension
QRect menuRect = this->menuRect(false);
//we try to see if the actions will fit there
bool hasHiddenActions = false;
for (int i = 0; i < actions.count(); ++i) {
const QRect &rect = actionRects.at(i);
if (rect.isValid() && !menuRect.contains(rect)) {
hasHiddenActions = true;
break;
}
}
//...and if not, determine the ones that fit on the menu with the extension visible
if (hasHiddenActions) {
menuRect = this->menuRect(true);
for (int i = 0; i < actions.count(); ++i) {
const QRect &rect = actionRects.at(i);
if (rect.isValid() && !menuRect.contains(rect)) {
hiddenActions.append(actions.at(i));
}
}
}
if (hiddenActions.count() > 0) {
QMenu *pop = extension->menu();
if (!pop) {
pop = new QMenu(q);
extension->setMenu(pop);
}
pop->clear();
pop->addActions(hiddenActions);
int vmargin = q->style()->pixelMetric(QStyle::PM_MenuBarVMargin, 0, q);
int x = q->isRightToLeft()
? menuRect.left() - extension->sizeHint().width() + 1
: menuRect.right();
extension->setGeometry(x, vmargin, extension->sizeHint().width(), menuRect.height() - vmargin*2);
extension->show();
} else {
extension->hide();
}
q->updateGeometry();
#ifdef QT3_SUPPORT
if (parent) {
QMenubarUpdatedEvent menubarUpdated(q);
QApplication::sendEvent(parent, &menubarUpdated);
}
#endif
}
QRect QMenuBarPrivate::actionRect(QAction *act) const
{
Q_Q(const QMenuBar);
const int index = actions.indexOf(act);
if (index == -1)
return QRect();
//makes sure the geometries are up-to-date
const_cast<QMenuBarPrivate*>(this)->updateGeometries();
if (index >= actionRects.count())
return QRect(); // that can happen in case of native menubar
QRect ret = actionRects.at(index);
return QStyle::visualRect(q->layoutDirection(), q->rect(), ret);
}
void QMenuBarPrivate::focusFirstAction()
{
if(!currentAction) {
updateGeometries();
int index = 0;
while (index < actions.count() && actionRects.at(index).isNull()) ++index;
if (index < actions.count())
setCurrentAction(actions.at(index));
}
}
void QMenuBarPrivate::setKeyboardMode(bool b)
{
Q_Q(QMenuBar);
if (b && !q->style()->styleHint(QStyle::SH_MenuBar_AltKeyNavigation, 0, q)) {
setCurrentAction(0);
return;
}
keyboardState = b;
if(b) {
QWidget *fw = QApplication::focusWidget();
if (fw != q)
keyboardFocusWidget = fw;
focusFirstAction();
q->setFocus(Qt::MenuBarFocusReason);
} else {
if(!popupState)
setCurrentAction(0);
if(keyboardFocusWidget) {
if (QApplication::focusWidget() == q)
keyboardFocusWidget->setFocus(Qt::MenuBarFocusReason);
keyboardFocusWidget = 0;
}
}
q->update();
}
void QMenuBarPrivate::popupAction(QAction *action, bool activateFirst)
{
Q_Q(QMenuBar);
if(!action || !action->menu() || closePopupMode)
return;
popupState = true;
if (action->isEnabled() && action->menu()->isEnabled()) {
closePopupMode = 0;
activeMenu = action->menu();
activeMenu->d_func()->causedPopup.widget = q;
activeMenu->d_func()->causedPopup.action = action;
QRect adjustedActionRect = actionRect(action);
QPoint pos(q->mapToGlobal(QPoint(adjustedActionRect.left(), adjustedActionRect.bottom() + 1)));
QSize popup_size = activeMenu->sizeHint();
QRect screenRect = QApplication::desktop()->screenGeometry(pos);
const bool fitUp = (q->mapToGlobal(adjustedActionRect.topLeft()).y() >= popup_size.height());
const bool fitDown = (pos.y() + popup_size.height() <= screenRect.bottom());
const int actionWidth = adjustedActionRect.width();
if (!fitUp && !fitDown) { //we should shift the menu
bool shouldShiftToRight = !q->isRightToLeft();
if (q->isRightToLeft() && popup_size.width() > pos.x())
shouldShiftToRight = true;
else if (actionWidth + popup_size.width() + pos.x() > screenRect.right())
shouldShiftToRight = false;
if (shouldShiftToRight)
pos.rx() += actionWidth;
else
pos.rx() -= popup_size.width();
} else if (q->isRightToLeft()) {
pos.setX(pos.x()-(popup_size.width() - actionWidth));
}
if(pos.x() < screenRect.x()) {
pos.setX(screenRect.x());
} else {
const int off = pos.x()+popup_size.width() - screenRect.right();
if(off > 0)
pos.setX(qMax(screenRect.x(), pos.x()-off));
}
if(!defaultPopDown || (fitUp && !fitDown))
pos.setY(qMax(screenRect.y(), q->mapToGlobal(QPoint(0, adjustedActionRect.top()-popup_size.height())).y()));
activeMenu->popup(pos);
if(activateFirst)
activeMenu->d_func()->setFirstActionActive();
}
q->update(actionRect(action));
}
void QMenuBarPrivate::setCurrentAction(QAction *action, bool popup, bool activateFirst)
{
if(currentAction == action && popup == popupState)
return;
autoReleaseTimer.stop();
doChildEffects = (popup && !activeMenu);
Q_Q(QMenuBar);
QWidget *fw = 0;
if(QMenu *menu = activeMenu) {
activeMenu = 0;
if (popup) {
fw = q->window()->focusWidget();
q->setFocus(Qt::NoFocusReason);
}
menu->hide();
}
if(currentAction)
q->update(actionRect(currentAction));
popupState = popup;
#ifndef QT_NO_STATUSTIP
QAction *previousAction = currentAction;
#endif
currentAction = action;
if (action) {
activateAction(action, QAction::Hover);
if(popup)
popupAction(action, activateFirst);
q->update(actionRect(action));
#ifndef QT_NO_STATUSTIP
} else if (previousAction) {
QString empty;
QStatusTipEvent tip(empty);
QApplication::sendEvent(q, &tip);
#endif
}
if (fw)
fw->setFocus(Qt::NoFocusReason);
}
void QMenuBarPrivate::calcActionRects(int max_width, int start) const
{
Q_Q(const QMenuBar);
if(!itemsDirty)
return;
//let's reinitialize the buffer
actionRects.resize(actions.count());
actionRects.fill(QRect());
const QStyle *style = q->style();
const int itemSpacing = style->pixelMetric(QStyle::PM_MenuBarItemSpacing, 0, q);
int max_item_height = 0, separator = -1, separator_start = 0, separator_len = 0;
//calculate size
const QFontMetrics fm = q->fontMetrics();
const int hmargin = style->pixelMetric(QStyle::PM_MenuBarHMargin, 0, q),
vmargin = style->pixelMetric(QStyle::PM_MenuBarVMargin, 0, q),
icone = style->pixelMetric(QStyle::PM_SmallIconSize, 0, q);
for(int i = 0; i < actions.count(); i++) {
QAction *action = actions.at(i);
if(!action->isVisible())
continue;
QSize sz;
//calc what I think the size is..
if(action->isSeparator()) {
if (style->styleHint(QStyle::SH_DrawMenuBarSeparator, 0, q))
separator = i;
continue; //we don't really position these!
} else {
const QString s = action->text();
QIcon is = action->icon();
// If an icon is set, only the icon is visible
if (!is.isNull())
sz = sz.expandedTo(QSize(icone, icone));
else if (!s.isEmpty())
sz = fm.size(Qt::TextShowMnemonic, s);
}
//let the style modify the above size..
QStyleOptionMenuItem opt;
q->initStyleOption(&opt, action);
sz = q->style()->sizeFromContents(QStyle::CT_MenuBarItem, &opt, sz, q);
if(!sz.isEmpty()) {
{ //update the separator state
int iWidth = sz.width() + itemSpacing;
if(separator == -1)
separator_start += iWidth;
else
separator_len += iWidth;
}
//maximum height
max_item_height = qMax(max_item_height, sz.height());
//append
actionRects[i] = QRect(0, 0, sz.width(), sz.height());
}
}
//calculate position
const int fw = q->style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, 0, q);
int x = fw + ((start == -1) ? hmargin : start) + itemSpacing;
int y = fw + vmargin;
for(int i = 0; i < actions.count(); i++) {
QRect &rect = actionRects[i];
if (rect.isNull())
continue;
//resize
rect.setHeight(max_item_height);
//move
if(separator != -1 && i >= separator) { //after the separator
int left = (max_width - separator_len - hmargin - itemSpacing) + (x - separator_start - hmargin);
if(left < separator_start) { //wrap
separator_start = x = hmargin;
y += max_item_height;
}
rect.moveLeft(left);
} else {
rect.moveLeft(x);
}
rect.moveTop(y);
//keep moving along..
x += rect.width() + itemSpacing;
}
}
void QMenuBarPrivate::activateAction(QAction *action, QAction::ActionEvent action_e)
{
Q_Q(QMenuBar);
if (!action || !action->isEnabled())
return;
action->activate(action_e);
if (action_e == QAction::Hover)
action->showStatusText(q);
// if(action_e == QAction::Trigger)
// emit q->activated(action);
// else if(action_e == QAction::Hover)
// emit q->highlighted(action);
}
void QMenuBarPrivate::_q_actionTriggered()
{
Q_Q(QMenuBar);
if (QAction *action = qobject_cast<QAction *>(q->sender())) {
emit q->triggered(action);
#ifdef QT3_SUPPORT
emit q->activated(q->findIdForAction(action));
#endif
}
}
void QMenuBarPrivate::_q_actionHovered()
{
Q_Q(QMenuBar);
if (QAction *action = qobject_cast<QAction *>(q->sender())) {
emit q->hovered(action);
#ifndef QT_NO_ACCESSIBILITY
if (QAccessible::isActive()) {
int actionIndex = actions.indexOf(action);
++actionIndex;
QAccessible::updateAccessibility(q, actionIndex, QAccessible::Focus);
QAccessible::updateAccessibility(q, actionIndex, QAccessible::Selection);
}
#endif //QT_NO_ACCESSIBILITY
#ifdef QT3_SUPPORT
emit q->highlighted(q->findIdForAction(action));
#endif
}
}
/*!
Initialize \a option with the values from the menu bar and information from \a action. This method
is useful for subclasses when they need a QStyleOptionMenuItem, but don't want
to fill in all the information themselves.
\sa QStyleOption::initFrom() QMenu::initStyleOption()
*/
void QMenuBar::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const
{
if (!option || !action)
return;
Q_D(const QMenuBar);
option->palette = palette();
option->state = QStyle::State_None;
if (isEnabled() && action->isEnabled())
option->state |= QStyle::State_Enabled;
else
option->palette.setCurrentColorGroup(QPalette::Disabled);
option->fontMetrics = fontMetrics();
if (d->currentAction && d->currentAction == action) {
option->state |= QStyle::State_Selected;
if (d->popupState && !d->closePopupMode)
option->state |= QStyle::State_Sunken;
}
if (hasFocus() || d->currentAction)
option->state |= QStyle::State_HasFocus;
option->menuRect = rect();
option->menuItemType = QStyleOptionMenuItem::Normal;
option->checkType = QStyleOptionMenuItem::NotCheckable;
option->text = action->text();
option->icon = action->icon();
}
/*!
\class QMenuBar
\brief The QMenuBar class provides a horizontal menu bar.
\ingroup mainwindow-classes
A menu bar consists of a list of pull-down menu items. You add
menu items with addMenu(). For example, asuming that \c menubar
is a pointer to a QMenuBar and \c fileMenu is a pointer to a
QMenu, the following statement inserts the menu into the menu bar:
\snippet doc/src/snippets/code/src_gui_widgets_qmenubar.cpp 0
The ampersand in the menu item's text sets Alt+F as a shortcut for
this menu. (You can use "\&\&" to get a real ampersand in the menu
bar.)
There is no need to lay out a menu bar. It automatically sets its
own geometry to the top of the parent widget and changes it
appropriately whenever the parent is resized.
\section1 Usage
In most main window style applications you would use the
\l{QMainWindow::}{menuBar()} function provided in QMainWindow,
adding \l{QMenu}s to the menu bar and adding \l{QAction}s to the
pop-up menus.
Example (from the \l{mainwindows/menus}{Menus} example):
\snippet examples/mainwindows/menus/mainwindow.cpp 9
Menu items may be removed with removeAction().
Widgets can be added to menus by using instances of the QWidgetAction
class to hold them. These actions can then be inserted into menus
in the usual way; see the QMenu documentation for more details.
\section1 Platform Dependent Look and Feel
Different platforms have different requirements for the appearance
of menu bars and their behavior when the user interacts with them.
For example, Windows systems are often configured so that the
underlined character mnemonics that indicate keyboard shortcuts
for items in the menu bar are only shown when the \gui{Alt} key is
pressed.
\table
\row \o \inlineimage plastique-menubar.png A menu bar shown in the
Plastique widget style.
\o The \l{QPlastiqueStyle}{Plastique widget style}, like most
other styles, handles the \gui{Help} menu in the same way as it
handles any other menu.
\row \o \inlineimage motif-menubar.png A menu bar shown in the
Motif widget style.
\o The \l{QMotifStyle}{Motif widget style} treats \gui{Help} menus
in a special way, placing them at right-hand end of the menu bar.
\endtable
\section1 QMenuBar on Mac OS X
QMenuBar on Mac OS X is a wrapper for using the system-wide menu bar.
If you have multiple menu bars in one dialog the outermost menu bar
(normally inside a widget with widget flag Qt::Window) will
be used for the system-wide menu bar.
Qt for Mac OS X also provides a menu bar merging feature to make
QMenuBar conform more closely to accepted Mac OS X menu bar layout.
The merging functionality is based on string matching the title of
a QMenu entry. These strings are translated (using QObject::tr())
in the "QMenuBar" context. If an entry is moved its slots will still
fire as if it was in the original place. The table below outlines
the strings looked for and where the entry is placed if matched:
\table
\header \i String matches \i Placement \i Notes
\row \i about.*
\i Application Menu | About <application name>
\i The application name is fetched from the \c {Info.plist} file
(see note below). If this entry is not found no About item
will appear in the Application Menu.
\row \i config, options, setup, settings or preferences
\i Application Menu | Preferences
\i If this entry is not found the Settings item will be disabled
\row \i quit or exit
\i Application Menu | Quit <application name>
\i If this entry is not found a default Quit item will be
created to call QApplication::quit()
\endtable
You can override this behavior by using the QAction::menuRole()
property.
If you want all windows in a Mac application to share one menu
bar, you must create a menu bar that does not have a parent.
Create a parent-less menu bar this way:
\snippet doc/src/snippets/code/src_gui_widgets_qmenubar.cpp 1
\bold{Note:} Do \e{not} call QMainWindow::menuBar() to create the
shared menu bar, because that menu bar will have the QMainWindow
as its parent. That menu bar would only be displayed for the
parent QMainWindow.
\bold{Note:} The text used for the application name in the menu
bar is obtained from the value set in the \c{Info.plist} file in
the application's bundle. See \l{Deploying an Application on
Mac OS X} for more information.
\section1 QMenuBar on Windows CE
QMenuBar on Windows CE is a wrapper for using the system-wide menu bar,
similar to the Mac. This feature is activated for Windows Mobile
and integrates QMenuBar with the native soft keys. The left soft
key can be controlled with QMenuBar::setDefaultAction() and the
right soft key can be used to access the menu bar.
The hovered() signal is not supported for the native menu
integration. Also, it is not possible to display an icon in a
native menu on Windows Mobile.
\section1 Examples
The \l{mainwindows/menus}{Menus} example shows how to use QMenuBar
and QMenu. The other \l{Main Window Examples}{main window
application examples} also provide menus using these classes.
\sa QMenu, QShortcut, QAction,
{http://developer.apple.com/documentation/UserExperience/Conceptual/AppleHIGuidelines/XHIGIntro/XHIGIntro.html}{Introduction to Apple Human Interface Guidelines},
{fowler}{GUI Design Handbook: Menu Bar}, {Menus Example}
*/
void QMenuBarPrivate::init()
{
Q_Q(QMenuBar);
q->setSizePolicy(QSizePolicy::MinimumExpanding, QSizePolicy::Minimum);
q->setAttribute(Qt::WA_CustomWhatsThis);
#ifdef Q_WS_MAC
macCreateMenuBar(q->parentWidget());
if(mac_menubar)
q->hide();
#endif
#ifdef Q_WS_WINCE
if (qt_wince_is_mobile()) {
wceCreateMenuBar(q->parentWidget());
if(wce_menubar)
q->hide();
}
#endif
#ifdef Q_WS_S60
symbianCreateMenuBar(q->parentWidget());
if(symbian_menubar)
q->hide();
#endif
q->setBackgroundRole(QPalette::Button);
oldWindow = oldParent = 0;
#ifdef QT3_SUPPORT
doAutoResize = false;
#endif
handleReparent();
q->setMouseTracking(q->style()->styleHint(QStyle::SH_MenuBar_MouseTracking, 0, q));
extension = new QMenuBarExtension(q);
extension->setFocusPolicy(Qt::NoFocus);
extension->hide();
}
//Gets the next action for keyboard navigation
QAction *QMenuBarPrivate::getNextAction(const int _start, const int increment) const
{
Q_Q(const QMenuBar);
const_cast<QMenuBarPrivate*>(this)->updateGeometries();
bool allowActiveAndDisabled = q->style()->styleHint(QStyle::SH_Menu_AllowActiveAndDisabled, 0, q);
const int start = (_start == -1 && increment == -1) ? actions.count() : _start;
const int end = increment == -1 ? 0 : actions.count() - 1;
for (int i = start; start != end;) {
i += increment;
QAction *current = actions.at(i);
if (!actionRects.at(i).isNull() && (allowActiveAndDisabled || current->isEnabled()))
return current;
}
if (_start != -1) //let's try from the beginning or the end
return getNextAction(-1, increment);
return 0;
}
/*!
Constructs a menu bar with parent \a parent.
*/
QMenuBar::QMenuBar(QWidget *parent) : QWidget(*new QMenuBarPrivate, parent, 0)
{
Q_D(QMenuBar);
d->init();
}
#ifdef QT3_SUPPORT
/*!
Use one of the constructors that doesn't take the \a name
argument and then use setObjectName() instead.
*/
QMenuBar::QMenuBar(QWidget *parent, const char *name) : QWidget(*new QMenuBarPrivate, parent, 0)
{
Q_D(QMenuBar);
d->init();
setObjectName(QString::fromAscii(name));
}
#endif
/*!
Destroys the menu bar.
*/
QMenuBar::~QMenuBar()
{
#ifdef Q_WS_MAC
Q_D(QMenuBar);
d->macDestroyMenuBar();
#endif
#ifdef Q_WS_WINCE
Q_D(QMenuBar);
if (qt_wince_is_mobile())
d->wceDestroyMenuBar();
#endif
#ifdef Q_WS_S60
Q_D(QMenuBar);
d->symbianDestroyMenuBar();
#endif
}
/*!
\overload
This convenience function creates a new action with \a text.
The function adds the newly created action to the menu's
list of actions, and returns it.
\sa QWidget::addAction(), QWidget::actions()
*/
QAction *QMenuBar::addAction(const QString &text)
{
QAction *ret = new QAction(text, this);
addAction(ret);
return ret;
}
/*!
\overload
This convenience function creates a new action with the given \a
text. The action's triggered() signal is connected to the \a
receiver's \a member slot. The function adds the newly created
action to the menu's list of actions and returns it.
\sa QWidget::addAction(), QWidget::actions()
*/
QAction *QMenuBar::addAction(const QString &text, const QObject *receiver, const char* member)
{
QAction *ret = new QAction(text, this);
QObject::connect(ret, SIGNAL(triggered(bool)), receiver, member);
addAction(ret);
return ret;
}
/*!
Appends a new QMenu with \a title to the menu bar. The menu bar
takes ownership of the menu. Returns the new menu.
\sa QWidget::addAction() QMenu::menuAction()
*/
QMenu *QMenuBar::addMenu(const QString &title)
{
QMenu *menu = new QMenu(title, this);
addAction(menu->menuAction());
return menu;
}
/*!
Appends a new QMenu with \a icon and \a title to the menu bar. The menu bar
takes ownership of the menu. Returns the new menu.
\sa QWidget::addAction() QMenu::menuAction()
*/
QMenu *QMenuBar::addMenu(const QIcon &icon, const QString &title)
{
QMenu *menu = new QMenu(title, this);
menu->setIcon(icon);
addAction(menu->menuAction());
return menu;
}
/*!
Appends \a menu to the menu bar. Returns the menu's menuAction().
\note The returned QAction object can be used to hide the corresponding
menu.
\sa QWidget::addAction() QMenu::menuAction()
*/
QAction *QMenuBar::addMenu(QMenu *menu)
{
QAction *action = menu->menuAction();
addAction(action);
return action;
}
/*!
Appends a separator to the menu.
*/
QAction *QMenuBar::addSeparator()
{
QAction *ret = new QAction(this);
ret->setSeparator(true);
addAction(ret);
return ret;
}
/*!
This convenience function creates a new separator action, i.e. an
action with QAction::isSeparator() returning true. The function inserts
the newly created action into this menu bar's list of actions before
action \a before and returns it.
\sa QWidget::insertAction(), addSeparator()
*/
QAction *QMenuBar::insertSeparator(QAction *before)
{
QAction *action = new QAction(this);
action->setSeparator(true);
insertAction(before, action);
return action;
}
/*!
This convenience function inserts \a menu before action \a before
and returns the menus menuAction().
\sa QWidget::insertAction() addMenu()
*/
QAction *QMenuBar::insertMenu(QAction *before, QMenu *menu)
{
QAction *action = menu->menuAction();
insertAction(before, action);
return action;
}
/*!
Returns the QAction that is currently highlighted. A null pointer
will be returned if no action is currently selected.
*/
QAction *QMenuBar::activeAction() const
{
Q_D(const QMenuBar);
return d->currentAction;
}
/*!
\since 4.1
Sets the currently highlighted action to \a act.
*/
void QMenuBar::setActiveAction(QAction *act)
{
Q_D(QMenuBar);
d->setCurrentAction(act, true, false);
}
/*!
Removes all the actions from the menu bar.
\note On Mac OS X, menu items that have been merged to the system
menu bar are not removed by this function. One way to handle this
would be to remove the extra actions yourself. You can set the
\l{QAction::MenuRole}{menu role} on the different menus, so that
you know ahead of time which menu items get merged and which do
not. Then decide what to recreate or remove yourself.
\sa removeAction()
*/
void QMenuBar::clear()
{
QList<QAction*> acts = actions();
for(int i = 0; i < acts.size(); i++)
removeAction(acts[i]);
}
/*!
\property QMenuBar::defaultUp
\brief the popup orientation
The default popup orientation. By default, menus pop "down" the
screen. By setting the property to true, the menu will pop "up".
You might call this for menus that are \e below the document to
which they refer.
If the menu would not fit on the screen, the other direction is
used automatically.
*/
void QMenuBar::setDefaultUp(bool b)
{
Q_D(QMenuBar);
d->defaultPopDown = !b;
}
bool QMenuBar::isDefaultUp() const
{
Q_D(const QMenuBar);
return !d->defaultPopDown;
}
/*!
\reimp
*/
void QMenuBar::resizeEvent(QResizeEvent *)
{
Q_D(QMenuBar);
d->itemsDirty = true;
d->updateGeometries();
}
/*!
\reimp
*/
void QMenuBar::paintEvent(QPaintEvent *e)
{
Q_D(QMenuBar);
QPainter p(this);
QRegion emptyArea(rect());
//draw the items
for (int i = 0; i < d->actions.count(); ++i) {
QAction *action = d->actions.at(i);
QRect adjustedActionRect = d->actionRect(action);
if (adjustedActionRect.isEmpty() || !d->isVisible(action))
continue;
if(!e->rect().intersects(adjustedActionRect))
continue;
emptyArea -= adjustedActionRect;
QStyleOptionMenuItem opt;
initStyleOption(&opt, action);
opt.rect = adjustedActionRect;
p.setClipRect(adjustedActionRect);
style()->drawControl(QStyle::CE_MenuBarItem, &opt, &p, this);
}
//draw border
if(int fw = style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, 0, this)) {
QRegion borderReg;
borderReg += QRect(0, 0, fw, height()); //left
borderReg += QRect(width()-fw, 0, fw, height()); //right
borderReg += QRect(0, 0, width(), fw); //top
borderReg += QRect(0, height()-fw, width(), fw); //bottom
p.setClipRegion(borderReg);
emptyArea -= borderReg;
QStyleOptionFrame frame;
frame.rect = rect();
frame.palette = palette();
frame.state = QStyle::State_None;
frame.lineWidth = style()->pixelMetric(QStyle::PM_MenuBarPanelWidth);
frame.midLineWidth = 0;
style()->drawPrimitive(QStyle::PE_PanelMenuBar, &frame, &p, this);
}
p.setClipRegion(emptyArea);
QStyleOptionMenuItem menuOpt;
menuOpt.palette = palette();
menuOpt.state = QStyle::State_None;
menuOpt.menuItemType = QStyleOptionMenuItem::EmptyArea;
menuOpt.checkType = QStyleOptionMenuItem::NotCheckable;
menuOpt.rect = rect();
menuOpt.menuRect = rect();
style()->drawControl(QStyle::CE_MenuBarEmptyArea, &menuOpt, &p, this);
}
/*!
\reimp
*/
void QMenuBar::setVisible(bool visible)
{
#if defined(Q_WS_MAC) || defined(Q_OS_WINCE) || defined(Q_WS_S60)
if (isNativeMenuBar())
return;
#endif
QWidget::setVisible(visible);
}
/*!
\reimp
*/
void QMenuBar::mousePressEvent(QMouseEvent *e)
{
Q_D(QMenuBar);
if(e->button() != Qt::LeftButton)
return;
d->mouseDown = true;
QAction *action = d->actionAt(e->pos());
if (!action || !d->isVisible(action)) {
d->setCurrentAction(0);
#ifndef QT_NO_WHATSTHIS
if (QWhatsThis::inWhatsThisMode())
QWhatsThis::showText(e->globalPos(), d->whatsThis, this);
#endif
return;
}
if(d->currentAction == action && d->popupState) {
if(QMenu *menu = d->activeMenu) {
d->activeMenu = 0;
menu->hide();
}
#ifdef Q_WS_WIN
if((d->closePopupMode = style()->styleHint(QStyle::SH_MenuBar_DismissOnSecondClick)))
update(d->actionRect(action));
#endif
} else {
d->setCurrentAction(action, true);
}
}
/*!
\reimp
*/
void QMenuBar::mouseReleaseEvent(QMouseEvent *e)
{
Q_D(QMenuBar);
if(e->button() != Qt::LeftButton || !d->mouseDown)
return;
d->mouseDown = false;
QAction *action = d->actionAt(e->pos());
if((d->closePopupMode && action == d->currentAction) || !action || !action->menu()) {
//we set the current action before activating
//so that we let the leave event set the current back to 0
d->setCurrentAction(action, false);
if(action)
d->activateAction(action, QAction::Trigger);
}
d->closePopupMode = 0;
}
/*!
\reimp
*/
void QMenuBar::keyPressEvent(QKeyEvent *e)
{
Q_D(QMenuBar);
d->updateGeometries();
int key = e->key();
if(isRightToLeft()) { // in reverse mode open/close key for submenues are reversed
if(key == Qt::Key_Left)
key = Qt::Key_Right;
else if(key == Qt::Key_Right)
key = Qt::Key_Left;
}
if(key == Qt::Key_Tab) //means right
key = Qt::Key_Right;
else if(key == Qt::Key_Backtab) //means left
key = Qt::Key_Left;
bool key_consumed = false;
switch(key) {
case Qt::Key_Up:
case Qt::Key_Down:
case Qt::Key_Enter:
case Qt::Key_Space:
case Qt::Key_Return: {
if(!style()->styleHint(QStyle::SH_MenuBar_AltKeyNavigation, 0, this) || !d->currentAction)
break;
if(d->currentAction->menu()) {
d->popupAction(d->currentAction, true);
} else if(key == Qt::Key_Enter || key == Qt::Key_Return || key == Qt::Key_Space) {
d->activateAction(d->currentAction, QAction::Trigger);
d->setCurrentAction(d->currentAction, false);
d->setKeyboardMode(false);
}
key_consumed = true;
break; }
case Qt::Key_Right:
case Qt::Key_Left: {
if(d->currentAction) {
int index = d->actions.indexOf(d->currentAction);
if (QAction *nextAction = d->getNextAction(index, key == Qt::Key_Left ? -1 : +1)) {
d->setCurrentAction(nextAction, d->popupState, true);
key_consumed = true;
}
}
break; }
case Qt::Key_Escape:
d->setCurrentAction(0);
d->setKeyboardMode(false);
key_consumed = true;
break;
default:
key_consumed = false;
}
if(!key_consumed &&
(!e->modifiers() ||
(e->modifiers()&(Qt::MetaModifier|Qt::AltModifier))) && e->text().length()==1 && !d->popupState) {
int clashCount = 0;
QAction *first = 0, *currentSelected = 0, *firstAfterCurrent = 0;
{
QChar c = e->text()[0].toUpper();
for(int i = 0; i < d->actions.size(); ++i) {
if (d->actionRects.at(i).isNull())
continue;
QAction *act = d->actions.at(i);
QString s = act->text();
if(!s.isEmpty()) {
int ampersand = s.indexOf(QLatin1Char('&'));
if(ampersand >= 0) {
if(s[ampersand+1].toUpper() == c) {
clashCount++;
if(!first)
first = act;
if(act == d->currentAction)
currentSelected = act;
else if (!firstAfterCurrent && currentSelected)
firstAfterCurrent = act;
}
}
}
}
}
QAction *next_action = 0;
if(clashCount >= 1) {
if(clashCount == 1 || !d->currentAction || (currentSelected && !firstAfterCurrent))
next_action = first;
else
next_action = firstAfterCurrent;
}
if(next_action) {
key_consumed = true;
d->setCurrentAction(next_action, true, true);
}
}
if(key_consumed)
e->accept();
else
e->ignore();
}
/*!
\reimp
*/
void QMenuBar::mouseMoveEvent(QMouseEvent *e)
{
Q_D(QMenuBar);
if (!(e->buttons() & Qt::LeftButton))
d->mouseDown = false;
bool popupState = d->popupState || d->mouseDown;
QAction *action = d->actionAt(e->pos());
if ((action && d->isVisible(action)) || !popupState)
d->setCurrentAction(action, popupState);
}
/*!
\reimp
*/
void QMenuBar::leaveEvent(QEvent *)
{
Q_D(QMenuBar);
if((!hasFocus() && !d->popupState) ||
(d->currentAction && d->currentAction->menu() == 0))
d->setCurrentAction(0);
}
/*!
\reimp
*/
void QMenuBar::actionEvent(QActionEvent *e)
{
Q_D(QMenuBar);
d->itemsDirty = true;
#if defined (Q_WS_MAC) || defined(Q_OS_WINCE) || defined(Q_WS_S60)
if (isNativeMenuBar()) {
#ifdef Q_WS_MAC
QMenuBarPrivate::QMacMenuBarPrivate *nativeMenuBar = d->mac_menubar;
#elif defined(Q_WS_S60)
QMenuBarPrivate::QSymbianMenuBarPrivate *nativeMenuBar = d->symbian_menubar;
#else
QMenuBarPrivate::QWceMenuBarPrivate *nativeMenuBar = d->wce_menubar;
#endif
if (!nativeMenuBar)
return;
if(e->type() == QEvent::ActionAdded)
nativeMenuBar->addAction(e->action(), nativeMenuBar->findAction(e->before()));
else if(e->type() == QEvent::ActionRemoved)
nativeMenuBar->removeAction(e->action());
else if(e->type() == QEvent::ActionChanged)
nativeMenuBar->syncAction(e->action());
}
#endif
if(e->type() == QEvent::ActionAdded) {
connect(e->action(), SIGNAL(triggered()), this, SLOT(_q_actionTriggered()));
connect(e->action(), SIGNAL(hovered()), this, SLOT(_q_actionHovered()));
} else if(e->type() == QEvent::ActionRemoved) {
e->action()->disconnect(this);
}
if (isVisible()) {
d->updateGeometries();
update();
}
}
/*!
\reimp
*/
void QMenuBar::focusInEvent(QFocusEvent *)
{
Q_D(QMenuBar);
if(d->keyboardState)
d->focusFirstAction();
}
/*!
\reimp
*/
void QMenuBar::focusOutEvent(QFocusEvent *)
{
Q_D(QMenuBar);
if(!d->popupState) {
d->setCurrentAction(0);
d->setKeyboardMode(false);
}
}
/*!
\reimp
*/
void QMenuBar::timerEvent (QTimerEvent *e)
{
Q_D(QMenuBar);
if (e->timerId() == d->autoReleaseTimer.timerId()) {
d->autoReleaseTimer.stop();
d->setCurrentAction(0);
}
QWidget::timerEvent(e);
}
void QMenuBarPrivate::handleReparent()
{
Q_Q(QMenuBar);
QWidget *newParent = q->parentWidget();
//Note: if parent is reparented, then window may change even if parent doesn't
// we need to install an event filter on parent, and remove the old one
if (oldParent != newParent) {
if (oldParent)
oldParent->removeEventFilter(q);
if (newParent)
newParent->installEventFilter(q);
}
//we also need event filter on top-level (for shortcuts)
QWidget *newWindow = newParent ? newParent->window() : 0;
if (oldWindow != newWindow) {
if (oldParent && oldParent != oldWindow)
oldWindow->removeEventFilter(q);
if (newParent && newParent != newWindow)
newWindow->installEventFilter(q);
}
oldParent = newParent;
oldWindow = newWindow;
#ifdef Q_WS_MAC
if (q->isNativeMenuBar() && !macWidgetHasNativeMenubar(newParent)) {
// If the new parent got a native menubar from before, keep that
// menubar rather than replace it with this one (because a parents
// menubar has precedence over children menubars).
macDestroyMenuBar();
macCreateMenuBar(newParent);
}
#endif
#ifdef Q_WS_WINCE
if (qt_wince_is_mobile() && wce_menubar)
wce_menubar->rebuild();
#endif
#ifdef Q_WS_S60
if (symbian_menubar)
symbian_menubar->rebuild();
#endif
}
#ifdef QT3_SUPPORT
/*!
Sets whether the menu bar should automatically resize itself
when its parent widget is resized.
This feature is provided to help porting to Qt 4. We recommend
against using it in new code.
\sa autoGeometry()
*/
void QMenuBar::setAutoGeometry(bool b)
{
Q_D(QMenuBar);
d->doAutoResize = b;
}
/*!
Returns true if the menu bar automatically resizes itself
when its parent widget is resized; otherwise returns false.
This feature is provided to help porting to Qt 4. We recommend
against using it in new code.
\sa setAutoGeometry()
*/
bool QMenuBar::autoGeometry() const
{
Q_D(const QMenuBar);
return d->doAutoResize;
}
#endif
/*!
\reimp
*/
void QMenuBar::changeEvent(QEvent *e)
{
Q_D(QMenuBar);
if(e->type() == QEvent::StyleChange) {
d->itemsDirty = true;
setMouseTracking(style()->styleHint(QStyle::SH_MenuBar_MouseTracking, 0, this));
if(parentWidget())
resize(parentWidget()->width(), heightForWidth(parentWidget()->width()));
d->updateGeometries();
} else if (e->type() == QEvent::ParentChange) {
d->handleReparent();
} else if (e->type() == QEvent::FontChange
|| e->type() == QEvent::ApplicationFontChange) {
d->itemsDirty = true;
d->updateGeometries();
}
QWidget::changeEvent(e);
}
/*!
\reimp
*/
bool QMenuBar::event(QEvent *e)
{
Q_D(QMenuBar);
switch (e->type()) {
case QEvent::KeyPress: {
QKeyEvent *ke = (QKeyEvent*)e;
#if 0
if(!d->keyboardState) { //all keypresses..
d->setCurrentAction(0);
return ;
}
#endif
if(ke->key() == Qt::Key_Tab || ke->key() == Qt::Key_Backtab) {
keyPressEvent(ke);
return true;
}
} break;
#ifndef QT_NO_SHORTCUT
case QEvent::Shortcut: {
QShortcutEvent *se = static_cast<QShortcutEvent *>(e);
int shortcutId = se->shortcutId();
for(int j = 0; j < d->shortcutIndexMap.size(); ++j) {
if (shortcutId == d->shortcutIndexMap.value(j))
d->_q_internalShortcutActivated(j);
}
} break;
#endif
case QEvent::Show:
#ifdef QT3_SUPPORT
if(QWidget *p = parentWidget()) {
// If itemsDirty == true, updateGeometries sends the MenubarUpdated event.
if (!d->itemsDirty) {
QMenubarUpdatedEvent menubarUpdated(this);
QApplication::sendEvent(p, &menubarUpdated);
}
}
#endif
d->_q_updateLayout();
break;
case QEvent::ShortcutOverride: {
QKeyEvent *kev = static_cast<QKeyEvent*>(e);
if (kev->key() == Qt::Key_Escape) {
e->accept();
return true;
}
}
break;
#ifdef QT3_SUPPORT
case QEvent::Hide: {
if(QWidget *p = parentWidget()) {
QMenubarUpdatedEvent menubarUpdated(this);
QApplication::sendEvent(p, &menubarUpdated);
}
} break;
#endif
#ifndef QT_NO_WHATSTHIS
case QEvent::QueryWhatsThis:
e->setAccepted(d->whatsThis.size());
if (QAction *action = d->actionAt(static_cast<QHelpEvent*>(e)->pos())) {
if (action->whatsThis().size() || action->menu())
e->accept();
}
return true;
#endif
case QEvent::LayoutDirectionChange:
d->_q_updateLayout();
break;
default:
break;
}
return QWidget::event(e);
}
/*!
\reimp
*/
bool QMenuBar::eventFilter(QObject *object, QEvent *event)
{
Q_D(QMenuBar);
if (object == parent() && object) {
#ifdef QT3_SUPPORT
if (d->doAutoResize && event->type() == QEvent::Resize) {
QResizeEvent *e = (QResizeEvent *)event;
int w = e->size().width();
setGeometry(0, y(), w, heightForWidth(w));
return false;
}
#endif
if (event->type() == QEvent::ParentChange) //GrandparentChange
d->handleReparent();
}
if (object == d->leftWidget || object == d->rightWidget) {
switch (event->type()) {
case QEvent::ShowToParent:
case QEvent::HideToParent:
d->_q_updateLayout();
break;
default:
break;
}
}
if (style()->styleHint(QStyle::SH_MenuBar_AltKeyNavigation, 0, this)) {
if (d->altPressed) {
switch (event->type()) {
case QEvent::KeyPress:
case QEvent::KeyRelease:
{
QKeyEvent *kev = static_cast<QKeyEvent*>(event);
if (kev->key() == Qt::Key_Alt || kev->key() == Qt::Key_Meta) {
if (event->type() == QEvent::KeyPress) // Alt-press does not interest us, we have the shortcut-override event
break;
d->setKeyboardMode(!d->keyboardState);
}
}
// fall through
case QEvent::MouseButtonPress:
case QEvent::MouseButtonRelease:
case QEvent::MouseMove:
case QEvent::FocusIn:
case QEvent::FocusOut:
case QEvent::ActivationChange:
d->altPressed = false;
qApp->removeEventFilter(this);
break;
default:
break;
}
} else if (isVisible()) {
if (event->type() == QEvent::ShortcutOverride) {
QKeyEvent *kev = static_cast<QKeyEvent*>(event);
if ((kev->key() == Qt::Key_Alt || kev->key() == Qt::Key_Meta)
&& kev->modifiers() == Qt::AltModifier) {
d->altPressed = true;
qApp->installEventFilter(this);
}
}
}
}
return false;
}
/*!
\internal
Return the item at \a pt, or 0 if there is no item there or if it is
a separator item.
*/
QAction *QMenuBar::actionAt(const QPoint &pt) const
{
Q_D(const QMenuBar);
return d->actionAt(pt);
}
/*!
\internal
Returns the geometry of action \a act.
*/
QRect QMenuBar::actionGeometry(QAction *act) const
{
Q_D(const QMenuBar);
return d->actionRect(act);
}
/*!
\reimp
*/
QSize QMenuBar::minimumSizeHint() const
{
Q_D(const QMenuBar);
#if defined(Q_WS_MAC) || defined(Q_WS_WINCE) || defined(Q_WS_S60)
const bool as_gui_menubar = !isNativeMenuBar();
#else
const bool as_gui_menubar = true;
#endif
ensurePolished();
QSize ret(0, 0);
const_cast<QMenuBarPrivate*>(d)->updateGeometries();
const int hmargin = style()->pixelMetric(QStyle::PM_MenuBarHMargin, 0, this);
const int vmargin = style()->pixelMetric(QStyle::PM_MenuBarVMargin, 0, this);
int fw = style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, 0, this);
int spaceBelowMenuBar = style()->styleHint(QStyle::SH_MainWindow_SpaceBelowMenuBar, 0, this);
if(as_gui_menubar) {
int w = parentWidget() ? parentWidget()->width() : QApplication::desktop()->width();
d->calcActionRects(w - (2 * fw), 0);
for (int i = 0; ret.isNull() && i < d->actions.count(); ++i)
ret = d->actionRects.at(i).size();
if (!d->extension->isHidden())
ret += QSize(d->extension->sizeHint().width(), 0);
ret += QSize(2*fw + hmargin, 2*fw + vmargin);
}
int margin = 2*vmargin + 2*fw + spaceBelowMenuBar;
if(d->leftWidget) {
QSize sz = d->leftWidget->minimumSizeHint();
ret.setWidth(ret.width() + sz.width());
if(sz.height() + margin > ret.height())
ret.setHeight(sz.height() + margin);
}
if(d->rightWidget) {
QSize sz = d->rightWidget->minimumSizeHint();
ret.setWidth(ret.width() + sz.width());
if(sz.height() + margin > ret.height())
ret.setHeight(sz.height() + margin);
}
if(as_gui_menubar) {
QStyleOptionMenuItem opt;
opt.rect = rect();
opt.menuRect = rect();
opt.state = QStyle::State_None;
opt.menuItemType = QStyleOptionMenuItem::Normal;
opt.checkType = QStyleOptionMenuItem::NotCheckable;
opt.palette = palette();
return (style()->sizeFromContents(QStyle::CT_MenuBar, &opt,
ret.expandedTo(QApplication::globalStrut()),
this));
}
return ret;
}
/*!
\reimp
*/
QSize QMenuBar::sizeHint() const
{
Q_D(const QMenuBar);
#if defined(Q_WS_MAC) || defined(Q_WS_WINCE) || defined(Q_WS_S60)
const bool as_gui_menubar = !isNativeMenuBar();
#else
const bool as_gui_menubar = true;
#endif
ensurePolished();
QSize ret(0, 0);
const_cast<QMenuBarPrivate*>(d)->updateGeometries();
const int hmargin = style()->pixelMetric(QStyle::PM_MenuBarHMargin, 0, this);
const int vmargin = style()->pixelMetric(QStyle::PM_MenuBarVMargin, 0, this);
int fw = style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, 0, this);
int spaceBelowMenuBar = style()->styleHint(QStyle::SH_MainWindow_SpaceBelowMenuBar, 0, this);
if(as_gui_menubar) {
const int w = parentWidget() ? parentWidget()->width() : QApplication::desktop()->width();
d->calcActionRects(w - (2 * fw), 0);
for (int i = 0; i < d->actionRects.count(); ++i) {
const QRect &actionRect = d->actionRects.at(i);
ret = ret.expandedTo(QSize(actionRect.x() + actionRect.width(), actionRect.y() + actionRect.height()));
}
//the action geometries already contain the top and left
//margins. So we only need to add those from right and bottom.
ret += QSize(fw + hmargin, fw + vmargin);
}
int margin = 2*vmargin + 2*fw + spaceBelowMenuBar;
if(d->leftWidget) {
QSize sz = d->leftWidget->sizeHint();
ret.setWidth(ret.width() + sz.width());
if(sz.height() + margin > ret.height())
ret.setHeight(sz.height() + margin);
}
if(d->rightWidget) {
QSize sz = d->rightWidget->sizeHint();
ret.setWidth(ret.width() + sz.width());
if(sz.height() + margin > ret.height())
ret.setHeight(sz.height() + margin);
}
if(as_gui_menubar) {
QStyleOptionMenuItem opt;
opt.rect = rect();
opt.menuRect = rect();
opt.state = QStyle::State_None;
opt.menuItemType = QStyleOptionMenuItem::Normal;
opt.checkType = QStyleOptionMenuItem::NotCheckable;
opt.palette = palette();
return (style()->sizeFromContents(QStyle::CT_MenuBar, &opt,
ret.expandedTo(QApplication::globalStrut()),
this));
}
return ret;
}
/*!
\reimp
*/
int QMenuBar::heightForWidth(int) const
{
Q_D(const QMenuBar);
#if defined(Q_WS_MAC) || defined(Q_WS_WINCE) || defined(Q_WS_S60)
const bool as_gui_menubar = !isNativeMenuBar();
#else
const bool as_gui_menubar = true;
#endif
const_cast<QMenuBarPrivate*>(d)->updateGeometries();
int height = 0;
const int vmargin = style()->pixelMetric(QStyle::PM_MenuBarVMargin, 0, this);
int fw = style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, 0, this);
int spaceBelowMenuBar = style()->styleHint(QStyle::SH_MainWindow_SpaceBelowMenuBar, 0, this);
if(as_gui_menubar) {
for (int i = 0; i < d->actionRects.count(); ++i)
height = qMax(height, d->actionRects.at(i).height());
if (height) //there is at least one non-null item
height += spaceBelowMenuBar;
height += 2*fw;
height += 2*vmargin;
}
int margin = 2*vmargin + 2*fw + spaceBelowMenuBar;
if(d->leftWidget)
height = qMax(d->leftWidget->sizeHint().height() + margin, height);
if(d->rightWidget)
height = qMax(d->rightWidget->sizeHint().height() + margin, height);
if(as_gui_menubar) {
QStyleOptionMenuItem opt;
opt.init(this);
opt.menuRect = rect();
opt.state = QStyle::State_None;
opt.menuItemType = QStyleOptionMenuItem::Normal;
opt.checkType = QStyleOptionMenuItem::NotCheckable;
return style()->sizeFromContents(QStyle::CT_MenuBar, &opt, QSize(0, height), this).height(); //not pretty..
}
return height;
}
/*!
\internal
*/
void QMenuBarPrivate::_q_internalShortcutActivated(int id)
{
Q_Q(QMenuBar);
QAction *act = actions.at(id);
setCurrentAction(act, true, true);
if (act && !act->menu()) {
activateAction(act, QAction::Trigger);
//100 is the same as the default value in QPushButton::animateClick
autoReleaseTimer.start(100, q);
} else if (act && q->style()->styleHint(QStyle::SH_MenuBar_AltKeyNavigation, 0, q)) {
// When we open a menu using a shortcut, we should end up in keyboard state
setKeyboardMode(true);
}
}
void QMenuBarPrivate::_q_updateLayout()
{
Q_Q(QMenuBar);
itemsDirty = true;
if (q->isVisible()) {
updateGeometries();
q->update();
}
}
/*!
\internal
This sets widget \a w to be shown directly on the left of the first or
the right of the last menu item, depending on \a corner.
*/
void QMenuBar::setCornerWidget(QWidget *w, Qt::Corner corner)
{
Q_D(QMenuBar);
switch (corner) {
case Qt::TopLeftCorner:
if (d->leftWidget)
d->leftWidget->removeEventFilter(this);
d->leftWidget = w;
break;
case Qt::TopRightCorner:
if (d->rightWidget)
d->rightWidget->removeEventFilter(this);
d->rightWidget = w;
break;
default:
qWarning("QMenuBar::setCornerWidget: Only TopLeftCorner and TopRightCorner are supported");
return;
}
if (w) {
w->setParent(this);
w->installEventFilter(this);
}
d->_q_updateLayout();
}
/*!
\internal
Returns the widget in the left of the first or the right of the last menu
item, depending on \a corner.
*/
QWidget *QMenuBar::cornerWidget(Qt::Corner corner) const
{
Q_D(const QMenuBar);
QWidget *w = 0;
switch(corner) {
case Qt::TopLeftCorner:
w = d->leftWidget;
break;
case Qt::TopRightCorner:
w = d->rightWidget;
break;
default:
qWarning("QMenuBar::cornerWidget: Only TopLeftCorner and TopRightCorner are supported");
break;
}
return w;
}
/*!
\property QMenuBar::nativeMenuBar
\brief Whether or not a menubar will be used as a native menubar on platforms that support it
\since 4.6
This property specifies whether or not the menubar should be used as a native menubar on platforms
that support it. The currently supported platforms are Mac OS X and Windows CE. On these platforms
if this property is true, the menubar is used in the native menubar and is not in the window of
its parent, if false the menubar remains in the window. On other platforms the value of this
attribute has no effect.
The default is to follow whether the Qt::AA_DontUseNativeMenuBar attribute
is set for the application. Explicitly settings this property overrides
the presence (or abscence) of the attribute.
*/
void QMenuBar::setNativeMenuBar(bool nativeMenuBar)
{
Q_D(QMenuBar);
if (d->nativeMenuBar == -1 || (nativeMenuBar != bool(d->nativeMenuBar))) {
d->nativeMenuBar = nativeMenuBar;
#ifdef Q_WS_MAC
if (!d->nativeMenuBar) {
extern void qt_mac_clear_menubar();
qt_mac_clear_menubar();
d->macDestroyMenuBar();
const QList<QAction *> &menubarActions = actions();
for (int i = 0; i < menubarActions.size(); ++i) {
const QAction *action = menubarActions.at(i);
if (QMenu *menu = action->menu()) {
delete menu->d_func()->mac_menu;
menu->d_func()->mac_menu = 0;
}
}
} else {
d->macCreateMenuBar(parentWidget());
}
macUpdateMenuBar();
updateGeometry();
setVisible(false);
setVisible(true);
#endif
}
}
bool QMenuBar::isNativeMenuBar() const
{
Q_D(const QMenuBar);
if (d->nativeMenuBar == -1) {
return !QApplication::instance()->testAttribute(Qt::AA_DontUseNativeMenuBar);
}
return d->nativeMenuBar;
}
/*!
\since 4.4
Sets the default action to \a act.
The default action is assigned to the left soft key. The menu is assigned
to the right soft key.
Currently there is only support for the default action on Windows
Mobile. All other platforms ignore the default action.
\sa defaultAction()
*/
#ifdef Q_WS_WINCE
void QMenuBar::setDefaultAction(QAction *act)
{
Q_D(QMenuBar);
if (d->defaultAction == act)
return;
#ifdef Q_WS_WINCE
if (qt_wince_is_mobile())
if (d->defaultAction) {
disconnect(d->defaultAction, SIGNAL(changed()), this, SLOT(_q_updateDefaultAction()));
disconnect(d->defaultAction, SIGNAL(destroyed ()), this, SLOT(_q_updateDefaultAction()));
}
#endif
d->defaultAction = act;
#ifdef Q_WS_WINCE
if (qt_wince_is_mobile())
if (d->defaultAction) {
connect(d->defaultAction, SIGNAL(changed()), this, SLOT(_q_updateDefaultAction()));
connect(d->defaultAction, SIGNAL(destroyed()), this, SLOT(_q_updateDefaultAction()));
}
if (d->wce_menubar) {
d->wce_menubar->rebuild();
}
#endif
}
/*!
\since 4.4
Returns the current default action.
\sa setDefaultAction()
*/
QAction *QMenuBar::defaultAction() const
{
return d_func()->defaultAction;
}
#endif
/*!
\fn void QMenuBar::triggered(QAction *action)
This signal is emitted when an action in a menu belonging to this menubar
is triggered as a result of a mouse click; \a action is the action that
caused the signal to be emitted.
Normally, you connect each menu action to a single slot using
QAction::triggered(), but sometimes you will want to connect
several items to a single slot (most often if the user selects
from an array). This signal is useful in such cases.
\sa hovered(), QAction::triggered()
*/
/*!
\fn void QMenuBar::hovered(QAction *action)
This signal is emitted when a menu action is highlighted; \a action
is the action that caused the event to be sent.
Often this is used to update status information.
\sa triggered(), QAction::hovered()
*/
#ifdef QT3_SUPPORT
/*!
Use style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, this)
instead.
*/
int QMenuBar::frameWidth() const
{
return style()->pixelMetric(QStyle::PM_MenuBarPanelWidth, 0, this);
}
int QMenuBar::insertAny(const QIcon *icon, const QString *text, const QObject *receiver, const char *member,
const QKeySequence *shortcut, const QMenu *popup, int id, int index)
{
QAction *act = popup ? popup->menuAction() : new QAction(this);
if(id != -1)
static_cast<QMenuItem*>(act)->setId(id);
if(icon)
act->setIcon(*icon);
if(text)
act->setText(*text);
if(shortcut)
act->setShortcut(*shortcut);
if(receiver && member)
QObject::connect(act, SIGNAL(triggered(bool)), receiver, member);
if(index == -1 || index >= actions().count())
addAction(act);
else
insertAction(actions().value(index), act);
return findIdForAction(act);
}
/*!
\since 4.2
Use addSeparator() or insertAction() instead.
\oldcode
menuBar->insertSeparator();
\newcode
menuBar->addSeparator();
\endcode
*/
int QMenuBar::insertSeparator(int index)
{
QAction *act = new QAction(this);
act->setSeparator(true);
if(index == -1 || index >= actions().count())
addAction(act);
else
insertAction(actions().value(index), act);
return findIdForAction(act);
}
/*!
Use QAction::setData() instead.
*/
bool QMenuBar::setItemParameter(int id, int param)
{
if(QAction *act = findActionForId(id)) {
act->d_func()->param = param;
return true;
}
return false;
}
/*!
Use QAction::data() instead.
*/
int QMenuBar::itemParameter(int id) const
{
if(QAction *act = findActionForId(id))
return act->d_func()->param;
return id;
}
QAction *QMenuBar::findActionForId(int id) const
{
QList<QAction *> list = actions();
for (int i = 0; i < list.size(); ++i) {
QAction *act = list.at(i);
if (findIdForAction(act) == id)
return act;
}
return 0;
}
int QMenuBar::findIdForAction(QAction *act) const
{
Q_ASSERT(act);
return act->d_func()->id;
}
#endif
/*!
\enum QMenuBar::Separator
\compat
\value Never
\value InWindowsStyle
*/
/*!
\fn void QMenuBar::addAction(QAction *action)
\overload
Appends the action \a action to the menu bar's list of actions.
\sa QMenu::addAction(), QWidget::addAction(), QWidget::actions()
*/
/*!
\fn uint QMenuBar::count() const
Use actions().count() instead.
*/
/*!
\fn int QMenuBar::insertItem(const QString &text, const QObject *receiver, const char* member, const QKeySequence& shortcut, int id, int index)
Use one of the insertAction() or addAction() overloads instead.
*/
/*!
\fn int QMenuBar::insertItem(const QIcon& icon, const QString &text, const QObject *receiver, const char* member, const QKeySequence& shortcut, int id, int index)
Use one of the insertAction() or addAction() overloads instead.
*/
/*!
\fn int QMenuBar::insertItem(const QPixmap &pixmap, const QObject *receiver, const char* member, const QKeySequence& shortcut, int id, int index)
Use one of the insertAction(), addAction(), insertMenu(), or
addMenu() overloads instead.
*/
/*!
\fn int QMenuBar::insertItem(const QString &text, int id, int index)
Use one of the insertAction() or addAction() overloads instead.
*/
/*!
\fn int QMenuBar::insertItem(const QIcon& icon, const QString &text, int id, int index)
Use one of the insertAction(), addAction(), insertMenu(), or
addMenu() overloads instead.
*/
/*!
\fn int QMenuBar::insertItem(const QString &text, QMenu *popup, int id, int index)
Use one of the insertMenu(), or addMenu() overloads instead.
*/
/*!
\fn int QMenuBar::insertItem(const QIcon& icon, const QString &text, QMenu *popup, int id, int index)
Use one of the insertMenu(), or addMenu() overloads instead.
*/
/*!
\fn int QMenuBar::insertItem(const QPixmap &pixmap, int id, int index)
Use one of the insertAction(), addAction(), insertMenu(), or
addMenu() overloads instead.
*/
/*!
\fn int QMenuBar::insertItem(const QPixmap &pixmap, QMenu *popup, int id, int index)
Use one of the insertMenu(), or addMenu() overloads instead.
*/
/*!
\fn void QMenuBar::removeItem(int id)
Use removeAction() instead.
*/
/*!
\fn void QMenuBar::removeItemAt(int index)
Use removeAction() instead.
*/
/*!
\fn QKeySequence QMenuBar::accel(int id) const
Use shortcut() on the relevant QAction instead.
*/
/*!
\fn void QMenuBar::setAccel(const QKeySequence& key, int id)
Use setShortcut() on the relevant QAction instead.
*/
/*!
\fn QIcon QMenuBar::iconSet(int id) const
Use icon() on the relevant QAction instead.
*/
/*!
\fn QString QMenuBar::text(int id) const
Use text() on the relevant QAction instead.
*/
/*!
\fn QPixmap QMenuBar::pixmap(int id) const
Use QPixmap(icon()) on the relevant QAction instead.
*/
/*!
\fn void QMenuBar::setWhatsThis(int id, const QString &w)
Use setWhatsThis() on the relevant QAction instead.
*/
/*!
\fn QString QMenuBar::whatsThis(int id) const
Use whatsThis() on the relevant QAction instead.
*/
/*!
\fn void QMenuBar::changeItem(int id, const QString &text)
Use setText() on the relevant QAction instead.
*/
/*!
\fn void QMenuBar::changeItem(int id, const QPixmap &pixmap)
Use setText() on the relevant QAction instead.
*/
/*!
\fn void QMenuBar::changeItem(int id, const QIcon &icon, const QString &text)
Use setIcon() and setText() on the relevant QAction instead.
*/
/*!
\fn bool QMenuBar::isItemActive(int id) const
Use activeAction() instead.
*/
/*!
\fn bool QMenuBar::isItemEnabled(int id) const
Use isEnabled() on the relevant QAction instead.
*/
/*!
\fn void QMenuBar::setItemEnabled(int id, bool enable)
Use setEnabled() on the relevant QAction instead.
*/
/*!
\fn bool QMenuBar::isItemChecked(int id) const
Use isChecked() on the relevant QAction instead.
*/
/*!
\fn void QMenuBar::setItemChecked(int id, bool check)
Use setChecked() on the relevant QAction instead.
*/
/*!
\fn bool QMenuBar::isItemVisible(int id) const
Use isVisible() on the relevant QAction instead.
*/
/*!
\fn void QMenuBar::setItemVisible(int id, bool visible)
Use setVisible() on the relevant QAction instead.
*/
/*!
\fn int QMenuBar::indexOf(int id) const
Use actions().indexOf(action) on the relevant QAction instead.
*/
/*!
\fn int QMenuBar::idAt(int index) const
Use actions instead.
*/
/*!
\fn void QMenuBar::activateItemAt(int index)
Use activate() on the relevant QAction instead.
*/
/*!
\fn bool QMenuBar::connectItem(int id, const QObject *receiver, const char* member)
Use connect() on the relevant QAction instead.
*/
/*!
\fn bool QMenuBar::disconnectItem(int id,const QObject *receiver, const char* member)
Use disconnect() on the relevant QAction instead.
*/
/*!
\fn QMenuItem *QMenuBar::findItem(int id) const
Use actions instead.
*/
/*!
\fn Separator QMenuBar::separator() const
This function is provided only to make old code compile.
*/
/*!
\fn void QMenuBar::setSeparator(Separator sep)
This function is provided only to make old code compile.
*/
/*!
\fn QRect QMenuBar::itemRect(int index)
Use actionGeometry() on the relevant QAction instead.
*/
/*!
\fn int QMenuBar::itemAtPos(const QPoint &p)
There is no equivalent way to achieve this in Qt 4.
*/
/*!
\fn void QMenuBar::activated(int itemId);
Use triggered() instead.
*/
/*!
\fn void QMenuBar::highlighted(int itemId);
Use hovered() instead.
*/
/*!
\fn void QMenuBar::setFrameRect(QRect)
\internal
*/
/*!
\fn QRect QMenuBar::frameRect() const
\internal
*/
/*!
\enum QMenuBar::DummyFrame
\internal
\value Box
\value Sunken
\value Plain
\value Raised
\value MShadow
\value NoFrame
\value Panel
\value StyledPanel
\value HLine
\value VLine
\value GroupBoxPanel
\value WinPanel
\value ToolBarPanel
\value MenuBarPanel
\value PopupPanel
\value LineEditPanel
\value TabWidgetPanel
\value MShape
*/
/*!
\fn void QMenuBar::setFrameShadow(DummyFrame)
\internal
*/
/*!
\fn DummyFrame QMenuBar::frameShadow() const
\internal
*/
/*!
\fn void QMenuBar::setFrameShape(DummyFrame)
\internal
*/
/*!
\fn DummyFrame QMenuBar::frameShape() const
\internal
*/
/*!
\fn void QMenuBar::setFrameStyle(int)
\internal
*/
/*!
\fn int QMenuBar::frameStyle() const
\internal
*/
/*!
\fn void QMenuBar::setLineWidth(int)
\internal
*/
/*!
\fn int QMenuBar::lineWidth() const
\internal
*/
/*!
\fn void QMenuBar::setMargin(int margin)
Sets the width of the margin around the contents of the widget to \a margin.
Use QWidget::setContentsMargins() instead.
\sa margin(), QWidget::setContentsMargins()
*/
/*!
\fn int QMenuBar::margin() const
Returns the width of the margin around the contents of the widget.
Use QWidget::getContentsMargins() instead.
\sa setMargin(), QWidget::getContentsMargins()
*/
/*!
\fn void QMenuBar::setMidLineWidth(int)
\internal
*/
/*!
\fn int QMenuBar::midLineWidth() const
\internal
*/
// for private slots
QT_END_NAMESPACE
#include <moc_qmenubar.cpp>
#endif // QT_NO_MENUBAR