NAME¶

Qt - Namespace for miscellaneous identifiers that need to be global-like

SYNOPSIS¶

#include <qnamespace.h>

Inherited by QObject, QPixmap, QBrush, QCanvasItem, QCursor, QPainter, QEvent, QIconViewItem, QKeySequence, QListViewItem, QCustomMenuItem, QPen, QStyleSheetItem, QSyntaxHighlighter, QTab, QTableItem, QThread, QToolTip, and QWhatsThis.

DESCRIPTION¶

The Qt class is a namespace for miscellaneous identifiers that need to be global-like.

Normally, you can ignore this class. QObject and a few other classes inherit it, so all the identifiers in the Qt namespace are normally usable without qualification.

However, you may occasionally need to say Qt::black instead of just black, particularly in static utility functions (such as many class factories).

See also Miscellaneous Classes.

Qt::AlignmentFlags¶

This enum type is used to describe alignment. It contains horizontal and vertical flags.

The horizontal flags are:

Qt::AlignAuto - Aligns according to the language. Left for most, right for Arabic and Hebrew.

Qt::AlignLeft - Aligns with the left edge.

Qt::AlignRight - Aligns with the right edge.

Qt::AlignHCenter - Centers horizontally in the available space.

Qt::AlignJustify - Justifies the text in the available space. Does not work for everything and may be interpreted as AlignAuto in some cases.

The vertical flags are:

Qt::AlignTop - Aligns with the top.

Qt::AlignBottom - Aligns with the bottom.

Qt::AlignVCenter - Centers vertically in the available space.

You can use only one of the horizontal flags at a time. There is one two-dimensional flag:

Qt::AlignCenter - Centers in both dimensions.

You can use at most one horizontal and one vertical flag at a time. AlignCenter counts as both horizontal and vertical.

Masks:

Qt::AlignHorizontal_Mask

Qt::AlignVertical_Mask

Conflicting combinations of flags have undefined meanings.

Qt::AnchorAttribute¶

An anchor has one or more of the following attributes:

Qt::AnchorName - the name attribute of the anchor. This attribute is used when scrolling to an anchor in the document.

Qt::AnchorHref - the href attribute of the anchor. This attribute is used when a link is clicked to determine what content to load.

Qt::ArrowType¶

Qt::UpArrow

Qt::DownArrow

Qt::LeftArrow

Qt::RightArrow

Qt::BGMode¶

Background mode

Qt::TransparentMode

Qt::OpaqueMode

Qt::BackgroundMode¶

This enum describes how the background of a widget changes, as the widget's palette changes.

The background is what the widget contains when paintEvent() is called. To minimize flicker, this should be the most common color or pixmap in the widget. For PaletteBackground, use colorGroup().brush( QColorGroup::Background ), and so on.

Qt::PaletteForeground

Qt::PaletteBackground

Qt::PaletteButton

Qt::PaletteLight

Qt::PaletteMidlight

Qt::PaletteDark

Qt::PaletteMid

Qt::PaletteText

Qt::PaletteBrightText

Qt::PaletteButtonText

Qt::PaletteBase

Qt::PaletteShadow

Qt::PaletteHighlight

Qt::PaletteHighlightedText

Qt::PaletteLink

Qt::PaletteLinkVisited

Qt::X11ParentRelative - (internal use only)

The final three values have special meaning:

Qt::NoBackground - the widget is not cleared before paintEvent(). If the widget's paint event always draws on all the pixels, using this mode can be both fast and flicker-free.

Qt::FixedColor - the widget is cleared to a fixed color, normally different from all the ones in the palette(). Set using setPaletteBackgroundColor().

Qt::FixedPixmap - the widget is cleared to a fixed pixmap, normally different from all the ones in the palette(). Set using setPaletteBackgroundPixmap().

Although FixedColor and FixedPixmap are sometimes just right, if you use them, make sure that you test your application when the desktop color scheme has been changed. (On X11, a quick way to test this is e.g. "./myapp -bg paleblue". On Windows, you must use the control panel.)

See also QWidget::backgroundMode, QWidget::backgroundMode, QWidget::setBackgroundPixmap(), and QWidget::paletteBackgroundColor.

Qt::BrushStyle¶

Qt::NoBrush

Qt::SolidPattern

Qt::Dense1Pattern

Qt::Dense2Pattern

Qt::Dense3Pattern

Qt::Dense4Pattern

Qt::Dense5Pattern

Qt::Dense6Pattern

Qt::Dense7Pattern

Qt::HorPattern

Qt::VerPattern

Qt::CrossPattern

Qt::BDiagPattern

Qt::FDiagPattern

Qt::DiagCrossPattern

Qt::CustomPattern

<center>
[Image Omitted]

</center>

Qt::ButtonState¶

This enum type describes the state of the mouse and the modifier buttons.

Qt::NoButton - used when the button state does not refer to any button (see QMouseEvent::button()).

Qt::LeftButton - set if the left button is pressed, or if this event refers to the left button. (The left button may be the right button on left-handed mice.)

Qt::RightButton - the right button.

Qt::MidButton - the middle button.

Qt::ShiftButton - a Shift key on the keyboard is also pressed.

Qt::ControlButton - a Ctrl key on the keyboard is also pressed.

Qt::AltButton - an Alt key on the keyboard is also pressed.

Qt::MetaButton - a Meta key on the keyboard is also pressed.

Qt::Keypad - a keypad button is pressed.

Qt::KeyButtonMask - a mask for ShiftButton, ControlButton, AltButton and MetaButton.

Qt::MouseButtonMask - a mask for LeftButton, RightButton and MidButton.

Qt::Corner¶

This enum type specifies a corner in a rectangle:

Qt::TopLeft - top left corner

Qt::TopRight - top right corner

Qt::BottomLeft - bottom left corner

Qt::BottomRight - bottom right corner

Qt::CursorShape¶

This enum type defines the various cursors that can be used.

Qt::ArrowCursor - standard arrow cursor

Qt::UpArrowCursor - upwards arrow

Qt::CrossCursor - crosshair

Qt::WaitCursor - hourglass/watch

Qt::BusyCursor - standard arrow with hourglass/watch

Qt::IbeamCursor - ibeam/text entry

Qt::SizeVerCursor - vertical resize

Qt::SizeHorCursor - horizontal resize

Qt::SizeFDiagCursor - diagonal resize (&#92;)

Qt::SizeBDiagCursor - diagonal resize (/)

Qt::SizeAllCursor - all directions resize

Qt::BlankCursor - blank/invisible cursor

Qt::SplitVCursor - vertical splitting

Qt::SplitHCursor - horizontal splitting

Qt::PointingHandCursor - a pointing hand

Qt::ForbiddenCursor - a slashed circle

Qt::WhatsThisCursor - an arrow with a question mark

Qt::BitmapCursor

ArrowCursor is the default for widgets in a normal state.

<center>
[Image Omitted]

</center>

Qt::DateFormat¶

Qt::TextDate - (default) Qt format

Qt::ISODate - ISO 8601 extended format (YYYY-MM-DD, or with time, YYYY-MM-DDTHH:MM:SS)

Qt::LocalDate - locale dependent format

Qt::Dock¶

Each dock window can be in one of the following positions:

Qt::DockTop - above the central widget, below the menu bar.

Qt::DockBottom - below the central widget, above the status bar.

Qt::DockLeft - to the left of the central widget.

Qt::DockRight - to the right of the central widget.

Qt::DockMinimized - the dock window is not shown (this is effectively a 'hidden' dock area); the handles of all minimized dock windows are drawn in one row below the menu bar.

Qt::DockTornOff - the dock window floats as its own top level window which always stays on top of the main window.

Qt::DockUnmanaged - not managed by a QMainWindow.

Qt::GUIStyle¶

This type is obsolete. It is provided to keep old source working. We strongly advise against using it in new code.

Qt::WindowsStyle

Qt::MotifStyle

Qt::MacStyle

Qt::Win3Style

Qt::PMStyle

Qt::ImageConversionFlags¶

The conversion flag is a bitwise-OR of the following values. The options marked "(default)" are set if no other values from the list are included (since the defaults are zero):

Color/Mono preference (ignored for QBitmap)

Qt::AutoColor - (default) - If the image has depth 1 and contains only black and white pixels, the pixmap becomes monochrome.

Qt::ColorOnly - The pixmap is dithered/converted to the native display depth.

Qt::MonoOnly - The pixmap becomes monochrome. If necessary, it is dithered using the chosen dithering algorithm.

Dithering mode preference for RGB channels

Qt::DiffuseDither - (default) - A high-quality dither.

Qt::OrderedDither - A faster, more ordered dither.

Qt::ThresholdDither - No dithering; closest color is used.

Dithering mode preference for alpha channel

Qt::ThresholdAlphaDither - (default) - No dithering.

Qt::OrderedAlphaDither - A faster, more ordered dither.

Qt::DiffuseAlphaDither - A high-quality dither.

Qt::NoAlpha - Not supported.

Color matching versus dithering preference

Qt::PreferDither - (default when converting to a pixmap) - Always dither 32-bit images when the image is converted to 8 bits.

Qt::AvoidDither - (default when converting for the purpose of saving to file) - Dither 32-bit images only if the image has more than 256 colors and it is being converted to 8 bits.

Qt::AutoDither - Not supported.

The following are not values that are used directly, but masks for the above classes:

Qt::ColorMode_Mask - Mask for the color mode.

Qt::Dither_Mask - Mask for the dithering mode for RGB channels.

Qt::AlphaDither_Mask - Mask for the dithering mode for the alpha channel.

Qt::DitherMode_Mask - Mask for the mode that determines the preference of color matching versus dithering.

Using 0 as the conversion flag sets all the default options.

Qt::Key¶

The key names used by Qt.

Qt::Key_Escape

Qt::Key_Tab

Qt::Key_Backtab

Qt::Key_Backspace

Qt::Key_Return

Qt::Key_Enter

Qt::Key_Insert

Qt::Key_Delete

Qt::Key_Pause

Qt::Key_Print

Qt::Key_SysReq

Qt::Key_Home

Qt::Key_End

Qt::Key_Left

Qt::Key_Up

Qt::Key_Right

Qt::Key_Down

Qt::Key_Prior

Qt::Key_Next

Qt::Key_Shift

Qt::Key_Control

Qt::Key_Meta

Qt::Key_Alt

Qt::Key_CapsLock

Qt::Key_NumLock

Qt::Key_ScrollLock

Qt::Key_Clear

Qt::Key_F1

Qt::Key_F2

Qt::Key_F3

Qt::Key_F4

Qt::Key_F5

Qt::Key_F6

Qt::Key_F7

Qt::Key_F8

Qt::Key_F9

Qt::Key_F10

Qt::Key_F11

Qt::Key_F12

Qt::Key_F13

Qt::Key_F14

Qt::Key_F15

Qt::Key_F16

Qt::Key_F17

Qt::Key_F18

Qt::Key_F19

Qt::Key_F20

Qt::Key_F21

Qt::Key_F22

Qt::Key_F23

Qt::Key_F24

Qt::Key_F25

Qt::Key_F26

Qt::Key_F27

Qt::Key_F28

Qt::Key_F29

Qt::Key_F30

Qt::Key_F31

Qt::Key_F32

Qt::Key_F33

Qt::Key_F34

Qt::Key_F35

Qt::Key_Super_L

Qt::Key_Super_R

Qt::Key_Menu

Qt::Key_Hyper_L

Qt::Key_Hyper_R

Qt::Key_Help

Qt::Key_Space

Qt::Key_Any

Qt::Key_Exclam

Qt::Key_QuoteDbl

Qt::Key_NumberSign

Qt::Key_Dollar

Qt::Key_Percent

Qt::Key_Ampersand

Qt::Key_Apostrophe

Qt::Key_ParenLeft

Qt::Key_ParenRight

Qt::Key_Asterisk

Qt::Key_Plus

Qt::Key_Comma

Qt::Key_Minus

Qt::Key_Period

Qt::Key_Slash

Qt::Key_0

Qt::Key_1

Qt::Key_2

Qt::Key_3

Qt::Key_4

Qt::Key_5

Qt::Key_6

Qt::Key_7

Qt::Key_8

Qt::Key_9

Qt::Key_Colon

Qt::Key_Semicolon

Qt::Key_Less

Qt::Key_Equal

Qt::Key_Greater

Qt::Key_Question

Qt::Key_At

Qt::Key_A

Qt::Key_B

Qt::Key_C

Qt::Key_D

Qt::Key_E

Qt::Key_F

Qt::Key_G

Qt::Key_H

Qt::Key_I

Qt::Key_J

Qt::Key_K

Qt::Key_L

Qt::Key_M

Qt::Key_N

Qt::Key_O

Qt::Key_P

Qt::Key_Q

Qt::Key_R

Qt::Key_S

Qt::Key_T

Qt::Key_U

Qt::Key_V

Qt::Key_W

Qt::Key_X

Qt::Key_Y

Qt::Key_Z

Qt::Key_BracketLeft

Qt::Key_Backslash

Qt::Key_BracketRight

Qt::Key_AsciiCircum

Qt::Key_Underscore

Qt::Key_QuoteLeft

Qt::Key_BraceLeft

Qt::Key_Bar

Qt::Key_BraceRight

Qt::Key_AsciiTilde

Qt::Key_nobreakspace

Qt::Key_exclamdown

Qt::Key_cent

Qt::Key_sterling

Qt::Key_currency

Qt::Key_yen

Qt::Key_brokenbar

Qt::Key_section

Qt::Key_diaeresis

Qt::Key_copyright

Qt::Key_ordfeminine

Qt::Key_guillemotleft

Qt::Key_notsign

Qt::Key_hyphen

Qt::Key_registered

Qt::Key_macron

Qt::Key_degree

Qt::Key_plusminus

Qt::Key_twosuperior

Qt::Key_threesuperior

Qt::Key_acute

Qt::Key_mu

Qt::Key_paragraph

Qt::Key_periodcentered

Qt::Key_cedilla

Qt::Key_onesuperior

Qt::Key_masculine

Qt::Key_guillemotright

Qt::Key_onequarter

Qt::Key_onehalf

Qt::Key_threequarters

Qt::Key_questiondown

Qt::Key_Agrave

Qt::Key_Aacute

Qt::Key_Acircumflex

Qt::Key_Atilde

Qt::Key_Adiaeresis

Qt::Key_Aring

Qt::Key_AE

Qt::Key_Ccedilla

Qt::Key_Egrave

Qt::Key_Eacute

Qt::Key_Ecircumflex

Qt::Key_Ediaeresis

Qt::Key_Igrave

Qt::Key_Iacute

Qt::Key_Icircumflex

Qt::Key_Idiaeresis

Qt::Key_ETH

Qt::Key_Ntilde

Qt::Key_Ograve

Qt::Key_Oacute

Qt::Key_Ocircumflex

Qt::Key_Otilde

Qt::Key_Odiaeresis

Qt::Key_multiply

Qt::Key_Ooblique

Qt::Key_Ugrave

Qt::Key_Uacute

Qt::Key_Ucircumflex

Qt::Key_Udiaeresis

Qt::Key_Yacute

Qt::Key_THORN

Qt::Key_ssharp

Qt::Key_agrave

Qt::Key_aacute

Qt::Key_acircumflex

Qt::Key_atilde

Qt::Key_adiaeresis

Qt::Key_aring

Qt::Key_ae

Qt::Key_ccedilla

Qt::Key_egrave

Qt::Key_eacute

Qt::Key_ecircumflex

Qt::Key_ediaeresis

Qt::Key_igrave

Qt::Key_iacute

Qt::Key_icircumflex

Qt::Key_idiaeresis

Qt::Key_eth

Qt::Key_ntilde

Qt::Key_ograve

Qt::Key_oacute

Qt::Key_ocircumflex

Qt::Key_otilde

Qt::Key_odiaeresis

Qt::Key_division

Qt::Key_oslash

Qt::Key_ugrave

Qt::Key_uacute

Qt::Key_ucircumflex

Qt::Key_udiaeresis

Qt::Key_yacute

Qt::Key_thorn

Qt::Key_ydiaeresis

Multimedia keys

Qt::Key_Back

Qt::Key_Forward

Qt::Key_Stop

Qt::Key_Refresh

Qt::Key_VolumeDown

Qt::Key_VolumeMute

Qt::Key_VolumeUp

Qt::Key_BassBoost

Qt::Key_BassUp

Qt::Key_BassDown

Qt::Key_TrebleUp

Qt::Key_TrebleDown

Qt::Key_MediaPlay

Qt::Key_MediaStop

Qt::Key_MediaPrev

Qt::Key_MediaNext

Qt::Key_MediaRecord

Qt::Key_HomePage

Qt::Key_Favorites

Qt::Key_Search

Qt::Key_Standby

Qt::Key_OpenUrl

Qt::Key_LaunchMail

Qt::Key_LaunchMedia

Qt::Key_Launch0

Qt::Key_Launch1

Qt::Key_Launch2

Qt::Key_Launch3

Qt::Key_Launch4

Qt::Key_Launch5

Qt::Key_Launch6

Qt::Key_Launch7

Qt::Key_Launch8

Qt::Key_Launch9

Qt::Key_LaunchA

Qt::Key_LaunchB

Qt::Key_LaunchC

Qt::Key_LaunchD

Qt::Key_LaunchE

Qt::Key_LaunchF

Qt::Key_MediaLast

Qt::Key_unknown

Qt::Key_Direction_L - internal use only

Qt::Key_Direction_R - internal use only

Qt::MacintoshVersion¶

Qt::MV_Unknown - Version cannot be detected

Qt::MV_9 - Mac OS 9

Qt::MV_10_DOT_3 - Mac OS X 10.3

Qt::MV_10_DOT_2 - Mac OS X 10.2

Qt::MV_10_DOT_1 - Mac OS X 10.1

Qt::MV_10_DOT_0 - Mac OS X 10.0

Qt::MV_10_DOT_4 - Mac OS X 10.4

Qt::MV_CHEETAH - 10.0 Codename

Qt::MV_PUMA - 10.1 Codename

Qt::MV_JAGUAR - 10.2 Codename

Qt::MV_PANTHER - 10.3 Codename

Qt::MV_TIGER - 10.4 Codename

Qt::Modifier¶

This enum type describes the keyboard modifier keys supported by Qt.

Qt::SHIFT - the Shift keys provided on all standard keyboards.

Qt::META - the Meta keys.

Qt::CTRL - the Ctrl keys.

Qt::ALT - the normal Alt keys, but not e.g. AltGr.

Qt::MODIFIER_MASK - is a mask of Shift, Ctrl, Alt and Meta.

Qt::UNICODE_ACCEL - the accelerator is specified as a Unicode code point, not as a Qt Key.

Qt::Orientation¶

This type is used to signify an object's orientation.

Qt::Horizontal

Qt::Vertical

Orientation is used with QScrollBar for example.

Qt::PaintUnit¶

Qt::PixelUnit

Qt::LoMetricUnit - obsolete

Qt::HiMetricUnit - obsolete

Qt::LoEnglishUnit - obsolete

Qt::HiEnglishUnit - obsolete

Qt::TwipsUnit - obsolete

Qt::PenCapStyle¶

This enum type defines the pen cap styles supported by Qt, i.e. the line end caps that can be drawn using QPainter.

Qt::FlatCap - a square line end that does not cover the end point of the line.

Qt::SquareCap - a square line end that covers the end point and extends beyond it with half the line width.

Qt::RoundCap - a rounded line end.

Qt::MPenCapStyle - mask of the pen cap styles.

<center>
[Image Omitted]

</center>

Qt::PenJoinStyle¶

This enum type defines the pen join styles supported by Qt, i.e. which joins between two connected lines can be drawn using QPainter.

Qt::MiterJoin - The outer edges of the lines are extended to meet at an angle, and this area is filled.

Qt::BevelJoin - The triangular notch between the two lines is filled.

Qt::RoundJoin - A circular arc between the two lines is filled.

Qt::MPenJoinStyle - mask of the pen join styles.

<center>
[Image Omitted]

</center>

Qt::PenStyle¶

This enum type defines the pen styles that can be drawn using QPainter. The styles are

Qt::NoPen - no line at all. For example, QPainter::drawRect() fills but does not draw any boundary line.

Qt::SolidLine - a simple line.

Qt::DashLine - dashes separated by a few pixels.

Qt::DotLine - dots separated by a few pixels.

Qt::DashDotLine - alternate dots and dashes.

Qt::DashDotDotLine - one dash, two dots, one dash, two dots.

Qt::MPenStyle - mask of the pen styles.

<center>
[Image Omitted]

</center>

Qt::RasterOp¶

This enum type is used to describe the way things are written to the paint device. Each bit of the src (what you write) interacts with the corresponding bit of the dst pixel.

Qt::CopyROP - dst = src

Qt::OrROP - dst = src OR dst

Qt::XorROP - dst = src XOR dst

Qt::NotAndROP - dst = (NOT src) AND dst

Qt::EraseROP - an alias for NotAndROP

Qt::NotCopyROP - dst = NOT src

Qt::NotOrROP - dst = (NOT src) OR dst

Qt::NotXorROP - dst = (NOT src) XOR dst

Qt::AndROP - dst = src AND dst

Qt::NotEraseROP - an alias for AndROP

Qt::NotROP - dst = NOT dst

Qt::ClearROP - dst = 0

Qt::SetROP - dst = 1

Qt::NopROP - dst = dst

Qt::AndNotROP - dst = src AND (NOT dst)

Qt::OrNotROP - dst = src OR (NOT dst)

Qt::NandROP - dst = NOT (src AND dst)

Qt::NorROP - dst = NOT (src OR dst)

By far the most useful ones are CopyROP and XorROP.

On Qt/Embedded, only CopyROP, XorROP, and NotROP are supported.

Qt::SequenceMatch¶

Qt::NoMatch - Sequences have nothing in common

Qt::PartialMatch - Sequences match partially, but are not complete

Qt::Identical - Sequences do not differ

Qt::SortOrder¶

This enum describes how the items in a widget are sorted.

Qt::Ascending - The items are sorted ascending e.g. starts with 'AAA' ends with 'ZZZ' in Latin-1 locales

Qt::Descending - The items are sorted descending e.g. starts with 'ZZZ' ends with 'AAA' in Latin-1 locales

Qt::StringComparisonMode¶

This enum type is used to set the string comparison mode when searching for an item. It is used by QListBox, QListView and QIconView, for example. We'll refer to the string being searched as the 'target' string.

Qt::CaseSensitive - The strings must match case sensitively.

Qt::ExactMatch - The target and search strings must match exactly.

Qt::BeginsWith - The target string begins with the search string.

Qt::EndsWith - The target string ends with the search string.

Qt::Contains - The target string contains the search string.

If you OR these flags together (excluding CaseSensitive), the search criteria be applied in the following order: ExactMatch, BeginsWith, EndsWith, Contains.

Matching is case-insensitive unless CaseSensitive is set. CaseSensitive can be OR-ed with any combination of the other flags.

Qt::TextFlags¶

This enum type is used to define some modifier flags. Some of these flags only make sense in the context of printing:

Qt::SingleLine - Treats all whitespace as spaces and prints just one line.

Qt::DontClip - If it's impossible to stay within the given bounds, it prints outside.

Qt::ExpandTabs - Makes the U+0009 (ASCII tab) character move to the next tab stop.

Qt::ShowPrefix - Displays the string "&P" as <u>P</u> (see QButton for an example). For an ampersand, use "&&".

Qt::WordBreak - Breaks lines at appropriate points, e.g. at word boundaries.

Qt::BreakAnywhere - Breaks lines anywhere, even within words.

Qt::NoAccel - Same as ShowPrefix but doesn't draw the underlines.

You can use as many modifier flags as you want, except that SingleLine and WordBreak cannot be combined.

Flags that are inappropriate for a given use (e.g. ShowPrefix to QGridLayout::addWidget()) are generally ignored.

Qt::TextFormat¶

This enum is used in widgets that can display both plain text and rich text, e.g. QLabel. It is used for deciding whether a text string should be interpreted as one or the other. This is normally done by passing one of the enum values to a setTextFormat() function.

Qt::PlainText - The text string is interpreted as a plain text string.

Qt::RichText - The text string is interpreted as a rich text string using the current QStyleSheet::defaultSheet().

Qt::AutoText - The text string is interpreted as for RichText if QStyleSheet::mightBeRichText() returns TRUE, otherwise as PlainText.

Qt::LogText - A special, limited text format which is only used by QTextEdit in an optimized mode.

Qt::TimeSpec¶

Qt::LocalTime - Locale dependent time (Timezones and Daylight Savings Time)

Qt::UTC - Coordinated Universal Time, replaces Greenwich Time

Qt::UIEffect¶

Qt::UI_General

Qt::UI_AnimateMenu

Qt::UI_FadeMenu

Qt::UI_AnimateCombo

Qt::UI_AnimateTooltip

Qt::UI_FadeTooltip

Qt::UI_AnimateToolBox - Reserved

Qt::WidgetFlags¶

This enum type is used to specify various window-system properties for the widget. They are fairly unusual but necessary in a few cases. Some of these flags depend on whether the underlying window manager supports them. (See the toplevel example for an explanation and example of their use.)

The main types are

Qt::WType_TopLevel - indicates that this widget is a top-level widget, usually with a window-system frame and so on.

Qt::WType_Dialog - indicates that this widget is a top-level window that should be decorated as a dialog (i.e. typically no maximize or minimize buttons in the title bar). If you want to use it as a modal dialog it should be launched from another window, or have a parent and this flag should be combined with WShowModal. If you make it modal, the dialog will prevent other top-level windows in the application from getting any input. WType_Dialog implies WType_TopLevel. We refer to a top-level window that has a parent as a secondary window. (See also WGroupLeader.)

Qt::WType_Popup - indicates that this widget is a popup top-level window, i.e. that it is modal, but has a window system frame appropriate for popup menus. WType_Popup implies WType_TopLevel.

Qt::WType_Desktop - indicates that this widget is the desktop. See also WPaintDesktop below. WType_Desktop implies WType_TopLevel.

There are also a number of flags which you can use to customize the appearance of top-level windows. These have no effect on other windows:

Qt::WStyle_Customize - indicates that the WStyle_* flags should be used to build the window instead of the default flags.

Qt::WStyle_NormalBorder - gives the window a normal border. This cannot be combined with WStyle_DialogBorder or WStyle_NoBorder.

Qt::WStyle_DialogBorder - gives the window a thin dialog border. This cannot be combined with WStyle_NormalBorder or WStyle_NoBorder.

Qt::WStyle_NoBorder - produces a borderless window. Note that the user cannot move or resize a borderless window via the window system. This cannot be combined with WStyle_NormalBorder or WStyle_DialogBorder. On Windows, the flag works fine. On X11, the result of the flag is dependent on the window manager and its ability to understand MOTIF and/or NETWM hints: most existing modern window managers can handle this. With WX11BypassWM, you can bypass the window manager completely. This results in a borderless window that is not managed at all (i.e. no keyboard input unless you call setActiveWindow() manually).

Qt::WStyle_NoBorderEx - this value is obsolete. It has the same effect as using WStyle_NoBorder.

Qt::WStyle_Title - gives the window a title bar.

Qt::WStyle_SysMenu - adds a window system menu.

Qt::WStyle_Minimize - adds a minimize button. Note that on Windows this has to be combined with WStyle_SysMenu for it to work.

Qt::WStyle_Maximize - adds a maximize button. Note that on Windows this has to be combined with WStyle_SysMenu for it to work.

Qt::WStyle_MinMax - is equal to WStyle_Minimize|WStyle_Maximize. Note that on Windows this has to be combined with WStyle_SysMenu to work.

Qt::WStyle_ContextHelp - adds a context help button to dialogs.

Qt::WStyle_Tool - makes the window a tool window. A tool window is often a small window with a smaller than usual title bar and decoration, typically used for collections of tool buttons. It there is a parent, the tool window will always be kept on top of it. If there isn't a parent, you may consider passing WStyle_StaysOnTop as well. If the window system supports it, a tool window can be decorated with a somewhat lighter frame. It can also be combined with WStyle_NoBorder.

Qt::WStyle_StaysOnTop - informs the window system that the window should stay on top of all other windows. Note that on some window managers on X11 you also have to pass WX11BypassWM for this flag to work correctly.

Qt::WStyle_Dialog - indicates that the window is a logical subwindow of its parent (i.e. a dialog). The window will not get its own taskbar entry and will be kept on top of its parent by the window system. Usually it will also be minimized when the parent is minimized. If not customized, the window is decorated with a slightly simpler title bar. This is the flag QDialog uses.

Qt::WStyle_Splash - indicates that the window is a splash screen. On X11, we try to follow NETWM standard for a splash screen window if the window manager supports is otherwise it is equivalent to WX11BypassWM. On other platforms, it is equivalent to WStyle_NoBorder | WMacNoSheet | WStyle_Tool | WWinOwnDC

Modifier flags:

Qt::WDestructiveClose - makes Qt delete this widget when the widget has accepted closeEvent(), or when the widget tried to ignore closeEvent() but could not.

Qt::WPaintDesktop - gives this widget paint events for the desktop.

Qt::WPaintUnclipped - makes all painters operating on this widget unclipped. Children of this widget or other widgets in front of it do not clip the area the painter can paint on.

Qt::WPaintClever - indicates that Qt should not try to optimize repainting for the widget, but instead pass on window system repaint events directly. (This tends to produce more events and smaller repaint regions.)

Qt::WMouseNoMask - indicates that even if the widget has a mask, it wants mouse events for its entire rectangle.

Qt::WStaticContents - indicates that the widget contents are north-west aligned and static. On resize, such a widget will receive paint events only for the newly visible part of itself.

Qt::WNoAutoErase - indicates that the widget paints all its pixels. Updating, resizing, scrolling and focus changes should therefore not erase the widget. This allows smart-repainting to avoid flicker.

Qt::WResizeNoErase - this value is obsolete; use WNoAutoErase instead.

Qt::WRepaintNoErase - this value is obsolete; use WNoAutoErase instead.

Qt::WGroupLeader - makes this window a group leader. A group leader should not have a parent (i.e. it should be a top-level window). Any decendant windows (direct or indirect) of a group leader are in its group; other windows are not. If you show a secondary window from the group (i.e. show a window whose top-most parent is a group leader), that window will be modal with respect to the other windows in the group, but modeless with respect to windows in other groups.

Miscellaneous flags

Qt::WShowModal - see WType_Dialog

Internal flags.

Qt::WNoMousePropagation

Qt::WStaticContents

Qt::WStyle_Reserved

Qt::WSubWindow

Qt::WType_Modal

Qt::WWinOwnDC

Qt::WX11BypassWM

Qt::WMacNoSheet

Qt::WMacDrawer

Qt::WStyle_Mask

Qt::WType_Mask

Qt::WidgetState¶

Internal flags.

Qt::WState_Created

Qt::WState_Disabled

Qt::WState_Visible

Qt::WState_ForceHide

Qt::WState_OwnCursor

Qt::WState_MouseTracking

Qt::WState_CompressKeys

Qt::WState_BlockUpdates

Qt::WState_InPaintEvent

Qt::WState_Reparented

Qt::WState_ConfigPending

Qt::WState_Resized

Qt::WState_AutoMask

Qt::WState_Polished

Qt::WState_DND

Qt::WState_Reserved0 - internal

Qt::WState_CreatedHidden

Qt::WState_Maximized

Qt::WState_Minimized

Qt::WState_ForceDisabled

Qt::WState_Exposed

Qt::WState_HasMouse

Qt::WState_CreatedHidden

Qt::WState_OwnSizePolicy

Qt::WState_FullScreen

Qt::WindowState¶

This enum type is used to specify the current state of a top-level window.

The states are

Qt::WindowNoState - The window has no state set (in normal state).

Qt::WindowMinimized - The window is minimized (i.e. iconified).

Qt::WindowMaximized - The window is maximized with a frame around it.

Qt::WindowFullScreen - The window fills the entire screen without any frame around it.

Qt::WindowActive - The window is the active window, i.e. it has keyboard focus.

Qt::WindowsVersion¶

Qt::WV_32s - Windows 3.1 with Win 32s

Qt::WV_95 - Windows 95

Qt::WV_98 - Windows 98

Qt::WV_Me - Windows Me

Qt::WV_DOS_based

Qt::WV_NT - Windows NT

Qt::WV_2000 - Windows 2000

Qt::WV_XP - Windows XP

Qt::WV_2003 - Windows Server 2003

Qt::WV_NT_based

Qt::WV_VISTA - Windows Vista

Qt::WV_CE - Windows CE

Qt::WV_CENET - Windows CE .NET

Qt::WV_CE_based

SEE ALSO¶

http://doc.trolltech.com/qt.html http://www.trolltech.com/faq/tech.html

COPYRIGHT¶

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement.

AUTHOR¶

Generated automatically from the source code.

BUGS¶

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you.

The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech.

If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qt.3qt) and the Qt version (3.3.8).