Merge remote branch 'origin/4.8' into 4.8-from-4.7
[qt:qt.git] / src / corelib / global / qnamespace.qdoc
1 /****************************************************************************
2 **
3 ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4 ** All rights reserved.
5 ** Contact: Nokia Corporation (qt-info@nokia.com)
6 **
7 ** This file is part of the documentation of the Qt Toolkit.
8 **
9 ** $QT_BEGIN_LICENSE:FDL$
10 ** GNU Free Documentation License
11 ** Alternatively, this file may be used under the terms of the GNU Free
12 ** Documentation License version 1.3 as published by the Free Software
13 ** Foundation and appearing in the file included in the packaging of
14 ** this file.
15 **
16 ** Other Usage
17 ** Alternatively, this file may be used in accordance with the terms
18 ** and conditions contained in a signed written agreement between you
19 ** and Nokia.
20 **
21 **
22 **
23 **
24 ** $QT_END_LICENSE$
25 **
26 ****************************************************************************/
27
28 /*!
29     \namespace Qt
30     \inmodule QtCore
31     \target Qt Namespace
32
33     \brief The Qt namespace contains miscellaneous identifiers
34     used throughout the Qt library.
35 */
36
37 /*!
38     \enum Qt::Orientation
39
40     This type is used to signify an object's orientation.
41
42     \value Horizontal
43     \value Vertical
44
45     Orientation is used with QScrollBar for example.
46 */
47
48 /*!
49     \enum Qt::AlignmentFlag
50
51     This enum type is used to describe alignment. It contains
52     horizontal and vertical flags that can be combined to produce
53     the required effect.
54
55     The \l{TextElideMode} enum can also be used in many situations
56     to fine-tune the appearance of aligned text.
57
58     The horizontal flags are:
59
60     \value AlignLeft Aligns with the left edge.
61     \value AlignRight Aligns with the right edge.
62     \value AlignHCenter Centers horizontally in the available space.
63     \value AlignJustify Justifies the text in the available space.
64     \omitvalue AlignAuto
65
66     The vertical flags are:
67
68     \value AlignTop Aligns with the top.
69     \value AlignBottom Aligns with the bottom.
70     \value AlignVCenter Centers vertically in the available space.
71
72     You can use only one of the horizontal flags at a time. There is
73     one two-dimensional flag:
74
75     \value AlignCenter Centers in both dimensions.
76
77     You can use at most one horizontal and one vertical flag at a
78     time. Qt::AlignCenter counts as both horizontal and vertical.
79
80     Three enum values are useful in applications that can be run in
81     right-to-left mode:
82
83     \value AlignAbsolute  If the widget's layout direction is
84         Qt::RightToLeft (instead of Qt::LeftToRight, the default),
85         Qt::AlignLeft refers to the \e right edge and Qt::AlignRight
86         to the \e left edge. This is normally the desired behavior.
87         If you want Qt::AlignLeft to always mean "left" and
88         Qt::AlignRight to always mean "right", combine the flag with
89         Qt::AlignAbsolute.
90     \value AlignLeading  Synonym for Qt::AlignLeft.
91     \value AlignTrailing  Synonym for Qt::AlignRight.
92
93     Masks:
94
95     \value AlignHorizontal_Mask
96     \value AlignVertical_Mask
97
98     Conflicting combinations of flags have undefined meanings.
99 */
100
101 /*!
102     \enum Qt::ApplicationAttribute
103
104     This enum describes attributes that change the behavior of
105     application-wide features. These are enabled and disabled using
106     QCoreApplication::setAttribute(), and can be tested for with
107     QCoreApplication::testAttribute().
108
109     \value AA_ImmediateWidgetCreation Ensures that widgets are created
110            as soon as they are constructed. By default, resources for
111            widgets are allocated on demand to improve efficiency and
112            minimize resource usage. Setting or clearing this attribute
113            affects widgets constructed after the change. Setting it
114            tells Qt to create toplevel windows immediately.
115            Therefore, if it is important to minimize resource
116            consumption, do not set this attribute.
117
118     \value AA_MSWindowsUseDirect3DByDefault This value is obsolete and
119            has no effect.
120
121     \value AA_DontShowIconsInMenus Actions with the Icon property won't be
122            shown in any menus unless specifically set by the
123            QAction::iconVisibleInMenu property.
124            Menus that are currently open or menus already created in the native
125            Mac OS X menubar \e{may not} pick up a change in this attribute. Changes
126            in the QAction::iconVisibleInMenu property will always be picked up.
127
128     \value AA_NativeWindows Ensures that widgets have native windows.
129
130     \value AA_DontCreateNativeWidgetSiblings Ensures that siblings of native
131            widgets stay non-native unless specifically set by the
132            Qt::WA_NativeWindow attribute.
133
134     \value AA_MacPluginApplication Stops the Qt mac application from doing
135            specific initializations that do not necessarily make sense when using Qt
136            to author a plugin. This includes avoiding loading our nib for the main
137            menu and not taking possession of the native menu bar. When setting this
138            attribute to true will also set the AA_DontUseNativeMenuBar attribute
139            to true.
140
141     \value AA_DontUseNativeMenuBar All menubars created while this attribute is
142            set to true won't be used as a native menubar (e.g, the menubar at
143            the top of the main screen on Mac OS X or at the bottom in Windows CE).
144
145     \value AA_MacDontSwapCtrlAndMeta On Mac OS X by default, Qt swaps the
146            Control and Meta (Command) keys (i.e., whenever Control is pressed, Qt
147            sends Meta, and whenever Meta is pressed Control is sent). When this
148            attribute is true, Qt will not do the flip. QKeySequence::StandardShortcuts
149            will also flip accordingly (i.e., QKeySequence::Copy will be
150            Command+C on the keyboard regardless of the value set, though what is output for
151            QKeySequence::toString(QKeySequence::PortableText) will be different).
152
153     \value AA_S60DontConstructApplicationPanes Stops Qt from initializing the S60 status
154            pane and softkey pane on Symbian. This is useful to save memory and reduce
155            startup time for applications that will run in fullscreen mode during their
156            whole lifetime. This attribute must be set before QApplication is
157            constructed.
158
159     \value AA_S60DisablePartialScreenInputMode By default in Symbian^3, a separate
160            editing window is opened on top of an application. This is exactly like
161            editing on previous versions of Symbian behave. When this attribute is false,
162            a non-fullscreen virtual keyboard window is shown on top of application and
163            it is ensured that the focused text input widget is visible.
164            The auto-translation of input widget is only supported for applications
165            based on QGraphicsView, but the non-fullscreen virtual keyboard will
166            work for any kind of application (i.e. QWidgets-based). By default this
167            attribute is true. This attribute must be set after QApplication is
168            constructed. This is only supported in Symbian^3 and later Symbian releases.
169
170     \value AA_X11InitThreads Calls XInitThreads() as part of the QApplication
171            construction in order to make Xlib calls thread-safe. This
172            attribute must be set before QApplication is constructed.
173
174     \value AA_CaptureMultimediaKeys Enables application to receive multimedia key events
175             (play, next, previous etc). This includes also external sources such as headsets.
176             Application can not use Remote Control framework on Symbian if this attribute is 
177             set. On Symbian, multimedia key event routing may vary between different devices. 
178             For example, application on background may receive multimedia key events only if 
179             it has active audio stream i.e. it is playing music or video. This attribute must 
180             be set before QApplication is constructed. This attribute is only supported in Symbian 
181             platform.
182
183     \omitvalue AA_AttributeCount
184 */
185
186 /*!
187     \enum Qt::MouseButton
188
189     This enum type describes the different mouse buttons.
190
191     \value NoButton        The button state does not refer to any
192     button (see QMouseEvent::button()).
193     \value LeftButton      The left button is pressed, or an event refers
194     to the left button. (The left button may be the right button on
195     left-handed mice.)
196     \value RightButton     The right button.
197     \value MidButton       The middle button.
198     \value MiddleButton    The middle button.
199     \value XButton1        The first X button.
200     \value XButton2        The second X button.
201
202     \omitvalue MouseButtonMask
203
204     \sa KeyboardModifier Modifier
205 */
206
207 /*!
208     \enum Qt::KeyboardModifier
209
210     This enum describes the modifier keys.
211
212     \value NoModifier       No modifier key is pressed.
213     \value ShiftModifier    A Shift key on the keyboard is pressed.
214     \value ControlModifier  A Ctrl key on the keyboard is pressed.
215     \value AltModifier      An Alt key on the keyboard is pressed.
216     \value MetaModifier     A Meta key on the keyboard is pressed.
217     \value KeypadModifier   A keypad button is pressed.
218     \value GroupSwitchModifier X11 only. A Mode_switch key on the keyboard is pressed.
219
220     \omitvalue KeyboardModifierMask
221
222     \note On Mac OS X, the \c ControlModifier value corresponds to
223     the Command keys on the Macintosh keyboard, and the \c MetaModifier value
224     corresponds to the Control keys. The \c KeypadModifier value will also be set
225     when an arrow key is pressed as the arrow keys are considered part of the
226     keypad.
227
228     \note On Windows Keyboards, Qt::MetaModifier and Qt::Key_Meta are mapped
229     to the Windows key.
230
231     \sa MouseButton Modifier
232 */
233
234 /*!
235     \enum Qt::Modifier
236
237     This enum provides shorter names for the keyboard modifier keys
238     supported by Qt.
239
240     \bold{Note:} On Mac OS X, the \c CTRL value corresponds to
241     the Command keys on the Macintosh keyboard, and the \c META value
242     corresponds to the Control keys.
243
244     \value SHIFT The Shift keys provided on all standard keyboards.
245     \value META The Meta keys.
246     \value CTRL The Ctrl keys.
247     \value ALT The normal Alt keys, but not keys like AltGr.
248     \value UNICODE_ACCEL The shortcut is specified as a Unicode code
249     point, not as a Qt Key.
250     \omitvalue MODIFIER_MASK
251
252     \sa KeyboardModifier MouseButton
253 */
254
255 /*!
256     \enum Qt::GlobalColor
257
258     Qt's predefined QColor objects:
259
260     \value white       \span {id="color-white"} {White (#ffffff) }
261     \value black       \span {id="color-black"} {Black (#000000) }
262     \value red         \span {id="color-red"} {Red (#ff0000) }
263     \value darkRed     \span {id="color-darkRed"} {Dark red (#800000) }
264     \value green       \span {id="color-green"} {Green (#00ff00) }
265     \value darkGreen   \span {id="color-darkGreen"} {Dark green (#008000) }
266     \value blue        \span {id="color-blue"} {Blue (#0000ff) }
267     \value darkBlue    \span {id="color-darkBlue"} {Dark blue (#000080) }
268     \value cyan        \span {id="color-cyan"} {Cyan (#00ffff) }
269     \value darkCyan    \span {id="color-darkCyan"} {Dark cyan (#008080) }
270     \value magenta     \span {id="color-magenta"} {Magenta (#ff00ff) }
271     \value darkMagenta \span {id="color-darkMagenta"} {Dark magenta (#800080) }
272     \value yellow      \span {id="color-yellow"} {Yellow (#ffff00) }
273     \value darkYellow  \span {id="color-darkYellow"} {Dark yellow (#808000) }
274     \value gray        \span {id="color-gray"} {Gray (#a0a0a4) }
275     \value darkGray    \span {id="color-darkGray"} {Dark gray (#808080) }
276     \value lightGray   \span {id="color-lightGray"} {Light gray (#c0c0c0) }
277     \value transparent a transparent black value (i.e., QColor(0, 0, 0, 0))
278     \value color0 0 pixel value (for bitmaps)
279     \value color1 1 pixel value (for bitmaps)
280
281     \sa QColor
282
283 */
284
285 /*!
286     \enum Qt::PenStyle
287
288     This enum type defines the pen styles that can be drawn using
289     QPainter. The styles are:
290
291     \table
292     \row
293     \o \inlineimage qpen-solid.png
294     \o \inlineimage qpen-dash.png
295     \o \inlineimage qpen-dot.png
296     \row
297     \o Qt::SolidLine
298     \o Qt::DashLine
299     \o Qt::DotLine
300     \row
301     \o \inlineimage qpen-dashdot.png
302     \o \inlineimage qpen-dashdotdot.png
303     \o \inlineimage qpen-custom.png
304     \row
305     \o Qt::DashDotLine
306     \o Qt::DashDotDotLine
307     \o Qt::CustomDashLine
308     \endtable
309
310     \value NoPen  no line at all. For example, QPainter::drawRect()
311     fills but does not draw any boundary line.
312
313     \value SolidLine  A plain line.
314     \value DashLine  Dashes separated by a few pixels.
315     \value DotLine  Dots separated by a few pixels.
316     \value DashDotLine  Alternate dots and dashes.
317     \value DashDotDotLine  One dash, two dots, one dash, two dots.
318     \value CustomDashLine  A custom pattern defined using
319                            QPainterPathStroker::setDashPattern().
320
321     \omitvalue MPenStyle
322
323     \sa QPen
324 */
325
326 /*!
327     \enum Qt::PenCapStyle
328
329     This enum type defines the pen cap styles supported by Qt, i.e.
330     the line end caps that can be drawn using QPainter.
331
332     \table
333     \row
334     \o \inlineimage qpen-square.png
335     \o \inlineimage qpen-flat.png
336     \o \inlineimage qpen-roundcap.png
337     \row
338     \o Qt::SquareCap
339     \o Qt::FlatCap
340     \o Qt::RoundCap
341     \endtable
342
343     \value FlatCap  a square line end that does not cover the end
344         point of the line.
345     \value SquareCap  a square line end that covers the end point and
346         extends beyond it by half the line width.
347     \value RoundCap  a rounded line end.
348     \omitvalue MPenCapStyle
349
350     \sa QPen
351 */
352
353 /*!
354     \enum Qt::PenJoinStyle
355
356     This enum type defines the pen join styles supported by Qt, i.e.
357     which joins between two connected lines can be drawn using
358     QPainter.
359
360     \table
361     \row
362     \o \inlineimage qpen-bevel.png
363     \o \inlineimage qpen-miter.png
364     \o \inlineimage qpen-roundjoin.png
365     \row
366     \o Qt::BevelJoin
367     \o Qt::MiterJoin
368     \o Qt::RoundJoin
369     \endtable
370
371     \value MiterJoin  The outer edges of the lines are extended to
372            meet at an angle, and this area is filled.
373     \value BevelJoin  The triangular notch between the two lines is filled.
374     \value RoundJoin  A circular arc between the two lines is filled.
375     \value SvgMiterJoin A miter join corresponding to the definition of
376            a miter join in the \l{SVG 1.2 Tiny} specification.
377     \omitvalue MPenJoinStyle
378
379     \sa QPen
380 */
381
382 /*!
383     \enum Qt::BrushStyle
384
385     This enum type defines the brush styles supported by Qt, i.e. the
386     fill pattern of shapes drawn using QPainter.
387
388     \image brush-styles.png Brush Styles
389
390     \value NoBrush  No brush pattern.
391     \value SolidPattern  Uniform color.
392     \value Dense1Pattern  Extremely dense brush pattern.
393     \value Dense2Pattern  Very dense brush pattern.
394     \value Dense3Pattern  Somewhat dense brush pattern.
395     \value Dense4Pattern  Half dense brush pattern.
396     \value Dense5Pattern  Somewhat sparse brush pattern.
397     \value Dense6Pattern  Very sparse brush pattern.
398     \value Dense7Pattern  Extremely sparse brush pattern.
399     \value HorPattern  Horizontal lines.
400     \value VerPattern  Vertical lines.
401     \value CrossPattern  Crossing horizontal and vertical lines.
402     \value BDiagPattern  Backward diagonal lines.
403     \value FDiagPattern  Forward diagonal lines.
404     \value DiagCrossPattern  Crossing diagonal lines.
405     \value LinearGradientPattern  Linear gradient (set using a dedicated QBrush constructor).
406     \value ConicalGradientPattern  Conical gradient (set using a dedicated QBrush constructor).
407     \value RadialGradientPattern  Radial gradient (set using a dedicated QBrush constructor).
408     \value TexturePattern  Custom pattern (see QBrush::setTexture()).
409
410     \omitvalue CustomPattern
411
412     \sa QBrush
413 */
414
415 /*!
416     \enum Qt::TextFlag
417
418     This enum type is used to define some modifier flags. Some of
419     these flags only make sense in the context of printing:
420
421     \value TextSingleLine Treats all whitespace as spaces and prints just
422            one line.
423     \value TextDontClip If it's impossible to stay within the given bounds,
424            it prints outside.
425     \value TextExpandTabs Makes the U+0009 (ASCII tab) character move to
426            the next tab stop.
427     \value TextShowMnemonic Displays the string "\&P" as \underline{P}
428            (see QButton for an example). For an ampersand, use "\&\&".
429     \value TextWordWrap Breaks lines at appropriate points, e.g. at word
430            boundaries.
431     \value TextWrapAnywhere Breaks lines anywhere, even within words.
432     \value TextHideMnemonic Same as Qt::TextShowMnemonic but doesn't draw
433            the underlines.
434     \value TextDontPrint Treat this text as "hidden" and don't print it.
435     \value IncludeTrailingSpaces When this option is set,
436            QTextLine::naturalTextWidth() and naturalTextRect() will
437            return a value that includes the width of trailing spaces in the
438            text; otherwise this width is excluded.
439     \value TextIncludeTrailingSpaces Same as IncludeTrailingSpaces
440     \value TextJustificationForced Ensures that text lines are justified.
441
442     \omitvalue TextLongestVariant Ensures that the longest variant is always used
443            when computing the size of a multi-variant string. (Internal)
444     \omitvalue TextBypassShaping
445     \omitvalue BreakAnywhere
446     \omitvalue DontClip
447     \omitvalue DontPrint
448     \omitvalue ExpandTabs
449     \omitvalue IncludeTrailingSpaces
450     \omitvalue NoAccel
451     \omitvalue ShowPrefix
452     \omitvalue SingleLine
453     \omitvalue WordBreak
454     \omitvalue TextForceLeftToRight
455     \omitvalue TextForceRightToLeft
456
457     You can use as many modifier flags as you want, except that
458     Qt::TextSingleLine and Qt::TextWordWrap cannot be combined.
459
460     Flags that are inappropriate for a given use are generally
461     ignored.
462 */
463
464 /*!
465     \enum Qt::BGMode
466
467     Background mode:
468
469     \value TransparentMode
470     \value OpaqueMode
471 */
472
473 /*!
474     \enum Qt::ConnectionType
475
476     This enum describes the types of connection that can be used
477     between signals and slots. In particular, it determines whether a
478     particular signal is delivered to a slot immediately or queued for
479     delivery at a later time.
480
481     \value AutoConnection
482             (default) If the signal is emitted from a different thread than the
483             receiving object, the signal is queued, behaving as
484             Qt::QueuedConnection. Otherwise, the slot is invoked directly,
485             behaving as Qt::DirectConnection. The type of connection is
486             determined when the signal is emitted.
487
488     \value DirectConnection
489            The slot is invoked immediately, when the signal is
490            emitted.
491
492     \value QueuedConnection
493            The slot is invoked when control returns to the event loop
494            of the receiver's thread. The slot is executed in the
495            receiver's thread.
496
497     \value BlockingQueuedConnection
498            Same as QueuedConnection, except the current thread blocks
499            until the slot returns. This connection type should only be
500            used where the emitter and receiver are in different
501            threads.  \note Violating this rule can cause your
502            application to deadlock.
503
504     \value UniqueConnection
505            Same as AutoConnection, but the connection is made only if
506            it does not duplicate an existing connection. i.e., if the
507            same signal is already connected to the same slot for the
508            same pair of objects, then the connection will fail. This
509            connection type was introduced in Qt 4.6.
510
511     \value AutoCompatConnection
512            The default type when Qt 3 support is enabled. Same as
513            AutoConnection but will also cause warnings to be output in
514            certain situations. See \l{Porting to Qt 4#Compatibility
515            Signals and Slots}{Compatibility Signals and Slots} for
516            further information.
517
518     With queued connections, the parameters must be of types that are
519     known to Qt's meta-object system, because Qt needs to copy the
520     arguments to store them in an event behind the scenes. If you try
521     to use a queued connection and get the error message:
522
523     \snippet doc/src/snippets/code/doc_src_qnamespace.qdoc 0
524
525     Call qRegisterMetaType() to register the data type before you
526     establish the connection.
527
528     When using signals and slots with multiple threads, see \l{Signals and Slots Across Threads}.
529
530     \sa {Thread Support in Qt}, QObject::connect(), qRegisterMetaType()
531 */
532
533 /*!
534     \enum Qt::DateFormat
535
536     \value TextDate The default Qt format, which includes the day and month name,
537     the day number in the month, and the year in full. The day and month names will
538     be short, localized names. This is basically equivalent to using the date format
539     string, "ddd MMM d yyyy". See QDate::toString() for more information.
540
541     \value ISODate \l{ISO 8601} extended format: either \c{YYYY-MM-DD} for dates or
542     \c{YYYY-MM-DDTHH:mm:ss}, \c{YYYY-MM-DDTHH:mm:ssTZD} (e.g., 1997-07-16T19:20:30+01:00)
543     for combined dates and times.
544
545     \value SystemLocaleShortDate The \l{QLocale::ShortFormat}{short format} used
546     by the \l{QLocale::system()}{operating system}.
547
548     \value SystemLocaleLongDate The \l{QLocale::LongFormat}{long format} used
549     by the \l{QLocale::system()}{operating system}.
550
551     \value DefaultLocaleShortDate The \l{QLocale::ShortFormat}{short format} specified
552     by the \l{QLocale::setDefault()}{application's locale}.
553
554     \value DefaultLocaleLongDate The \l{QLocale::LongFormat}{long format} used
555     by the \l{QLocale::setDefault()}{application's locale}.
556
557     \value SystemLocaleDate \e{This enum value is deprecated.} Use Qt::SystemLocaleShortDate
558     instead (or Qt::SystemLocaleLongDate if you want long dates).
559
560     \value LocaleDate \e{This enum value is deprecated.} Use Qt::DefaultLocaleShortDate
561     instead (or Qt::DefaultLocaleLongDate if you want long dates).
562
563     \value LocalDate \e{This enum value is deprecated.} Use Qt::SystemLocaleShortDate
564     instead (or Qt::SystemLocaleLongDate if you want long dates).
565
566     \note For \c ISODate formats, each \c Y, \c M and \c D represents a single digit
567     of the year, month and day used to specify the date. Each \c H, \c M and \c S
568     represents a single digit of the hour, minute and second used to specify the time.
569     The presence of a literal \c T character is used to separate the date and time when
570     both are specified.
571 */
572
573
574 /*!
575     \enum Qt::TimeSpec
576
577     \value LocalTime Locale dependent time (Timezones and Daylight Savings Time).
578     \value UTC Coordinated Universal Time, replaces Greenwich Mean Time.
579     \value OffsetFromUTC An offset in seconds from Coordinated Universal Time.
580 */
581
582 /*!
583     \enum Qt::DayOfWeek
584
585     \value Monday
586     \value Tuesday
587     \value Wednesday
588     \value Thursday
589     \value Friday
590     \value Saturday
591     \value Sunday
592 */
593
594 /*!
595     \enum Qt::CaseSensitivity
596
597     \value CaseInsensitive
598     \value CaseSensitive
599 */
600
601 /*!
602     \enum Qt::ToolBarArea
603
604     \value LeftToolBarArea
605     \value RightToolBarArea
606     \value TopToolBarArea
607     \value BottomToolBarArea
608     \value AllToolBarAreas
609     \value NoToolBarArea
610
611     \omitvalue ToolBarArea_Mask
612 */
613
614 /*!
615     \enum Qt::DockWidgetArea
616
617     \value LeftDockWidgetArea
618     \value RightDockWidgetArea
619     \value TopDockWidgetArea
620     \value BottomDockWidgetArea
621     \value AllDockWidgetAreas
622     \value NoDockWidgetArea
623
624     \omitvalue DockWidgetArea_Mask
625 */
626
627 /*!
628     \enum Qt::BackgroundMode
629
630     \compat
631
632     \value FixedColor
633     \value FixedPixmap
634     \value NoBackground
635     \value PaletteForeground
636     \value PaletteButton
637     \value PaletteLight
638     \value PaletteMidlight
639     \value PaletteDark
640     \value PaletteMid
641     \value PaletteText
642     \value PaletteBrightText
643     \value PaletteBase
644     \value PaletteBackground
645     \value PaletteShadow
646     \value PaletteHighlight
647     \value PaletteHighlightedText
648     \value PaletteButtonText
649     \value PaletteLink
650     \value PaletteLinkVisited
651     \value X11ParentRelative
652 */
653
654 /*!
655     \enum Qt::ImageConversionFlag
656
657     The options marked "(default)" are set if no other values from
658     the list are included (since the defaults are zero):
659
660     Color/Mono preference (ignored for QBitmap):
661
662     \value AutoColor (default) - If the image has \link
663            QImage::depth() depth\endlink 1 and contains only
664            black and white pixels, the pixmap becomes monochrome.
665     \value ColorOnly The pixmap is dithered/converted to the
666            \link QPixmap::defaultDepth() native display depth\endlink.
667     \value MonoOnly The pixmap becomes monochrome. If necessary,
668            it is dithered using the chosen dithering algorithm.
669
670     Dithering mode preference for RGB channels:
671
672     \value DiffuseDither (default) - A high-quality dither.
673     \value OrderedDither A faster, more ordered dither.
674     \value ThresholdDither No dithering; closest color is used.
675
676     Dithering mode preference for alpha channel:
677
678     \value ThresholdAlphaDither (default) - No dithering.
679     \value OrderedAlphaDither A faster, more ordered dither.
680     \value DiffuseAlphaDither A high-quality dither.
681     \omitvalue NoAlpha
682
683     Color matching versus dithering preference:
684
685     \value PreferDither (default when converting to a pixmap) - Always dither
686            32-bit images when the image is converted to 8 bits.
687     \value AvoidDither (default when converting for the purpose of saving to
688            file) - Dither 32-bit images only if the image has more than 256
689            colors and it is being converted to 8 bits.
690     \omitvalue AutoDither
691
692     \omitvalue ColorMode_Mask
693     \omitvalue Dither_Mask
694     \omitvalue AlphaDither_Mask
695     \omitvalue DitherMode_Mask
696
697     \value NoOpaqueDetection Do not check whether the image contains non-opaque
698            pixels. Use this if you know that the image is semi-transparent and
699            you want to avoid the overhead of checking the pixels in the image
700            until a non-opaque pixel is found, or if you want the pixmap to
701            retain an alpha channel for some other reason. If the image has no
702            alpha channel this flag has no effect.
703
704     \omitvalue NoFormatConversion Don't do any format conversions on the image.
705            Can be useful when converting a QImage to a QPixmap for a one-time
706            rendering operation for example.
707 */
708
709 /*! \enum Qt::GUIStyle
710
711     \compat
712
713     \value WindowsStyle
714     \value MotifStyle
715     \value MacStyle
716     \value Win3Style
717     \value PMStyle
718 */
719
720 /*!
721     \enum Qt::UIEffect
722
723     This enum describes the available UI effects.
724
725     By default, Qt will try to use the platform specific desktop
726     settings for each effect. Use the
727     QApplication::setDesktopSettingsAware() function (passing \c false
728     as argument) to prevent this, and the
729     QApplication::setEffectEnabled() to enable or disable a particular
730     effect.
731
732     Note that all effects are disabled on screens running at less than
733     16-bit color depth.
734
735     \omitvalue UI_General
736
737     \value UI_AnimateMenu Show animated menus.
738     \value UI_FadeMenu Show faded menus.
739     \value UI_AnimateCombo Show animated comboboxes.
740     \value UI_AnimateTooltip Show tooltip animations.
741     \value UI_FadeTooltip Show tooltip fading effects.
742     \value UI_AnimateToolBox Reserved
743
744     \sa QApplication::setEffectEnabled(), QApplication::setDesktopSettingsAware()
745 */
746
747 /*! \enum Qt::AspectRatioMode
748
749     This enum type defines what happens to the aspect ratio when
750     scaling an rectangle.
751
752     \image qimage-scaling.png
753
754     \value IgnoreAspectRatio  The size is scaled freely. The aspect
755                               ratio is not preserved.
756     \value KeepAspectRatio  The size is scaled to a rectangle as
757                             large as possible inside a given
758                             rectangle, preserving the aspect ratio.
759     \value KeepAspectRatioByExpanding  The size is scaled to a
760                                        rectangle as small as possible
761                                        outside a given rectangle,
762                                        preserving the aspect ratio.
763
764     \omitvalue ScaleFree
765     \omitvalue ScaleMin
766     \omitvalue ScaleMax
767
768     \sa QSize::scale(), QImage::scaled()
769 */
770
771 /*! \typedef Qt::ScaleMode
772     \compat
773
774     Use Qt::AspectRatioMode instead.
775
776     The enum values have been renamed as follows:
777
778     \table
779     \row \i Old enum value \i New enum value
780     \row \i Qt::ScaleFree  \i Qt::IgnoreAspectRatio
781     \row \i Qt::ScaleMin   \i Qt::KeepAspectRatio
782     \row \i Qt::ScaleMax   \i Qt::KeepAspectRatioByExpanding
783     \endtable
784 */
785
786 /*! \enum Qt::TransformationMode
787
788     This enum type defines whether image transformations (e.g.,
789     scaling) should be smooth or not.
790
791     \value FastTransformation  The transformation is performed
792                                quickly, with no smoothing.
793     \value SmoothTransformation  The resulting image is transformed
794                                  using bilinear filtering.
795
796     \sa QImage::scaled()
797 */
798
799 /*! \enum Qt::Axis
800
801     This enum type defines three values to represent the three
802     axes in the cartesian coordinate system.
803
804     \value XAxis  The X axis.
805     \value YAxis  The Y axis.
806     \value ZAxis  The Z axis.
807
808     \sa QTransform::rotate(), QTransform::rotateRadians()
809  */
810
811 /*!
812     \enum Qt::WidgetAttribute
813
814     \keyword widget attributes
815
816     This enum type is used to specify various widget attributes.
817     Attributes are set and cleared with QWidget::setAttribute(), and
818     queried with QWidget::testAttribute(), although some have special
819     convenience functions which are mentioned below.
820
821     \value WA_AcceptDrops Allows data from drag and drop operations
822     to be dropped onto the widget (see QWidget::setAcceptDrops()).
823
824     \value WA_AlwaysShowToolTips Enables tooltips for inactive windows.
825
826     \value WA_ContentsPropagated This flag is superfluous and
827     obsolete; it no longer has any effect. Since Qt 4.1, all widgets
828     that do not set WA_PaintOnScreen propagate their contents.
829
830     \value WA_CustomWhatsThis Indicates that the widget wants to
831     continue operating normally in "What's This?" mode. This is set by the
832     widget's author.
833
834     \value WA_DeleteOnClose Makes Qt delete this widget when the
835     widget has accepted the close event (see QWidget::closeEvent()).
836
837     \value WA_Disabled Indicates that the widget is disabled, i.e.
838     it does not receive any mouse or keyboard events. There is also a
839     getter functions QWidget::isEnabled().  This is set/cleared by the
840     Qt kernel.
841
842     \value WA_DontShowOnScreen Indicates that the widget is hidden or is
843     not a part of the viewable Desktop.
844
845     \omitvalue WA_DropSiteRegistered
846     \omitvalue WA_ForceAcceptDrops
847
848     \value WA_ForceDisabled Indicates that the widget is
849     explicitly disabled, i.e. it will remain disabled even when all
850     its ancestors are set to the enabled state. This implies
851     WA_Disabled. This is set/cleared by QWidget::setEnabled() and
852     QWidget::setDisabled().
853
854     \value WA_ForceUpdatesDisabled Indicates that updates are
855     explicitly disabled for the widget; i.e. it will remain disabled
856     even when all its ancestors are set to the updates-enabled state.
857     This implies WA_UpdatesDisabled. This is set/cleared by
858     QWidget::setUpdatesEnabled().
859
860     \value WA_GroupLeader
861         \e{This attribute has been deprecated.} Use QWidget::windowModality
862         instead.
863
864     \value WA_Hover Forces Qt to generate paint events when the mouse
865     enters or leaves the widget. This feature is typically used when
866     implementing custom styles; see the \l{widgets/styles}{Styles}
867     example for details.
868
869     \value WA_InputMethodEnabled Enables input methods for Asian languages.
870     Must be set when creating custom text editing widgets.
871     On Windows CE and Symbian this flag can be used in addition to
872     QApplication::autoSipEnabled to automatically display the SIP when
873     entering a widget.
874
875     \value WA_KeyboardFocusChange Set on a toplevel window when
876     the users changes focus with the keyboard (tab, backtab, or shortcut).
877
878     \value WA_KeyCompression Enables key event compression if set,
879     and disables it if not set. By default key compression is off, so
880     widgets receive one key press event for each key press (or more,
881     since autorepeat is usually on). If you turn it on and your
882     program doesn't keep up with key input, Qt may try to compress key
883     events so that more than one character can be processed in each
884     event.
885     For example, a word processor widget might receive 2, 3 or more
886     characters in each QKeyEvent::text(), if the layout recalculation
887     takes too long for the CPU.
888     If a widget supports multiple character unicode input, it is
889     always safe to turn the compression on.
890     Qt performs key event compression only for printable characters.
891     Qt::Modifier keys, cursor movement keys, function keys and
892     miscellaneous action keys (e.g. Escape, Enter, Backspace,
893     PrintScreen) will stop key event compression, even if there are
894     more compressible key events available.
895     Platforms other than Mac and X11 do not support this compression,
896     in which case turning it on will have no effect.
897     This is set/cleared by the widget's author.
898
899     \value WA_LayoutOnEntireRect Indicates that the widget
900     wants QLayout to operate on the entire QWidget::rect(), not only
901     on QWidget::contentsRect(). This is set by the widget's author.
902
903     \value WA_LayoutUsesWidgetRect Ignore the layout item rect from the style
904     when laying out this widget with QLayout. This makes a difference in
905     QMacStyle and QPlastiqueStyle for some widgets.
906
907     \value WA_MacNoClickThrough When a widget that has this attribute set
908     is clicked, and its window is inactive, the click will make the window
909     active but won't be seen by the widget. Typical use of this attribute
910     is on widgets with "destructive" actions, such as a "Delete" button.
911     WA_MacNoClickThrough also applies to all child widgets of the widget
912     that has it set.
913
914     \value WA_MacOpaqueSizeGrip Indicates that the native Carbon size grip
915     should be opaque instead of transparent (the default). This attribute
916     is only applicable to Mac OS X and is set by the widget's author.
917
918     \value WA_MacShowFocusRect Indicates that this widget should get a
919     QFocusFrame around it. Some widgets draw their own focus halo
920     regardless of this attribute. Not that the QWidget::focusPolicy
921     also plays the main role in whether something is given focus or
922     not, this only controls whether or not this gets the focus
923     frame. This attribute is only applicable to Mac OS X.
924
925     \value WA_MacNormalSize Indicates the widget should have the
926     normal size for widgets in Mac OS X. This attribute is only
927     applicable to Mac OS X.
928
929     \value WA_MacSmallSize Indicates the widget should have the small
930     size for widgets in Mac OS X. This attribute is only applicable to
931     Mac OS X.
932
933     \value WA_MacMiniSize Indicates the widget should have the mini
934     size for widgets in Mac OS X. This attribute is only applicable to
935     Mac OS X.
936
937     \value WA_MacVariableSize Indicates the widget can choose between
938     alternative sizes for widgets to avoid clipping.
939     This attribute is only applicable to Mac OS X.
940
941     \value WA_MacBrushedMetal Indicates the widget should be drawn in
942     the brushed metal style as supported by the windowing system. This
943     attribute is only applicable to Mac OS X.
944
945     \omitvalue WA_MacMetalStyle
946
947     \value WA_Mapped Indicates that the widget is mapped on screen.
948     This is set/cleared by the Qt kernel.
949
950     \value WA_MouseNoMask Makes the widget receive mouse events for
951     the entire widget regardless of the currently set mask,
952     overriding QWidget::setMask(). This is not applicable for
953     top-level windows.
954
955     \value WA_MouseTracking Indicates that the widget has mouse
956     tracking enabled. See QWidget::mouseTracking.
957
958     \value WA_Moved Indicates that the widget has an explicit
959     position. This is set/cleared by QWidget::move() and
960     by QWidget::setGeometry().
961
962     \value WA_MSWindowsUseDirect3D This value is obsolete and has no
963     effect.
964
965     \value WA_NoBackground This value is obsolete. Use
966     WA_OpaquePaintEvent instead.
967
968     \value WA_NoChildEventsForParent Indicates that the widget does
969     not want ChildAdded or ChildRemoved events sent to its
970     parent. This is rarely necessary but can help to avoid automatic
971     insertion widgets like splitters and layouts. This is set by a
972     widget's author.
973
974     \value WA_NoChildEventsFromChildren Indicates that the widget does
975     not want to receive ChildAdded or ChildRemoved events sent from its
976     children. This is set by a widget's author.
977
978     \value WA_NoMouseReplay Used for pop-up widgets. Indicates that the most
979     recent mouse press event should not be replayed when the pop-up widget
980     closes. The flag is set by the widget's author and cleared by the Qt kernel
981     every time the widget receives a new mouse event.
982
983     \value WA_NoMousePropagation Prohibits mouse events from being propagated
984     to the widget's parent. This attribute is disabled by default.
985
986     \value WA_TransparentForMouseEvents When enabled, this attribute disables
987     the delivery of mouse events to the widget and its children. Mouse events
988     are delivered to other widgets as if the widget and its children were not
989     present in the widget hierarchy; mouse clicks and other events effectively
990     "pass through" them. This attribute is disabled by default.
991
992     \value WA_NoSystemBackground Indicates that the widget has no background,
993     i.e. when the widget receives paint events, the background is not
994     automatically repainted. \note Unlike WA_OpaquePaintEvent, newly exposed
995     areas are \bold never filled with the background (e.g., after showing a
996     window for the first time the user can see "through" it until the
997     application processes the paint events). This flag is set or cleared by the
998     widget's author.
999
1000     \value WA_OpaquePaintEvent Indicates that the widget paints all its pixels
1001     when it receives a paint event. Thus, it is not required for operations
1002     like updating, resizing, scrolling and focus changes to erase the widget
1003     before generating paint events. The use of WA_OpaquePaintEvent provides a
1004     small optimization by helping to reduce flicker on systems that do not
1005     support double buffering and avoiding computational cycles necessary to
1006     erase the background prior to painting. \note Unlike
1007     WA_NoSystemBackground, WA_OpaquePaintEvent makes an effort to avoid
1008     transparent window backgrounds. This flag is set or cleared by the widget's
1009     author.
1010
1011     \value WA_OutsideWSRange Indicates that the widget is outside
1012     the valid range of the window system's coordinate system. A widget
1013     outside the valid range cannot be mapped on screen. This is
1014     set/cleared by the Qt kernel.
1015
1016     \value WA_PaintOnScreen Indicates that the widget wants to draw directly
1017     onto the screen. Widgets with this attribute set do not participate in
1018     composition management, i.e. they cannot be semi-transparent or shine
1019     through semi-transparent overlapping widgets. \note This flag is only
1020     supported on X11 and it disables double buffering. On Qt for Embedded
1021     Linux, the flag only works when set on a top-level widget and it relies on
1022     support from the active screen driver. This flag is set or cleared by the
1023     widget's author. To render outside of Qt's paint system, e.g., if you
1024     require native painting primitives, you need to reimplement
1025     QWidget::paintEngine() to return 0 and set this flag.
1026
1027     \value WA_PaintOutsidePaintEvent Makes it possible to use QPainter to
1028     paint on the widget outside \l{QWidget::paintEvent()}{paintEvent()}. This
1029     flag is not supported on Windows, Mac OS X or Embedded Linux. We recommend
1030     that you use it only when porting Qt 3 code to Qt 4.
1031
1032     \value WA_PaintUnclipped Makes all painters operating on this widget
1033     unclipped. Children of this widget or other widgets in front of it do not
1034     clip the area the painter can paint on. This flag is only supported for
1035     widgets with the WA_PaintOnScreen flag set. The preferred way to do this in
1036     a cross platform way is to create a transparent widget that lies in front
1037     of the other widgets.
1038
1039     \value WA_PendingMoveEvent Indicates that a move event is pending, e.g.,
1040     when a hidden widget was moved. This flag is set or cleared by the Qt
1041     kernel.
1042
1043     \value WA_PendingResizeEvent Indicates that a resize event is pending,
1044     e.g., when a hidden widget was resized. This flag is set or cleared by the
1045     Qt kernel.
1046
1047     \value WA_QuitOnClose Makes Qt quit the application when the last widget
1048     with the attribute set has accepted closeEvent(). This behavior can be
1049     modified with the QApplication::quitOnLastWindowClosed property. By default
1050     this attribute is set for all widgets of type Qt::Window.
1051
1052     \value WA_Resized Indicates that the widget has an explicit size. This flag
1053     is set or cleared by QWidget::resize() and QWidget::setGeometry().
1054
1055     \value WA_RightToLeft Indicates that the layout direction for the widget
1056     is right to left.
1057
1058     \value WA_SetCursor Indicates that the widget has a cursor of its own. This
1059     flag is set or cleared by QWidget::setCursor() and QWidget::unsetCursor().
1060
1061     \value WA_SetFont Indicates that the widget has a font of its own. This
1062     flag is set or cleared by QWidget::setFont().
1063
1064     \value WA_SetPalette Indicates that the widget has a palette of its own.
1065     This flag is set or cleared by QWidget::setPalette().
1066
1067     \value WA_SetStyle Indicates that the widget has a style of its own. This
1068     flag is set or cleared by QWidget::setStyle().
1069
1070     \value WA_ShowModal \e{This attribute has been deprecated.} Use
1071     QWidget::windowModality instead.
1072
1073     \value WA_StaticContents Indicates that the widget contents are north-west
1074     aligned and static. On resize, such a widget will receive paint events only
1075     for parts of itself that are newly visible. This flag is set or cleared by
1076     the widget's author.
1077
1078     \value WA_StyleSheet Indicates that the widget is styled using a
1079     \l{Qt Style Sheets}{style sheet}.
1080
1081     \value WA_TranslucentBackground Indicates that the widget should have a
1082     translucent background, i.e., any non-opaque regions of the widgets will be
1083     translucent because the widget will have an alpha channel. Setting this
1084     flag causes WA_NoSystemBackground to be set. On Windows the
1085     widget also needs the Qt::FramelessWindowHint window flag to be set.
1086     This flag is set or cleared by the widget's author.
1087
1088     \value WA_UnderMouse Indicates that the widget is under the mouse cursor.
1089     The value is not updated correctly during drag and drop operations. There
1090     is also a getter function, QWidget::underMouse(). This flag is set or
1091     cleared by the Qt kernel.
1092
1093     \value WA_UpdatesDisabled Indicates that updates are blocked (including the
1094     system background). This flag is set or cleared by the Qt kernel.
1095     \warning This flag must \e never be set or cleared by the widget's author.
1096
1097     \value WA_WindowModified Indicates that the window is marked as modified.
1098     On some platforms this flag will do nothing, on others (including Mac OS X
1099     and Windows) the window will take a modified appearance. This flag is set
1100     or cleared by QWidget::setWindowModified().
1101
1102     \value WA_WindowPropagation Makes a toplevel window inherit font and
1103     palette from its parent.
1104
1105     \value WA_MacAlwaysShowToolWindow On Mac OS X, show the tool window even
1106     when the application is not active.  By default, all tool windows are
1107     hidden when the application is inactive.
1108
1109     \value WA_SetLocale Indicates the locale should be taken into consideration
1110     in the widget.
1111
1112     \value WA_StyledBackground Indicates the widget should be drawn using a
1113     styled background.
1114
1115     \value WA_ShowWithoutActivating Show the widget without making it active.
1116
1117     \value WA_NativeWindow Indicates that a native window is created for the
1118     widget. Enabling this flag will also force a native window for the widget's
1119     ancestors unless Qt::WA_DontCreateNativeAncestors is set.
1120
1121     \value WA_DontCreateNativeAncestors Indicates that the widget's ancestors
1122     are kept non-native even though the widget itself is native.
1123
1124     \value WA_X11NetWmWindowTypeDesktop Adds _NET_WM_WINDOW_TYPE_DESKTOP to the
1125     window's _NET_WM_WINDOW_TYPE X11 window property. See
1126     http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1127     has no effect on non-X11 platforms.
1128
1129     \value WA_X11NetWmWindowTypeDock Adds _NET_WM_WINDOW_TYPE_DOCK to the
1130     window's _NET_WM_WINDOW_TYPE X11 window property. See
1131     http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1132     has no effect on non-X11 platforms.
1133
1134     \value WA_X11NetWmWindowTypeToolBar Adds _NET_WM_WINDOW_TYPE_TOOLBAR to the
1135     window's _NET_WM_WINDOW_TYPE X11 window property. See
1136     http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1137     has no effect on non-X11 platforms. \note Qt automaticaly sets this
1138     attribute for QToolBar.
1139
1140     \value WA_X11NetWmWindowTypeMenu Adds _NET_WM_WINDOW_TYPE_MENU to the
1141     window's _NET_WM_WINDOW_TYPE X11 window property. See
1142     http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1143     has no effect on non-X11 platforms. \note Qt automatically sets this
1144     attribute for QMenu when torn-off.
1145
1146     \value WA_X11NetWmWindowTypeUtility Adds _NET_WM_WINDOW_TYPE_UTILITY to the
1147     window's _NET_WM_WINDOW_TYPE X11 window property. See
1148     http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1149     has no effect on non-X11 platforms. \note Qt automatically sets this
1150     attribute for the Qt::Tool window type.
1151
1152     \value WA_X11NetWmWindowTypeSplash Adds _NET_WM_WINDOW_TYPE_SPLASH to the
1153     window's _NET_WM_WINDOW_TYPE X11 window property. See
1154     http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1155     has no effect on non-X11 platforms. \note Qt automatically sets this
1156     attribute for the Qt::SplashScreen window type.
1157
1158     \value WA_X11NetWmWindowTypeDialog Adds _NET_WM_WINDOW_TYPE_DIALOG
1159     to the window's _NET_WM_WINDOW_TYPE X11 window property. See
1160     http://standards.freedesktop.org/wm-spec/ for more details. This
1161     attribute has no effect on non-X11 platforms. \note Qt automatically sets
1162     this attribute for the Qt::Dialog and Qt::Sheet window types.
1163
1164     \value WA_X11NetWmWindowTypeDropDownMenu Adds
1165     _NET_WM_WINDOW_TYPE_DROPDOWN_MENU to the window's
1166     _NET_WM_WINDOW_TYPE X11 window property. See
1167     http://standards.freedesktop.org/wm-spec/ for more details. This
1168     attribute has no effect on non-X11 platforms. \note Qt
1169     automatically sets this attribute for QMenus added to a QMenuBar.
1170
1171     \value WA_X11NetWmWindowTypePopupMenu Adds _NET_WM_WINDOW_TYPE_POPUP_MENU
1172     to the window's _NET_WM_WINDOW_TYPE X11 window property. See
1173     http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1174     has no effect on non-X11 platforms. \note Qt automatically sets this
1175     attribute for QMenu.
1176
1177     \value WA_X11NetWmWindowTypeToolTip Adds _NET_WM_WINDOW_TYPE_TOOLTIP to the
1178     window's _NET_WM_WINDOW_TYPE X11 window property. See
1179     http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1180     has no effect on non-X11 platforms. \note Qt automatically sets this
1181     attribute for the Qt::ToolTip window type.
1182
1183     \value WA_X11NetWmWindowTypeNotification Adds
1184     _NET_WM_WINDOW_TYPE_NOTIFICATION to the window's _NET_WM_WINDOW_TYPE X11
1185     window property. See http://standards.freedesktop.org/wm-spec/ for more
1186     details. This attribute has no effect on non-X11 platforms.
1187
1188     \value WA_X11NetWmWindowTypeCombo Adds _NET_WM_WINDOW_TYPE_COMBO
1189     to the window's _NET_WM_WINDOW_TYPE X11 window property. See
1190     http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1191     has no effect on non-X11 platforms. \note Qt automatically sets this
1192     attribute for the QComboBox pop-up.
1193
1194     \value WA_X11NetWmWindowTypeDND Adds _NET_WM_WINDOW_TYPE_DND to
1195     the window's _NET_WM_WINDOW_TYPE X11 window property. See
1196     http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1197     has no effect on non-X11 platforms. \note Qt automatically sets this
1198     attribute on the feedback widget used during a drag.
1199
1200     \value WA_MacFrameworkScaled Enables resolution independence aware mode
1201     on Mac when using Carbon. This attribute has no effect on Cocoa.
1202     The attribute is off by default and can be enabled on a per-window basis.
1203
1204     \value WA_AcceptTouchEvents Allows touch events (see QTouchEvent)
1205     to be sent to the widget. Must be set on all widgets that can
1206     handle touch events. Without this attribute set, events from a
1207     touch device will be sent as mouse events.
1208
1209     \value WA_TouchPadAcceptSingleTouchEvents Allows touchpad single
1210     touch events to be sent to the widget.
1211
1212     \value WA_MergeSoftkeys Allows widget to merge softkeys with parent widget,
1213     i.e. widget can set only one softkeys and request softkey implementation
1214     to take rest of the softkeys from the parent. Note parents are traversed until
1215     WA_MergeSoftkeys is not set. See also Qt::WA_MergeSoftkeysRecursively
1216     This attribute currently has effect only on Symbian platforms
1217
1218     \value WA_MergeSoftkeysRecursively Allows widget to merge softkeys recursively
1219     with all parents. If this attribute is set, the widget parents are traversed until
1220     window boundary (widget without parent or dialog) is found.
1221     This attribute currently has effect only on Symbian platforms
1222
1223     \value WA_X11DoNotAcceptFocus Asks the window manager to not give focus
1224     to this top level window. This attribute has no effect on non-X11
1225     platforms.
1226
1227     \value WA_LockPortraitOrientation Locks the widget to a portrait orientation,
1228     ignoring changes to the display's orientation with respect to the user.
1229     \value WA_LockLandscapeOrientation Locks the widget to a landscape orientation,
1230     ignoring changes to the display's orientation with respect to the user.
1231     \value WA_AutoOrientation Causes the widget to change orientation whenever the
1232     display changes orientation with respect to the user.
1233     
1234     \value WA_MacNoShadow Since Qt 4.8, this attribute disables drop shadows
1235     for this top level window. Only affects Cocoa builds of Qt for Mac OS X.
1236
1237     \omitvalue WA_SetLayoutDirection
1238     \omitvalue WA_InputMethodTransparent
1239     \omitvalue WA_WState_CompressKeys
1240     \omitvalue WA_WState_ConfigPending
1241     \omitvalue WA_WState_Created
1242     \omitvalue WA_WState_DND
1243     \omitvalue WA_WState_ExplicitShowHide
1244     \omitvalue WA_WState_Hidden
1245     \omitvalue WA_WState_InPaintEvent
1246     \omitvalue WA_WState_OwnSizePolicy
1247     \omitvalue WA_WState_Polished
1248     \omitvalue WA_WState_Reparented
1249     \omitvalue WA_WState_Visible
1250     \omitvalue WA_SetWindowIcon
1251     \omitvalue WA_PendingUpdate
1252     \omitvalue WA_LaidOut
1253     \omitvalue WA_GrabbedShortcut
1254     \omitvalue WA_DontShowOnScreen
1255     \omitvalue WA_InvalidSize
1256     \omitvalue WA_ForceUpdatesDisabled
1257     \omitvalue WA_NoX11EventCompression
1258     \omitvalue WA_TintedBackground
1259     \omitvalue WA_X11OpenGLOverlay
1260     \omitvalue WA_CanHostQMdiSubWindowTitleBar
1261     \omitvalue WA_AttributeCount
1262     \omitvalue WA_StyleSheet
1263     \omitvalue WA_X11BypassTransientForHint
1264     \omitvalue WA_SetWindowModality
1265     \omitvalue WA_WState_WindowOpacitySet
1266     \omitvalue WA_WState_AcceptedTouchBeginEvent
1267     \omitvalue WA_SymbianNoSystemRotation
1268 */
1269
1270 /*! \typedef Qt::HANDLE
1271
1272     Platform-specific handle type for system objects. This is
1273     equivalent to \c{void *} on Mac OS X and embedded Linux,
1274     and to \c{unsigned long} on X11. On Windows it is the
1275     DWORD returned by the Win32 function getCurrentThreadId().
1276
1277     \warning Using this type is not portable.
1278 */
1279
1280 /*!
1281     \enum Qt::Key
1282
1283     The key names used by Qt.
1284
1285     \value Key_Escape
1286     \value Key_Tab
1287     \value Key_Backtab
1288     \omitvalue Key_BackTab
1289     \value Key_Backspace
1290     \omitvalue Key_BackSpace
1291     \value Key_Return
1292     \value Key_Enter     Typically located on the keypad.
1293     \value Key_Insert
1294     \value Key_Delete
1295     \value Key_Pause    The Pause/Break key (\note Not anything to do with pausing media)
1296     \value Key_Print
1297     \value Key_SysReq
1298     \value Key_Clear
1299     \value Key_Home
1300     \value Key_End
1301     \value Key_Left
1302     \value Key_Up
1303     \value Key_Right
1304     \value Key_Down
1305     \value Key_PageUp
1306     \omitvalue Key_Prior
1307     \value Key_PageDown
1308     \omitvalue Key_Next
1309     \value Key_Shift
1310     \value Key_Control    On Mac OS X, this corresponds to the Command keys.
1311     \value Key_Meta       On Mac OS X, this corresponds to the Control keys.
1312                           On Windows keyboards, this key is mapped to the
1313                           Windows key.
1314     \value Key_Alt
1315     \value Key_AltGr      On Windows, when the KeyDown event for this key is
1316                           sent, the Ctrl+Alt modifiers are also set.
1317     \value Key_CapsLock
1318     \value Key_NumLock
1319     \value Key_ScrollLock
1320     \value Key_F1
1321     \value Key_F2
1322     \value Key_F3
1323     \value Key_F4
1324     \value Key_F5
1325     \value Key_F6
1326     \value Key_F7
1327     \value Key_F8
1328     \value Key_F9
1329     \value Key_F10
1330     \value Key_F11
1331     \value Key_F12
1332     \value Key_F13
1333     \value Key_F14
1334     \value Key_F15
1335     \value Key_F16
1336     \value Key_F17
1337     \value Key_F18
1338     \value Key_F19
1339     \value Key_F20
1340     \value Key_F21
1341     \value Key_F22
1342     \value Key_F23
1343     \value Key_F24
1344     \value Key_F25
1345     \value Key_F26
1346     \value Key_F27
1347     \value Key_F28
1348     \value Key_F29
1349     \value Key_F30
1350     \value Key_F31
1351     \value Key_F32
1352     \value Key_F33
1353     \value Key_F34
1354     \value Key_F35
1355     \value Key_Super_L
1356     \value Key_Super_R
1357     \value Key_Menu
1358     \value Key_Hyper_L
1359     \value Key_Hyper_R
1360     \value Key_Help
1361     \value Key_Direction_L
1362     \value Key_Direction_R
1363     \value Key_Space
1364     \value Key_Any
1365     \value Key_Exclam
1366     \value Key_QuoteDbl
1367     \value Key_NumberSign
1368     \value Key_Dollar
1369     \value Key_Percent
1370     \value Key_Ampersand
1371     \value Key_Apostrophe
1372     \value Key_ParenLeft
1373     \value Key_ParenRight
1374     \value Key_Asterisk
1375     \value Key_Plus
1376     \value Key_Comma
1377     \value Key_Minus
1378     \value Key_Period
1379     \value Key_Slash
1380     \value Key_0
1381     \value Key_1
1382     \value Key_2
1383     \value Key_3
1384     \value Key_4
1385     \value Key_5
1386     \value Key_6
1387     \value Key_7
1388     \value Key_8
1389     \value Key_9
1390     \value Key_Colon
1391     \value Key_Semicolon
1392     \value Key_Less
1393     \value Key_Equal
1394     \value Key_Greater
1395     \value Key_Question
1396     \value Key_At
1397     \value Key_A
1398     \value Key_B
1399     \value Key_C
1400     \value Key_D
1401     \value Key_E
1402     \value Key_F
1403     \value Key_G
1404     \value Key_H
1405     \value Key_I
1406     \value Key_J
1407     \value Key_K
1408     \value Key_L
1409     \value Key_M
1410     \value Key_N
1411     \value Key_O
1412     \value Key_P
1413     \value Key_Q
1414     \value Key_R
1415     \value Key_S
1416     \value Key_T
1417     \value Key_U
1418     \value Key_V
1419     \value Key_W
1420     \value Key_X
1421     \value Key_Y
1422     \value Key_Z
1423     \value Key_BracketLeft
1424     \value Key_Backslash
1425     \value Key_BracketRight
1426     \value Key_AsciiCircum
1427     \value Key_Underscore
1428     \value Key_QuoteLeft
1429     \value Key_BraceLeft
1430     \value Key_Bar
1431     \value Key_BraceRight
1432     \value Key_AsciiTilde
1433     \value Key_nobreakspace
1434     \value Key_exclamdown
1435     \value Key_cent
1436     \value Key_sterling
1437     \value Key_currency
1438     \value Key_yen
1439     \value Key_brokenbar
1440     \value Key_section
1441     \value Key_diaeresis
1442     \value Key_copyright
1443     \value Key_ordfeminine
1444     \value Key_guillemotleft
1445     \value Key_notsign
1446     \value Key_hyphen
1447     \value Key_registered
1448     \value Key_macron
1449     \value Key_degree
1450     \value Key_plusminus
1451     \value Key_twosuperior
1452     \value Key_threesuperior
1453     \value Key_acute
1454     \value Key_mu
1455     \value Key_paragraph
1456     \value Key_periodcentered
1457     \value Key_cedilla
1458     \value Key_onesuperior
1459     \value Key_masculine
1460     \value Key_guillemotright
1461     \value Key_onequarter
1462     \value Key_onehalf
1463     \value Key_threequarters
1464     \value Key_questiondown
1465     \value Key_Agrave
1466     \value Key_Aacute
1467     \value Key_Acircumflex
1468     \value Key_Atilde
1469     \value Key_Adiaeresis
1470     \value Key_Aring
1471     \value Key_AE
1472     \value Key_Ccedilla
1473     \value Key_Egrave
1474     \value Key_Eacute
1475     \value Key_Ecircumflex
1476     \value Key_Ediaeresis
1477     \value Key_Igrave
1478     \value Key_Iacute
1479     \value Key_Icircumflex
1480     \value Key_Idiaeresis
1481     \value Key_ETH
1482     \value Key_Ntilde
1483     \value Key_Ograve
1484     \value Key_Oacute
1485     \value Key_Ocircumflex
1486     \value Key_Otilde
1487     \value Key_Odiaeresis
1488     \value Key_multiply
1489     \value Key_Ooblique
1490     \value Key_Ugrave
1491     \value Key_Uacute
1492     \value Key_Ucircumflex
1493     \value Key_Udiaeresis
1494     \value Key_Yacute
1495     \value Key_THORN
1496     \value Key_ssharp
1497     \omitvalue Key_agrave
1498     \omitvalue Key_aacute
1499     \omitvalue Key_acircumflex
1500     \omitvalue Key_atilde
1501     \omitvalue Key_adiaeresis
1502     \omitvalue Key_aring
1503     \omitvalue Key_ae
1504     \omitvalue Key_ccedilla
1505     \omitvalue Key_egrave
1506     \omitvalue Key_eacute
1507     \omitvalue Key_ecircumflex
1508     \omitvalue Key_ediaeresis
1509     \omitvalue Key_igrave
1510     \omitvalue Key_iacute
1511     \omitvalue Key_icircumflex
1512     \omitvalue Key_idiaeresis
1513     \omitvalue Key_eth
1514     \omitvalue Key_ntilde
1515     \omitvalue Key_ograve
1516     \omitvalue Key_oacute
1517     \omitvalue Key_ocircumflex
1518     \omitvalue Key_otilde
1519     \omitvalue Key_odiaeresis
1520     \value Key_division
1521     \omitvalue Key_oslash
1522     \omitvalue Key_ugrave
1523     \omitvalue Key_uacute
1524     \omitvalue Key_ucircumflex
1525     \omitvalue Key_udiaeresis
1526     \omitvalue Key_yacute
1527     \omitvalue Key_thorn
1528     \value Key_ydiaeresis
1529     \value Key_Multi_key
1530     \value Key_Codeinput
1531     \value Key_SingleCandidate
1532     \value Key_MultipleCandidate
1533     \value Key_PreviousCandidate
1534     \value Key_Mode_switch
1535     \value Key_Kanji
1536     \value Key_Muhenkan
1537     \value Key_Henkan
1538     \value Key_Romaji
1539     \value Key_Hiragana
1540     \value Key_Katakana
1541     \value Key_Hiragana_Katakana
1542     \value Key_Zenkaku
1543     \value Key_Hankaku
1544     \value Key_Zenkaku_Hankaku
1545     \value Key_Touroku
1546     \value Key_Massyo
1547     \value Key_Kana_Lock
1548     \value Key_Kana_Shift
1549     \value Key_Eisu_Shift
1550     \value Key_Eisu_toggle
1551     \value Key_Hangul
1552     \value Key_Hangul_Start
1553     \value Key_Hangul_End
1554     \value Key_Hangul_Hanja
1555     \value Key_Hangul_Jamo
1556     \value Key_Hangul_Romaja
1557     \value Key_Hangul_Jeonja
1558     \value Key_Hangul_Banja
1559     \value Key_Hangul_PreHanja
1560     \value Key_Hangul_PostHanja
1561     \value Key_Hangul_Special
1562     \value Key_Dead_Grave
1563     \value Key_Dead_Acute
1564     \value Key_Dead_Circumflex
1565     \value Key_Dead_Tilde
1566     \value Key_Dead_Macron
1567     \value Key_Dead_Breve
1568     \value Key_Dead_Abovedot
1569     \value Key_Dead_Diaeresis
1570     \value Key_Dead_Abovering
1571     \value Key_Dead_Doubleacute
1572     \value Key_Dead_Caron
1573     \value Key_Dead_Cedilla
1574     \value Key_Dead_Ogonek
1575     \value Key_Dead_Iota
1576     \value Key_Dead_Voiced_Sound
1577     \value Key_Dead_Semivoiced_Sound
1578     \value Key_Dead_Belowdot
1579     \value Key_Dead_Hook
1580     \value Key_Dead_Horn
1581     \value Key_Back
1582     \value Key_Forward
1583     \value Key_Stop
1584     \value Key_Refresh
1585     \value Key_VolumeDown
1586     \value Key_VolumeMute
1587     \value Key_VolumeUp
1588     \value Key_BassBoost
1589     \value Key_BassUp
1590     \value Key_BassDown
1591     \value Key_TrebleUp
1592     \value Key_TrebleDown
1593     \value Key_MediaPlay    A key setting the state of the media player to play
1594     \value Key_MediaStop    A key setting the state of the media player to stop
1595     \value Key_MediaPrevious
1596     \omitvalue Key_MediaPrev
1597     \value Key_MediaNext
1598     \value Key_MediaRecord
1599     \value Key_MediaPause   A key setting the state of the media player to pause (\note not the pause/break key)
1600     \value Key_MediaTogglePlayPause   A key to toggle the play/pause state in the media player (rather than setting an absolute state)
1601     \value Key_HomePage
1602     \value Key_Favorites
1603     \value Key_Search
1604     \value Key_Standby
1605     \value Key_OpenUrl
1606     \value Key_LaunchMail
1607     \value Key_LaunchMedia
1608     \value Key_Launch0 On X11 this key is mapped to "My Computer" (XF86XK_MyComputer) key for legacy reasons.
1609     \value Key_Launch1 On X11 this key is mapped to "Calculator" (XF86XK_Calculator) key for legacy reasons.
1610     \value Key_Launch2 On X11 this key is mapped to XF86XK_Launch0 key for legacy reasons.
1611     \value Key_Launch3 On X11 this key is mapped to XF86XK_Launch1 key for legacy reasons.
1612     \value Key_Launch4 On X11 this key is mapped to XF86XK_Launch2 key for legacy reasons.
1613     \value Key_Launch5 On X11 this key is mapped to XF86XK_Launch3 key for legacy reasons.
1614     \value Key_Launch6 On X11 this key is mapped to XF86XK_Launch4 key for legacy reasons.
1615     \value Key_Launch7 On X11 this key is mapped to XF86XK_Launch5 key for legacy reasons.
1616     \value Key_Launch8 On X11 this key is mapped to XF86XK_Launch6 key for legacy reasons.
1617     \value Key_Launch9 On X11 this key is mapped to XF86XK_Launch7 key for legacy reasons.
1618     \value Key_LaunchA On X11 this key is mapped to XF86XK_Launch8 key for legacy reasons.
1619     \value Key_LaunchB On X11 this key is mapped to XF86XK_Launch9 key for legacy reasons.
1620     \value Key_LaunchC On X11 this key is mapped to XF86XK_LaunchA key for legacy reasons.
1621     \value Key_LaunchD On X11 this key is mapped to XF86XK_LaunchB key for legacy reasons.
1622     \value Key_LaunchE On X11 this key is mapped to XF86XK_LaunchC key for legacy reasons.
1623     \value Key_LaunchF On X11 this key is mapped to XF86XK_LaunchD key for legacy reasons.
1624     \value Key_LaunchG On X11 this key is mapped to XF86XK_LaunchE key for legacy reasons.
1625     \value Key_LaunchH On X11 this key is mapped to XF86XK_LaunchF key for legacy reasons.
1626     \value Key_MonBrightnessUp
1627     \value Key_MonBrightnessDown
1628     \value Key_KeyboardLightOnOff
1629     \value Key_KeyboardBrightnessUp
1630     \value Key_KeyboardBrightnessDown
1631     \value Key_PowerOff
1632     \value Key_WakeUp
1633     \value Key_Eject
1634     \value Key_ScreenSaver
1635     \value Key_WWW
1636     \value Key_Memo
1637     \value Key_LightBulb
1638     \value Key_Shop
1639     \value Key_History
1640     \value Key_AddFavorite
1641     \value Key_HotLinks
1642     \value Key_BrightnessAdjust
1643     \value Key_Finance
1644     \value Key_Community
1645     \value Key_AudioRewind
1646     \value Key_BackForward
1647     \value Key_ApplicationLeft
1648     \value Key_ApplicationRight
1649     \value Key_Book
1650     \value Key_CD
1651     \value Key_Calculator On X11 this key is not mapped for legacy reasons. Use Qt::Key_Launch1 instead.
1652     \value Key_ToDoList
1653     \value Key_ClearGrab
1654     \value Key_Close
1655     \value Key_Copy
1656     \value Key_Cut
1657     \value Key_Display
1658     \value Key_DOS
1659     \value Key_Documents
1660     \value Key_Excel
1661     \value Key_Explorer
1662     \value Key_Game
1663     \value Key_Go
1664     \value Key_iTouch
1665     \value Key_LogOff
1666     \value Key_Market
1667     \value Key_Meeting
1668     \value Key_MenuKB
1669     \value Key_MenuPB
1670     \value Key_MySites
1671     \value Key_News
1672     \value Key_OfficeHome
1673     \value Key_Option
1674     \value Key_Paste
1675     \value Key_Phone
1676     \value Key_Calendar
1677     \value Key_Reply
1678     \value Key_Reload
1679     \value Key_RotateWindows
1680     \value Key_RotationPB
1681     \value Key_RotationKB
1682     \value Key_Save
1683     \value Key_Send
1684     \value Key_Spell
1685     \value Key_SplitScreen
1686     \value Key_Support
1687     \value Key_TaskPane
1688     \value Key_Terminal
1689     \value Key_Tools
1690     \value Key_Travel
1691     \value Key_Video
1692     \value Key_Word
1693     \value Key_Xfer
1694     \value Key_ZoomIn
1695     \value Key_ZoomOut
1696     \value Key_Away
1697     \value Key_Messenger
1698     \value Key_WebCam
1699     \value Key_MailForward
1700     \value Key_Pictures
1701     \value Key_Music
1702     \value Key_Battery
1703     \value Key_Bluetooth
1704     \value Key_WLAN
1705     \value Key_UWB
1706     \value Key_AudioForward
1707     \value Key_AudioRepeat
1708     \value Key_AudioRandomPlay
1709     \value Key_Subtitle
1710     \value Key_AudioCycleTrack
1711     \value Key_Time
1712     \value Key_Hibernate
1713     \value Key_View
1714     \value Key_TopMenu
1715     \value Key_PowerDown
1716     \value Key_Suspend
1717     \value Key_ContrastAdjust
1718     \value Key_MediaLast
1719     \value Key_unknown
1720
1721     \value Key_Call     A key to answer or initiate a call (see Qt::Key_ToggleCallHangup for a key to toggle current call state)
1722     \value Key_Camera   A key to activate the camera shutter
1723     \value Key_CameraFocus  A key to focus the camera
1724     \value Key_Context1
1725     \value Key_Context2
1726     \value Key_Context3
1727     \value Key_Context4
1728     \value Key_Flip
1729     \value Key_Hangup   A key to end an ongoing call (see Qt::Key_ToggleCallHangup for a key to toggle current call state)
1730     \value Key_No
1731     \value Key_Select
1732     \value Key_Yes
1733     \value Key_ToggleCallHangup A key to toggle the current call state (ie. either answer, or hangup) depending on current call state
1734     \value Key_VoiceDial
1735     \value Key_LastNumberRedial
1736
1737     \value Key_Execute
1738     \value Key_Printer
1739     \value Key_Play
1740     \value Key_Sleep
1741     \value Key_Zoom
1742     \value Key_Cancel
1743
1744     \sa QKeyEvent::key()
1745 */
1746
1747 /*!
1748     \enum Qt::HitTestAccuracy
1749
1750     This enum contains the types of accuracy that can be used by the
1751     QTextDocument class when testing for mouse clicks on text documents.
1752
1753     \value ExactHit The point at which input occurred must coincide
1754                     exactly with input-sensitive parts of the document.
1755     \value FuzzyHit The point at which input occurred can lie close to
1756                     input-sensitive parts of the document.
1757
1758     This enum is defined in the \c <QTextDocument> header file.
1759 */
1760
1761 /*!
1762     \enum Qt::WhiteSpaceMode
1763
1764     This enum describes the types of whitespace mode that are used by
1765     the QTextDocument class to meet the requirements of different kinds
1766     of textual information.
1767
1768     \value WhiteSpaceNormal         The whitespace mode used to display
1769                                     normal word wrapped text in paragraphs.
1770     \value WhiteSpacePre            A preformatted text mode in which
1771                                     whitespace is reproduced exactly.
1772     \value WhiteSpaceNoWrap
1773
1774     \omitvalue WhiteSpaceModeUndefined
1775
1776     This enum is defined in the \c <QTextDocument> header file.
1777 */
1778
1779 /*!
1780     \enum Qt::ButtonState_enum
1781     \compat
1782     \value ShiftButton
1783     \value ControlButton
1784     \value AltButton
1785     \value MetaButton
1786     \value Keypad
1787     \value KeyButtonMask
1788
1789     Use Qt::KeyboardModifier instead.
1790 */
1791
1792 /*!
1793     \typedef Qt::ButtonState
1794     \compat
1795
1796     Use Qt::KeyboardModifier instead.
1797 */
1798
1799 /*!
1800     \enum Qt::CheckState
1801
1802     This enum describes the state of checkable items, controls, and widgets.
1803
1804     \value Unchecked        The item is unchecked.
1805     \value PartiallyChecked The item is partially checked. Items in hierarchical models
1806                             may be partially checked if some, but not all, of their
1807                             children are checked.
1808     \value Checked          The item is checked.
1809
1810     \sa QCheckBox, Qt::ItemFlags, Qt::ItemDataRole
1811 */
1812
1813
1814 /*!
1815     \enum Qt::ToolButtonStyle
1816
1817     The style of the tool button, describing how the button's text and
1818     icon should be displayed.
1819
1820     \value ToolButtonIconOnly Only display the icon.
1821     \value ToolButtonTextOnly Only display the text.
1822     \value ToolButtonTextBesideIcon The text appears beside the icon.
1823     \value ToolButtonTextUnderIcon The text appears under the icon.
1824     \value ToolButtonFollowStyle Follow the \l{QStyle::SH_ToolButtonStyle}{style}.
1825 */
1826
1827 /*!
1828     \enum Qt::Corner
1829
1830     This enum type specifies a corner in a rectangle:
1831
1832     \value TopLeftCorner     The top-left corner of the rectangle.
1833     \value TopRightCorner    The top-right corner of the rectangle.
1834     \value BottomLeftCorner  The bottom-left corner of the rectangle.
1835     \value BottomRightCorner The bottom-right corner of the rectangle.
1836
1837     \omitvalue TopLeft
1838     \omitvalue TopRight
1839     \omitvalue BottomLeft
1840     \omitvalue BottomRight
1841 */
1842
1843 /*!
1844     \enum Qt::ScrollBarPolicy
1845
1846     This enum type describes the various modes of QAbstractScrollArea's scroll
1847     bars.
1848
1849     \value ScrollBarAsNeeded QAbstractScrollArea shows a scroll bar when the
1850     content is too large to fit and not otherwise. This is the
1851     default.
1852
1853     \value ScrollBarAlwaysOff QAbstractScrollArea never shows a scroll bar.
1854
1855     \value ScrollBarAlwaysOn  QAbstractScrollArea always shows a scroll bar.
1856
1857     (The modes for the horizontal and vertical scroll bars are
1858     independent.)
1859 */
1860
1861 /*!
1862     \enum Qt::ArrowType
1863
1864     \value NoArrow
1865     \value UpArrow
1866     \value DownArrow
1867     \value LeftArrow
1868     \value RightArrow
1869 */
1870
1871 /*!
1872     \enum Qt::FocusReason
1873
1874     This enum specifies why the focus changed. It will be passed
1875     through QWidget::setFocus and can be retrieved in the QFocusEvent
1876     sent to the widget upon focus change.
1877
1878     \value MouseFocusReason        A mouse action occurred.
1879     \value TabFocusReason          The Tab key was pressed.
1880     \value BacktabFocusReason      A Backtab occurred. The input for this may
1881                                    include the Shift or Control keys;
1882                                    e.g. Shift+Tab.
1883     \value ActiveWindowFocusReason The window system made this window either
1884                                    active or inactive.
1885     \value PopupFocusReason        The application opened/closed a pop-up that
1886                                    grabbed/released the keyboard focus.
1887     \value ShortcutFocusReason     The user typed a label's buddy shortcut
1888     \value MenuBarFocusReason      The menu bar took focus.
1889     \value OtherFocusReason        Another reason, usually application-specific.
1890
1891     \omitvalue NoFocusReason
1892
1893     \sa {Keyboard Focus}
1894 */
1895
1896 /*!
1897     \enum Qt::WindowState
1898
1899     \keyword window state
1900
1901     This enum type is used to specify the current state of a top-level
1902     window.
1903
1904     The states are
1905
1906     \value WindowNoState   The window has no state set (in normal state).
1907     \value WindowMinimized The window is minimized (i.e. iconified).
1908     \value WindowMaximized The window is maximized with a frame around it.
1909     \value WindowFullScreen The window fills the entire screen without any frame around it.
1910     \value WindowActive The window is the active window, i.e. it has keyboard focus.
1911
1912 */
1913
1914 /*!
1915     \enum Qt::ContextMenuPolicy
1916
1917     This enum type defines the various policies a widget can have with
1918     respect to showing a context menu.
1919
1920     \value NoContextMenu the widget does not feature a context menu,
1921     context menu handling is deferred to the widget's parent.
1922     \value PreventContextMenu the widget does not feature a context
1923     menu, and in contrast to \c NoContextMenu, the handling is \e not
1924     deferred to the widget's parent. This means that all right mouse
1925     button events are guaranteed to be delivered to the widget itself
1926     through mousePressEvent(), and mouseReleaseEvent().
1927     \value DefaultContextMenu  the widget's QWidget::contextMenuEvent() handler is called.
1928     \value ActionsContextMenu  the widget displays its QWidget::actions() as context menu.
1929     \value CustomContextMenu  the widget emits the QWidget::customContextMenuRequested() signal.
1930 */
1931
1932 /*!
1933     \enum Qt::FocusPolicy
1934
1935     This enum type defines the various policies a widget can have with
1936     respect to acquiring keyboard focus.
1937
1938     \value TabFocus  the widget accepts focus by tabbing.
1939     \value ClickFocus  the widget accepts focus by clicking.
1940     \value StrongFocus  the widget accepts focus by both tabbing
1941                     and clicking. On Mac OS X this will also
1942                     be indicate that the widget accepts tab focus
1943                     when in 'Text/List focus mode'.
1944     \value WheelFocus  like Qt::StrongFocus plus the widget accepts
1945                     focus by using the mouse wheel.
1946     \value NoFocus  the widget does not accept focus.
1947
1948 */
1949
1950 /*!
1951     \enum Qt::ShortcutContext
1952
1953     For a QEvent::Shortcut event to occur, the shortcut's key sequence
1954     must be entered by the user in a context where the shortcut is
1955     active. The possible contexts are these:
1956
1957     \value WidgetShortcut The shortcut is active when its
1958     parent widget has focus.
1959     \value WidgetWithChildrenShortcut The shortcut is active
1960     when its parent widget, or any of its children has focus.
1961     Children which are top-level widgets, except pop-ups, are
1962     not affected by this shortcut context.
1963     \value WindowShortcut The shortcut is active when its
1964     parent widget is a logical subwidget of the
1965     active top-level window.
1966     \value ApplicationShortcut The shortcut is active when one of
1967     the applications windows are active.
1968 */
1969
1970 /*!
1971     \typedef Qt::WFlags
1972
1973     Synonym for Qt::WindowFlags.
1974 */
1975
1976 /*!
1977     \enum Qt::WindowType
1978
1979     \keyword window flag
1980
1981     This enum type is used to specify various window-system properties
1982     for the widget. They are fairly unusual but necessary in a few
1983     cases. Some of these flags depend on whether the underlying window
1984     manager supports them.
1985
1986     The main types are
1987
1988     \value Widget  This is the default type for QWidget. Widgets of
1989                    this type are child widgets if they have a parent,
1990                    and independent windows if they have no parent.
1991                    See also Qt::Window and Qt::SubWindow.
1992
1993     \value Window  Indicates that the widget is a window, usually
1994                    with a window system frame and a title bar,
1995                    irrespective of whether the widget has a parent or
1996                    not. Note that it is not possible to unset this
1997                    flag if the widget does not have a parent.
1998
1999     \value Dialog  Indicates that the widget is a window that should
2000                    be decorated as a dialog (i.e., typically no
2001                    maximize or minimize buttons in the title bar).
2002                    This is the default type for QDialog. If you want
2003                    to use it as a modal dialog, it should be launched
2004                    from another window, or have a parent and used
2005                    with the QWidget::windowModality property. If you make
2006                    it modal, the dialog will prevent other top-level
2007                    windows in the application from getting any input.
2008                    We refer to a top-level window that has a parent
2009                    as a \e secondary window.
2010
2011     \value Sheet   Indicates that the window is a Macintosh sheet. Since
2012                    using a sheet implies window modality, the recommended
2013                    way is to use QWidget::setWindowModality(), or
2014                    QDialog::open(), instead.
2015
2016     \value Drawer  Indicates that the widget is a Macintosh drawer.
2017
2018     \value Popup   Indicates that the widget is a pop-up top-level
2019                    window, i.e. that it is modal, but has a window
2020                    system frame appropriate for pop-up menus.
2021
2022     \value Tool    Indicates that the widget is a tool window. A tool
2023                    window is often a small window with a smaller than
2024                    usual title bar and decoration, typically used for
2025                    collections of tool buttons. If there is a parent,
2026                    the tool window will always be kept on top of it.
2027                    If there isn't a parent, you may consider using
2028                    Qt::WindowStaysOnTopHint as well. If the window
2029                    system supports it, a tool window can be decorated
2030                    with a somewhat lighter frame. It can also be
2031                    combined with Qt::FramelessWindowHint.
2032                    \br
2033                    \br
2034                    On Mac OS X, tool windows correspond to the
2035                    \l{http://developer.apple.com/documentation/Carbon/Conceptual/HandlingWindowsControls/hitb-wind_cont_concept/chapter_2_section_2.html}{Floating}
2036                    class of windows. This means that the window lives on a
2037                    level above normal windows; it impossible to put a normal
2038                    window on top of it. By default, tool windows will disappear
2039                    when the application is inactive.  This can be controlled by
2040                    the Qt::WA_MacAlwaysShowToolWindow attribute.
2041
2042     \value ToolTip Indicates that the widget is a tooltip. This is
2043                    used internally to implement
2044                    \l{QWidget::toolTip}{tooltips}.
2045
2046     \value SplashScreen Indicates that the window is a splash screen.
2047                         This is the default type for QSplashScreen.
2048
2049     \value Desktop  Indicates that this widget is the desktop. This
2050                     is the type for QDesktopWidget.
2051
2052     \value SubWindow  Indicates that this widget is a sub-window, such
2053                       as a QMdiSubWindow widget.
2054
2055     There are also a number of flags which you can use to customize
2056     the appearance of top-level windows. These have no effect on other
2057     windows:
2058
2059     \value MSWindowsFixedSizeDialogHint  Gives the window a thin dialog border on Windows.
2060            This style is traditionally used for fixed-size dialogs.
2061
2062     \value MSWindowsOwnDC  Gives the window its own display
2063            context on Windows.
2064
2065     \value X11BypassWindowManagerHint  Bypass the window
2066            manager completely. This results in a borderless window
2067            that is not managed at all (i.e., no keyboard input unless
2068            you call QWidget::activateWindow() manually).
2069
2070     \value FramelessWindowHint  Produces a borderless window.
2071            The user cannot move or resize a borderless window via the window
2072            system. On X11, the result of the flag is dependent on the window manager and its
2073            ability to understand Motif and/or NETWM hints. Most existing
2074            modern window managers can handle this.
2075
2076     The \c CustomizeWindowHint flag is used to enable customization of
2077     the window controls. This flag must be set to allow the \c
2078     WindowTitleHint, \c WindowSystemMenuHint, \c
2079     WindowMinimizeButtonHint, \c WindowMaximizeButtonHint and \c
2080     WindowCloseButtonHint flags to be changed.
2081
2082     \value CustomizeWindowHint  Turns off the default window title hints.
2083
2084     \value WindowTitleHint  Gives the window a title bar.
2085
2086     \value WindowSystemMenuHint Adds a window system menu, and
2087     possibly a close button (for example on Mac). If you need to hide
2088     or show a close button, it is more portable to use \c
2089     WindowCloseButtonHint.
2090
2091     \value WindowMinimizeButtonHint  Adds a minimize button. On
2092            some platforms this implies Qt::WindowSystemMenuHint for it to work.
2093
2094     \value WindowMaximizeButtonHint  Adds a maximize button. On
2095            some platforms this implies Qt::WindowSystemMenuHint for it to work.
2096
2097     \value WindowMinMaxButtonsHint  Adds a minimize and a maximize
2098            button. On some platforms this implies Qt::WindowSystemMenuHint for it to work.
2099
2100     \value WindowCloseButtonHint  Adds a close button. On
2101            some platforms this implies Qt::WindowSystemMenuHint for it
2102            to work.
2103
2104     \value WindowContextHelpButtonHint  Adds a context help button to dialogs.
2105            On some platforms this implies Qt::WindowSystemMenuHint for it to work.
2106
2107     \value MacWindowToolBarButtonHint On Mac OS X adds a tool bar button (i.e.,
2108            the oblong button that is on the top right of windows that have toolbars).
2109
2110     \value BypassGraphicsProxyWidget Prevents the window and its children from
2111            automatically embedding themselves into a QGraphicsProxyWidget if the
2112            parent widget is already embedded. You can set this flag if you
2113            want your widget to always be a toplevel widget on the desktop,
2114            regardless of whether the parent widget is embedded in a scene or
2115            not.
2116
2117     \value WindowShadeButtonHint
2118
2119     \value WindowStaysOnTopHint  Informs the window system that the
2120            window should stay on top of all other windows. Note that
2121            on some window managers on X11 you also have to pass
2122            Qt::X11BypassWindowManagerHint for this flag to work
2123            correctly.
2124
2125     \value WindowStaysOnBottomHint Informs the window system that the
2126            window should stay on bottom of all other windows. Note
2127            that on X11 this hint will work only in window managers
2128            that support _NET_WM_STATE_BELOW atom. If a window always
2129            on the bottom has a parent, the parent will also be left on
2130            the bottom.  This window hint is currently not implemented
2131            for Mac OS X.
2132
2133     \value WindowOkButtonHint Adds an OK button to the window decoration of a dialog.
2134            Only supported for Windows CE.
2135
2136     \value WindowCancelButtonHint Adds a Cancel button to the window decoration of a dialog.
2137            Only supported for Windows CE.
2138
2139     \value WindowSoftkeysVisibleHint Makes softkeys visible when widget is fullscreen.
2140            Only supported for Symbian.
2141
2142     \value WindowSoftkeysRespondHint Makes softkeys to receive key events even
2143            when invisible. With this hint the softkey actions are triggered
2144            even the softkeys are invisible i.e. the window is displayed with
2145            \c showFullscreen(). Only supported for Symbian.
2146
2147     \value WindowType_Mask  A mask for extracting the window type
2148                             part of the window flags.
2149
2150     Obsolete flags:
2151
2152     \value WMouseNoMask         Use Qt::WA_MouseNoMask instead.
2153     \value WDestructiveClose    Use Qt::WA_DeleteOnClose instead.
2154     \value WStaticContents      Use Qt::WA_StaticContents instead.
2155     \value WGroupLeader         No longer needed.
2156     \value WShowModal           Use QWidget::windowModality instead.
2157     \value WNoMousePropagation  Use Qt::WA_NoMousePropagation instead.
2158     \value WType_TopLevel       Use Qt::Window instead.
2159     \value WType_Dialog         Use Qt::Dialog instead.
2160     \value WType_Popup          Use Qt::Popup instead.
2161     \value WType_Desktop        Use Qt::Desktop instead.
2162     \value WType_Mask           Use Qt::WindowType_Mask instead.
2163
2164     \value WStyle_Customize     No longer needed.
2165     \value WStyle_NormalBorder  No longer needed.
2166     \value WStyle_DialogBorder  Use Qt::MSWindowsFixedSizeDialogHint instead.
2167     \value WStyle_NoBorder      Use Qt::FramelessWindowHint instead.
2168     \value WStyle_Title         Use Qt::WindowTitleHint instead.
2169     \value WStyle_SysMenu       Use Qt::WindowSystemMenuHint instead.
2170     \value WStyle_Minimize      Use Qt::WindowMinimizeButtonHint instead.
2171     \value WStyle_Maximize      Use Qt::WindowMaximizeButtonHint instead.
2172     \value WStyle_MinMax        Use Qt::WindowMinMaxButtonsHint instead.
2173     \value WStyle_Tool          Use Qt::Tool instead.
2174     \value WStyle_StaysOnTop    Use Qt::WindowStaysOnTopHint instead.
2175     \value WStyle_ContextHelp   Use Qt::WindowContextHelpButtonHint instead.
2176
2177     \value WPaintDesktop        No longer needed.
2178     \value WPaintClever         No longer needed.
2179
2180     \value WX11BypassWM         Use Qt::X11BypassWindowManagerHint instead.
2181     \value WWinOwnDC            Use Qt::MSWindowsOwnDC instead.
2182     \value WMacSheet            Use Qt::Sheet instead.
2183     \value WMacDrawer           Use Qt::Drawer instead.
2184
2185     \value WStyle_Splash        Use Qt::SplashScreen instead.
2186
2187     \value WNoAutoErase         No longer needed.
2188     \value WRepaintNoErase      No longer needed.
2189     \value WNorthWestGravity    Use Qt::WA_StaticContents instead.
2190     \value WType_Modal          Use Qt::Dialog and QWidget::windowModality instead.
2191     \value WStyle_Dialog        Use Qt::Dialog instead.
2192     \value WStyle_NoBorderEx    Use Qt::FramelessWindowHint instead.
2193     \value WResizeNoErase       No longer needed.
2194     \value WMacNoSheet          No longer needed.
2195
2196     \sa QWidget::windowFlags, {Window Flags Example}
2197 */
2198
2199 /*!
2200     \enum Qt::DropAction
2201
2202     \value CopyAction       Copy the data to the target.
2203     \value MoveAction       Move the data from the source to the target.
2204     \value LinkAction       Create a link from the source to the target.
2205     \value ActionMask
2206     \value IgnoreAction     Ignore the action (do nothing with the data).
2207     \value TargetMoveAction On Windows, this value is used when the ownership of the D&D data
2208                             should be taken over by the target application,
2209                             i.e., the source application should not delete
2210                             the data.
2211                             \br
2212                             On X11 this value is used to do a move.
2213                             \br
2214                             TargetMoveAction is not used on the Mac.
2215 */
2216
2217 #if defined(Q_OS_WIN) && defined(QT3_SUPPORT)
2218 /*!
2219     \enum Qt::WindowsVersion
2220     \compat
2221
2222     \value WV_32s
2223     \value WV_95
2224     \value WV_98
2225     \value WV_Me
2226     \value WV_DOS_based
2227     \value WV_NT
2228     \value WV_2000
2229     \value WV_XP
2230     \value WV_2003
2231     \value WV_NT_based
2232     \value WV_CE
2233     \value WV_CENET
2234     \value WV_CE_based
2235     \value WV_CE_5
2236     \value WV_CE_6
2237 */
2238 #endif
2239
2240 #if defined(Q_OS_MAC) && defined(QT3_SUPPORT)
2241 /*!
2242     \enum Qt::MacintoshVersion
2243     \compat
2244
2245     \value MV_Unknown  Use QSysInfo::MV_Unknown instead.
2246     \value MV_9        Use QSysInfo::MV_9 instead.
2247     \value MV_10_DOT_0 Use QSysInfo::MV_10_0 instead.
2248     \value MV_10_DOT_1 Use QSysInfo::MV_10_1 instead.
2249     \value MV_10_DOT_2 Use QSysInfo::MV_10_2 instead.
2250     \value MV_10_DOT_3 Use QSysInfo::MV_10_3 instead.
2251     \value MV_10_DOT_4 Use QSysInfo::MV_10_4 instead.
2252
2253     \value MV_CHEETAH  Use QSysInfo::MV_10_0 instead.
2254     \value MV_PUMA     Use QSysInfo::MV_10_1 instead.
2255     \value MV_JAGUAR   Use QSysInfo::MV_10_2 instead.
2256     \value MV_PANTHER  Use QSysInfo::MV_10_3 instead.
2257     \value MV_TIGER    Use QSysInfo::MV_10_4 instead.
2258
2259     \sa QSysInfo::MacVersion
2260 */
2261 #endif
2262
2263 /*! \typedef Qt::ToolBarDock
2264     \compat
2265
2266     Use Qt::Dock instead.
2267 */
2268
2269 /*!
2270     \enum Qt::Dock
2271     \compat
2272
2273     Each dock window can be in one of the following positions:
2274
2275     \value DockUnmanaged not managed by a Q3MainWindow.
2276
2277     \value DockTornOff the dock window floats as its own top level
2278     window which always stays on top of the main window.
2279
2280     \value DockTop  above the central widget, below the menu bar.
2281
2282     \value DockBottom  below the central widget, above the status bar.
2283
2284     \value DockRight to the right of the central widget.
2285
2286     \value DockLeft  to the left of the central widget.
2287
2288     \value DockMinimized the dock window is not shown (this is
2289     effectively a 'hidden' dock area); the handles of all minimized
2290     dock windows are drawn in one row below the menu bar.
2291
2292     \omitvalue Bottom
2293     \omitvalue Left
2294     \omitvalue Minimized
2295     \omitvalue Right
2296     \omitvalue Top
2297     \omitvalue TornOff
2298     \omitvalue Unmanaged
2299 */
2300
2301 /*!
2302   \enum Qt::AnchorAttribute
2303
2304   An anchor has one or more of the following attributes:
2305
2306   \value AnchorName the name attribute of the anchor. This attribute is
2307   used when scrolling to an anchor in the document.
2308
2309   \value AnchorHref the href attribute of the anchor. This attribute is
2310   used when a link is clicked to determine what content to load.
2311 */
2312
2313 /*!
2314     \enum Qt::SortOrder
2315
2316     This enum describes how the items in a widget are sorted.
2317
2318     \value AscendingOrder The items are sorted ascending e.g. starts with
2319     'AAA' ends with 'ZZZ' in Latin-1 locales
2320
2321     \value DescendingOrder The items are sorted descending e.g. starts with
2322     'ZZZ' ends with 'AAA' in Latin-1 locales
2323
2324     \omitvalue Ascending
2325     \omitvalue Descending
2326 */
2327
2328 /*!
2329     \enum Qt::ClipOperation
2330
2331     \value NoClip This operation turns clipping off.
2332
2333     \value ReplaceClip Replaces the current clip path/rect/region with
2334     the one supplied in the function call.
2335
2336     \value IntersectClip Intersects the current clip path/rect/region
2337     with the one supplied in the function call.
2338
2339     \value UniteClip Unites the current clip path/rect/region with the
2340     one supplied in the function call.
2341 */
2342
2343 /*!
2344     \enum Qt::ItemSelectionMode
2345
2346     This enum is used in QGraphicsItem, QGraphicsScene and QGraphicsView to
2347     specify how items are selected, or how to determine if a shapes and items
2348     collide.
2349
2350     \value ContainsItemShape The output list contains only items whose
2351            \l{QGraphicsItem::shape()}{shape} is fully contained inside the
2352            selection area. Items that intersect with the area's outline are
2353            not included.
2354
2355     \value IntersectsItemShape The output list contains both items whose
2356            \l{QGraphicsItem::shape()}{shape} is fully contained inside the
2357            selection area, and items that intersect with the area's
2358            outline. This is a common mode for rubber band selection.
2359
2360     \value ContainsItemBoundingRect The output list contains only items whose
2361            \l{QGraphicsItem::boundingRect()}{bounding rectangle} is fully
2362            contained inside the selection area. Items that intersect with the
2363            area's outline are not included.
2364
2365     \value IntersectsItemBoundingRect The output list contains both items
2366            whose \l{QGraphicsItem::boundingRect()}{bounding rectangle} is
2367            fully contained inside the selection area, and items that intersect
2368            with the area's outline. This method is commonly used for
2369            determining areas that need redrawing.
2370
2371     \sa QGraphicsScene::items(), QGraphicsScene::collidingItems(),
2372         QGraphicsView::items(), QGraphicsItem::collidesWithItem(),
2373         QGraphicsItem::collidesWithPath()
2374 */
2375
2376 /*!
2377     \enum Qt::FillRule
2378
2379     Specifies which method should be used to fill the paths and polygons.
2380
2381     \value OddEvenFill Specifies that the region is filled using the
2382     odd even fill rule. With this rule, we determine whether a point
2383     is inside the shape by using the following method.
2384     Draw a horizontal line from the point to a location outside the shape,
2385     and count the number of intersections. If the number of intersections
2386     is an odd number, the point is inside the shape. This mode is the
2387     default.
2388
2389     \value WindingFill Specifies that the region is filled using the
2390     non zero winding rule. With this rule, we determine whether a
2391     point is inside the shape by using the following method.
2392     Draw a horizontal line from the point to a location outside the shape.
2393     Determine whether the direction of the line at each intersection point
2394     is up or down. The winding number is determined by summing the
2395     direction of each intersection. If the number is non zero, the point
2396     is inside the shape. This fill mode can also in most cases be considered
2397     as the intersection of closed shapes.
2398 */
2399
2400 /*!
2401     \enum Qt::PaintUnit
2402
2403     \compat
2404
2405     \value PixelUnit
2406     \value LoMetricUnit Obsolete
2407     \value HiMetricUnit Obsolete
2408     \value LoEnglishUnit Obsolete
2409     \value HiEnglishUnit Obsolete
2410     \value TwipsUnit Obsolete
2411 */
2412
2413 /*!
2414     \enum Qt::TextFormat
2415
2416     This enum is used in widgets that can display both plain text and
2417     rich text, e.g. QLabel. It is used for deciding whether a text
2418     string should be interpreted as one or the other. This is normally
2419     done by passing one of the enum values to a setTextFormat()
2420     function.
2421
2422     \value PlainText  The text string is interpreted as a plain text
2423         string.
2424
2425     \value RichText The text string is interpreted as a rich text
2426         string.
2427
2428     \value AutoText The text string is interpreted as for
2429         Qt::RichText if Qt::mightBeRichText() returns true, otherwise
2430         as Qt::PlainText.
2431
2432     \value LogText A special, limited text format which is only used
2433     by Q3TextEdit in an optimized mode.
2434 */
2435
2436 /*!
2437     \enum Qt::CursorShape
2438
2439     This enum type defines the various cursors that can be used.
2440
2441     The standard arrow cursor is the default for widgets in a normal state.
2442
2443     \value ArrowCursor    \inlineimage cursor-arrow.png
2444                           The standard arrow cursor.
2445     \value UpArrowCursor  \inlineimage cursor-uparrow.png
2446                           An arrow pointing upwards toward the top of the screen.
2447     \value CrossCursor    \inlineimage cursor-cross.png
2448                           A crosshair cursor, typically used to help the
2449                           user accurately select a point on the screen.
2450     \value WaitCursor     \inlineimage cursor-wait.png
2451                           An hourglass or watch cursor, usually shown during
2452                           operations that prevent the user from interacting with
2453                           the application.
2454     \value IBeamCursor    \inlineimage cursor-ibeam.png
2455                           A caret or ibeam cursor, indicating that a widget can
2456                           accept and display text input.
2457     \value SizeVerCursor  \inlineimage cursor-sizev.png
2458                           A cursor used for elements that are used to vertically
2459                           resize top-level windows.
2460     \value SizeHorCursor  \inlineimage cursor-sizeh.png
2461                           A cursor used for elements that are used to horizontally
2462                           resize top-level windows.
2463     \value SizeBDiagCursor  \inlineimage cursor-sizeb.png
2464                           A cursor used for elements that are used to diagonally
2465                           resize top-level windows at their top-right and
2466                           bottom-left corners.
2467     \value SizeFDiagCursor  \inlineimage cursor-sizef.png
2468                           A cursor used for elements that are used to diagonally
2469                           resize top-level windows at their top-left and
2470                           bottom-right corners.
2471     \value SizeAllCursor  \inlineimage cursor-sizeall.png
2472                           A cursor used for elements that are used to resize
2473                           top-level windows in any direction.
2474     \value BlankCursor    A blank/invisible cursor, typically used when the cursor
2475                           shape needs to be hidden.
2476     \value SplitVCursor   \inlineimage cursor-vsplit.png
2477                           A cursor used for vertical splitters, indicating that
2478                           a handle can be dragged horizontally to adjust the use
2479                           of available space.
2480     \value SplitHCursor   \inlineimage cursor-hsplit.png
2481                           A cursor used for horizontal splitters, indicating that
2482                           a handle can be dragged vertically to adjust the use
2483                           of available space.
2484     \value PointingHandCursor  \inlineimage cursor-hand.png
2485                           A pointing hand cursor that is typically used for
2486                           clickable elements such as hyperlinks.
2487     \value ForbiddenCursor  \inlineimage cursor-forbidden.png
2488                           A slashed circle cursor, typically used during drag
2489                           and drop operations to indicate that dragged content
2490                           cannot be dropped on particular widgets or inside
2491                           certain regions.
2492     \value OpenHandCursor \inlineimage cursor-openhand.png
2493                           A cursor representing an open hand, typically used to
2494                           indicate that the area under the cursor is the visible
2495                           part of a canvas that the user can click and drag in
2496                           order to scroll around.
2497     \value ClosedHandCursor \inlineimage cursor-closedhand.png
2498                           A cursor representing a closed hand, typically used to
2499                           indicate that a dragging operation is in progress that
2500                           involves scrolling.
2501     \value WhatsThisCursor  \inlineimage cursor-whatsthis.png
2502                           An arrow with a question mark, typically used to indicate
2503                           the presence of What's This? help for a widget.
2504     \value BusyCursor     \inlineimage cursor-wait.png
2505                           An hourglass or watch cursor, usually shown during
2506                           operations that allow the user to interact with
2507                           the application while they are performed in the
2508                           background.
2509     \value DragMoveCursor
2510                           A cursor that is usually used when dragging an item.
2511     \value DragCopyCursor
2512                           A cursor that is usually used when dragging an item
2513                           to copy it.
2514     \value DragLinkCursor
2515                           A cursor that is usually used when dragging an item
2516                           to make a link to it.
2517
2518     \value BitmapCursor
2519     \omitvalue LastCursor
2520     \omitvalue CustomCursor
2521
2522     \omitvalue arrowCursor
2523     \omitvalue upArrowCursor
2524     \omitvalue crossCursor
2525     \omitvalue waitCursor
2526     \omitvalue ibeamCursor
2527     \omitvalue sizeVerCursor
2528     \omitvalue sizeHorCursor
2529     \omitvalue sizeBDiagCursor
2530     \omitvalue sizeFDiagCursor
2531     \omitvalue sizeAllCursor
2532     \omitvalue blankCursor
2533     \omitvalue splitVCursor
2534     \omitvalue splitHCursor
2535     \omitvalue pointingHandCursor
2536     \omitvalue forbiddenCursor
2537     \omitvalue whatsThisCursor
2538 */
2539
2540 /*!
2541     \typedef Qt::TextFlags
2542     \compat
2543
2544     Use Qt::TextFlag instead.
2545 */
2546
2547 /*!
2548     \enum Qt::LayoutDirection
2549
2550     Specifies the direction of Qt's layouts and text handling.
2551
2552     \value LeftToRight  Left-to-right layout.
2553     \value RightToLeft  Right-to-left layout.
2554     \value LayoutDirectionAuto   Automatic layout.
2555
2556     Right-to-left layouts are necessary for certain languages,
2557     notably Arabic and Hebrew.
2558
2559     LayoutDirectionAuto serves two purposes. When used in conjunction with widgets and layouts, it
2560     will imply to use the layout direction set on the parent widget or QApplication. This
2561     has the same effect as QWidget::unsetLayoutDirection().
2562
2563     When LayoutDirectionAuto is used in conjunction with text layouting, it will imply that the text
2564     directionality is determined from the content of the string to be layouted.
2565
2566     \sa QApplication::setLayoutDirection(), QWidget::setLayoutDirection(), QTextOption::setTextDirection(), QString::isRightToLeft()
2567 */
2568
2569 /*!
2570     \enum Qt::AnchorPoint
2571
2572     Specifies a side of a layout item that can be anchored. This is used by
2573     QGraphicsAnchorLayout.
2574
2575     \value AnchorLeft               The left side of a layout item.
2576     \value AnchorHorizontalCenter   A "virtual" side that is centered between the left and the
2577                                     right side of a layout item.
2578     \value AnchorRight              The right side of a layout item.
2579     \value AnchorTop                The top side of a layout item.
2580     \value AnchorVerticalCenter     A "virtual" side that is centered between the top and the
2581                                     bottom side of a layout item.
2582     \value AnchorBottom             The bottom side of a layout item.
2583
2584     \sa QGraphicsAnchorLayout
2585 */
2586
2587 /*!
2588     \enum Qt::InputMethodHint
2589
2590     \value ImhNone                   No hints.
2591
2592     Flags that alter the behavior:
2593
2594     \value ImhHiddenText             Characters should be hidden, as is typically used when entering passwords.
2595                                      This is automatically set when setting QLineEdit::echoMode to \c Password.
2596     \value ImhNoAutoUppercase        The input method should not try to automatically switch to upper case
2597                                      when a sentence ends.
2598     \value ImhPreferNumbers          Numbers are preferred (but not required).
2599     \value ImhPreferUppercase        Upper case letters are preferred (but not required).
2600     \value ImhPreferLowercase        Lower case letters are preferred (but not required).
2601     \value ImhNoPredictiveText       Do not use predictive text (i.e. dictionary lookup) while typing.
2602
2603     Flags that restrict input (exclusive flags):
2604
2605     \value ImhDigitsOnly             Only digits are allowed.
2606     \value ImhFormattedNumbersOnly   Only number input is allowed. This includes decimal point and minus sign.
2607     \value ImhUppercaseOnly          Only upper case letter input is allowed.
2608     \value ImhLowercaseOnly          Only lower case letter input is allowed.
2609     \value ImhDialableCharactersOnly Only characters suitable for phone dialling are allowed.
2610     \value ImhEmailCharactersOnly    Only characters suitable for email addresses are allowed.
2611     \value ImhUrlCharactersOnly      Only characters suitable for URLs are allowed.
2612
2613     Masks:
2614
2615     \value ImhExclusiveInputMask     This mask yields nonzero if any of the exclusive flags are used.
2616
2617     \note If several exclusive flags are ORed together, the resulting character set will
2618           consist of the union of the specified sets. For instance specifying \c ImhNumbersOnly and
2619           \c ImhUppercaseOnly would yield a set consisting of numbers and uppercase letters.
2620
2621     \sa QGraphicsItem::inputMethodHints()
2622 */
2623
2624 /*!
2625     \enum Qt::InputMethodQuery
2626
2627     \value ImMicroFocus       The rectangle covering the area of the input cursor in widget coordinates.
2628     \value ImFont             The currently used font for text input.
2629     \value ImCursorPosition   The logical position of the cursor within the text surrounding the input area (see \c ImSurroundingText).
2630     \value ImSurroundingText  The plain text around the input area, for example the current paragraph.
2631     \value ImCurrentSelection The currently selected text.
2632     \value ImMaximumTextLength The maximum number of characters that the widget can hold. If there is no limit, QVariant() is returned.
2633     \value ImAnchorPosition   The position of the selection anchor. This may be less or greater than \c ImCursorPosition, depending on which side of selection the cursor is. If there is no selection, it returns the same as \c ImCursorPosition.
2634 */
2635
2636 /*!
2637     \enum Qt::ItemDataRole
2638
2639     Each item in the model has a set of data elements associated with
2640     it, each with its own role. The roles are used by the view to indicate
2641     to the model which type of data it needs. Custom models should return
2642     data in these types.
2643
2644     The general purpose roles (and the associated types) are:
2645
2646     \value DisplayRole    The key data to be rendered in the form of text. (QString)
2647     \value DecorationRole The data to be rendered as a decoration in the form
2648                           of an icon. (QColor, QIcon or QPixmap)
2649     \value EditRole       The data in a form suitable for editing in an
2650                           editor. (QString)
2651     \value ToolTipRole    The data displayed in the item's tooltip. (QString)
2652     \value StatusTipRole  The data displayed in the status bar. (QString)
2653     \value WhatsThisRole  The data displayed for the item in "What's This?"
2654                           mode. (QString)
2655     \value SizeHintRole   The size hint for the item that will be supplied
2656                           to views. (QSize)
2657
2658     Roles describing appearance and meta data (with associated types):
2659
2660     \value FontRole             The font used for items rendered with the default
2661                                 delegate. (QFont)
2662     \value TextAlignmentRole    The alignment of the text for items rendered with the
2663                                 default delegate. (Qt::AlignmentFlag)
2664     \value BackgroundRole       The background brush used for items rendered with
2665                                 the default delegate. (QBrush)
2666     \value BackgroundColorRole  This role is obsolete. Use BackgroundRole instead.
2667     \value ForegroundRole       The foreground brush (text color, typically)
2668                                 used for items rendered with the default delegate.
2669                                 (QBrush)
2670     \value TextColorRole        This role is obsolete. Use ForegroundRole instead.
2671     \value CheckStateRole       This role is used to obtain the checked state of
2672                                 an item. (Qt::CheckState)
2673     \value InitialSortOrderRole This role is used to obtain the initial sort order
2674                                 of a header view section. (Qt::SortOrder). This
2675                                 role was introduced in Qt 4.8.
2676
2677     Accessibility roles (with associated types):
2678
2679     \value AccessibleTextRole        The text to be used by accessibility
2680                                      extensions and plugins, such as screen
2681                                      readers. (QString)
2682     \value AccessibleDescriptionRole A description of the item for accessibility
2683                                      purposes. (QString)
2684
2685     User roles:
2686
2687     \value UserRole       The first role that can be used for application-specific purposes.
2688
2689     \omitvalue DisplayPropertyRole
2690     \omitvalue DecorationPropertyRole
2691     \omitvalue ToolTipPropertyRole
2692     \omitvalue StatusTipPropertyRole
2693     \omitvalue WhatsThisPropertyRole
2694
2695     For user roles, it is up to the developer to decide which types to use and ensure that
2696     components use the correct types when accessing and setting data.
2697 */
2698
2699 /*!
2700     \enum Qt::ItemFlag
2701
2702     This enum describes the properties of an item:
2703
2704     \value NoItemFlags It does not have any properties set.
2705     \value ItemIsSelectable It can be selected.
2706     \value ItemIsEditable It can be edited.
2707     \value ItemIsDragEnabled It can be dragged.
2708     \value ItemIsDropEnabled It can be used as a drop target.
2709     \value ItemIsUserCheckable It can be checked or unchecked by the user.
2710     \value ItemIsEnabled The user can interact with the item.
2711     \value ItemIsTristate The item is checkable with three separate states.
2712
2713     Note that checkable items need to be given both a suitable set of flags
2714     and an initial state, indicating whether the item is checked or not.
2715     This is handled automatically for model/view components, but needs
2716     to be explicitly set for instances of QListWidgetItem, QTableWidgetItem,
2717     and QTreeWidgetItem.
2718
2719     \sa QAbstractItemModel
2720 */
2721
2722 /*!
2723     \enum Qt::MatchFlag
2724
2725     This enum describes the type of matches that can be used when searching
2726     for items in a model.
2727
2728     \value MatchExactly     Performs QVariant-based matching.
2729     \value MatchFixedString Performs string-based matching.
2730            String-based comparisons are case-insensitive unless the
2731            \c MatchCaseSensitive flag is also specified.
2732     \value MatchContains    The search term is contained in the item.
2733     \value MatchStartsWith  The search term matches the start of the item.
2734     \value MatchEndsWith    The search term matches the end of the item.
2735     \value MatchCaseSensitive  The search is case sensitive.
2736     \value MatchRegExp      Performs string-based matching using a regular
2737            expression as the search term.
2738     \value MatchWildcard    Performs string-based matching using a string with
2739            wildcards as the search term.
2740     \value MatchWrap        Perform a search that wraps around, so that when
2741            the search reaches the last item in the model, it begins again at
2742            the first item and continues until all items have been examined.
2743     \value MatchRecursive   Searches the entire hierarchy.
2744
2745     \sa QString::compare(), QRegExp
2746 */
2747
2748 /*!
2749     \enum Qt::TextElideMode
2750
2751     This enum specifies where the ellipsis should appear when
2752     displaying texts that don't fit:
2753
2754     \value ElideLeft    The ellipsis should appear at the beginning of the text.
2755     \value ElideRight   The ellipsis should appear at the end of the text.
2756     \value ElideMiddle  The ellipsis should appear in the middle of the text.
2757     \value ElideNone    Ellipsis should NOT appear in the text.
2758
2759     Qt::ElideMiddle is normally the most appropriate choice for URLs (e.g.,
2760     "\l{http://bugreports.qt.nokia.com/browse/QTWEBSITE-13}{http://bugreports.qt.../QTWEBSITE-13/}"),
2761     whereas Qt::ElideRight is appropriate
2762     for other strings (e.g.,
2763     "\l{http://qt.nokia.com/doc/qq/qq09-mac-deployment.html}{Deploying Applications on Ma...}").
2764
2765     \sa QAbstractItemView::textElideMode, QFontMetrics::elidedText(), AlignmentFlag QTabBar::elideMode
2766 */
2767
2768 /*!
2769     \enum Qt::WindowModality
2770
2771     \keyword modal
2772
2773     This enum specifies the behavior of a modal window. A modal window
2774     is one that blocks input to other windows. Note that windows that
2775     are children of a modal window are not blocked.
2776
2777     The values are:
2778     \value NonModal         The window is not modal and does not block input to other windows.
2779     \value WindowModal      The window is modal to a single window hierarchy and blocks input to its parent window, all grandparent windows, and all siblings of its parent and grandparent windows.
2780     \value ApplicationModal The window is modal to the application and blocks input to all windows.
2781
2782     \sa QWidget::windowModality, QDialog
2783 */
2784
2785 /*!
2786     \enum Qt::TextInteractionFlag
2787
2788     This enum specifies how a text displaying widget reacts to user input.
2789
2790     \value NoTextInteraction          No interaction with the text is possible.
2791     \value TextSelectableByMouse      Text can be selected with the mouse and copied to the clipboard using
2792                                       a context menu or standard keyboard shortcuts.
2793     \value TextSelectableByKeyboard   Text can be selected with the cursor keys on the keyboard. A text cursor is shown.
2794     \value LinksAccessibleByMouse     Links can be highlighted and activated with the mouse.
2795     \value LinksAccessibleByKeyboard  Links can be focused using tab and activated with enter.
2796     \value TextEditable               The text is fully editable.
2797
2798     \value TextEditorInteraction      The default for a text editor.
2799     \value TextBrowserInteraction     The default for QTextBrowser.
2800 */
2801
2802 /*!
2803     \enum Qt::MaskMode
2804
2805     This enum specifies the behavior of the
2806     QPixmap::createMaskFromColor() and QImage::createMaskFromColor()
2807     functions.
2808
2809     \value MaskInColor   Creates a mask where all pixels matching the given color are opaque.
2810     \value MaskOutColor  Creates a mask where all pixels matching the given color are transparent.
2811 */
2812
2813 /*!
2814     \enum Qt::DockWidgetAreaSizes
2815     \internal
2816 */
2817
2818 /*!
2819     \enum Qt::ToolBarAreaSizes
2820     \internal
2821 */
2822
2823 /*!
2824     \enum Qt::EventPriority
2825
2826     This enum can be used to specify event priorities.
2827
2828     \value HighEventPriority Events with this priority are sent before
2829     events with NormalEventPriority or LowEventPriority.
2830
2831     \value NormalEventPriority Events with this priority are sent
2832     after events with HighEventPriority, but before events with
2833     LowEventPriority.
2834
2835     \value LowEventPriority Events with this priority are sent after
2836     events with HighEventPriority or NormalEventPriority.
2837
2838     Note that these values are provided purely for convenience, since
2839     event priorities can be any value between \c INT_MAX and \c
2840     INT_MIN, inclusive. For example, you can define custom priorities
2841     as being relative to each other:
2842
2843     \snippet doc/src/snippets/code/doc_src_qnamespace.cpp 1
2844
2845     \sa QCoreApplication::postEvent()
2846 */
2847 /*!
2848     \enum Qt::SizeHint
2849     \since 4.4
2850
2851     This enum is used by QGraphicsLayoutItem::sizeHint()
2852
2853     \value MinimumSize is used to specify the minimum size of a graphics layout item.
2854     \value PreferredSize is used to specify the preferred size of a graphics layout item.
2855     \value MaximumSize is used to specify the maximum size of a graphics layout item.
2856     \value MinimumDescent is used to specify the minimum descent of a text string in a graphics layout item.
2857     \omitvalue NSizeHints
2858
2859     \sa QGraphicsLayoutItem::sizeHint()
2860 */
2861
2862 /*!
2863     \enum Qt::SizeMode
2864     \since 4.4
2865
2866     This enum is used by QPainter::drawRoundedRect() and QPainterPath::addRoundedRect()
2867     functions to specify the radii of rectangle corners with respect to the dimensions
2868     of the bounding rectangles specified.
2869
2870     \value AbsoluteSize Specifies the size using absolute measurements.
2871     \value RelativeSize Specifies the size relative to the bounding rectangle,
2872                         typically using percentage measurements.
2873 */
2874
2875 /*!
2876     \enum Qt::WindowFrameSection
2877     \since 4.4
2878
2879     This enum is used to describe parts of a window frame. It is returned by
2880     QGraphicsWidget::windowFrameSectionAt() to describe what section of the window
2881     frame is under the mouse.
2882
2883     \value NoSection
2884     \value LeftSection
2885     \value TopLeftSection
2886     \value TopSection
2887     \value TopRightSection
2888     \value RightSection
2889     \value BottomRightSection
2890     \value BottomSection
2891     \value BottomLeftSection
2892     \value TitleBarArea
2893
2894     \sa QGraphicsWidget::windowFrameEvent()
2895     \sa QGraphicsWidget::paintWindowFrame()
2896     \sa QGraphicsWidget::windowFrameSectionAt()
2897
2898 */
2899
2900 /*!
2901   \enum Qt::TileRule
2902   \since 4.6
2903
2904   This enum describes how to repeat or stretch the parts of an image
2905   when drawing.
2906
2907   \value StretchTile  Scale the image to fit to the available area.
2908
2909   \value RepeatTile   Repeat the image until there is no more space. May
2910   crop the last image.
2911
2912   \value RoundTile    Similar to Repeat, but scales the image down to
2913   ensure that the last tile is not cropped.
2914 */
2915
2916 /*!
2917     \enum Qt::Initialization
2918     \internal
2919 */
2920
2921 /*!
2922     \enum Qt::CoordinateSystem
2923     \since 4.6
2924
2925     This enum specifies the coordinate system.
2926
2927     \value DeviceCoordinates Coordinates are relative to the upper-left corner
2928     of the object's paint device.
2929
2930     \value LogicalCoordinates Coordinates are relative to the upper-left corner
2931     of the object.
2932 */
2933
2934 /*!
2935     \enum Qt::GestureState
2936     \since 4.6
2937
2938     This enum type describes the state of a gesture.
2939
2940     \value GestureStarted   A continuous gesture has started.
2941     \value GestureUpdated   A gesture continues.
2942     \value GestureFinished  A gesture has finished.
2943     \value GestureCanceled  A gesture was canceled.
2944     \omitvalue NoGesture
2945
2946     \sa QGesture
2947 */
2948
2949 /*!
2950     \enum Qt::GestureType
2951     \since 4.6
2952
2953     This enum type describes the standard gestures.
2954
2955     \value TapGesture        A Tap gesture.
2956     \value TapAndHoldGesture A Tap-And-Hold (Long-Tap) gesture.
2957     \value PanGesture        A Pan gesture.
2958     \value PinchGesture      A Pinch gesture.
2959     \value SwipeGesture      A Swipe gesture.
2960     \value CustomGesture A flag that can be used to test if the gesture is a
2961     user-defined gesture ID.
2962     \omitvalue LastGestureType
2963
2964     User-defined gestures are registered with the
2965     QGestureRecognizer::registerRecognizer() function which generates a custom
2966     gesture ID with the Qt::CustomGesture flag set.
2967
2968     \sa QGesture, QWidget::grabGesture(), QGraphicsObject::grabGesture()
2969 */
2970
2971 /*!
2972     \enum Qt::GestureFlag
2973     \since 4.6
2974
2975     This enum type describes additional flags that can be used when subscribing
2976     to a gesture.
2977
2978     \value DontStartGestureOnChildren By default gestures can start on the
2979     widget or over any of its children. Use this flag to disable this and allow
2980     a gesture to start on the widget only.
2981
2982     \value ReceivePartialGestures Allows any ignored gesture events to be
2983     propagated to parent widgets which have specified this hint. By default
2984     only gestures that are in the Qt::GestureStarted state are propagated and
2985     the widget always gets the full gesture sequence starting with a gesture in
2986     the Qt::GestureStarted state and ending with a gesture in the
2987     Qt::GestureFinished or Qt::GestureCanceled states.
2988
2989     \value IgnoredGesturesPropagateToParent Since Qt 4.7, this flag allows you
2990     to fine-tune gesture event propagation. By setting the flag when
2991     \l{QGraphicsObject::grabGesture()}{grabbing} a gesture all ignored partial
2992     gestures will propagate to their parent items.
2993
2994     \sa QWidget::grabGesture(), QGraphicsObject::grabGesture()
2995 */
2996
2997 /*!
2998     \enum Qt::NavigationMode
2999     \since 4.6
3000
3001     This enum type describes the mode for moving focus.
3002
3003     \value NavigationModeNone                Only the touch screen is used.
3004     \value NavigationModeKeypadTabOrder      Qt::Key_Up and Qt::Key_Down are used to change focus.
3005     \value NavigationModeKeypadDirectional   Qt::Key_Up, Qt::Key_Down, Qt::Key_Left and Qt::Key_Right are used to change focus.
3006     \value NavigationModeCursorAuto          The mouse cursor is used to change focus,
3007                                              it is displayed only on non touchscreen devices.
3008                                              The keypad is used to implement a virtual cursor, unless
3009                                              the device has an analog mouse type of input device (e.g. touchpad).
3010                                              This is the recommended setting for an application such as a web browser that
3011                                              needs pointer control on both touch and non-touch devices.
3012     \value NavigationModeCursorForceVisible  The mouse cursor is used to change focus,
3013                                              it is displayed regardless of device type.
3014                                              The keypad is used to implement a virtual cursor, unless
3015                                              the device has an analog mouse type of input device (e.g. touchpad)
3016
3017     \note: in 4.6, cursor navigation is only implemented for Symbian OS.
3018            On other platforms, it behaves as NavigationModeNone.
3019     \sa QApplication::setNavigationMode()
3020     \sa QApplication::navigationMode()
3021 */