src/corelib/global/qnamespace.qdoc

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