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