From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/qframe.html | 370 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 370 insertions(+) create mode 100644 doc/html/qframe.html (limited to 'doc/html/qframe.html') diff --git a/doc/html/qframe.html b/doc/html/qframe.html new file mode 100644 index 000000000..524843b64 --- /dev/null +++ b/doc/html/qframe.html @@ -0,0 +1,370 @@ + + + + + +TQFrame Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

TQFrame Class Reference

+ +

The TQFrame class is the base class of widgets that can have a frame. +More... +

#include <qframe.h> +

Inherits TQWidget. +

Inherited by TQGroupBox, TQScrollView, TQDockWindow, TQGrid, TQHBox, TQLabel, TQLCDNumber, TQLineEdit, TQMenuBar, TQPopupMenu, TQProgressBar, TQSplitter, TQToolBox, and TQWidgetStack. +

List of all member functions. +

Public Members

+ +

Properties

+ +

Protected Members

+ +

Detailed Description

+ + +The TQFrame class is the base class of widgets that can have a frame. +

+

It draws a frame and calls a virtual function, drawContents(), to +fill in the frame. This function is reimplemented by subclasses. +There are also two other less useful functions: drawFrame() and +frameChanged(). +

TQPopupMenu uses this to "raise" the menu above the surrounding +screen. TQProgressBar has a "sunken" look. TQLabel has a flat look. +The frames of widgets like these can be changed. +

+    TQLabel label(...);
+    label.setFrameStyle( TQFrame::Panel | TQFrame::Raised );
+    label.setLineWidth( 2 );
+
+    TQProgressBar pbar(...);
+    label.setFrameStyle( TQFrame::NoFrame );
+
+ +

The TQFrame class can also be used directly for creating simple +frames without any contents, although usually you would use a +TQHBox or TQVBox because they automatically lay out the widgets you +put inside the frame. +

A frame widget has four attributes: frameStyle(), lineWidth(), +midLineWidth(), and margin(). +

The frame style is specified by a frame + shape and a shadow style. The +frame shapes are NoFrame, Box, Panel, StyledPanel, PopupPanel, WinPanel, ToolBarPanel, MenuBarPanel, HLine and VLine; the shadow styles are Plain, Raised and +Sunken. +

The line width is the width of the frame border. +

The mid-line width specifies the width of an extra line in the +middle of the frame, which uses a third color to obtain a special +3D effect. Notice that a mid-line is only drawn for Box, HLine and VLine frames that are raised or sunken. +

The margin is the gap between the frame and the contents of the +frame. +

+This table shows the most useful combinations of styles and widths +(and some rather useless ones): +

Table of frame styles

See also Abstract Widget Classes. + +

Member Type Documentation

+

TQFrame::Shadow

+ +

This enum type defines the 3D effect used for TQFrame's frame. +

Shadow interacts with TQFrame::Shape, the lineWidth() and the +midLineWidth(). See the picture of the frames +in the class description. +

See also TQFrame::Shape, lineWidth, and midLineWidth. + +

TQFrame::Shape

+ +

This enum type defines the shapes of a TQFrame's frame. +

When it does not call TQStyle, Shape interacts with TQFrame::Shadow, +the lineWidth() and the midLineWidth() to create the total result. +See the picture of the frames in the class +description. +

See also TQFrame::Shadow, TQFrame::style(), and TQStyle::drawPrimitive(). + +

Member Function Documentation

+

TQFrame::TQFrame ( TQWidget * parent = 0, const char * name = 0, WFlags f = 0 ) +

+Constructs a frame widget with frame style NoFrame and a +1-pixel frame width. +

The parent, name and f arguments are passed to the +TQWidget constructor. + +

TQRect TQFrame::contentsRect () const +

Returns the rectangle inside the frame. +See the "contentsRect" property for details. +

void TQFrame::drawContents ( TQPainter * ) [virtual protected] +

+Virtual function that draws the contents of the frame. +

The TQPainter is already open when you get it, and you must leave +it open. Painter transformations are switched off on entry. If you +transform the painter, remember to take the frame into account and +reset transformation before +returning. +

This function is reimplemented by subclasses that draw something +inside the frame. It should only draw inside contentsRect(). The +default function does nothing. +

See also contentsRect and TQPainter::setClipRect(). + +

Reimplemented in TQLabel, TQLCDNumber, TQMenuBar, and TQPopupMenu. +

void TQFrame::drawFrame ( TQPainter * p ) [virtual protected] +

+Draws the frame using the painter p and the current frame +attributes and color group. The rectangle inside the frame is not +affected. +

This function is virtual, but in general you do not need to +reimplement it. If you do, note that the TQPainter is already open +and must remain open. +

See also frameRect, contentsRect, drawContents(), frameStyle(), and palette. + +

void TQFrame::frameChanged () [virtual protected] +

+Virtual function that is called when the frame style, line width +or mid-line width changes. +

This function can be reimplemented by subclasses that need to know +when the frame attributes change. +

The default implementation calls update(). + +

TQRect TQFrame::frameRect () const +

Returns the frame rectangle. +See the "frameRect" property for details. +

Shadow TQFrame::frameShadow () const +

Returns the frame shadow value from the frame style. +See the "frameShadow" property for details. +

Shape TQFrame::frameShape () const +

Returns the frame shape value from the frame style. +See the "frameShape" property for details. +

int TQFrame::frameStyle () const +

+ +

Returns the frame style. +

The default value is TQFrame::NoFrame. +

See also setFrameStyle(), frameShape, and frameShadow. + +

Example: scrollview/scrollview.cpp. +

int TQFrame::frameWidth () const +

Returns the width of the frame that is drawn. +See the "frameWidth" property for details. +

int TQFrame::lineWidth () const +

Returns the line width. +See the "lineWidth" property for details. +

int TQFrame::margin () const +

Returns the width of the margin. +See the "margin" property for details. +

int TQFrame::midLineWidth () const +

Returns the width of the mid-line. +See the "midLineWidth" property for details. +

void TQFrame::paintEvent ( TQPaintEvent * event ) [virtual protected] +

+Processes the paint event event. +

Paints the frame and the contents. +

Opens the painter on the frame and calls drawFrame(), then +drawContents(). + +

Examples: life/life.cpp and qfd/fontdisplayer.cpp. +

Reimplemented from TQWidget. +

void TQFrame::resizeEvent ( TQResizeEvent * e ) [virtual protected] +

+Processes the resize event e. +

Adjusts the frame rectangle for the resized widget. The frame +rectangle is elastic, and the surrounding area is static. +

The resulting frame rectangle may be null or invalid. You can use +setMinimumSize() to avoid those possibilities. +

Nothing is done if the frame rectangle is a null rectangle already. + +

Example: life/life.cpp. +

Reimplemented from TQWidget. +

void TQFrame::setFrameRect ( const TQRect & ) [virtual] +

Sets the frame rectangle. +See the "frameRect" property for details. +

void TQFrame::setFrameShadow ( Shadow ) +

Sets the frame shadow value from the frame style. +See the "frameShadow" property for details. +

void TQFrame::setFrameShape ( Shape ) +

Sets the frame shape value from the frame style. +See the "frameShape" property for details. +

void TQFrame::setFrameStyle ( int style ) [virtual] +

+Sets the frame style to style. +

The style is the bitwise OR between a frame shape and a frame +shadow style. See the illustration in the +class documentation. +

The frame shapes are given in TQFrame::Shape and the shadow +styles in TQFrame::Shadow. +

If a mid-line width greater than 0 is specified, an additional +line is drawn for Raised or Sunken Box, HLine, and VLine frames. The mid-color of the current color group is used for +drawing middle lines. +

See also Illustration, frameStyle(), colorGroup, and TQColorGroup. + +

Examples: cursor/cursor.cpp, layout/layout.cpp, listboxcombo/listboxcombo.cpp, rangecontrols/rangecontrols.cpp, scrollview/scrollview.cpp, tabdialog/tabdialog.cpp, and tictac/tictac.cpp. +

void TQFrame::setLineWidth ( int ) [virtual] +

Sets the line width. +See the "lineWidth" property for details. +

void TQFrame::setMargin ( int ) [virtual] +

Sets the width of the margin. +See the "margin" property for details. +

void TQFrame::setMidLineWidth ( int ) [virtual] +

Sets the width of the mid-line. +See the "midLineWidth" property for details. +

Property Documentation

+

TQRect contentsRect

+

This property holds the rectangle inside the frame. +

Get this property's value with contentsRect(). +

See also frameRect and drawContents(). + +

TQRect frameRect

+

This property holds the frame rectangle. +

The frame rectangle is the rectangle the frame is drawn in. By +default, this is the entire widget. Setting this property does not cause a widget update. +

If this property is set to a null rectangle (for example +TQRect(0, 0, 0, 0)), then the frame rectangle is equivalent to +the widget rectangle. +

See also contentsRect. + +

Set this property's value with setFrameRect() and get this property's value with frameRect(). +

Shadow frameShadow

+

This property holds the frame shadow value from the frame style. +

Set this property's value with setFrameShadow() and get this property's value with frameShadow(). +

See also frameStyle() and frameShape. + +

Shape frameShape

+

This property holds the frame shape value from the frame style. +

Set this property's value with setFrameShape() and get this property's value with frameShape(). +

See also frameStyle() and frameShadow. + +

int frameWidth

+

This property holds the width of the frame that is drawn. +

Note that the frame width depends on the frame style, not only the line +width and the mid-line width. For example, the style NoFrame +always has a frame width of 0, whereas the style Panel has a +frame width equivalent to the line width. The frame width also +includes the margin. +

See also lineWidth, midLineWidth, frameStyle(), and margin. + +

Get this property's value with frameWidth(). +

int lineWidth

+

This property holds the line width. +

Note that the total line width for HLine and VLine is +given by frameWidth(), not lineWidth(). +

The default value is 1. +

See also midLineWidth and frameWidth. + +

Set this property's value with setLineWidth() and get this property's value with lineWidth(). +

int margin

+

This property holds 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(). +

The margin is filled according to backgroundMode(). +

The default value is 0. +

See also margin, lineWidth, and frameWidth. + +

Set this property's value with setMargin() and get this property's value with margin(). +

int midLineWidth

+

This property holds the width of the mid-line. +

The default value is 0. +

See also lineWidth and frameWidth. + +

Set this property's value with setMidLineWidth() and get this property's value with midLineWidth(). + +

+This file is part of the TQt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
TQt 3.3.8
+
+ -- cgit v1.2.1