1
/****************************************************************************
3
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4
** Contact: Nokia Corporation (qt-info@nokia.com)
6
** This file is part of the documentation of the Qt Toolkit.
8
** $QT_BEGIN_LICENSE:LGPL$
10
** Licensees holding valid Qt Commercial licenses may use this file in
11
** accordance with the Qt Commercial License Agreement provided with the
12
** Software or, alternatively, in accordance with the terms contained in
13
** a written agreement between you and Nokia.
15
** GNU Lesser General Public License Usage
16
** Alternatively, this file may be used under the terms of the GNU Lesser
17
** General Public License version 2.1 as published by the Free Software
18
** Foundation and appearing in the file LICENSE.LGPL included in the
19
** packaging of this file. Please review the following information to
20
** ensure the GNU Lesser General Public License version 2.1 requirements
21
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
23
** In addition, as a special exception, Nokia gives you certain
24
** additional rights. These rights are described in the Nokia Qt LGPL
25
** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
28
** GNU General Public License Usage
29
** Alternatively, this file may be used under the terms of the GNU
30
** General Public License version 3.0 as published by the Free Software
31
** Foundation and appearing in the file LICENSE.GPL included in the
32
** packaging of this file. Please review the following information to
33
** ensure the GNU General Public License version 3.0 requirements will be
34
** met: http://www.gnu.org/copyleft/gpl.html.
36
** If you are unsure which license is appropriate for your use, please
37
** contact the sales department at http://www.qtsoftware.com/contact.
40
****************************************************************************/
45
\brief The Qt namespace contains miscellaneous identifiers
46
used throughout the Qt library.
54
This type is used to signify an object's orientation.
59
Orientation is used with QScrollBar for example.
63
\enum Qt::AlignmentFlag
65
This enum type is used to describe alignment. It contains
66
horizontal and vertical flags that can be combined to produce
69
The \l{TextElideMode} enum can also be used in many situations
70
to fine-tune the appearance of aligned text.
72
The horizontal flags are:
74
\value AlignLeft Aligns with the left edge.
75
\value AlignRight Aligns with the right edge.
76
\value AlignHCenter Centers horizontally in the available space.
77
\value AlignJustify Justifies the text in the available space.
80
The vertical flags are:
82
\value AlignTop Aligns with the top.
83
\value AlignBottom Aligns with the bottom.
84
\value AlignVCenter Centers vertically in the available space.
86
You can use only one of the horizontal flags at a time. There is
87
one two-dimensional flag:
89
\value AlignCenter Centers in both dimensions.
91
You can use at most one horizontal and one vertical flag at a
92
time. Qt::AlignCenter counts as both horizontal and vertical.
94
Three enum values are useful in applications that can be run in
97
\value AlignAbsolute If the widget's layout direction is
98
Qt::RightToLeft (instead of Qt::LeftToRight, the default),
99
Qt::AlignLeft refers to the \e right edge and Qt::AlignRight
100
to the \e left edge. This is normally the desired behavior.
101
If you want Qt::AlignLeft to always mean "left" and
102
Qt::AlignRight to always mean "right", combine the flag with
104
\value AlignLeading Synonym for Qt::AlignLeft.
105
\value AlignTrailing Synonym for Qt::AlignRight.
109
\value AlignHorizontal_Mask
110
\value AlignVertical_Mask
112
Conflicting combinations of flags have undefined meanings.
116
\enum Qt::ApplicationAttribute
118
This enum describes attributes that change the behavior of
119
application-wide features. These are enabled and disabled using
120
QCoreApplication::setAttribute(), and can be tested for with
121
QCoreApplication::testAttribute().
123
\value AA_ImmediateWidgetCreation Ensures that widgets are created
124
as soon as they are constructed. By default, resources for
125
widgets are allocated on demand to improve efficiency and
126
minimize resource usage. Setting or clearing this attribute
127
affects widgets constructed after the change. Setting it
128
tells Qt to create toplevel windows immediately.
129
Therefore, if it is important to minimize resource
130
consumption, do not set this attribute.
132
\value AA_MSWindowsUseDirect3DByDefault Is a Windows specific
133
attribute, that will make the Direct3D paint engine the
134
default Qt widget paint engine. Note that you can toggle
135
usage of the Direct3D engine on individual QWidgets by
136
setting/clearing the \c WA_MSWindowsUseDirect3D attribute
137
on a specific widget. \bold {This functionality is
140
\value AA_DontShowIconsInMenus Actions with the Icon property won't be
141
shown in any menus unless specifically set by the
142
QAction::iconVisibleInMenu property.
144
Menus that are currently open or menus already created in the native
145
Mac OS X menubar \e{may not} pick up a change in this attribute. Changes
146
in the QAction::iconVisibleInMenu property will always be picked up.
148
\value AA_NativeWindows Ensures that widgets have native windows.
150
\value AA_DontCreateNativeWidgetSiblings Ensures that siblings of native
151
widgets stay non-native unless specifically set by the
152
Qt::WA_NativeWindow attribute.
154
\value AA_MacPluginApplication Stops the a Qt mac application from doing
155
specific initializations that do not necessarily make sense when using Qt
156
to author a plugin. This includes avoiding loading our nib for the main
157
menu and not taking possession of the native menu bar.
159
\omitvalue AA_AttributeCount
163
\enum Qt::MouseButton
165
This enum type describes the different mouse buttons.
167
\value NoButton The button state does not refer to any
168
button (see QMouseEvent::button()).
169
\value LeftButton The left button is pressed, or an event refers
170
to the left button. (The left button may be the right button on
172
\value RightButton The right button.
173
\value MidButton The middle button.
174
\value XButton1 The first X button.
175
\value XButton2 The second X button.
177
\omitvalue MouseButtonMask
179
\sa KeyboardModifier Modifier
183
\enum Qt::KeyboardModifier
185
This enum describes the modifier keys.
187
\value NoModifier No modifier key is pressed.
188
\value ShiftModifier A Shift key on the keyboard is pressed.
189
\value ControlModifier A Ctrl key on the keyboard is pressed.
190
\value AltModifier An Alt key on the keyboard is pressed.
191
\value MetaModifier A Meta key on the keyboard is pressed.
192
\value KeypadModifier A keypad button is pressed.
193
\value GroupSwitchModifier X11 only. A Mode_switch key on the keyboard is pressed.
195
\omitvalue KeyboardModifierMask
197
\note On Mac OS X, the \c ControlModifier value corresponds to
198
the Command keys on the Macintosh keyboard, and the \c MetaModifier value
199
corresponds to the Control keys. The \c KeypadModifier value will also be set
200
when an arrow key is pressed as the arrow keys are considered part of the
203
\note On Windows Keyboards, Qt::MetaModifier and Qt::Key_Meta are mapped
206
\sa MouseButton Modifier
212
This enum provides shorter names for the keyboard modifier keys
215
\bold{Note:} On Mac OS X, the \c CTRL value corresponds to
216
the Command keys on the Macintosh keyboard, and the \c META value
217
corresponds to the Control keys.
219
\value SHIFT The Shift keys provided on all standard keyboards.
220
\value META The Meta keys.
221
\value CTRL The Ctrl keys.
222
\value ALT The normal Alt keys, but not keys like AltGr.
223
\value UNICODE_ACCEL The shortcut is specified as a Unicode code
224
point, not as a Qt Key.
225
\omitvalue MODIFIER_MASK
227
\sa KeyboardModifier MouseButton
231
\enum Qt::GlobalColor
234
<style type="text/css" id="colorstyles">
235
#white { background-color: #ffffff; color: #000000 }
236
#black { background-color: #000000; color: #ffffff }
237
#red { background-color: #ff0000; color: #000000 }
238
#darkRed { background-color: #800000; color: #ffffff }
239
#green { background-color: #00ff00; color: #000000 }
240
#darkGreen { background-color: #008000; color: #ffffff }
241
#blue { background-color: #0000ff; color: #ffffff }
242
#darkBlue { background-color: #000080; color: #ffffff }
243
#cyan { background-color: #00ffff; color: #000000 }
244
#darkCyan { background-color: #008080; color: #ffffff }
245
#magenta { background-color: #ff00ff; color: #000000 }
246
#darkMagenta { background-color: #800080; color: #ffffff }
247
#yellow { background-color: #ffff00; color: #000000 }
248
#darkYellow { background-color: #808000; color: #ffffff }
249
#gray { background-color: #a0a0a4; color: #000000 }
250
#darkGray { background-color: #808080; color: #ffffff }
251
#lightGray { background-color: #c0c0c0; color: #000000 }
255
Qt's predefined QColor objects:
257
\value white \raw HTML
258
White <tt id="white">(#ffffff)</tt>
260
\value black \raw HTML
261
Black <tt id="black">(#000000)</tt>
264
Red <tt id="red">(#ff0000)</tt>
266
\value darkRed \raw HTML
267
Dark red <tt id="darkRed">(#800000)</tt>
269
\value green \raw HTML
270
Green <tt id="green">(#00ff00)</tt>
272
\value darkGreen \raw HTML
273
Dark green <tt id="darkGreen">(#008000)</tt>
275
\value blue \raw HTML
276
Blue <tt id="blue">(#0000ff)</tt>
278
\value darkBlue \raw HTML
279
Dark blue <tt id="darkBlue">(#000080)</tt>
281
\value cyan \raw HTML
282
Cyan <tt id="cyan">(#00ffff)</tt>
284
\value darkCyan \raw HTML
285
Dark cyan <tt id="darkCyan">(#008080)</tt>
287
\value magenta \raw HTML
288
Magenta <tt id="magenta">(#ff00ff)</tt>
290
\value darkMagenta \raw HTML
291
Dark magenta <tt id="darkMagenta">(#800080)</tt>
293
\value yellow \raw HTML
294
Yellow <tt id="yellow">(#ffff00)</tt>
296
\value darkYellow \raw HTML
297
Dark yellow <tt id="darkYellow">(#808000)</tt>
299
\value gray \raw HTML
300
Gray <tt id="gray">(#a0a0a4)</tt>
302
\value darkGray \raw HTML
303
Dark gray <tt id="darkGray">(#808080)</tt>
305
\value lightGray \raw HTML
306
Light gray <tt id="lightGray">(#c0c0c0)</tt>
308
\value transparent a transparent black value (i.e., QColor(0, 0, 0, 0))
309
\value color0 0 pixel value (for bitmaps)
310
\value color1 1 pixel value (for bitmaps)
319
This enum type defines the pen styles that can be drawn using
320
QPainter. The styles are:
324
\o \inlineimage qpen-solid.png
325
\o \inlineimage qpen-dash.png
326
\o \inlineimage qpen-dot.png
332
\o \inlineimage qpen-dashdot.png
333
\o \inlineimage qpen-dashdotdot.png
334
\o \inlineimage qpen-custom.png
337
\o Qt::DashDotDotLine
338
\o Qt::CustomDashLine
341
\value NoPen no line at all. For example, QPainter::drawRect()
342
fills but does not draw any boundary line.
344
\value SolidLine A plain line.
345
\value DashLine Dashes separated by a few pixels.
346
\value DotLine Dots separated by a few pixels.
347
\value DashDotLine Alternate dots and dashes.
348
\value DashDotDotLine One dash, two dots, one dash, two dots.
349
\value CustomDashLine A custom pattern defined using
350
QPainterPathStroker::setDashPattern().
358
\enum Qt::PenCapStyle
360
This enum type defines the pen cap styles supported by Qt, i.e.
361
the line end caps that can be drawn using QPainter.
365
\o \inlineimage qpen-square.png
366
\o \inlineimage qpen-flat.png
367
\o \inlineimage qpen-roundcap.png
374
\value FlatCap a square line end that does not cover the end
376
\value SquareCap a square line end that covers the end point and
377
extends beyond it by half the line width.
378
\value RoundCap a rounded line end.
379
\omitvalue MPenCapStyle
385
\enum Qt::PenJoinStyle
387
This enum type defines the pen join styles supported by Qt, i.e.
388
which joins between two connected lines can be drawn using
393
\o \inlineimage qpen-bevel.png
394
\o \inlineimage qpen-miter.png
395
\o \inlineimage qpen-roundjoin.png
402
\value MiterJoin The outer edges of the lines are extended to
403
meet at an angle, and this area is filled.
404
\value BevelJoin The triangular notch between the two lines is filled.
405
\value RoundJoin A circular arc between the two lines is filled.
406
\value SvgMiterJoin A miter join corresponding to the definition of
407
a miter join in the \l{SVG 1.2 Tiny} specification.
408
\omitvalue MPenJoinStyle
416
This enum type defines the brush styles supported by Qt, i.e. the
417
fill pattern of shapes drawn using QPainter.
419
\image brush-styles.png Brush Styles
421
\value NoBrush No brush pattern.
422
\value SolidPattern Uniform color.
423
\value Dense1Pattern Extremely dense brush pattern.
424
\value Dense2Pattern Very dense brush pattern.
425
\value Dense3Pattern Somewhat dense brush pattern.
426
\value Dense4Pattern Half dense brush pattern.
427
\value Dense5Pattern Somewhat sparse brush pattern.
428
\value Dense6Pattern Very sparse brush pattern.
429
\value Dense7Pattern Extremely sparse brush pattern.
430
\value HorPattern Horizontal lines.
431
\value VerPattern Vertical lines.
432
\value CrossPattern Crossing horizontal and vertical lines.
433
\value BDiagPattern Backward diagonal lines.
434
\value FDiagPattern Forward diagonal lines.
435
\value DiagCrossPattern Crossing diagonal lines.
436
\value LinearGradientPattern Linear gradient (set using a dedicated QBrush constructor).
437
\value ConicalGradientPattern Conical gradient (set using a dedicated QBrush constructor).
438
\value RadialGradientPattern Radial gradient (set using a dedicated QBrush constructor).
439
\value TexturePattern Custom pattern (see QBrush::setTexture()).
441
\omitvalue CustomPattern
449
This enum type is used to define some modifier flags. Some of
450
these flags only make sense in the context of printing:
452
\value TextSingleLine Treats all whitespace as spaces and prints just
454
\value TextDontClip If it's impossible to stay within the given bounds,
456
\value TextExpandTabs Makes the U+0009 (ASCII tab) character move to
458
\value TextShowMnemonic Displays the string "\&P" as \underline{P}
459
(see QButton for an example). For an ampersand, use "\&\&".
460
\value TextWordWrap Breaks lines at appropriate points, e.g. at word
462
\value TextWrapAnywhere Breaks lines anywhere, even within words.
463
\value TextHideMnemonic Same as Qt::TextShowMnemonic but doesn't draw the underlines.
464
\value TextDontPrint Treat this text as "hidden" and don't print
466
\value IncludeTrailingSpaces When this option is set, QTextLine::naturalTextWidth() and naturalTextRect() will
467
return a value that includes the width of trailing spaces in the text; otherwise
468
this width is excluded.
469
\value TextIncludeTrailingSpaces Same as IncludeTrailingSpaces
470
\value TextJustificationForced Ensures that text lines are justified.
472
\omitvalue BreakAnywhere
475
\omitvalue ExpandTabs
476
\omitvalue IncludeTrailingSpaces
478
\omitvalue ShowPrefix
479
\omitvalue SingleLine
481
\omitvalue TextForceLeftToRight
482
\omitvalue TextForceRightToLeft
484
You can use as many modifier flags as you want, except that
485
Qt::TextSingleLine and Qt::TextWordWrap cannot be combined.
487
Flags that are inappropriate for a given use are generally
496
\value TransparentMode
501
\enum Qt::ConnectionType
503
This enum describes the types of connection that can be used between signals and
504
slots. In particular, it determines whether a particular signal is delivered to a
505
slot immediately or queued for delivery at a later time.
507
\omitvalue AutoCompatConnection
508
\value DirectConnection When emitted, the signal is immediately delivered to the slot.
509
\value QueuedConnection When emitted, the signal is queued until the event loop is
510
able to deliver it to the slot.
511
\value BlockingQueuedConnection
512
Same as QueuedConnection, except that the current thread blocks
513
until the slot has been delivered. This connection type should
514
only be used for receivers in a different thread. Note that misuse
515
of this type can lead to deadlocks in your application.
516
\value AutoConnection If the signal is emitted from the thread
517
in which the receiving object lives, the
518
slot is invoked directly, as with
519
Qt::DirectConnection; otherwise the
520
signal is queued, as with
521
Qt::QueuedConnection.
523
With queued connections, the parameters must be of types that are known to
524
Qt's meta-object system, because Qt needs to copy the arguments to store them
525
in an event behind the scenes. If you try to use a queued connection and
526
get the error message
528
\snippet doc/src/snippets/code/doc_src_qnamespace.qdoc 0
530
call qRegisterMetaType() to register the data type before you
531
establish the connection.
533
\sa {Thread Support in Qt}, QObject::connect(), qRegisterMetaType()
539
\value TextDate The default Qt format, which includes the day and month name,
540
the day number in the month, and the year in full. The day and month names will
541
be short, localized names. This is basically equivalent to using the date format
542
string, "ddd MMM d yyyy". See QDate::toString() for more information.
544
\value ISODate ISO 8601 extended format: either \c{YYYY-MM-DD} for dates or
545
\c{YYYY-MM-DDTHH:MM:SS} for combined dates and times.
547
\value SystemLocaleShortDate The \l{QLocale::ShortFormat}{short format} used
548
by the \l{QLocale::system()}{operating system}.
550
\value SystemLocaleLongDate The \l{QLocale::LongFormat}{long format} used
551
by the \l{QLocale::system()}{operating system}.
553
\value DefaultLocaleShortDate The \l{QLocale::ShortFormat}{short format} specified
554
by the \l{QLocale::setDefault()}{application's locale}.
556
\value DefaultLocaleLongDate The \l{QLocale::LongFormat}{long format} used
557
by the \l{QLocale::setDefault()}{application's locale}.
559
\value SystemLocaleDate \e{This enum value is deprecated.} Use Qt::SystemLocaleShortDate
560
instead (or Qt::SystemLocaleLongDate if you want long dates).
562
\value LocaleDate \e{This enum value is deprecated.} Use Qt::DefaultLocaleShortDate
563
instead (or Qt::DefaultLocaleLongDate if you want long dates).
565
\value LocalDate \e{This enum value is deprecated.} Use Qt::SystemLocaleShortDate
566
instead (or Qt::SystemLocaleLongDate if you want long dates).
568
\note For \c ISODate formats, each \c Y, \c M and \c D represents a single digit
569
of the year, month and day used to specify the date. Each \c H, \c M and \c S
570
represents a single digit of the hour, minute and second used to specify the time.
571
The presence of a literal \c T character is used to separate the date and time when
579
\value LocalTime Locale dependent time (Timezones and Daylight Savings Time).
580
\value UTC Coordinated Universal Time, replaces Greenwich Mean Time.
581
\value OffsetFromUTC An offset in seconds from Coordinated Universal Time.
597
\enum Qt::CaseSensitivity
599
\value CaseInsensitive
604
\enum Qt::ToolBarArea
606
\value LeftToolBarArea
607
\value RightToolBarArea
608
\value TopToolBarArea
609
\value BottomToolBarArea
610
\value AllToolBarAreas
613
\omitvalue ToolBarArea_Mask
617
\enum Qt::DockWidgetArea
619
\value LeftDockWidgetArea
620
\value RightDockWidgetArea
621
\value TopDockWidgetArea
622
\value BottomDockWidgetArea
623
\value AllDockWidgetAreas
624
\value NoDockWidgetArea
626
\omitvalue DockWidgetArea_Mask
630
\enum Qt::BackgroundMode
637
\value PaletteForeground
640
\value PaletteMidlight
644
\value PaletteBrightText
646
\value PaletteBackground
648
\value PaletteHighlight
649
\value PaletteHighlightedText
650
\value PaletteButtonText
652
\value PaletteLinkVisited
653
\value X11ParentRelative
657
\enum Qt::ImageConversionFlag
659
The options marked "(default)" are set if no other values from
660
the list are included (since the defaults are zero):
662
Color/Mono preference (ignored for QBitmap):
664
\value AutoColor (default) - If the image has \link
665
QImage::depth() depth\endlink 1 and contains only
666
black and white pixels, the pixmap becomes monochrome.
667
\value ColorOnly The pixmap is dithered/converted to the
668
\link QPixmap::defaultDepth() native display depth\endlink.
669
\value MonoOnly The pixmap becomes monochrome. If necessary,
670
it is dithered using the chosen dithering algorithm.
672
Dithering mode preference for RGB channels:
674
\value DiffuseDither (default) - A high-quality dither.
675
\value OrderedDither A faster, more ordered dither.
676
\value ThresholdDither No dithering; closest color is used.
678
Dithering mode preference for alpha channel:
680
\value ThresholdAlphaDither (default) - No dithering.
681
\value OrderedAlphaDither A faster, more ordered dither.
682
\value DiffuseAlphaDither A high-quality dither.
685
Color matching versus dithering preference:
687
\value PreferDither (default when converting to a pixmap) - Always dither
688
32-bit images when the image is converted to 8 bits.
689
\value AvoidDither (default when converting for the purpose of saving to
690
file) - Dither 32-bit images only if the image has more than 256
691
colors and it is being converted to 8 bits.
692
\omitvalue AutoDither
694
\omitvalue ColorMode_Mask
695
\omitvalue Dither_Mask
696
\omitvalue AlphaDither_Mask
697
\omitvalue DitherMode_Mask
698
\omitvalue NoOpaqueDetection
701
/*! \enum Qt::GUIStyle
715
This enum describes the available UI effects.
717
By default, Qt will try to use the platform specific desktop
718
settings for each effect. Use the
719
QApplication::setDesktopSettingsAware() function (passing \c false
720
as argument) to prevent this, and the
721
QApplication::setEffectEnabled() to enable or disable a particular
724
Note that all effects are disabled on screens running at less than
727
\omitvalue UI_General
729
\value UI_AnimateMenu Show animated menus.
730
\value UI_FadeMenu Show faded menus.
731
\value UI_AnimateCombo Show animated comboboxes.
732
\value UI_AnimateTooltip Show tooltip animations.
733
\value UI_FadeTooltip Show tooltip fading effects.
734
\value UI_AnimateToolBox Reserved
736
\sa QApplication::setEffectEnabled(), QApplication::setDesktopSettingsAware()
739
/*! \enum Qt::AspectRatioMode
741
This enum type defines what happens to the aspect ratio when
742
scaling an rectangle.
744
\image qimage-scaling.png
746
\value IgnoreAspectRatio The size is scaled freely. The aspect
747
ratio is not preserved.
748
\value KeepAspectRatio The size is scaled to a rectangle as
749
large as possible inside a given
750
rectangle, preserving the aspect ratio.
751
\value KeepAspectRatioByExpanding The size is scaled to a
752
rectangle as small as possible
753
outside a given rectangle,
754
preserving the aspect ratio.
760
\sa QSize::scale(), QImage::scaled()
763
/*! \typedef Qt::ScaleMode
766
Use Qt::AspectRatioMode instead.
768
The enum values have been renamed as follows:
771
\row \i Old enum value \i New enum value
772
\row \i Qt::ScaleFree \i Qt::IgnoreAspectRatio
773
\row \i Qt::ScaleMin \i Qt::KeepAspectRatio
774
\row \i Qt::ScaleMax \i Qt::KeepAspectRatioByExpanding
778
/*! \enum Qt::TransformationMode
780
This enum type defines whether image transformations (e.g.,
781
scaling) should be smooth or not.
783
\value FastTransformation The transformation is performed
784
quickly, with no smoothing.
785
\value SmoothTransformation The resulting image is transformed
786
using bilinear filtering.
793
This enum type defines three values to represent the three
794
axes in the cartesian coordinate system.
796
\value XAxis The X axis.
797
\value YAxis The Y axis.
798
\value ZAxis The Z axis.
800
\sa QTransform::rotate(), QTransform::rotateRadians()
804
\enum Qt::WidgetAttribute
806
\keyword widget attributes
808
This enum type is used to specify various widget attributes.
809
Attributes are set and cleared with QWidget::setAttribute(), and
810
queried with QWidget::testAttribute(), although some have special
811
convenience functions which are mentioned below.
813
\value WA_AcceptDrops Allows data from drag and drop operations
814
to be dropped onto the widget (see QWidget::setAcceptDrops()).
816
\value WA_AlwaysShowToolTips Enables tooltips for inactive windows.
818
\value WA_ContentsPropagated This flag is superfluous and
819
obsolete; it no longer has any effect. Since Qt 4.1, all widgets
820
that do not set WA_PaintOnScreen propagate their contents.
822
\value WA_CustomWhatsThis Indicates that the widget wants to
823
continue operating normally in "What's This?" mode. This is set by the
826
\value WA_DeleteOnClose Makes Qt delete this widget when the
827
widget has accepted the close event (see QWidget::closeEvent()).
829
\value WA_Disabled Indicates that the widget is disabled, i.e.
830
it does not receive any mouse or keyboard events. There is also a
831
getter functions QWidget::isEnabled(). This is set/cleared by the
834
\omitvalue WA_DropSiteRegistered
835
\omitvalue WA_ForceAcceptDrops
837
\value WA_ForceDisabled Indicates that the widget is
838
explicitly disabled, i.e. it will remain disabled even when all
839
its ancestors are set to the enabled state. This implies
840
WA_Disabled. This is set/cleared by QWidget::setEnabled() and
841
QWidget::setDisabled().
843
\value WA_ForceUpdatesDisabled Indicates that updates are
844
explicitly disabled for the widget; i.e. it will remain disabled
845
even when all its ancestors are set to the updates-enabled state.
846
This implies WA_UpdatesDisabled. This is set/cleared by
847
QWidget::setUpdatesEnabled().
849
\value WA_GroupLeader
850
\e{This attribute has been deprecated.} Use QWidget::windowModality
853
\value WA_Hover Forces Qt to generate paint events when the mouse
854
enters or leaves the widget. This feature is typically used when
855
implementing custom styles; see the \l{widgets/styles}{Styles}
858
\value WA_InputMethodEnabled Enables input methods for Asian languages.
859
Must be set when creating custom text editing widgets.
860
On Windows CE this flag can be used in addition to
861
QApplication::autoSipEnabled to automatically display the SIP when
864
\value WA_KeyboardFocusChange Set on a toplevel window when
865
the users changes focus with the keyboard (tab, backtab, or shortcut).
867
\value WA_KeyCompression Enables key event compression if set,
868
and disables it if not set. By default key compression is off, so
869
widgets receive one key press event for each key press (or more,
870
since autorepeat is usually on). If you turn it on and your
871
program doesn't keep up with key input, Qt may try to compress key
872
events so that more than one character can be processed in each
874
For example, a word processor widget might receive 2, 3 or more
875
characters in each QKeyEvent::text(), if the layout recalculation
876
takes too long for the CPU.
877
If a widget supports multiple character unicode input, it is
878
always safe to turn the compression on.
879
Qt performs key event compression only for printable characters.
880
Qt::Modifier keys, cursor movement keys, function keys and
881
miscellaneous action keys (e.g. Escape, Enter, Backspace,
882
PrintScreen) will stop key event compression, even if there are
883
more compressible key events available.
884
Platforms other than Mac and X11 do not support this compression,
885
in which case turning it on will have no effect.
886
This is set/cleared by the widget's author.
888
\value WA_LayoutOnEntireRect Indicates that the widget
889
wants QLayout to operate on the entire QWidget::rect(), not only
890
on QWidget::contentsRect(). This is set by the widget's author.
892
\value WA_LayoutUsesWidgetRect Ignore the layout item rect from the style
893
when laying out this widget with QLayout. This makes a difference in
894
QMacStyle and QPlastiqueStyle for some widgets.
896
\value WA_MacNoClickThrough When a widget that has this attribute set
897
is clicked, and its window is inactive, the click will make the window
898
active but won't be seen by the widget. Typical use of this attribute
899
is on widgets with "destructive" actions, such as a "Delete" button.
900
WA_MacNoClickThrough also applies to all child widgets of the widget
903
\value WA_MacOpaqueSizeGrip Indicates that the native Carbon size grip
904
should be opaque instead of transparent (the default). This attribute
905
is only applicable to Mac OS X and is set by the widget's author.
907
\value WA_MacShowFocusRect Indicates that this widget should get a
908
QFocusFrame around it. Some widgets draw their own focus halo
909
regardless of this attribute. Not that the QWidget::focusPolicy
910
also plays the main role in whether something is given focus or
911
not, this only controls whether or not this gets the focus
912
frame. This attribute is only applicable to Mac OS X.
914
\value WA_MacNormalSize Indicates the widget should have the
915
normal size for widgets in Mac OS X. This attribute is only
916
applicable to Mac OS X.
918
\value WA_MacSmallSize Indicates the widget should have the small
919
size for widgets in Mac OS X. This attribute is only applicable to
922
\value WA_MacMiniSize Indicates the widget should have the mini
923
size for widgets in Mac OS X. This attribute is only applicable to
926
\value WA_MacVariableSize Indicates the widget can choose between
927
alternative sizes for widgets to avoid clipping.
928
This attribute is only applicable to Mac OS X.
930
\value WA_MacBrushedMetal Indicates the widget should be drawn in
931
the brushed metal style as supported by the windowing system. This
932
attribute is only applicable to Mac OS X.
934
\omitvalue WA_MacMetalStyle
936
\value WA_Mapped Indicates that the widget is mapped on screen.
937
This is set/cleared by the Qt kernel.
939
\value WA_MouseNoMask Makes the widget receive mouse events for
940
the entire widget regardless of the currently set mask,
941
overriding QWidget::setMask(). This is not applicable for
944
\value WA_MouseTracking Indicates that the widget has mouse
945
tracking enabled. See QWidget::mouseTracking.
947
\value WA_Moved Indicates that the widget has an explicit
948
position. This is set/cleared by QWidget::move() and
949
by QWidget::setGeometry().
951
\value WA_MSWindowsUseDirect3D Makes drawing to a widget
952
with this attribute set use the Direct3D paint engine, if the
953
Direct3D paint engine is available. \bold {This functionality
956
\value WA_NoBackground This value is obsolete. Use
957
WA_OpaquePaintEvent instead.
959
\value WA_NoChildEventsForParent Indicates that the widget does
960
not want ChildAdded or ChildRemoved events sent to its
961
parent. This is rarely necessary but can help to avoid automatic
962
insertion widgets like splitters and layouts. This is set by a
965
\value WA_NoChildEventsFromChildren Indicates that the widget does
966
not want to receive ChildAdded or ChildRemoved events sent from its
967
children. This is set by a widget's author.
969
\value WA_NoMouseReplay Used for pop-up widgets. Indicates that the most
970
recent mouse press event should not be replayed when the pop-up widget
971
closes. The flag is set by the widget's author and cleared by the Qt kernel
972
every time the widget receives a new mouse event.
974
\value WA_NoMousePropagation Prohibits mouse events from being propagated
975
to the widget's parent. This attribute is disabled by default.
977
\value WA_TransparentForMouseEvents When enabled, this attribute disables
978
the delivery of mouse events to the widget and its children. Mouse events
979
are delivered to other widgets as if the widget and its children were not
980
present in the widget hierarchy; mouse clicks and other events effectively
981
"pass through" them. This attribute is disabled by default.
983
\value WA_NoSystemBackground Indicates that the widget has no background,
984
i.e. when the widget receives paint events, the background is not
985
automatically repainted. \note Unlike WA_OpaquePaintEvent, newly exposed
986
areas are \bold never filled with the background (e.g., after showing a
987
window for the first time the user can see "through" it until the
988
application processes the paint events). This flag is set or cleared by the
991
\value WA_OpaquePaintEvent Indicates that the widget paints all its pixels
992
when it receives a paint event. Thus, it is not required for operations
993
like updating, resizing, scrolling and focus changes to erase the widget
994
before generating paint events. The use of WA_OpaquePaintEvent provides a
995
small optimization by helping to reduce flicker on systems that do not
996
support double buffering and avoiding computational cycles necessary to
997
erase the background prior to painting. \note Unlike
998
WA_NoSystemBackground, WA_OpaquePaintEvent makes an effort to avoid
999
transparent window backgrounds. This flag is set or cleared by the widget's
1002
\value WA_OutsideWSRange Indicates that the widget is outside
1003
the valid range of the window system's coordinate system. A widget
1004
outside the valid range cannot be mapped on screen. This is
1005
set/cleared by the Qt kernel.
1007
\value WA_PaintOnScreen Indicates that the widget wants to draw directly
1008
onto the screen. Widgets with this attribute set do not participate in
1009
composition management, i.e. they cannot be semi-transparent or shine
1010
through semi-transparent overlapping widgets. \note This flag is only
1011
supported on X11 and it disables double buffering. On Qt for Embedded
1012
Linux, the flag only works when set on a top-level widget and it relies on
1013
support from the active screen driver. This flag is set or cleared by the
1014
widget's author. To render outside of Qt's paint system, e.g., if you
1015
require native painting primitives, you need to reimplement
1016
QWidget::paintEngine() to return 0 and set this flag.
1018
\value WA_PaintOutsidePaintEvent Makes it possible to use QPainter to
1019
paint on the widget outside \l{QWidget::paintEvent()}{paintEvent()}. This
1020
flag is not supported on Windows, Mac OS X or Embedded Linux. We recommend
1021
that you use it only when porting Qt 3 code to Qt 4.
1023
\value WA_PaintUnclipped Makes all painters operating on this widget
1024
unclipped. Children of this widget or other widgets in front of it do not
1025
clip the area the painter can paint on. This flag is only supported for
1026
widgets with the WA_PaintOnScreen flag set. The preferred way to do this in
1027
a cross platform way is to create a transparent widget that lies in front
1028
of the other widgets.
1030
\value WA_PendingMoveEvent Indicates that a move event is pending, e.g.,
1031
when a hidden widget was moved. This flag is set or cleared by the Qt
1034
\value WA_PendingResizeEvent Indicates that a resize event is pending,
1035
e.g., when a hidden widget was resized. This flag is set or cleared by the
1038
\value WA_QuitOnClose Makes Qt quit the application when the last widget
1039
with the attribute set has accepted closeEvent(). This behavior can be
1040
modified with the QApplication::quitOnLastWindowClosed property. By default
1041
this attribute is set for all widgets of type Qt::Window.
1043
\value WA_Resized Indicates that the widget has an explicit size. This flag
1044
is set or cleared by QWidget::resize() and QWidget::setGeometry().
1046
\value WA_RightToLeft Indicates that the layout direction for the widget
1049
\value WA_SetCursor Indicates that the widget has a cursor of its own. This
1050
flag is set or cleared by QWidget::setCursor() and QWidget::unsetCursor().
1052
\value WA_SetFont Indicates that the widget has a font of its own. This
1053
flag is set or cleared by QWidget::setFont().
1055
\value WA_SetPalette Indicates that the widget has a palette of its own.
1056
This flag is set or cleared by QWidget::setPalette().
1058
\value WA_SetStyle Indicates that the widget has a style of its own. This
1059
flag is set or cleared by QWidget::setStyle().
1061
\value WA_ShowModal \e{This attribute has been deprecated.} Use
1062
QWidget::windowModality instead.
1064
\value WA_StaticContents Indicates that the widget contents are north-west
1065
aligned and static. On resize, such a widget will receive paint events only
1066
for parts of itself that are newly visible. This flag is set or cleared by
1067
the widget's author.
1069
\value WA_StyleSheet Indicates that the widget is styled using a
1070
\l{Qt Style Sheets}{style sheet}.
1072
\value WA_TranslucentBackground Indicates that the widget should have a
1073
translucent background, i.e., any non-opaque regions of the widgets will be
1074
translucent because the widget will have an alpha channel. Setting this
1075
flag causes WA_NoSystemBackground to be set. On Windows the
1076
widget also needs the Qt::FramelessWindowHint window flag to be set.
1077
This flag is set or cleared by the widget's author.
1079
\value WA_UnderMouse Indicates that the widget is under the mouse cursor.
1080
The value is not updated correctly during drag and drop operations. There
1081
is also a getter function, QWidget::underMouse(). This flag is set or
1082
cleared by the Qt kernel.
1084
\value WA_UpdatesDisabled Indicates that updates are blocked (including the
1085
system background). This flag is set or cleared by the Qt kernel.
1086
\warning This flag must \e never be set or cleared by the widget's author.
1088
\value WA_WindowModified Indicates that the window is marked as modified.
1089
On some platforms this flag will do nothing, on others (including Mac OS X
1090
and Windows) the window will take a modified appearance. This flag is set
1091
or cleared by QWidget::setWindowModified().
1093
\value WA_WindowPropagation Makes a toplevel window inherit font and
1094
palette from its parent.
1096
\value WA_MacAlwaysShowToolWindow On Mac OS X, show the tool window even
1097
when the application is not active. By default, all tool windows are
1098
hidden when the application is inactive.
1100
\value WA_SetLocale Indicates the locale should be taken into consideration
1103
\value WA_StyledBackground Indicates the widget should be drawn using a
1106
\value WA_ShowWithoutActivating Show the widget without making it active.
1108
\value WA_NativeWindow Indicates that a native window is created for the
1109
widget. Enabling this flag will also force a native window for the widget's
1110
ancestors unless Qt::WA_DontCreateNativeAncestors is set.
1112
\value WA_DontCreateNativeAncestors Indicates that the widget's ancestors
1113
are kept non-native even though the widget itself is native.
1115
\value WA_X11NetWmWindowTypeDesktop Adds _NET_WM_WINDOW_TYPE_DESKTOP to the
1116
window's _NET_WM_WINDOW_TYPE X11 window property. See
1117
http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1118
has no effect on non-X11 platforms.
1120
\value WA_X11NetWmWindowTypeDock Adds _NET_WM_WINDOW_TYPE_DOCK to the
1121
window's _NET_WM_WINDOW_TYPE X11 window property. See
1122
http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1123
has no effect on non-X11 platforms.
1125
\value WA_X11NetWmWindowTypeToolBar Adds _NET_WM_WINDOW_TYPE_TOOLBAR to the
1126
window's _NET_WM_WINDOW_TYPE X11 window property. See
1127
http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1128
has no effect on non-X11 platforms. \note Qt automaticaly sets this
1129
attribute for QToolBar.
1131
\value WA_X11NetWmWindowTypeMenu Adds _NET_WM_WINDOW_TYPE_MENU to the
1132
window's _NET_WM_WINDOW_TYPE X11 window property. See
1133
http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1134
has no effect on non-X11 platforms. \note Qt automatically sets this
1135
attribute for QMenu when torn-off.
1137
\value WA_X11NetWmWindowTypeUtility Adds _NET_WM_WINDOW_TYPE_UTILITY to the
1138
window's _NET_WM_WINDOW_TYPE X11 window property. See
1139
http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1140
has no effect on non-X11 platforms. \note Qt automatically sets this
1141
attribute for the Qt::Tool window type.
1143
\value WA_X11NetWmWindowTypeSplash Adds _NET_WM_WINDOW_TYPE_SPLASH to the
1144
window's _NET_WM_WINDOW_TYPE X11 window property. See
1145
http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1146
has no effect on non-X11 platforms. \note Qt automatically sets this
1147
attribute for the Qt::SplashScreen window type.
1149
\value WA_X11NetWmWindowTypeDialog Adds _NET_WM_WINDOW_TYPE_DIALOG
1150
to the window's _NET_WM_WINDOW_TYPE X11 window property. See
1151
http://standards.freedesktop.org/wm-spec/ for more details. This
1152
attribute has no effect on non-X11 platforms. \note Qt automatically sets
1153
this attribute for the Qt::Dialog and Qt::Sheet window types.
1155
\value WA_X11NetWmWindowTypeDropDownMenu Adds
1156
_NET_WM_WINDOW_TYPE_DROPDOWN_MENU to the window's
1157
_NET_WM_WINDOW_TYPE X11 window property. See
1158
http://standards.freedesktop.org/wm-spec/ for more details. This
1159
attribute has no effect on non-X11 platforms. \note Qt
1160
automatically sets this attribute for QMenus added to a QMenuBar.
1162
\value WA_X11NetWmWindowTypePopupMenu Adds _NET_WM_WINDOW_TYPE_POPUP_MENU
1163
to the window's _NET_WM_WINDOW_TYPE X11 window property. See
1164
http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1165
has no effect on non-X11 platforms. \note Qt automatically sets this
1166
attribute for QMenu.
1168
\value WA_X11NetWmWindowTypeToolTip Adds _NET_WM_WINDOW_TYPE_TOOLTIP to the
1169
window's _NET_WM_WINDOW_TYPE X11 window property. See
1170
http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1171
has no effect on non-X11 platforms. \note Qt automatically sets this
1172
attribute for the Qt::ToolTip window type.
1174
\value WA_X11NetWmWindowTypeNotification Adds
1175
_NET_WM_WINDOW_TYPE_NOTIFICATION to the window's _NET_WM_WINDOW_TYPE X11
1176
window property. See http://standards.freedesktop.org/wm-spec/ for more
1177
details. This attribute has no effect on non-X11 platforms.
1179
\value WA_X11NetWmWindowTypeCombo Adds _NET_WM_WINDOW_TYPE_COMBO
1180
to the window's _NET_WM_WINDOW_TYPE X11 window property. See
1181
http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1182
has no effect on non-X11 platforms. \note Qt automatically sets this
1183
attribute for the QComboBox pop-up.
1185
\value WA_X11NetWmWindowTypeDND Adds _NET_WM_WINDOW_TYPE_DND to
1186
the window's _NET_WM_WINDOW_TYPE X11 window property. See
1187
http://standards.freedesktop.org/wm-spec/ for more details. This attribute
1188
has no effect on non-X11 platforms. \note Qt automatically sets this
1189
attribute on the feedback widget used during a drag.
1191
\value WA_MacFrameworkScaled Enables resolution independence aware mode
1192
on Mac when using Carbon. This attribute has no effect on Cocoa.
1193
The attribute is off by default and can be enabled on a per-window basis.
1195
\omitvalue WA_SetLayoutDirection
1196
\omitvalue WA_InputMethodTransparent
1197
\omitvalue WA_WState_CompressKeys
1198
\omitvalue WA_WState_ConfigPending
1199
\omitvalue WA_WState_Created
1200
\omitvalue WA_WState_DND
1201
\omitvalue WA_WState_ExplicitShowHide
1202
\omitvalue WA_WState_Hidden
1203
\omitvalue WA_WState_InPaintEvent
1204
\omitvalue WA_WState_OwnSizePolicy
1205
\omitvalue WA_WState_Polished
1206
\omitvalue WA_WState_Reparented
1207
\omitvalue WA_WState_Visible
1208
\omitvalue WA_SetWindowIcon
1209
\omitvalue WA_PendingUpdate
1210
\omitvalue WA_LaidOut
1211
\omitvalue WA_GrabbedShortcut
1212
\omitvalue WA_DontShowOnScreen
1213
\omitvalue WA_InvalidSize
1214
\omitvalue WA_ForceUpdatesDisabled
1215
\omitvalue WA_NoX11EventCompression
1216
\omitvalue WA_TintedBackground
1217
\omitvalue WA_X11OpenGLOverlay
1218
\omitvalue WA_CanHostQMdiSubWindowTitleBar
1219
\omitvalue WA_AttributeCount
1220
\omitvalue WA_StyleSheet
1221
\omitvalue WA_X11BypassTransientForHint
1222
\omitvalue WA_SetWindowModality
1223
\omitvalue WA_WState_WindowOpacitySet
1226
/*! \typedef Qt::HANDLE
1228
Platform-specific handle type for system objects. This is
1229
equivalent to \c{void *} on Windows and Mac OS X, and embedded
1230
Linux, and to \c{unsigned long} on X11.
1232
\warning Using this type is not portable.
1238
The key names used by Qt.
1243
\omitvalue Key_BackTab
1244
\value Key_Backspace
1245
\omitvalue Key_BackSpace
1247
\value Key_Enter Typically located on the keypad.
1261
\omitvalue Key_Prior
1265
\value Key_Control On Mac OS X, this corresponds to the Command keys.
1266
\value Key_Meta On Mac OS X, this corresponds to the Control keys.
1267
On Windows keyboards, this key is mapped to the
1270
\value Key_AltGr On Windows, when the KeyDown event for this key is
1271
sent, the Ctrl+Alt modifiers are also set.
1274
\value Key_ScrollLock
1316
\value Key_Direction_L
1317
\value Key_Direction_R
1322
\value Key_NumberSign
1325
\value Key_Ampersand
1326
\value Key_Apostrophe
1327
\value Key_ParenLeft
1328
\value Key_ParenRight
1346
\value Key_Semicolon
1378
\value Key_BracketLeft
1379
\value Key_Backslash
1380
\value Key_BracketRight
1381
\value Key_AsciiCircum
1382
\value Key_Underscore
1383
\value Key_QuoteLeft
1384
\value Key_BraceLeft
1386
\value Key_BraceRight
1387
\value Key_AsciiTilde
1388
\value Key_nobreakspace
1389
\value Key_exclamdown
1394
\value Key_brokenbar
1396
\value Key_diaeresis
1397
\value Key_copyright
1398
\value Key_ordfeminine
1399
\value Key_guillemotleft
1402
\value Key_registered
1405
\value Key_plusminus
1406
\value Key_twosuperior
1407
\value Key_threesuperior
1410
\value Key_paragraph
1411
\value Key_periodcentered
1413
\value Key_onesuperior
1414
\value Key_masculine
1415
\value Key_guillemotright
1416
\value Key_onequarter
1418
\value Key_threequarters
1419
\value Key_questiondown
1422
\value Key_Acircumflex
1424
\value Key_Adiaeresis
1430
\value Key_Ecircumflex
1431
\value Key_Ediaeresis
1434
\value Key_Icircumflex
1435
\value Key_Idiaeresis
1440
\value Key_Ocircumflex
1442
\value Key_Odiaeresis
1447
\value Key_Ucircumflex
1448
\value Key_Udiaeresis
1452
\omitvalue Key_agrave
1453
\omitvalue Key_aacute
1454
\omitvalue Key_acircumflex
1455
\omitvalue Key_atilde
1456
\omitvalue Key_adiaeresis
1457
\omitvalue Key_aring
1459
\omitvalue Key_ccedilla
1460
\omitvalue Key_egrave
1461
\omitvalue Key_eacute
1462
\omitvalue Key_ecircumflex
1463
\omitvalue Key_ediaeresis
1464
\omitvalue Key_igrave
1465
\omitvalue Key_iacute
1466
\omitvalue Key_icircumflex
1467
\omitvalue Key_idiaeresis
1469
\omitvalue Key_ntilde
1470
\omitvalue Key_ograve
1471
\omitvalue Key_oacute
1472
\omitvalue Key_ocircumflex
1473
\omitvalue Key_otilde
1474
\omitvalue Key_odiaeresis
1476
\omitvalue Key_oslash
1477
\omitvalue Key_ugrave
1478
\omitvalue Key_uacute
1479
\omitvalue Key_ucircumflex
1480
\omitvalue Key_udiaeresis
1481
\omitvalue Key_yacute
1482
\omitvalue Key_thorn
1483
\value Key_ydiaeresis
1484
\value Key_Multi_key
1485
\value Key_Codeinput
1486
\value Key_SingleCandidate
1487
\value Key_MultipleCandidate
1488
\value Key_PreviousCandidate
1489
\value Key_Mode_switch
1496
\value Key_Hiragana_Katakana
1499
\value Key_Zenkaku_Hankaku
1502
\value Key_Kana_Lock
1503
\value Key_Kana_Shift
1504
\value Key_Eisu_Shift
1505
\value Key_Eisu_toggle
1507
\value Key_Hangul_Start
1508
\value Key_Hangul_End
1509
\value Key_Hangul_Hanja
1510
\value Key_Hangul_Jamo
1511
\value Key_Hangul_Romaja
1512
\value Key_Hangul_Jeonja
1513
\value Key_Hangul_Banja
1514
\value Key_Hangul_PreHanja
1515
\value Key_Hangul_PostHanja
1516
\value Key_Hangul_Special
1517
\value Key_Dead_Grave
1518
\value Key_Dead_Acute
1519
\value Key_Dead_Circumflex
1520
\value Key_Dead_Tilde
1521
\value Key_Dead_Macron
1522
\value Key_Dead_Breve
1523
\value Key_Dead_Abovedot
1524
\value Key_Dead_Diaeresis
1525
\value Key_Dead_Abovering
1526
\value Key_Dead_Doubleacute
1527
\value Key_Dead_Caron
1528
\value Key_Dead_Cedilla
1529
\value Key_Dead_Ogonek
1530
\value Key_Dead_Iota
1531
\value Key_Dead_Voiced_Sound
1532
\value Key_Dead_Semivoiced_Sound
1533
\value Key_Dead_Belowdot
1534
\value Key_Dead_Hook
1535
\value Key_Dead_Horn
1540
\value Key_VolumeDown
1541
\value Key_VolumeMute
1543
\value Key_BassBoost
1547
\value Key_TrebleDown
1548
\value Key_MediaPlay
1549
\value Key_MediaStop
1550
\value Key_MediaPrevious
1551
\omitvalue Key_MediaPrev
1552
\value Key_MediaNext
1553
\value Key_MediaRecord
1555
\value Key_Favorites
1559
\value Key_LaunchMail
1560
\value Key_LaunchMedia
1577
\value Key_MediaLast
1598
\sa QKeyEvent::key()
1602
\enum Qt::HitTestAccuracy
1604
This enum contains the types of accuracy that can be used by the
1605
QTextDocument class when testing for mouse clicks on text documents.
1607
\value ExactHit The point at which input occurred must coincide
1608
exactly with input-sensitive parts of the document.
1609
\value FuzzyHit The point at which input occurred can lie close to
1610
input-sensitive parts of the document.
1612
This enum is defined in the \c <QTextDocument> header file.
1616
\enum Qt::WhiteSpaceMode
1618
This enum describes the types of whitespace mode that are used by
1619
the QTextDocument class to meet the requirements of different kinds
1620
of textual information.
1622
\value WhiteSpaceNormal The whitespace mode used to display
1623
normal word wrapped text in paragraphs.
1624
\value WhiteSpacePre A preformatted text mode in which
1625
whitespace is reproduced exactly.
1626
\value WhiteSpaceNoWrap
1628
\omitvalue WhiteSpaceModeUndefined
1630
This enum is defined in the \c <QTextDocument> header file.
1634
\enum Qt::ButtonState_enum
1637
\value ControlButton
1641
\value KeyButtonMask
1643
Use Qt::KeyboardModifier instead.
1647
\typedef Qt::ButtonState
1650
Use Qt::KeyboardModifier instead.
1654
\enum Qt::CheckState
1656
This enum describes the state of checkable items, controls, and widgets.
1658
\value Unchecked The item is unchecked.
1659
\value PartiallyChecked The item is partially checked. Items in hierarchical models
1660
may be partially checked if some, but not all, of their
1661
children are checked.
1662
\value Checked The item is checked.
1664
\sa QCheckBox, Qt::ItemFlags, Qt::ItemDataRole
1669
\enum Qt::ToolButtonStyle
1671
The style of the tool button, describing how the button's text and
1672
icon should be displayed.
1674
\value ToolButtonIconOnly Only display the icon.
1675
\value ToolButtonTextOnly Only display the text.
1676
\value ToolButtonTextBesideIcon The text appears beside the icon.
1677
\value ToolButtonTextUnderIcon The text appears under the icon.
1683
This enum type specifies a corner in a rectangle:
1685
\value TopLeftCorner The top-left corner of the rectangle.
1686
\value TopRightCorner The top-right corner of the rectangle.
1687
\value BottomLeftCorner The bottom-left corner of the rectangle.
1688
\value BottomRightCorner The bottom-right corner of the rectangle.
1692
\omitvalue BottomLeft
1693
\omitvalue BottomRight
1697
\enum Qt::ScrollBarPolicy
1699
This enum type describes the various modes of QAbstractScrollArea's scroll
1702
\value ScrollBarAsNeeded QAbstractScrollArea shows a scroll bar when the
1703
content is too large to fit and not otherwise. This is the
1706
\value ScrollBarAlwaysOff QAbstractScrollArea never shows a scroll bar.
1708
\value ScrollBarAlwaysOn QAbstractScrollArea always shows a scroll bar.
1710
(The modes for the horizontal and vertical scroll bars are
1725
\enum Qt::FocusReason
1727
This enum specifies why the focus changed. It will be passed
1728
through QWidget::setFocus and can be retrieved in the QFocusEvent
1729
sent to the widget upon focus change.
1731
\value MouseFocusReason A mouse action occurred.
1732
\value TabFocusReason The Tab key was pressed.
1733
\value BacktabFocusReason A Backtab occurred. The input for this may
1734
include the Shift or Control keys;
1736
\value ActiveWindowFocusReason The window system made this window either
1738
\value PopupFocusReason The application opened/closed a pop-up that
1739
grabbed/released the keyboard focus.
1740
\value ShortcutFocusReason The user typed a label's buddy shortcut
1741
\value MenuBarFocusReason The menu bar took focus.
1742
\value OtherFocusReason Another reason, usually application-specific.
1744
\omitvalue NoFocusReason
1746
\sa {Keyboard Focus}
1750
\enum Qt::WindowState
1752
\keyword window state
1754
This enum type is used to specify the current state of a top-level
1759
\value WindowNoState The window has no state set (in normal state).
1760
\value WindowMinimized The window is minimized (i.e. iconified).
1761
\value WindowMaximized The window is maximized with a frame around it.
1762
\value WindowFullScreen The window fills the entire screen without any frame around it.
1763
\value WindowActive The window is the active window, i.e. it has keyboard focus.
1768
\enum Qt::ContextMenuPolicy
1770
This enum type defines the various policies a widget can have with
1771
respect to showing a context menu.
1773
\value NoContextMenu the widget does not feature a context menu,
1774
context menu handling is deferred to the widget's parent.
1775
\value PreventContextMenu the widget does not feature a context
1776
menu, and in contrast to \c NoContextMenu, the handling is \e not
1777
deferred to the widget's parent. This means that all right mouse
1778
button events are guaranteed to be delivered to the widget itself
1779
through mousePressEvent(), and mouseReleaseEvent().
1780
\value DefaultContextMenu the widget's QWidget::contextMenuEvent() handler is called.
1781
\value ActionsContextMenu the widget displays its QWidget::actions() as context menu.
1782
\value CustomContextMenu the widget emits the QWidget::customContextMenuRequested() signal.
1786
\enum Qt::FocusPolicy
1788
This enum type defines the various policies a widget can have with
1789
respect to acquiring keyboard focus.
1791
\value TabFocus the widget accepts focus by tabbing.
1792
\value ClickFocus the widget accepts focus by clicking.
1793
\value StrongFocus the widget accepts focus by both tabbing
1794
and clicking. On Mac OS X this will also
1795
be indicate that the widget accepts tab focus
1796
when in 'Text/List focus mode'.
1797
\value WheelFocus like Qt::StrongFocus plus the widget accepts
1798
focus by using the mouse wheel.
1799
\value NoFocus the widget does not accept focus.
1804
\enum Qt::ShortcutContext
1806
For a QEvent::Shortcut event to occur, the shortcut's key sequence
1807
must be entered by the user in a context where the shortcut is
1808
active. The possible contexts are these:
1810
\value WidgetShortcut The shortcut is active when its
1811
parent widget has focus.
1812
\value WidgetWithChildrenShortcut The shortcut is active
1813
when its parent widget, or any of its children has focus.
1814
Children which are top-level widgets, except pop-ups, are
1815
not affected by this shortcut context.
1816
\value WindowShortcut The shortcut is active when its
1817
parent widget is a logical subwidget of the
1818
active top-level window.
1819
\value ApplicationShortcut The shortcut is active when one of
1820
the applications windows are active.
1826
Synonym for Qt::WindowFlags.
1830
\enum Qt::WindowType
1832
\keyword window flag
1834
This enum type is used to specify various window-system properties
1835
for the widget. They are fairly unusual but necessary in a few
1836
cases. Some of these flags depend on whether the underlying window
1837
manager supports them.
1841
\value Widget This is the default type for QWidget. Widgets of
1842
this type are child widgets if they have a parent,
1843
and independent windows if they have no parent.
1844
See also Qt::Window and Qt::SubWindow.
1846
\value Window Indicates that the widget is a window, usually
1847
with a window system frame and a title bar,
1848
irrespective of whether the widget has a parent or
1849
not. Note that it is not possible to unset this
1850
flag if the widget does not have a parent.
1852
\value Dialog Indicates that the widget is a window that should
1853
be decorated as a dialog (i.e., typically no
1854
maximize or minimize buttons in the title bar).
1855
This is the default type for QDialog. If you want
1856
to use it as a modal dialog, it should be launched
1857
from another window, or have a parent and used
1858
with the QWidget::windowModality property. If you make
1859
it modal, the dialog will prevent other top-level
1860
windows in the application from getting any input.
1861
We refer to a top-level window that has a parent
1862
as a \e secondary window.
1864
\value Sheet Indicates that the widget is a Macintosh sheet.
1866
\value Drawer Indicates that the widget is a Macintosh drawer.
1868
\value Popup Indicates that the widget is a pop-up top-level
1869
window, i.e. that it is modal, but has a window
1870
system frame appropriate for pop-up menus.
1872
\value Tool Indicates that the widget is a tool window. A tool
1873
window is often a small window with a smaller than
1874
usual title bar and decoration, typically used for
1875
collections of tool buttons. It there is a parent,
1876
the tool window will always be kept on top of it.
1877
If there isn't a parent, you may consider using
1878
Qt::WindowStaysOnTopHint as well. If the window
1879
system supports it, a tool window can be decorated
1880
with a somewhat lighter frame. It can also be
1881
combined with Qt::FramelessWindowHint.
1884
On Mac OS X, tool windows correspond to the
1885
\l{http://developer.apple.com/documentation/Carbon/Conceptual/HandlingWindowsControls/hitb-wind_cont_concept/chapter_2_section_2.html}{Floating}
1886
class of windows. This means that the window lives on a
1887
level above normal windows; it impossible to put a normal
1888
window on top of it. By default, tool windows will disappear
1889
when the application is inactive. This can be controlled by
1890
the Qt::WA_MacAlwaysShowToolWindow attribute.
1892
\value ToolTip Indicates that the widget is a tooltip. This is
1893
used internally to implement
1894
\l{QWidget::toolTip}{tooltips}.
1896
\value SplashScreen Indicates that the window is a splash screen.
1897
This is the default type for QSplashScreen.
1899
\value Desktop Indicates that this widget is the desktop. This
1900
is the type for QDesktopWidget.
1902
\value SubWindow Indicates that this widget is a sub-window, such
1903
as a QMdiSubWindow widget.
1905
There are also a number of flags which you can use to customize
1906
the appearance of top-level windows. These have no effect on other
1909
\value MSWindowsFixedSizeDialogHint Gives the window a thin dialog border on Windows.
1910
This style is traditionally used for fixed-size dialogs.
1912
\value MSWindowsOwnDC Gives the window its own display
1915
\value X11BypassWindowManagerHint Bypass the window
1916
manager completely. This results in a borderless window
1917
that is not managed at all (i.e., no keyboard input unless
1918
you call QWidget::activateWindow() manually).
1920
\value FramelessWindowHint Produces a borderless window.
1921
The user cannot move or resize a borderless window via the window
1922
system. On X11, the result of the flag is dependent on the window manager and its
1923
ability to understand Motif and/or NETWM hints. Most existing
1924
modern window managers can handle this.
1926
The \c CustomizeWindowHint flag is used to enable customization of
1927
the window controls. This flag must be set to allow the \c
1928
WindowTitleHint, \c WindowSystemMenuHint, \c
1929
WindowMinimizeButtonHint, \c WindowMaximizeButtonHint and \c
1930
WindowCloseButtonHint flags to be changed.
1932
\value CustomizeWindowHint Turns off the default window title hints.
1934
\value WindowTitleHint Gives the window a title bar.
1936
\value WindowSystemMenuHint Adds a window system menu, and
1937
possibly a close button (for example on Mac). If you need to hide
1938
or show a close button, it is more portable to use \c
1939
WindowCloseButtonHint.
1941
\value WindowMinimizeButtonHint Adds a minimize button. On
1942
some platforms this implies Qt::WindowSystemMenuHint for it to work.
1944
\value WindowMaximizeButtonHint Adds a maximize button. On
1945
some platforms this implies Qt::WindowSystemMenuHint for it to work.
1947
\value WindowMinMaxButtonsHint Adds a minimize and a maximize
1948
button. On some platforms this implies Qt::WindowSystemMenuHint for it to work.
1950
\value WindowCloseButtonHint Adds a close button. On
1951
some platforms this implies Qt::WindowSystemMenuHint for it
1954
\value WindowContextHelpButtonHint Adds a context help button to dialogs.
1955
On some platforms this implies Qt::WindowSystemMenuHint for it to work.
1957
\value MacWindowToolBarButtonHint On Mac OS X adds a tool bar button (i.e.,
1958
the oblong button that is on the top right of windows that have toolbars.
1960
\value BypassGraphicsProxyWidget Prevents the window and its children from
1961
automatically embedding themselves into a QGraphicsProxyWidget if the
1962
parent widget is already embedded. You can set this flag if you
1963
want your widget to always be a toplevel widget on the desktop,
1964
regardless of whether the parent widget is embedded in a scene or
1967
\value WindowShadeButtonHint
1969
\value WindowStaysOnTopHint Informs the window system that the
1970
window should stay on top of all other windows. Note that
1971
on some window managers on X11 you also have to pass
1972
Qt::X11BypassWindowManagerHint for this flag to work
1975
\value WindowStaysOnBottomHint Informs the window system that the
1976
window should stay on bottom of all other windows. Note
1977
that on X11 this hint will work only in window managers
1978
that support _NET_WM_STATE_BELOW atom. If a window always
1979
on the bottom has a parent, the parent will also be left on
1980
the bottom. This window hint is currently not implemented
1983
\value WindowOkButtonHint Adds an OK button to the window decoration of a dialog.
1984
Only supported for Windows CE.
1986
\value WindowCancelButtonHint Adds a Cancel button to the window decoration of a dialog.
1987
Only supported for Windows CE.
1989
\value WindowType_Mask A mask for extracting the window type
1990
part of the window flags.
1994
\value WMouseNoMask Use Qt::WA_MouseNoMask instead.
1995
\value WDestructiveClose Use Qt::WA_DeleteOnClose instead.
1996
\value WStaticContents Use Qt::WA_StaticContents instead.
1997
\value WGroupLeader No longer needed.
1998
\value WShowModal Use QWidget::windowModality instead.
1999
\value WNoMousePropagation Use Qt::WA_NoMousePropagation instead.
2000
\value WType_TopLevel Use Qt::Window instead.
2001
\value WType_Dialog Use Qt::Dialog instead.
2002
\value WType_Popup Use Qt::Popup instead.
2003
\value WType_Desktop Use Qt::Desktop instead.
2004
\value WType_Mask Use Qt::WindowType_Mask instead.
2006
\value WStyle_Customize No longer needed.
2007
\value WStyle_NormalBorder No longer needed.
2008
\value WStyle_DialogBorder Use Qt::MSWindowsFixedSizeDialogHint instead.
2009
\value WStyle_NoBorder Use Qt::FramelessWindowHint instead.
2010
\value WStyle_Title Use Qt::WindowTitleHint instead.
2011
\value WStyle_SysMenu Use Qt::WindowSystemMenuHint instead.
2012
\value WStyle_Minimize Use Qt::WindowMinimizeButtonHint instead.
2013
\value WStyle_Maximize Use Qt::WindowMaximizeButtonHint instead.
2014
\value WStyle_MinMax Use Qt::WindowMinMaxButtonsHint instead.
2015
\value WStyle_Tool Use Qt::Tool instead.
2016
\value WStyle_StaysOnTop Use Qt::WindowStaysOnTopHint instead.
2017
\value WStyle_ContextHelp Use Qt::WindowContextHelpButtonHint instead.
2019
\value WPaintDesktop No longer needed.
2020
\value WPaintClever No longer needed.
2022
\value WX11BypassWM Use Qt::X11BypassWindowManagerHint instead.
2023
\value WWinOwnDC Use Qt::MSWindowsOwnDC instead.
2024
\value WMacSheet Use Qt::Sheet instead.
2025
\value WMacDrawer Use Qt::Drawer instead.
2027
\value WStyle_Splash Use Qt::SplashScreen instead.
2029
\value WNoAutoErase No longer needed.
2030
\value WRepaintNoErase No longer needed.
2031
\value WNorthWestGravity Use Qt::WA_StaticContents instead.
2032
\value WType_Modal Use Qt::Dialog and QWidget::windowModality instead.
2033
\value WStyle_Dialog Use Qt::Dialog instead.
2034
\value WStyle_NoBorderEx Use Qt::FramelessWindowHint instead.
2035
\value WResizeNoErase No longer needed.
2036
\value WMacNoSheet No longer needed.
2038
\sa QWidget::windowFlags, {Window Flags Example}
2042
\enum Qt::DropAction
2044
\value CopyAction Copy the data to the target.
2045
\value MoveAction Move the data from the source to the target.
2046
\value LinkAction Create a link from the source to the target.
2048
\value IgnoreAction Ignore the action (do nothing with the data).
2049
\value TargetMoveAction On Windows, this value is used when the ownership of the D&D data
2050
should be taken over by the target application,
2051
i.e., the source application should not delete
2054
On X11 this value is used to do a move.
2056
TargetMoveAction is not used on the Mac.
2059
#if defined(Q_OS_WIN) && defined(QT3_SUPPORT)
2061
\enum Qt::WindowsVersion
2082
#if defined(Q_OS_MAC) && defined(QT3_SUPPORT)
2084
\enum Qt::MacintoshVersion
2087
\value MV_Unknown Use QSysInfo::MV_Unknown instead.
2088
\value MV_9 Use QSysInfo::MV_9 instead.
2089
\value MV_10_DOT_0 Use QSysInfo::MV_10_0 instead.
2090
\value MV_10_DOT_1 Use QSysInfo::MV_10_1 instead.
2091
\value MV_10_DOT_2 Use QSysInfo::MV_10_2 instead.
2092
\value MV_10_DOT_3 Use QSysInfo::MV_10_3 instead.
2093
\value MV_10_DOT_4 Use QSysInfo::MV_10_4 instead.
2095
\value MV_CHEETAH Use QSysInfo::MV_10_0 instead.
2096
\value MV_PUMA Use QSysInfo::MV_10_1 instead.
2097
\value MV_JAGUAR Use QSysInfo::MV_10_2 instead.
2098
\value MV_PANTHER Use QSysInfo::MV_10_3 instead.
2099
\value MV_TIGER Use QSysInfo::MV_10_4 instead.
2101
\sa QSysInfo::MacVersion
2105
/*! \typedef Qt::ToolBarDock
2108
Use Qt::Dock instead.
2115
Each dock window can be in one of the following positions:
2117
\value DockUnmanaged not managed by a Q3MainWindow.
2119
\value DockTornOff the dock window floats as its own top level
2120
window which always stays on top of the main window.
2122
\value DockTop above the central widget, below the menu bar.
2124
\value DockBottom below the central widget, above the status bar.
2126
\value DockRight to the right of the central widget.
2128
\value DockLeft to the left of the central widget.
2130
\value DockMinimized the dock window is not shown (this is
2131
effectively a 'hidden' dock area); the handles of all minimized
2132
dock windows are drawn in one row below the menu bar.
2136
\omitvalue Minimized
2140
\omitvalue Unmanaged
2144
\enum Qt::AnchorAttribute
2146
An anchor has one or more of the following attributes:
2148
\value AnchorName the name attribute of the anchor. This attribute is
2149
used when scrolling to an anchor in the document.
2151
\value AnchorHref the href attribute of the anchor. This attribute is
2152
used when a link is clicked to determine what content to load.
2158
This enum describes how the items in a widget are sorted.
2160
\value AscendingOrder The items are sorted ascending e.g. starts with
2161
'AAA' ends with 'ZZZ' in Latin-1 locales
2163
\value DescendingOrder The items are sorted descending e.g. starts with
2164
'ZZZ' ends with 'AAA' in Latin-1 locales
2166
\omitvalue Ascending
2167
\omitvalue Descending
2171
\enum Qt::ClipOperation
2173
\value NoClip This operation turns clipping off.
2175
\value ReplaceClip Replaces the current clip path/rect/region with
2176
the one supplied in the function call.
2178
\value IntersectClip Intersects the current clip path/rect/region
2179
with the one supplied in the function call.
2181
\value UniteClip Unites the current clip path/rect/region with the
2182
one supplied in the function call.
2186
\enum Qt::ItemSelectionMode
2188
This enum is used in QGraphicsItem, QGraphicsScene and QGraphicsView to
2189
specify how items are selected, or how to determine if a shapes and items
2192
\value ContainsItemShape The output list contains only items whose
2193
\l{QGraphicsItem::shape()}{shape} is fully contained inside the
2194
selection area. Items that intersect with the area's outline are
2197
\value IntersectsItemShape The output list contains both items whose
2198
\l{QGraphicsItem::shape()}{shape} is fully contained inside the
2199
selection area, and items that intersect with the area's
2200
outline. This is a common mode for rubber band selection.
2202
\value ContainsItemBoundingRect The output list contains only items whose
2203
\l{QGraphicsItem::boundingRect()}{bounding rectangle} is fully
2204
contained inside the selection area. Items that intersect with the
2205
area's outline are not included.
2207
\value IntersectsItemBoundingRect The output list contains both items
2208
whose \l{QGraphicsItem::boundingRect()}{bounding rectangle} is
2209
fully contained inside the selection area, and items that intersect
2210
with the area's outline. This method is commonly used for
2211
determining areas that need redrawing.
2213
\sa QGraphicsScene::items(), QGraphicsScene::collidingItems(),
2214
QGraphicsView::items(), QGraphicsItem::collidesWithItem(),
2215
QGraphicsItem::collidesWithPath()
2221
Specifies which method should be used to fill the paths and polygons.
2223
\value OddEvenFill Specifies that the region is filled using the
2224
odd even fill rule. With this rule, we determine whether a point
2225
is inside the shape by using the following method.
2226
Draw a horizontal line from the point to a location outside the shape,
2227
and count the number of intersections. If the number of intersections
2228
is an odd number, the point is inside the shape. This mode is the
2231
\value WindingFill Specifies that the region is filled using the
2232
non zero winding rule. With this rule, we determine whether a
2233
point is inside the shape by using the following method.
2234
Draw a horizontal line from the point to a location outside the shape.
2235
Determine whether the direction of the line at each intersection point
2236
is up or down. The winding number is determined by summing the
2237
direction of each intersection. If the number is non zero, the point
2238
is inside the shape. This fill mode can also in most cases be considered
2239
as the intersection of closed shapes.
2248
\value LoMetricUnit Obsolete
2249
\value HiMetricUnit Obsolete
2250
\value LoEnglishUnit Obsolete
2251
\value HiEnglishUnit Obsolete
2252
\value TwipsUnit Obsolete
2256
\enum Qt::TextFormat
2258
This enum is used in widgets that can display both plain text and
2259
rich text, e.g. QLabel. It is used for deciding whether a text
2260
string should be interpreted as one or the other. This is normally
2261
done by passing one of the enum values to a setTextFormat()
2264
\value PlainText The text string is interpreted as a plain text
2267
\value RichText The text string is interpreted as a rich text
2270
\value AutoText The text string is interpreted as for
2271
Qt::RichText if Qt::mightBeRichText() returns true, otherwise
2274
\value LogText A special, limited text format which is only used
2275
by Q3TextEdit in an optimized mode.
2279
\enum Qt::CursorShape
2281
This enum type defines the various cursors that can be used.
2283
The standard arrow cursor is the default for widgets in a normal state.
2285
\value ArrowCursor \inlineimage cursor-arrow.png
2286
The standard arrow cursor.
2287
\value UpArrowCursor \inlineimage cursor-uparrow.png
2288
An arrow pointing upwards toward the top of the screen.
2289
\value CrossCursor \inlineimage cursor-cross.png
2290
A crosshair cursor, typically used to help the
2291
user accurately select a point on the screen.
2292
\value WaitCursor \inlineimage cursor-wait.png
2293
An hourglass or watch cursor, usually shown during
2294
operations that prevent the user from interacting with
2296
\value IBeamCursor \inlineimage cursor-ibeam.png
2297
A caret or ibeam cursor, indicating that a widget can
2298
accept and display text input.
2299
\value SizeVerCursor \inlineimage cursor-sizev.png
2300
A cursor used for elements that are used to vertically
2301
resize top-level windows.
2302
\value SizeHorCursor \inlineimage cursor-sizeh.png
2303
A cursor used for elements that are used to horizontally
2304
resize top-level windows.
2305
\value SizeBDiagCursor \inlineimage cursor-sizeb.png
2306
A cursor used for elements that are used to diagonally
2307
resize top-level windows at their top-right and
2308
bottom-left corners.
2309
\value SizeFDiagCursor \inlineimage cursor-sizef.png
2310
A cursor used for elements that are used to diagonally
2311
resize top-level windows at their top-left and
2312
bottom-right corners.
2313
\value SizeAllCursor \inlineimage cursor-sizeall.png
2314
A cursor used for elements that are used to resize
2315
top-level windows in any direction.
2316
\value BlankCursor A blank/invisible cursor, typically used when the cursor
2317
shape needs to be hidden.
2318
\value SplitVCursor \inlineimage cursor-vsplit.png
2319
A cursor used for vertical splitters, indicating that
2320
a handle can be dragged horizontally to adjust the use
2322
\value SplitHCursor \inlineimage cursor-hsplit.png
2323
A cursor used for horizontal splitters, indicating that
2324
a handle can be dragged vertically to adjust the use
2326
\value PointingHandCursor \inlineimage cursor-hand.png
2327
A pointing hand cursor that is typically used for
2328
clickable elements such as hyperlinks.
2329
\value ForbiddenCursor \inlineimage cursor-forbidden.png
2330
A slashed circle cursor, typically used during drag
2331
and drop operations to indicate that dragged content
2332
cannot be dropped on particular widgets or inside
2334
\value OpenHandCursor \inlineimage cursor-openhand.png
2335
A cursor representing an open hand, typically used to
2336
indicate that the area under the cursor is the visible
2337
part of a canvas that the user can click and drag in
2338
order to scroll around.
2339
\value ClosedHandCursor \inlineimage cursor-closedhand.png
2340
A cursor representing a closed hand, typically used to
2341
indicate that a dragging operation is in progress that
2343
\value WhatsThisCursor \inlineimage cursor-whatsthis.png
2344
An arrow with a question mark, typically used to indicate
2345
the presence of What's This? help for a widget.
2346
\value BusyCursor \inlineimage cursor-wait.png
2347
An hourglass or watch cursor, usually shown during
2348
operations that allow the user to interact with
2349
the application while they are performed in the
2352
\omitvalue LastCursor
2353
\omitvalue CustomCursor
2355
\omitvalue arrowCursor
2356
\omitvalue upArrowCursor
2357
\omitvalue crossCursor
2358
\omitvalue waitCursor
2359
\omitvalue ibeamCursor
2360
\omitvalue sizeVerCursor
2361
\omitvalue sizeHorCursor
2362
\omitvalue sizeBDiagCursor
2363
\omitvalue sizeFDiagCursor
2364
\omitvalue sizeAllCursor
2365
\omitvalue blankCursor
2366
\omitvalue splitVCursor
2367
\omitvalue splitHCursor
2368
\omitvalue pointingHandCursor
2369
\omitvalue forbiddenCursor
2370
\omitvalue whatsThisCursor
2374
\typedef Qt::TextFlags
2377
Use Qt::TextFlag instead.
2381
\enum Qt::LayoutDirection
2383
Specifies the direction of Qt's layouts:
2385
\value LeftToRight Left-to-right layout.
2386
\value RightToLeft Right-to-left layout.
2388
Right-to-left layouts are necessary for certain languages,
2389
notably Arabic and Hebrew.
2391
\sa QApplication::setLayoutDirection(), QWidget::setLayoutDirection()
2395
\enum Qt::InputMethodQuery
2397
\value ImMicroFocus The rectangle covering the area of the input cursor in widget coordinates.
2398
\value ImFont The currently used font for text input.
2399
\value ImCursorPosition The logical position of the cursor within the text surrounding the input area (see ImSurroundingText).
2400
If any text is selected, the position returned will be at the logical end of the
2401
selection, even if the real cursor is located at the logical start.
2402
\value ImSurroundingText The plain text around the input area, for example the current paragraph.
2403
\value ImCurrentSelection The currently selected text.
2407
\enum Qt::ItemDataRole
2409
Each item in the model has a set of data elements associated with
2410
it, each with its own role. The roles are used by the view to indicate
2411
to the model which type of data it needs.
2413
The general purpose roles are:
2415
\value DisplayRole The key data to be rendered in the form of text.
2416
\value DecorationRole The data to be rendered as a decoration in the form
2418
\value EditRole The data in a form suitable for editing in an
2420
\value ToolTipRole The data displayed in the item's tooltip.
2421
\value StatusTipRole The data displayed in the status bar.
2422
\value WhatsThisRole The data displayed for the item in "What's This?"
2424
\value SizeHintRole The size hint for the item that will be supplied
2427
Roles describing appearance and meta data:
2429
\value FontRole The font used for items rendered with the default
2431
\value TextAlignmentRole The alignment of the text for items rendered with the
2433
\value BackgroundRole The background brush used for items rendered with
2434
the default delegate.
2435
\value BackgroundColorRole This role is obsolete. Use BackgroundRole instead.
2436
\value ForegroundRole The foreground brush (text color, typically)
2437
used for items rendered with the default delegate.
2438
\value TextColorRole This role is obsolete. Use ForegroundRole instead.
2439
\value CheckStateRole This role is used to obtain the checked state of
2440
an item (see \l Qt::CheckState).
2442
Accessibility roles:
2444
\value AccessibleTextRole The text to be used by accessibility
2445
extensions and plugins, such as screen
2447
\value AccessibleDescriptionRole A description of the item for accessibility
2452
\value UserRole The first role that can be used for application-specific purposes.
2454
\omitvalue DisplayPropertyRole
2455
\omitvalue DecorationPropertyRole
2456
\omitvalue ToolTipPropertyRole
2457
\omitvalue StatusTipPropertyRole
2458
\omitvalue WhatsThisPropertyRole
2464
This enum describes the properties of an item:
2466
\value NoItemFlags It does not have any properties set.
2467
\value ItemIsSelectable It can be selected.
2468
\value ItemIsEditable It can be edited.
2469
\value ItemIsDragEnabled It can be dragged.
2470
\value ItemIsDropEnabled It can be used as a drop target.
2471
\value ItemIsUserCheckable It can be checked or unchecked by the user.
2472
\value ItemIsEnabled The user can interact with the item.
2473
\value ItemIsTristate The item is checkable with three separate states.
2475
Note that checkable items need to be given both a suitable set of flags
2476
and an initial state, indicating whether the item is checked or not.
2477
This is handled automatically for model/view components, but needs
2478
to be explicitly set for instances of QListWidgetItem, QTableWidgetItem,
2479
and QTreeWidgetItem.
2481
\sa QAbstractItemModel
2487
This enum describes the type of matches that can be used when searching
2488
for items in a model.
2490
\value MatchExactly Performs QVariant-based matching.
2491
\value MatchFixedString Performs string-based matching.
2492
String-based comparisons are case-insensitive unless the
2493
\c MatchCaseSensitive flag is also specified.
2494
\value MatchContains The search term is contained in the item.
2495
\value MatchStartsWith The search term matches the start of the item.
2496
\value MatchEndsWith The search term matches the end of the item.
2497
\value MatchCaseSensitive The search is case sensitive.
2498
\value MatchRegExp Performs string-based matching using a regular
2499
expression as the search term.
2500
\value MatchWildcard Performs string-based matching using a string with
2501
wildcards as the search term.
2502
\value MatchWrap Perform a search that wraps around, so that when
2503
the search reaches the last item in the model, it begins again at
2504
the first item and continues until all items have been examined.
2505
\value MatchRecursive Searches the entire hierarchy.
2507
\sa QString::compare(), QRegExp
2511
\enum Qt::TextElideMode
2513
This enum specifies where the ellipsis should appear when
2514
displaying texts that don't fit:
2516
\value ElideLeft The ellipsis should appear at the beginning of the text.
2517
\value ElideRight The ellipsis should appear at the end of the text.
2518
\value ElideMiddle The ellipsis should appear in the middle of the text.
2519
\value ElideNone Ellipsis should NOT appear in the text.
2521
Qt::ElideMiddle is normally the most appropriate choice for URLs (e.g.,
2522
"\l{http://www.qtsoftware.com/careers/movingto/beijing/}{http://www.qtsof...ovingto/beijing/}"),
2523
whereas Qt::ElideRight is appropriate
2524
for other strings (e.g.,
2525
"\l{http://doc.trolltech.com/qq/qq09-mac-deployment.html}{Deploying Applications on Ma...}").
2527
\sa QAbstractItemView::textElideMode, QFontMetrics::elidedText(), AlignmentFlag QTabBar::elideMode
2531
\enum Qt::WindowModality
2535
This enum specifies the behavior of a modal window. A modal window
2536
is one that blocks input to other windows. Note that windows that
2537
are children of a modal window are not blocked.
2540
\value NonModal The window is not modal and does not block input to other windows.
2541
\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.
2542
\value ApplicationModal The window is modal to the application and blocks input to all windows.
2544
\sa QWidget::windowModality, QDialog
2548
\enum Qt::TextInteractionFlag
2550
This enum specifies how a text displaying widget reacts to user input.
2552
\value NoTextInteraction No interaction with the text is possible.
2553
\value TextSelectableByMouse Text can be selected with the mouse and copied to the clipboard using
2554
a context menu or standard keyboard shortcuts.
2555
\value TextSelectableByKeyboard Text can be selected with the cursor keys on the keyboard. A text cursor is shown.
2556
\value LinksAccessibleByMouse Links can be highlighted and activated with the mouse.
2557
\value LinksAccessibleByKeyboard Links can be focused using tab and activated with enter.
2558
\value TextEditable The text is fully editable.
2560
\value TextEditorInteraction The default for a text editor.
2561
\value TextBrowserInteraction The default for QTextBrowser.
2567
This enum specifies the behavior of the
2568
QPixmap::createMaskFromColor() and QImage::createMaskFromColor()
2571
\value MaskInColor Creates a mask where all pixels matching the given color are opaque.
2572
\value MaskOutColor Creates a mask where all pixels matching the given color are transparent.
2576
\enum Qt::DockWidgetAreaSizes
2581
\enum Qt::ToolBarAreaSizes
2586
\enum Qt::EventPriority
2588
This enum can be used to specify event priorities.
2590
\value HighEventPriority Events with this priority are sent before
2591
events with NormalEventPriority or LowEventPriority.
2593
\value NormalEventPriority Events with this priority are sent
2594
after events with HighEventPriority, but before events with
2597
\value LowEventPriority Events with this priority are sent after
2598
events with HighEventPriority or NormalEventPriority.
2600
Note that these values are provided purely for convenience, since
2601
event priorities can be any value between \c INT_MAX and \c
2602
INT_MIN, inclusive. For example, you can define custom priorities
2603
as being relative to each other:
2605
\snippet doc/src/snippets/code/doc_src_qnamespace.qdoc 1
2607
\sa QCoreApplication::postEvent()
2613
This enum is used by QGraphicsLayoutItem::sizeHint()
2615
\value MinimumSize is used to specify the minimum size of a graphics layout item.
2616
\value PreferredSize is used to specify the preferred size of a graphics layout item.
2617
\value MaximumSize is used to specify the maximum size of a graphics layout item.
2618
\value MinimumDescent is used to specify the minimum descent of a text string in a graphics layout item.
2619
\omitvalue NSizeHints
2621
\sa QGraphicsLayoutItem::sizeHint()
2628
This enum is used by QPainter::drawRoundedRect() and QPainterPath::addRoundedRect()
2629
functions to specify the radii of rectangle corners with respect to the dimensions
2630
of the bounding rectangles specified.
2632
\value AbsoluteSize Specifies the size using absolute measurements.
2633
\value RelativeSize Specifies the size relative to the bounding rectangle,
2634
typically using percentage measurements.
2638
\enum Qt::WindowFrameSection
2641
This enum is used to describe parts of a window frame. It is returned by
2642
QGraphicsWidget::windowFrameSectionAt() to describe what section of the window
2643
frame is under the mouse.
2647
\value TopLeftSection
2649
\value TopRightSection
2651
\value BottomRightSection
2652
\value BottomSection
2653
\value BottomLeftSection
2656
\sa QGraphicsWidget::windowFrameEvent()
2657
\sa QGraphicsWidget::paintWindowFrame()
2658
\sa QGraphicsWidget::windowFrameSectionAt()
added
removed
doc/src/qnamespace.qdoc
