Qtopia Home - Classes - Hierachy - Annotated - Functions - Licenses - Reference

Qt Class Reference

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

#include <qnamespace.h>

Inherited by QObject, QListViewItem, QTableItem, QDL, QPixmap, QBrush, QEvent, QCustomMenuItem, QPainter, QPen, QStyleSheetItem, QToolTip, and QWhatsThis.

List of all member functions.

Public Members

• enum ButtonState { NoButton = 0x0000, LeftButton = 0x0001, RightButton = 0x0002, MidButton = 0x0004, MouseButtonMask = 0x0007, ShiftButton = 0x0008, ControlButton = 0x0010, AltButton = 0x0020, KeyButtonMask = 0x0038, Keypad = 0x4000 }
• enum Orientation { Horizontal, Vertical }
• enum AlignmentFlags { AlignLeft = 0x0001, AlignRight = 0x0002, AlignHCenter = 0x0004, AlignTop = 0x0008, AlignBottom = 0x0010, AlignVCenter = 0x0020, AlignCenter = AlignVCenter | AlignHCenter, SingleLine = 0x0040, DontClip = 0x0080, ExpandTabs = 0x0100, ShowPrefix = 0x0200, WordBreak = 0x0400, DontPrint = 0x1000 }
• enum WidgetState { WState_Created = 0x00000001, WState_Disabled = 0x00000002, WState_Visible = 0x00000004, WState_ForceHide = 0x00000008, WState_OwnCursor = 0x00000010, WState_MouseTracking = 0x00000020, WState_CompressKeys = 0x00000040, WState_BlockUpdates = 0x00000080, WState_InPaintEvent = 0x00000100, WState_Reparented = 0x00000200, WState_ConfigPending = 0x00000400, WState_Resized = 0x00000800, WState_AutoMask = 0x00001000, WState_Polished = 0x00002000, WState_DND = 0x00004000, WState_Modal = 0x00008000, WState_Reserved1 = 0x00010000, WState_Reserved2 = 0x00020000, WState_Reserved3 = 0x00040000, WState_Maximized = 0x00080000, WState_TranslateBackground = 0x00100000, WState_ForceDisabled = 0x00200000, WState_Exposed = 0x00400000, WState_TranslateBackground1 = 0x00800000, WState_GlobalBrushOrigin = 0x01000000 }
• typedef uint WFlags
• enum WidgetFlags { WType_TopLevel = 0x00000001, WType_Modal = 0x00000002, WType_Popup = 0x00000004, WType_Desktop = 0x00000008, WType_Mask = 0x0000000f, WStyle_Customize = 0x00000010, WStyle_NormalBorder = 0x00000020, WStyle_DialogBorder = 0x00000040, WStyle_NoBorder = 0x00000000, WStyle_Title = 0x00000080, WStyle_SysMenu = 0x00000100, WStyle_Minimize = 0x00000200, WStyle_Maximize = 0x00000400, WStyle_MinMax = WStyle_Minimize | WStyle_Maximize, WStyle_Tool = 0x00000800, WStyle_StaysOnTop = 0x00001000, WStyle_Dialog = 0x00002000, WStyle_ContextHelp = 0x00004000, WStyle_NoBorderEx = 0x00008000, WStyle_Mask = 0x0000fff0, WDestructiveClose = 0x00010000, WPaintDesktop = 0x00020000, WPaintUnclipped = 0x00040000, WPaintClever = 0x00080000, WResizeNoErase = 0x00100000, WMouseNoMask = 0x00200000, WNorthWestGravity = 0x00400000, WRepaintNoErase = 0x00800000, WX11BypassWM = 0x01000000, WGroupLeader = 0x02000000 }
• enum ImageConversionFlags { ColorMode_Mask = 0x00000003, AutoColor = 0x00000000, ColorOnly = 0x00000003, MonoOnly = 0x00000002, AlphaDither_Mask = 0x0000000c, ThresholdAlphaDither = 0x00000000, OrderedAlphaDither = 0x00000004, DiffuseAlphaDither = 0x00000008, NoAlpha = 0x0000000c, Dither_Mask = 0x00000030, DiffuseDither = 0x00000000, OrderedDither = 0x00000010, ThresholdDither = 0x00000020, DitherMode_Mask = 0x000000c0, AutoDither = 0x00000000, PreferDither = 0x00000040, AvoidDither = 0x00000080 }
• enum BGMode { TransparentMode, OpaqueMode }
• enum PaintUnit { PixelUnit, LoMetricUnit, HiMetricUnit, LoEnglishUnit, HiEnglishUnit, TwipsUnit }
• enum GUIStyle { MacStyle, WindowsStyle, Win3Style, PMStyle, MotifStyle }
• enum Modifier { SHIFT = 0x00200000, CTRL = 0x00400000, ALT = 0x00800000, MODIFIER_MASK = 0x00e00000, UNICODE_ACCEL = 0x10000000, ASCII_ACCEL = UNICODE_ACCEL }
• enum Key { Key_Escape = 0x1000, Key_Tab = 0x1001, Key_Backtab = 0x1002, Key_BackTab = Key_Backtab, Key_Backspace = 0x1003, Key_BackSpace = Key_Backspace, Key_Return = 0x1004, Key_Enter = 0x1005, Key_Insert = 0x1006, Key_Delete = 0x1007, Key_Pause = 0x1008, Key_Print = 0x1009, Key_SysReq = 0x100a, Key_Home = 0x1010, Key_End = 0x1011, Key_Left = 0x1012, Key_Up = 0x1013, Key_Right = 0x1014, Key_Down = 0x1015, Key_Prior = 0x1016, Key_PageUp = Key_Prior, Key_Next = 0x1017, Key_PageDown = Key_Next, Key_Shift = 0x1020, Key_Control = 0x1021, Key_Meta = 0x1022, Key_Alt = 0x1023, Key_CapsLock = 0x1024, Key_NumLock = 0x1025, Key_ScrollLock = 0x1026, Key_F1 = 0x1030, Key_F2 = 0x1031, Key_F3 = 0x1032, Key_F4 = 0x1033, Key_F5 = 0x1034, Key_F6 = 0x1035, Key_F7 = 0x1036, Key_F8 = 0x1037, Key_F9 = 0x1038, Key_F10 = 0x1039, Key_F11 = 0x103a, Key_F12 = 0x103b, Key_F13 = 0x103c, Key_F14 = 0x103d, Key_F15 = 0x103e, Key_F16 = 0x103f, Key_F17 = 0x1040, Key_F18 = 0x1041, Key_F19 = 0x1042, Key_F20 = 0x1043, Key_F21 = 0x1044, Key_F22 = 0x1045, Key_F23 = 0x1046, Key_F24 = 0x1047, Key_F25 = 0x1048, Key_F26 = 0x1049, Key_F27 = 0x104a, Key_F28 = 0x104b, Key_F29 = 0x104c, Key_F30 = 0x104d, Key_F31 = 0x104e, Key_F32 = 0x104f, Key_F33 = 0x1050, Key_F34 = 0x1051, Key_F35 = 0x1052, Key_Super_L = 0x1053, Key_Super_R = 0x1054, Key_Menu = 0x1055, Key_Hyper_L = 0x1056, Key_Hyper_R = 0x1057, Key_Help = 0x1058, Key_Muhenkan = 0x1122, Key_Henkan = 0x1123, Key_Hiragana_Katakana = 0x1127, Key_Zenkaku_Hankaku = 0x112A, Key_Space = 0x20, Key_Any = Key_Space, Key_Exclam = 0x21, Key_QuoteDbl = 0x22, Key_NumberSign = 0x23, Key_Dollar = 0x24, Key_Percent = 0x25, Key_Ampersand = 0x26, Key_Apostrophe = 0x27, Key_ParenLeft = 0x28, Key_ParenRight = 0x29, Key_Asterisk = 0x2a, Key_Plus = 0x2b, Key_Comma = 0x2c, Key_Minus = 0x2d, Key_Period = 0x2e, Key_Slash = 0x2f, Key_0 = 0x30, Key_1 = 0x31, Key_2 = 0x32, Key_3 = 0x33, Key_4 = 0x34, Key_5 = 0x35, Key_6 = 0x36, Key_7 = 0x37, Key_8 = 0x38, Key_9 = 0x39, Key_Colon = 0x3a, Key_Semicolon = 0x3b, Key_Less = 0x3c, Key_Equal = 0x3d, Key_Greater = 0x3e, Key_Question = 0x3f, Key_At = 0x40, Key_A = 0x41, Key_B = 0x42, Key_C = 0x43, Key_D = 0x44, Key_E = 0x45, Key_F = 0x46, Key_G = 0x47, Key_H = 0x48, Key_I = 0x49, Key_J = 0x4a, Key_K = 0x4b, Key_L = 0x4c, Key_M = 0x4d, Key_N = 0x4e, Key_O = 0x4f, Key_P = 0x50, Key_Q = 0x51, Key_R = 0x52, Key_S = 0x53, Key_T = 0x54, Key_U = 0x55, Key_V = 0x56, Key_W = 0x57, Key_X = 0x58, Key_Y = 0x59, Key_Z = 0x5a, Key_BracketLeft = 0x5b, Key_Backslash = 0x5c, Key_BracketRight = 0x5d, Key_AsciiCircum = 0x5e, Key_Underscore = 0x5f, Key_QuoteLeft = 0x60, Key_BraceLeft = 0x7b, Key_Bar = 0x7c, Key_BraceRight = 0x7d, Key_AsciiTilde = 0x7e, Key_nobreakspace = 0x0a0, Key_exclamdown = 0x0a1, Key_cent = 0x0a2, Key_sterling = 0x0a3, Key_currency = 0x0a4, Key_yen = 0x0a5, Key_brokenbar = 0x0a6, Key_section = 0x0a7, Key_diaeresis = 0x0a8, Key_copyright = 0x0a9, Key_ordfeminine = 0x0aa, Key_guillemotleft = 0x0ab, Key_notsign = 0x0ac, Key_hyphen = 0x0ad, Key_registered = 0x0ae, Key_macron = 0x0af, Key_degree = 0x0b0, Key_plusminus = 0x0b1, Key_twosuperior = 0x0b2, Key_threesuperior = 0x0b3, Key_acute = 0x0b4, Key_mu = 0x0b5, Key_paragraph = 0x0b6, Key_periodcentered = 0x0b7, Key_cedilla = 0x0b8, Key_onesuperior = 0x0b9, Key_masculine = 0x0ba, Key_guillemotright = 0x0bb, Key_onequarter = 0x0bc, Key_onehalf = 0x0bd, Key_threequarters = 0x0be, Key_questiondown = 0x0bf, Key_Agrave = 0x0c0, Key_Aacute = 0x0c1, Key_Acircumflex = 0x0c2, Key_Atilde = 0x0c3, Key_Adiaeresis = 0x0c4, Key_Aring = 0x0c5, Key_AE = 0x0c6, Key_Ccedilla = 0x0c7, Key_Egrave = 0x0c8, Key_Eacute = 0x0c9, Key_Ecircumflex = 0x0ca, Key_Ediaeresis = 0x0cb, Key_Igrave = 0x0cc, Key_Iacute = 0x0cd, Key_Icircumflex = 0x0ce, Key_Idiaeresis = 0x0cf, Key_ETH = 0x0d0, Key_Ntilde = 0x0d1, Key_Ograve = 0x0d2, Key_Oacute = 0x0d3, Key_Ocircumflex = 0x0d4, Key_Otilde = 0x0d5, Key_Odiaeresis = 0x0d6, Key_multiply = 0x0d7, Key_Ooblique = 0x0d8, Key_Ugrave = 0x0d9, Key_Uacute = 0x0da, Key_Ucircumflex = 0x0db, Key_Udiaeresis = 0x0dc, Key_Yacute = 0x0dd, Key_THORN = 0x0de, Key_ssharp = 0x0df, Key_agrave = 0x0e0, Key_aacute = 0x0e1, Key_acircumflex = 0x0e2, Key_atilde = 0x0e3, Key_adiaeresis = 0x0e4, Key_aring = 0x0e5, Key_ae = 0x0e6, Key_ccedilla = 0x0e7, Key_egrave = 0x0e8, Key_eacute = 0x0e9, Key_ecircumflex = 0x0ea, Key_ediaeresis = 0x0eb, Key_igrave = 0x0ec, Key_iacute = 0x0ed, Key_icircumflex = 0x0ee, Key_idiaeresis = 0x0ef, Key_eth = 0x0f0, Key_ntilde = 0x0f1, Key_ograve = 0x0f2, Key_oacute = 0x0f3, Key_ocircumflex = 0x0f4, Key_otilde = 0x0f5, Key_odiaeresis = 0x0f6, Key_division = 0x0f7, Key_oslash = 0x0f8, Key_ugrave = 0x0f9, Key_uacute = 0x0fa, Key_ucircumflex = 0x0fb, Key_udiaeresis = 0x0fc, Key_yacute = 0x0fd, Key_thorn = 0x0fe, Key_ydiaeresis = 0x0ff, Key_unknown = 0xffff }
• enum ArrowType { UpArrow, DownArrow, LeftArrow, RightArrow }
• enum RasterOp { CopyROP, OrROP, XorROP, NotAndROP, EraseROP = NotAndROP, NotCopyROP, NotOrROP, NotXorROP, AndROP, NotEraseROP = AndROP, NotROP, ClearROP, SetROP, NopROP, AndNotROP, OrNotROP, NandROP, NorROP, LastROP = NorROP }
• enum PenStyle { NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine, MPenStyle = 0x0f }
• enum PenCapStyle { FlatCap = 0x00, SquareCap = 0x10, RoundCap = 0x20, MPenCapStyle = 0x30 }
• enum PenJoinStyle { MiterJoin = 0x00, BevelJoin = 0x40, RoundJoin = 0x80, MPenJoinStyle = 0xc0 }
• enum BrushStyle { NoBrush, SolidPattern, Dense1Pattern, Dense2Pattern, Dense3Pattern, Dense4Pattern, Dense5Pattern, Dense6Pattern, Dense7Pattern, HorPattern, VerPattern, CrossPattern, BDiagPattern, FDiagPattern, DiagCrossPattern, CustomPattern = 24 }
• enum WindowsVersion { WV_32s = 0x0001, WV_95 = 0x0002, WV_98 = 0x0003, WV_DOS_based = 0x000f, WV_NT = 0x0010, WV_2000 = 0x0020, WV_NT_based = 0x00f0 }
• enum UIEffect { UI_General, UI_AnimateMenu, UI_FadeMenu, UI_AnimateCombo, UI_AnimateTooltip, UI_FadeTooltip }
• enum TextFormat { PlainText, RichText, AutoText }

Detailed 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 that all the identifiers in the Qt namespace are visible to you without qualification.

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

See also

Member Type Documentation

Qt::AlignmentFlags

This enum type is used to describe alignment. It contains four sets of flags: Horizontal, vertical and modifying flags. The horizontal flags are:

• AlignLeft - Align with the left edge.
• AlignRight - Align with the right edge.
• AlignHCenter - Center horizontally in the available space.

• AlignTop - Align with the top.
• AlignBottom - Align with the bottom.
• AlignVCenter - Center vertically in the available space.

• AlignCenter - Center in both dimensions.

There are also some modifier flags. All of them apply only to printing:

• SingleLine - Treat all white-space as space and print just one line.
• DontClip - If it's impossible to stay within the given bounds, print outside.
• ExpandTabs - Make the U+0009 (ascii tab) character move to the next tab stop.
• ShowPrefix - Display the string "&P" as an underlined P (see QButton for an example). To get an ampersand, use "&&".
• WordBreak - Do line breaking at at appropriate points.

You can only use one of the horizontal flags at a time, and one of the vertical flags. AlignCenter counts as both horizontal and vertical. 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 ignored.

Conflicting combinations of flags have undefined meanings.

Qt::ButtonState

• NoButton - used when the button state does not refer to any button (see QMouseEvent::button()).
• LeftButton - set if the left button is pressed, or this event refers to the left button. Note that the left button may be the right button on left-handed mice.
• RightButton - the right button.
• MidButton - the middle button
• ShiftButton - a shift key on the keyboard is also pressed.
• ControlButton - a control key on the keyboard is also pressed.
• AltButton - an alt (or meta) key on the keyboard is also pressed.
• Keypad - a keypad button is pressed.

Qt::Orientation

This type is used to signify whether an object should be Horizontal or Vertical (for example in QScrollBar).

Qt::PenCapStyle

This enum type defines the pen cap styles supported by Qt; ie. what sorts of line end caps that can be drawn using QPainter. The available styles are:

• FlatCap - A square line end that does not cover the end point of the line.
• SquareCap - A square line end that covers the end point and extends beyond it with half the line width.
• RoundCap - A rounded line end.

Qt::PenJoinStyle

This enum type defines the pen join styles supported by Qt; ie. what sorts of joins between two connected lines that can be drawn using QPainter. The available styles are:

• MiterJoin - The outer edges of the lines are extended to meet at an angle, and this area is filled.
• BevelJoin - The triangular notch between the two lines is filled.
• RoundJoin - A circular arc between the two lines is filled.

Qt::PenStyle

This enum type defines the pen styles supported by Qt; ie. what sorts of lines that can be drawn using QPainter. The current styles are:

• NoPen - no line at all. For example, QPainter::drawRect() fills but does not draw any explicit boundary line.
• SolidLine - a simple line.
• DashLine - dashes, separated by a few pixels.
• DotLine - dots, separated by a few pixels.
• DashDotLine - alternately dots and dashes.
• DashDotDotLine - one dash, two dots, one dash, two dots...

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. The currently defined values are:

• CopyROP - dst = src
• OrROP - dst = src OR dst
• XorROP - dst = src XOR dst
• NotAndROP - dst = (NOT src) AND dst
• EraseROP - an alias for NotAndROP
• NotCopyROP - dst = NOT src
• NotOrROP - dst = (NOT src) OR dst
• NotXorROP - dst = (NOT src) XOR dst
• AndROP - dst = src AND dst
• NotEraseROP - an alias for AndROP
• NotROP - dst = NOT dst
• ClearROP - dst = 0
• SetROP - dst = 1
• NopROP - dst = dst
• AndNotROP - dst = src AND (NOT dst)
• OrNotROP - dst = src OR (NOT dst)
• NandROP - dst = NOT (src AND dst)
• 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::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 the one or the other. This is normally done by passing one of the enum values to a setTextFormat() function.

• PlainText - The text string is interpreted as a normal text string.
• RichText - The text string is interpreted as a rich text according to the current QStyleSheet::defaultSheet().
• AutoText - The text string is interpreted as for RichText if QStyleSheet::mightBeRichText() returns TRUE, otherwise as for PlainText.

Qt::WidgetFlags

This enum type is used to specify various window-system properties of the widget. Mostly they are fairly unusual, but necessary in a few cases.

The main types are

• WType_TopLevel - indicates that this widget is a top-level widget, usually with a window-system frame and so on.
• WType_Modal - indicates that this widget is a modal top-level widget, ie. that it prevents widgets in all other top-level widget from getting any input. WType_Modal inplies WStyle_Dialog.
• WType_Popup - indicates that this widget is a popup top-level window, ie. that it is modal, but has a window system frame appropriate for popup menus.
• WType_Desktop - indicates that this widget is the desktop. See also WPaintDesktop below.

• WStyle_Customize - indicates that instead of the default, the WStyle_* flags should be used to build the window.
• WStyle_NormalBorder - gives the window a normal border. Cannot be combined with WStyle_DialogBorder or WStyle_NoBorder.
• WStyle_DialogBorder - gives the window a thin dialog border. Cannot be combined with WStyle_NormalBorder or WStyle_NoBorder.
• WStyle_NoBorder - gives a borderless window. Note that the user cannot move or resize a borderless window via the window system. Cannot be combined with WStyle_NormalBorder or WStyle_DialogBorder. On Windows, the flag works fine. On X11, it bypasses the window manager completely. This results in a borderless window, but also in a window that is not managed at all (i.e. for example no keyboard focus unless you call setActiveWindow() manually. ) For compatibility, the flag was not changed for Qt-2.1. We suggest using WStyle_NoBorderEx instead.
• WStyle_NoBorderEx - gives a borderless window. Note that the user cannot move or resize a borderless window via the window system. Cannot be combined with WStyle_NormalBorder or WStyle_DialogBorder. On X11, the result of the flag is depending on the window manager and its ability to understand MOTIF hints to some degree. Most existing modern window managers do this. With WX11BypassWM, you can bypass the window manager completely. This results in a borderless window for sure, but also in a window that is not managed at all (i.e. for example no keyboard input unless you call setActiveWindow() manually )
• WStyle_Title - gives the window a title bar.
• WStyle_SysMenu - adds a window system menu.
• WStyle_Minimize - adds a minimize button. Note that on Windows this has to be combined with WStyle_SysMenu for it to work.
• WStyle_Maximize - adds a maximize button. Note that on Windows this has to be combined with WStyle_SysMenu for it to work.
• WStyle_MinMax - is equal to WStyle_Minimize|WStyle_Maximize. Note that on Windows this has to be combined with WStyle_SysMenu for it to work.
• WStyle_ContextHelp - adds a context help button to dialogs.
• WStyle_Tool - makes the window a tool window. A tool window is a small window that lives for a short time and it is typically used for creating popup windows. 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 is be decorated with a somewhat lighter frame. It can, however, be combined with WStyle_NoBorder as well.
• WStyle_StaysOnTop - informs the window system that the window should stay on top of all other windows.
• WStyle_Dialog - indicates that the window is a logical subwindow of its parent, in other words: a dialog. The window will not get its own taskbar entry and 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.

• WDestructiveClose - makes Qt delete this object when the object has accepted closeEvent(), or when the widget tried to ignore closeEvent() but could not.
• WPaintDesktop - gives this widget paint events for the desktop.
• 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.
• 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.)
• WResizeNoErase - indicates that resizing the widget should not erase it. This allows smart-repainting to avoid flicker.
• WMouseNoMask - indicates that even if the widget has a mask, it wants mouse events for its entire rectangle.
• WNorthWestGravity - indicates that the widget contents is north-west aligned and static. On resize, such a widget will receive paint events only for the newly visible part of itself.
• WRepaintNoErase - indicates that the widget paints all its pixels. Updating, scrolling and focus changes should therefore not erase the widget. This allows smart-repainting to avoid flicker.
• WGroupLeader - makes this widget or window a group leader. Modality of secondary windows only affects windows within the same group.

This file is part of the Qtopia platform, copyright © 1995-2005 Trolltech, all rights reserved.