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