source: trunk/src/corelib/global/qnamespace.qdoc@ 1023

Last change on this file since 1023 was 846, checked in by Dmitry A. Kuminov, 14 years ago

trunk: Merged in qt 4.7.2 sources from branches/vendor/nokia/qt.

  • Property svn:eol-style set to native
File size: 113.6 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4** All rights reserved.
5** Contact: Nokia Corporation ([email protected])
6**
7** This file is part of the documentation of the Qt Toolkit.
8**
9** $QT_BEGIN_LICENSE:FDL$
10** Commercial Usage
11** Licensees holding valid Qt Commercial licenses may use this file in
12** accordance with the Qt Commercial License Agreement provided with the
13** Software or, alternatively, in accordance with the terms contained in a
14** written agreement between you and Nokia.
15**
16** GNU Free Documentation License
17** Alternatively, this file may be used under the terms of the GNU Free
18** Documentation License version 1.3 as published by the Free Software
19** Foundation and appearing in the file included in the packaging of this
20** file.
21**
22** If you have questions regarding the use of this file, please contact
23** Nokia at [email protected].
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