qt.3qt

Trolltech公司发布的基于C++图形开发环境

.SH "Qt::PenStyle"
This enum type defines the pen styles that can be drawn using QPainter. The styles are
.TP
\fCQt::NoPen\fR - no line at all. For example, QPainter::drawRect() fills but does not draw any boundary line.
.TP
\fCQt::SolidLine\fR - a simple line.
.TP
\fCQt::DashLine\fR - dashes separated by a few pixels.
.TP
\fCQt::DotLine\fR - dots separated by a few pixels.
.TP
\fCQt::DashDotLine\fR - alternate dots and dashes.
.TP
\fCQt::DashDotDotLine\fR - one dash, two dots, one dash, two dots.
.TP
\fCQt::MPenStyle\fR - mask of the pen styles.
.PP
<center>
.ce 1
.B "[Image Omitted]"
.PP
</center>
.SH "Qt::RasterOp"
This enum type is used to describe the way things are written to the paint device. Each bit of the \fIsrc\fR (what you write) interacts with the corresponding bit of the \fIdst\fR pixel.
.TP
\fCQt::CopyROP\fR - dst = src
.TP
\fCQt::OrROP\fR - dst = src OR dst
.TP
\fCQt::XorROP\fR - dst = src XOR dst
.TP
\fCQt::NotAndROP\fR - dst = (NOT src) AND dst
.TP
\fCQt::EraseROP\fR - an alias for NotAndROP
.TP
\fCQt::NotCopyROP\fR - dst = NOT src
.TP
\fCQt::NotOrROP\fR - dst = (NOT src) OR dst
.TP
\fCQt::NotXorROP\fR - dst = (NOT src) XOR dst
.TP
\fCQt::AndROP\fR - dst = src AND dst
.TP
\fCQt::NotEraseROP\fR - an alias for AndROP
.TP
\fCQt::NotROP\fR - dst = NOT dst
.TP
\fCQt::ClearROP\fR - dst = 0
.TP
\fCQt::SetROP\fR - dst = 1
.TP
\fCQt::NopROP\fR - dst = dst
.TP
\fCQt::AndNotROP\fR - dst = src AND (NOT dst)
.TP
\fCQt::OrNotROP\fR - dst = src OR (NOT dst)
.TP
\fCQt::NandROP\fR - dst = NOT (src AND dst)
.TP
\fCQt::NorROP\fR - dst = NOT (src OR dst)
.PP
By far the most useful ones are CopyROP and XorROP.
.PP
On Qt/Embedded, only CopyROP, XorROP, and NotROP are supported.
.SH "Qt::SequenceMatch"
.TP
\fCQt::NoMatch\fR - Sequences have nothing in common
.TP
\fCQt::PartialMatch\fR - Sequences match partially, but are not complete
.TP
\fCQt::Identical\fR - Sequences do not differ
.SH "Qt::SortOrder"
This enum describes how the items in a widget are sorted.
.TP
\fCQt::Ascending\fR - The items are sorted ascending e.g. starts with 'AAA' ends with 'ZZZ' in Latin-1 locales
.TP
\fCQt::Descending\fR - The items are sorted descending e.g. starts with 'ZZZ' ends with 'AAA' in Latin-1 locales
.SH "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.
.TP
\fCQt::CaseSensitive\fR - The strings must match case sensitively.
.TP
\fCQt::ExactMatch\fR - The target and search strings must match exactly.
.TP
\fCQt::BeginsWith\fR - The target string begins with the search string.
.TP
\fCQt::EndsWith\fR - The target string ends with the search string.
.TP
\fCQt::Contains\fR - The target string contains the search string.
.PP
If you OR these flags together (excluding CaseSensitive), the search criteria be applied in the following order: ExactMatch, BeginsWith, EndsWith, Contains.
.PP
Matching is case-insensitive unless CaseSensitive is set. CaseSensitive can be OR-ed with any combination of the other flags.
.SH "Qt::TextFlags"
This enum type is used to define some modifier flags. Some of these flags only make sense in the context of printing:
.TP
\fCQt::SingleLine\fR - Treats all whitespace as spaces and prints just one line.
.TP
\fCQt::DontClip\fR - If it's impossible to stay within the given bounds, it prints outside.
.TP
\fCQt::ExpandTabs\fR - Makes the U+0009 (ASCII tab) character move to the next tab stop.
.TP
\fCQt::ShowPrefix\fR - Displays the string "&P" as <u>P</u> (see QButton for an example). For an ampersand, use "&&".
.TP
\fCQt::WordBreak\fR - Breaks lines at appropriate points, e.g. at word boundaries.
.TP
\fCQt::BreakAnywhere\fR - Breaks lines anywhere, even within words.
.TP
\fCQt::NoAccel\fR - Same as ShowPrefix but doesn't draw the underlines.
.PP
You can use as many modifier flags as you want, except that SingleLine and WordBreak cannot be combined.
.PP
Flags that are inappropriate for a given use (e.g. ShowPrefix to QGridLayout::addWidget()) are generally ignored.
.SH "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.
.TP
\fCQt::PlainText\fR - The text string is interpreted as a plain text string.
.TP
\fCQt::RichText\fR - The text string is interpreted as a rich text string using the current QStyleSheet::defaultSheet().
.TP
\fCQt::AutoText\fR - The text string is interpreted as for RichText if QStyleSheet::mightBeRichText() returns TRUE, otherwise as PlainText.
.TP
\fCQt::LogText\fR - A special, limited text format which is only used by QTextEdit in an optimized mode.
.SH "Qt::TimeSpec"
.TP
\fCQt::LocalTime\fR - Locale dependent time (Timezones and Daylight Savings Time)
.TP
\fCQt::UTC\fR - Coordinated Universal Time, replaces Greenwich Time
.SH "Qt::UIEffect"
.TP
\fCQt::UI_General\fR
.TP
\fCQt::UI_AnimateMenu\fR
.TP
\fCQt::UI_FadeMenu\fR
.TP
\fCQt::UI_AnimateCombo\fR
.TP
\fCQt::UI_AnimateTooltip\fR
.TP
\fCQt::UI_FadeTooltip\fR
.TP
\fCQt::UI_AnimateToolBox\fR - Reserved
.SH "Qt::WidgetFlags"

.PP
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.)
.PP
The main types are
.TP
\fCQt::WType_TopLevel\fR - indicates that this widget is a top-level widget, usually with a window-system frame and so on.
.TP
\fCQt::WType_Dialog\fR - 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 \fIsecondary\fR window. (See also WGroupLeader.)
.TP
\fCQt::WType_Popup\fR - 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.
.TP
\fCQt::WType_Desktop\fR - indicates that this widget is the desktop. See also WPaintDesktop below. WType_Desktop implies WType_TopLevel.
.PP
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:
.TP
\fCQt::WStyle_Customize\fR - indicates that the \fCWStyle_*\fR flags should be used to build the window instead of the default flags.
.TP
\fCQt::WStyle_NormalBorder\fR - gives the window a normal border. This cannot be combined with WStyle_DialogBorder or WStyle_NoBorder.
.TP
\fCQt::WStyle_DialogBorder\fR - gives the window a thin dialog border. This cannot be combined with WStyle_NormalBorder or WStyle_NoBorder.
.TP
\fCQt::WStyle_NoBorder\fR - 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).
.TP
\fCQt::WStyle_NoBorderEx\fR - this value is obsolete. It has the same effect as using WStyle_NoBorder.
.TP
\fCQt::WStyle_Title\fR - gives the window a title bar.
.TP
\fCQt::WStyle_SysMenu\fR - adds a window system menu.
.TP
\fCQt::WStyle_Minimize\fR - adds a minimize button. Note that on Windows this has to be combined with WStyle_SysMenu for it to work.
.TP
\fCQt::WStyle_Maximize\fR - adds a maximize button. Note that on Windows this has to be combined with WStyle_SysMenu for it to work.
.TP
\fCQt::WStyle_MinMax\fR - is equal to \fCWStyle_Minimize|WStyle_Maximize\fR. Note that on Windows this has to be combined with WStyle_SysMenu to work.
.TP
\fCQt::WStyle_ContextHelp\fR - adds a context help button to dialogs.
.TP
\fCQt::WStyle_Tool\fR - 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.
.TP
\fCQt::WStyle_StaysOnTop\fR - 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.
.TP
\fCQt::WStyle_Dialog\fR - 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.
.TP
\fCQt::WStyle_Splash\fR - 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 \fC|\fR WMacNoSheet \fC|\fR WStyle_Tool \fC|\fR WWinOwnDC
.PP
Modifier flags:
.TP
\fCQt::WDestructiveClose\fR - makes Qt delete this widget when the widget has accepted closeEvent(), or when the widget tried to ignore closeEvent() but could not.
.TP
\fCQt::WPaintDesktop\fR - gives this widget paint events for the desktop.
.TP
\fCQt::WPaintUnclipped\fR - 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.
.TP
\fCQt::WPaintClever\fR - indicates that Qt should \fInot\fR 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.)
.TP
\fCQt::WMouseNoMask\fR - indicates that even if the widget has a mask, it wants mouse events for its entire rectangle.
.TP
\fCQt::WStaticContents\fR - 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.
.TP
\fCQt::WNoAutoErase\fR - 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.
.TP
\fCQt::WResizeNoErase\fR - this value is obsolete; use WNoAutoErase instead.
.TP
\fCQt::WRepaintNoErase\fR - this value is obsolete; use WNoAutoErase instead.
.TP
\fCQt::WGroupLeader\fR - makes this window a group leader. A group leader should \fInot\fR 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.
.PP
Miscellaneous flags
.TP
\fCQt::WShowModal\fR - see WType_Dialog
.PP
Internal flags.
.TP
\fCQt::WNoMousePropagation\fR
.TP
\fCQt::WStaticContents\fR
.TP
\fCQt::WStyle_Reserved\fR
.TP
\fCQt::WSubWindow\fR
.TP
\fCQt::WType_Modal\fR
.TP
\fCQt::WWinOwnDC\fR
.TP
\fCQt::WX11BypassWM\fR
.TP
\fCQt::WMacNoSheet\fR
.TP
\fCQt::WMacDrawer\fR
.TP
\fCQt::WStyle_Mask\fR
.TP
\fCQt::WType_Mask\fR
.SH "Qt::WidgetState"
Internal flags.
.TP
\fCQt::WState_Created\fR
.TP
\fCQt::WState_Disabled\fR
.TP
\fCQt::WState_Visible\fR
.TP
\fCQt::WState_ForceHide\fR
.TP
\fCQt::WState_OwnCursor\fR
.TP
\fCQt::WState_MouseTracking\fR
.TP
\fCQt::WState_CompressKeys\fR
.TP
\fCQt::WState_BlockUpdates\fR
.TP
\fCQt::WState_InPaintEvent\fR
.TP
\fCQt::WState_Reparented\fR
.TP
\fCQt::WState_ConfigPending\fR
.TP
\fCQt::WState_Resized\fR
.TP
\fCQt::WState_AutoMask\fR
.TP
\fCQt::WState_Polished\fR
.TP
\fCQt::WState_DND\fR
.TP
\fCQt::WState_Reserved0\fR - \fIinternal\fR
.TP
\fCQt::WState_CreatedHidden\fR
.TP
\fCQt::WState_Maximized\fR
.TP
\fCQt::WState_Minimized\fR
.TP
\fCQt::WState_ForceDisabled\fR
.TP
\fCQt::WState_Exposed\fR
.TP
\fCQt::WState_HasMouse\fR
.TP
\fCQt::WState_CreatedHidden\fR
.TP
\fCQt::WState_OwnSizePolicy\fR
.TP
\fCQt::WState_FullScreen\fR
.SH "Qt::WindowState"

.PP
This enum type is used to specify the current state of a top-level window.
.PP
The states are
.TP
\fCQt::WindowNoState\fR - The window has no state set (in normal state).
.TP
\fCQt::WindowMinimized\fR - The window is minimized (i.e. iconified).
.TP
\fCQt::WindowMaximized\fR - The window is maximized with a frame around it.
.TP
\fCQt::WindowFullScreen\fR - The window fills the entire screen without any frame around it.
.TP
\fCQt::WindowActive\fR - The window is the active window, i.e. it has keyboard focus.
.SH "Qt::WindowsVersion"
.TP
\fCQt::WV_32s\fR
.TP
\fCQt::WV_95\fR
.TP
\fCQt::WV_98\fR
.TP
\fCQt::WV_Me\fR
.TP
\fCQt::WV_DOS_based\fR
.TP
\fCQt::WV_NT\fR
.TP
\fCQt::WV_2000\fR
.TP
\fCQt::WV_XP\fR
.TP
\fCQt::WV_2003\fR
.TP
\fCQt::WV_NT_based\fR
.TP
\fCQt::WV_CE\fR
.TP
\fCQt::WV_CENET\fR
.TP
\fCQt::WV_CE_based\fR

.SH "SEE ALSO"
.BR http://doc.trolltech.com/qt.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2001 Trolltech AS, http://www.trolltech.com.  See the
license file included in the distribution for a complete license
statement.
.SH AUTHOR
Generated automatically from the source code.
.SH BUGS
If you find a bug in Qt, please report it as described in
.BR http://doc.trolltech.com/bughowto.html .
Good bug reports help us to help you. Thank you.
.P
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. 
.P
If you find errors in this manual page, please report them to
.BR [e-mail] .
Please include the name of the manual page (qt.3qt) and the Qt
version (3.3.4).