qframe.3qt

Qt/Embedded是一个多平台的C++图形用户界面应用程序框架

Reimplemented in QProgressBar and QLabel.
.SH "void QFrame::drawFrame ( QPainter * p ) \fC[virtual protected]\fR"
Draws the frame using the current frame attributes and color group. The rectangle inside the frame is not affected.
.PP
This function is virtual, but in general you do not need to reimplement it. If you do, note that the QPainter is already open and must remain open.
.PP
See also frameRect(), contentsRect(), drawContents(), frameStyle(), setPalette() and drawFrameMask().
.SH "void QFrame::drawFrameMask ( QPainter * p ) \fC[virtual protected]\fR"
Virtual function that draws the mask of the frame's frame.
.PP
If you reimplemented drawFrame(QPainter*) and your widget should support transparency you probably have to re-implement this function as well.
.PP
See also drawFrame(), updateMask(), QWidget::setAutoMask() and QPainter::setClipRect().
.SH "void QFrame::frameChanged () \fC[virtual protected]\fR"
Virtual function that is called when the frame style, line width or mid-line width changes.
.PP
This function can be reimplemented by subclasses that need to know when the frame attributes change.
.PP
The default implementation calls update().
.PP
Reimplemented in QWidgetStack, QScrollView, QHBox and QGrid.
.SH "QRect QFrame::frameRect () const"
Returns the frame rectangle.
.PP
The default frame rectangle is equivalent to the widget rectangle.
.PP
See also setFrameRect().
.SH "Shadow QFrame::frameShadow () const"
Returns the frame shadow value from the frame style.
.PP
See also setFrameShadow(), frameStyle() and frameShape().
.SH "Shape QFrame::frameShape () const"
Returns the frame shape value from the frame style.
.PP
See also setFrameShape(), frameStyle() and frameShadow().
.SH "int QFrame::frameStyle () const"
Returns the frame style.
.PP
The default value is QFrame::NoFrame.
.PP
See also setFrameStyle(), frameShape() and frameShadow().
.PP
Examples:
.(l
scrollview/scrollview.cpp
.)l
.SH "int QFrame::frameWidth () const"
Returns the width of the frame that is drawn.
.PP
Note that the frame width depends on the frame style, not only the line width and the mid line width. For example, the style \fCNoFrame\fR always has a frame width 0, while the style \fCPanel\fR has a frame width equivalent to the line width. The frame width also includes the margin.
.PP
See also lineWidth(), midLineWidth(), frameStyle() and margin().
.SH "int QFrame::lineWidth () const"
Returns the line width. (Note that the \fItotal\fR line width for \fCHLine\fR and \fCVLine\fR is given by frameWidth(), not lineWidth().)
.PP
The default value is 1.
.PP
See also setLineWidth(), midLineWidth() and frameWidth().
.PP
Examples:
.(l
scrollview/scrollview.cpp
.)l
.SH "int QFrame::margin () const"
Returns the width of the margin. The margin is the distance between the innermost pixel of the frame and the outermost pixel of contentsRect(). It is included in frameWidth().
.PP
The margin is filled according to backgroundMode().
.PP
The default value is 0.
.PP
See also setMargin(), lineWidth() and frameWidth().
.PP
Examples:
.(l
scrollview/scrollview.cpp
.)l
.SH "int QFrame::midLineWidth () const"
Returns the width of the mid-line.
.PP
The default value is 0.
.PP
See also setMidLineWidth(), lineWidth() and frameWidth().
.PP
Examples:
.(l
scrollview/scrollview.cpp
.)l
.SH "void QFrame::paintEvent ( QPaintEvent * event ) \fC[virtual protected]\fR"
Handles paint events for the frame.
.PP
Paints the frame and the contents.
.PP
Opens the painter on the frame and calls first drawFrame(), then drawContents().
.PP
Reimplemented from QWidget.
.SH "void QFrame::resizeEvent ( QResizeEvent * e ) \fC[virtual protected]\fR"
Handles resize events for the frame.
.PP
Adjusts the frame rectangle for the resized widget. The frame rectangle is elastic, the surrounding area is static.
.PP
The resulting frame rectangle may be null or invalid. You can use setMinimumSize() to avoid that possibility.
.PP
Nothing is done if the frame rectangle is a null rectangle already.
.PP
Reimplemented from QWidget.
.SH "void QFrame::setFrameRect ( const QRect & r ) \fC[virtual]\fR"
Sets the frame rectangle to \fIr.\fR
.PP
The frame rectangle is the rectangle the frame is drawn in. By default, this is the entire widget. Calling setFrameRect() does \fInot\fR cause a widget update.
.PP
If \fIr\fR is a null rectangle (for example \fCQRect(0,0,0,0)\fR), then the frame rectangle is equivalent to the widget rectangle.
.PP
See also frameRect() and contentsRect().
.PP
Reimplemented in QWidgetStack.
.SH "void QFrame::setFrameShadow ( Shadow )"
Sets the frame shadow value of the frame style.
.PP
See also frameShadow(), frameStyle() and setFrameShape().
.SH "void QFrame::setFrameShape ( Shape )"
Sets the frame shape value of the frame style.
.PP
See also frameShape(), frameStyle() and setFrameShadow().
.SH "void QFrame::setFrameStyle ( int style ) \fC[virtual]\fR"
Sets the frame style to \fIstyle.\fR
.PP
The \fIstyle\fR is the bitwise OR between a frame shape and a frame shadow style. See the illustration in the class documentation.
.PP
The frame shapes are:
.TP
\fCNoFrame\fR draws nothing. Naturally, you should not specify a shadow style if you use this.
.TP
\fCBox\fR draws a rectangular box. The contents appear to be level with the surrounding screen, but the border itself may be raised or sunken.
.TP
\fCPanel\fR draws a rectangular panel that can be raised or sunken.
.TP
\fCStyledPanel\fR draws a rectangular panel with a look depending on the current GUI style. It can be raised or sunken.
.TP
\fCPopupPanel\fR is used to draw a frame suitable for popup windows. Its look also depends on the current GUI style, usually the same as \fCStyledPanel.\fR
.TP
\fCWinPanel\fR draws a rectangular panel that can be raised or sunken, very like those in Windows 95. Specifying this shape sets the line width to 2 pixels. WinPanel is provided for compatibility. For GUI style independence we recommend using StyledPanel instead.
.TP
\fCHLine\fR draws a horizontal line (vertically centered).
.TP
\fCVLine\fR draws a vertical line (horizontally centered).
.PP
The shadow styles are:
.TP
\fCPlain\fR draws using the palette foreground color (without any 3D effect).
.TP
\fCRaised\fR draws a 3D raised line using the light and dark colors of the current color group.
.TP
\fCSunken\fR draws a 3D sunken line using the light and dark colors of the current color group.
.PP
If a mid-line width greater than 0 is specified, an additional line is drawn for \fCRaised\fR or \fCSunken Box, HLine\fR and \fCVLine\fR frames. The mid color of the current color group is used for drawing middle lines.
.PP
See also Illustration, frameStyle(), colorGroup() and QColorGroup.
.PP
Examples:
.(l
xform/xform.cpp cursor/cursor.cpp layout/layout.cpp popup/popup.cpp scrollview/scrollview.cpp customlayout/main.cpp
.)l
.SH "void QFrame::setLineWidth ( int w ) \fC[virtual]\fR"
Sets the line width to \fIw.\fR
.PP
See also frameWidth(), lineWidth() and setMidLineWidth().
.PP
Examples:
.(l
xform/xform.cpp scrollview/scrollview.cpp
.)l
.SH "void QFrame::setMargin ( int w ) \fC[virtual]\fR"
Sets the width of the margin to \fIw.\fR
.PP
See also margin() and setLineWidth().
.PP
Examples:
.(l
scrollview/scrollview.cpp
.)l
.SH "void QFrame::setMidLineWidth ( int w ) \fC[virtual]\fR"
Sets the width of the mid-line to \fIw.\fR
.PP
See also midLineWidth() and setLineWidth().
.PP
Examples:
.(l
scrollview/scrollview.cpp
.)l
.SH "QSize QFrame::sizeHint () const \fC[virtual]\fR"
Reimplemented for internal reasons; the API is not affected.
.PP
Reimplemented from QWidget.
.SH "QSizePolicy QFrame::sizePolicy () const \fC[virtual]\fR"
Reimplemented for internal reasons; the API is not affected.
.PP
Reimplemented from QWidget.
.SH "void QFrame::updateMask () \fC[virtual protected]\fR"
Reimplementation of QWidget::updateMask(). Draws the mask of the frame when transparency is required.
.PP
This function calls the virtual functions drawFrameMask() and drawContentsMask(). These are the ones you may want to reimplement in subclasses.
.PP
See also QWidget::setAutoMask(), drawFrameMask() and drawContentsMask().
.PP
Reimplemented from QWidget.
.SH "SEE ALSO"
.BR http://doc.trolltech.com/qframe.html
.SH COPYRIGHT
Copyright 1992-2000 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.