Qt Jambi Home

com.trolltech.qt.core
Class QSizeF

java.lang.Object
  extended by com.trolltech.qt.QSignalEmitter
      extended by com.trolltech.qt.QtJambiObject
          extended by com.trolltech.qt.core.QSizeF
All Implemented Interfaces:
QtJambiInterface

public class QSizeF
extends QtJambiObject

The QSizeF class defines the size of a two-dimensional object using floating point precision.

A size is specified by a width and a height. It can be set in the constructor and changed using the setWidth, setHeight, or scale functions, or using arithmetic operators. A size can also be manipulated directly by retrieving references to the width and height using the rwidth() and rheight() functions. Finally, the width and height can be swapped using the transpose function.

The isValid function determines if a size is valid. A valid size has both width and height greater than or equal to zero. The isEmpty function returns true if either of the width and height is less than (or equal to) zero, while the isNull function returns true only if both the width and the height is zero.

Use the expandedTo function to retrieve a size which holds the maximum height and width of this size and a given size. Similarly, the boundedTo function returns a size which holds the minimum height and width of this size and a given size.

The QSizeF class also provides the toSize function returning a QSize copy of this size, constructed by rounding the width and height to the nearest integers.

QSizeF objects can be streamed as well as compared.

See Also:
QSize, QPointF, QRectF

Nested Class Summary
 
Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter
QSignalEmitter.Signal0, QSignalEmitter.Signal1<A>, QSignalEmitter.Signal2<A,B>, QSignalEmitter.Signal3<A,B,C>, QSignalEmitter.Signal4<A,B,C,D>, QSignalEmitter.Signal5<A,B,C,D,E>, QSignalEmitter.Signal6<A,B,C,D,E,F>, QSignalEmitter.Signal7<A,B,C,D,E,F,G>, QSignalEmitter.Signal8<A,B,C,D,E,F,G,H>, QSignalEmitter.Signal9<A,B,C,D,E,F,G,H,I>
 
Constructor Summary
QSizeF()
          Constructs an invalid size.
QSizeF(double w, double h)
          Constructs a size with the given w and h.
QSizeF(QSize sz)
          Constructs a size with floating point accuracy from the given sz.
 
Method Summary
 QSizeF add(QSizeF s)
          Adds s to this QSizeF and returns the result.
 QSizeF boundedTo(QSizeF arg__1)
          Returns a size holding the minimum width and height of this size and the given arg__1.
 QSizeF divide(double d)
          Divides this QSizeF by the divisor d and returns the result.
 boolean equals(java.lang.Object other)
          
 QSizeF expandedTo(QSizeF arg__1)
          Returns a size holding the maximum width and height of this size and the given arg__1.
static QSizeF fromNativePointer(QNativePointer nativePointer)
          This function returns the QSizeF instance pointed to by nativePointer
 double height()
          Returns the height.
 boolean isEmpty()
          Returns true if either of the width and height is less than or equal to 0; otherwise returns false.
 boolean isNull()
          Returns true if both the width and height is 0; otherwise returns false.
 boolean isValid()
          Returns true if both the width and height is equal to or greater than 0; otherwise returns false.
 QSizeF multiply(double d)
          Multiplies this QSizeF by the factor d and return the result.
static QNativePointer nativePointerArray(QSizeF[] array)
          This function returns a QNativePointer that is pointing to the specified QSizeF array.
 void readFrom(QDataStream arg__1)
          Reads a QSizeF from arg__1.
 void scale(double w, double h, Qt.AspectRatioMode mode)
          Scales the size to a rectangle with the given w and h, according to the specified mode.
 void scale(QSizeF s, Qt.AspectRatioMode mode)
          Scales the size to a rectangle with the given s, according to the specified mode.
 void setHeight(double h)
          Sets the height to the given h.
 void setWidth(double w)
          Sets the width to the given w.
 QSizeF subtract(QSizeF s)
          Subtracts s from this QSizeF and returns the result.
 QSize toSize()
          Returns an integer based copy of this size.
 void transpose()
          Swaps the width and height values.
 double width()
          Returns the width.
 void writeTo(QDataStream arg__1)
          Writes thisQSizeF to arg__1.
 
Methods inherited from class com.trolltech.qt.QtJambiObject
dispose, disposed, finalize, reassignNativeResources, tr, tr, tr
 
Methods inherited from class com.trolltech.qt.QSignalEmitter
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread
 
Methods inherited from class java.lang.Object
clone, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.trolltech.qt.QtJambiInterface
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership
 

Constructor Detail

QSizeF

public QSizeF(QSize sz)

Constructs a size with floating point accuracy from the given sz.

See Also:
toSize

QSizeF

public QSizeF(double w,
              double h)

Constructs a size with the given w and h.


QSizeF

public QSizeF()

Constructs an invalid size.

See Also:
isValid
Method Detail

boundedTo

public final QSizeF boundedTo(QSizeF arg__1)

Returns a size holding the minimum width and height of this size and the given arg__1.

See Also:
expandedTo, scale

expandedTo

public final QSizeF expandedTo(QSizeF arg__1)

Returns a size holding the maximum width and height of this size and the given arg__1.

See Also:
boundedTo, scale

height

public final double height()

Returns the height.

See Also:
width, setHeight

isEmpty

public final boolean isEmpty()

Returns true if either of the width and height is less than or equal to 0; otherwise returns false.

See Also:
isNull, isValid

isNull

public final boolean isNull()

Returns true if both the width and height is 0; otherwise returns false.

See Also:
isValid, isEmpty

isValid

public final boolean isValid()

Returns true if both the width and height is equal to or greater than 0; otherwise returns false.

See Also:
isNull, isEmpty

writeTo

public final void writeTo(QDataStream arg__1)
Writes thisQSizeF to arg__1.


readFrom

public final void readFrom(QDataStream arg__1)
Reads a QSizeF from arg__1.


scale

public final void scale(double w,
                        double h,
                        Qt.AspectRatioMode mode)

Scales the size to a rectangle with the given w and h, according to the specified mode.

Example:

    QSizeF t1(10, 12);
    t1.scale(60, 60, Qt::IgnoreAspectRatio);
    // t1 is (60, 60)

    QSizeF t2(10, 12);
    t2.scale(60, 60, Qt::KeepAspectRatio);
    // t2 is (50, 60)

    QSizeF t3(10, 12);
    t3.scale(60, 60, Qt::KeepAspectRatioByExpanding);
    // t3 is (60, 72)

See Also:
setWidth, setHeight

scale

public final void scale(QSizeF s,
                        Qt.AspectRatioMode mode)

Scales the size to a rectangle with the given s, according to the specified mode.


setHeight

public final void setHeight(double h)

Sets the height to the given h.

See Also:
height, rheight, setWidth

setWidth

public final void setWidth(double w)

Sets the width to the given w.

See Also:
width, rwidth, setHeight

toSize

public final QSize toSize()

Returns an integer based copy of this size.

Note that the coordinates in the returned size will be rounded to the nearest integer.

See Also:
QSizeF

transpose

public final void transpose()

Swaps the width and height values.

See Also:
setWidth, setHeight

width

public final double width()

Returns the width.

See Also:
height, setWidth

fromNativePointer

public static QSizeF fromNativePointer(QNativePointer nativePointer)
This function returns the QSizeF instance pointed to by nativePointer

Parameters:
nativePointer - the QNativePointer of which object should be returned.

nativePointerArray

public static QNativePointer nativePointerArray(QSizeF[] array)
This function returns a QNativePointer that is pointing to the specified QSizeF array.

Parameters:
array - the array that the returned pointer will point to.
Returns:
a QNativePointer that is pointing to the specified array.

equals

public boolean equals(java.lang.Object other)

Overrides:
equals in class java.lang.Object

multiply

public final QSizeF multiply(double d)
Multiplies this QSizeF by the factor d and return the result.


divide

public final QSizeF divide(double d)
Divides this QSizeF by the divisor d and returns the result.


add

public final QSizeF add(QSizeF s)
Adds s to this QSizeF and returns the result.


subtract

public final QSizeF subtract(QSizeF s)
Subtracts s from this QSizeF and returns the result.


Qt Jambi Home