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/qsize.html | 378 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 378 insertions(+) create mode 100644 doc/html/qsize.html (limited to 'doc/html/qsize.html') diff --git a/doc/html/qsize.html b/doc/html/qsize.html new file mode 100644 index 000000000..9727d7781 --- /dev/null +++ b/doc/html/qsize.html @@ -0,0 +1,378 @@ + + + + + +TQSize Class + + + + + + + +

TQSize Class Reference

+ +

The TQSize class defines the size of a two-dimensional object. +More... +

#include <qsize.h> +

List of all member functions. +

Public Members

enum ScaleMode { ScaleFree, ScaleMin, ScaleMax }
TQSize ()
TQSize ( int w, int h )
bool isNull () const
bool isEmpty () const
bool isValid () const
int width () const
int height () const
void setWidth ( int w )
void setHeight ( int h )
void transpose ()
void scale ( int w, int h, ScaleMode mode )
void scale ( const TQSize & s, ScaleMode mode )
TQSize expandedTo ( const TQSize & otherSize ) const
TQSize boundedTo ( const TQSize & otherSize ) const
TQCOORD & rwidth ()
TQCOORD & rheight ()
TQSize & operator+= ( const TQSize & s )
TQSize & operator-= ( const TQSize & s )
TQSize & operator*= ( int c )
TQSize & operator*= ( double c )
TQSize & operator/= ( int c )
TQSize & operator/= ( double c )

Related Functions

bool operator== ( const TQSize & s1, const TQSize & s2 )
bool operator!= ( const TQSize & s1, const TQSize & s2 )
const TQSize operator+ ( const TQSize & s1, const TQSize & s2 )
const TQSize operator- ( const TQSize & s1, const TQSize & s2 )
const TQSize operator* ( const TQSize & s, int c )
const TQSize operator* ( int c, const TQSize & s )
const TQSize operator* ( const TQSize & s, double c )
const TQSize operator* ( double c, const TQSize & s )
const TQSize operator/ ( const TQSize & s, int c )
const TQSize operator/ ( const TQSize & s, double c )
TQDataStream & operator<< ( TQDataStream & s, const TQSize & sz )
TQDataStream & operator>> ( TQDataStream & s, TQSize & sz )

Detailed Description

+ + +The TQSize class defines the size of a two-dimensional object. +

+ +

A size is specified by a width and a height. +

The coordinate type is TQCOORD (defined in <qwindowdefs.h> as int). +The minimum value of TQCOORD is TQCOORD_MIN (-2147483648) and the maximum +value is TQCOORD_MAX (2147483647). +

The size can be set in the constructor and changed with setWidth() +and setHeight(), or using operator+=(), operator-=(), operator*=() +and operator/=(), etc. You can swap the width and height with +transpose(). You can get a size which holds the maximum height and +width of two sizes using expandedTo(), and the minimum height and +width of two sizes using boundedTo(). +

See also TQPoint, TQRect, Graphics Classes, and Image Processing Classes. + +

Member Type Documentation

TQSize::ScaleMode

This enum type defines the different ways of scaling a size. +

TQSize::ScaleFree - The size is scaled freely. The ratio is not preserved. +
TQSize::ScaleMin - The size is scaled to a rectangle as large as possible +inside a given rectangle, preserving the aspect ratio. +
TQSize::ScaleMax - The size is scaled to a rectangle as small as possible +outside a given rectangle, preserving the aspect ratio. +

See also TQSize::scale(), TQImage::scale(), and TQImage::smoothScale(). + +

Member Function Documentation

TQSize::TQSize () +

+ +Constructs a size with invalid (negative) width and height. + +

TQSize::TQSize ( int w, int h ) +

+ +Constructs a size with width w and height h. + +

TQSize TQSize::boundedTo ( const TQSize & otherSize ) const +

+ +

Returns a size with the minimum width and height of this size and +otherSize. + +

TQSize TQSize::expandedTo ( const TQSize & otherSize ) const +

+ +

Returns a size with the maximum width and height of this size and +otherSize. + +

Examples: customlayout/card.cpp and customlayout/flow.cpp. +

int TQSize::height () const +

+ +Returns the height. +

bool TQSize::isEmpty () const +

+ +Returns TRUE if the width is less than or equal to 0, or the height is +less than or equal to 0; otherwise returns FALSE. + +

bool TQSize::isNull () const +

+ +Returns TRUE if the width is 0 and the height is 0; otherwise +returns FALSE. + +

bool TQSize::isValid () const +

+ +Returns TRUE if the width is equal to or greater than 0 and the height is +equal to or greater than 0; otherwise returns FALSE. + +

TQSize & TQSize::operator*= ( int c ) +

+ +Multiplies both the width and height by c and returns a reference to +the size. + +

TQSize & TQSize::operator*= ( double c ) +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Multiplies both the width and height by c and returns a reference to +the size. +

Note that the result is truncated. + +

TQSize & TQSize::operator+= ( const TQSize & s ) +

+ +

Adds s to the size and returns a reference to this size. +

Example: +

+    TQSize s(  3, 7 );
+    TQSize r( -1, 4 );
+    s += r;                     // s becomes (2,11)
+

+ + +

TQSize & TQSize::operator-= ( const TQSize & s ) +

+ +

Subtracts s from the size and returns a reference to this size. +

Example: +

+    TQSize s(  3, 7 );
+    TQSize r( -1, 4 );
+    s -= r;                     // s becomes (4,3)
+

+ + +

TQSize & TQSize::operator/= ( int c ) +

+ +Divides both the width and height by c and returns a reference to the +size. + +

TQSize & TQSize::operator/= ( double c ) +

+ +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Divides both the width and height by c and returns a reference to the +size. +

Note that the result is truncated. + +

TQCOORD & TQSize::rheight () +

+ +Returns a reference to the height. +

Using a reference makes it possible to directly manipulate the height. +

Example: +

+    TQSize s( 100, 10 );
+    s.rheight() += 5;           // s becomes (100,15)
+

+ +

TQCOORD & TQSize::rwidth () +

+ +Returns a reference to the width. +

Using a reference makes it possible to directly manipulate the width. +

Example: +

+    TQSize s( 100, 10 );
+    s.rwidth() += 20;           // s becomes (120,10)
+

+ +

void TQSize::scale ( int w, int h, ScaleMode mode ) +

+Scales the size to a rectangle of width w and height h according +to the ScaleMode mode. +

If mode is ScaleFree, the size is set to (w, h). +
If mode is ScaleMin, the current size is scaled to a rectangle +as large as possible inside (w, h), preserving the aspect ratio. +
If mode is ScaleMax, the current size is scaled to a rectangle +as small as possible outside (w, h), preserving the aspect ratio. +

Example: +

+    TQSize t1( 10, 12 );
+    t1.scale( 60, 60, TQSize::ScaleFree );
+    // t1 is (60, 60)
+
+    TQSize t2( 10, 12 );
+    t2.scale( 60, 60, TQSize::ScaleMin );
+    // t2 is (50, 60)
+
+    TQSize t3( 10, 12 );
+    t3.scale( 60, 60, TQSize::ScaleMax );
+    // t3 is (60, 72)
+

+ + +

void TQSize::scale ( const TQSize & s, ScaleMode mode ) +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Equivalent to scale(s.width(), s.height(), mode). + +

void TQSize::setHeight ( int h ) +

+ +Sets the height to h. +

void TQSize::setWidth ( int w ) +

+ +Sets the width to w. +

void TQSize::transpose () +

+Swaps the values of width and height. + +

int TQSize::width () const +

+ +Returns the width. +

Related Functions

bool operator!= ( const TQSize & s1, const TQSize & s2 ) +

+ + +Returns TRUE if s1 and s2 are different; otherwise returns FALSE. + +

const TQSize operator* ( const TQSize & s, int c ) +

+ + +Multiplies s by c and returns the result. + +

const TQSize operator* ( int c, const TQSize & s ) +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

+Multiplies s by c and returns the result. + +

const TQSize operator* ( const TQSize & s, double c ) +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

+Multiplies s by c and returns the result. + +

const TQSize operator* ( double c, const TQSize & s ) +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

+Multiplies s by c and returns the result. + +

const TQSize operator+ ( const TQSize & s1, const TQSize & s2 ) +

+ + +Returns the sum of s1 and s2; each component is added separately. + +

const TQSize operator- ( const TQSize & s1, const TQSize & s2 ) +

+ + +Returns s2 subtracted from s1; each component is +subtracted separately. + +

const TQSize operator/ ( const TQSize & s, int c ) +

+ + +Divides s by c and returns the result. + +

const TQSize operator/ ( const TQSize & s, double c ) +

+ + +This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Divides s by c and returns the result. +

Note that the result is truncated. + +

TQDataStream & operator<< ( TQDataStream & s, const TQSize & sz ) +

+ +Writes the size sz to the stream s and returns a reference to +the stream. +

bool operator== ( const TQSize & s1, const TQSize & s2 ) +

+ + +Returns TRUE if s1 and s2 are equal; otherwise returns FALSE. + +

TQDataStream & operator>> ( TQDataStream & s, TQSize & sz ) +

+ +Reads the size from the stream s into size sz and returns a +reference to the stream. +

See also Format of the TQDataStream operators. + + +

+ +

Trademarks +

TQt 3.3.8

+ -- cgit v1.2.1