QRectF Class

メンバ関数のドキュメント

[constexpr noexcept] QRectF::QRectF()

ヌル矩形を生成します。

isNull()も参照してください 。

[constexpr noexcept] QRectF::QRectF(const QRect &rectangle)

指定されたQRect rectangle からQRectF矩形を生成します。

toRect() およびQRect::toRectF()も参照してください 。

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QPointF &bottomRight)

指定されたtopLeft およびbottomRight の角を持つ長方形を作成します。

setTopLeft() およびsetBottomRight()も参照してください 。

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QSizeF &size)

指定されたtopLeft の角と、指定されたsize を用いて長方形を構築します。

setTopLeft() およびsetSize()も参照してください 。

[constexpr noexcept] QRectF::QRectF(qreal x, qreal y, qreal width, qreal height)

(x,y)を左上隅とし、指定されたwidth およびheight を持つ長方形を作成します。すべての引数は有限でなければなりません。

setRect()も参照してください 。

[constexpr noexcept] void QRectF::adjust(qreal dx1, qreal dy1, qreal dx2, qreal dy2)

矩形の既存の座標に、それぞれdx1 、dy1 、dx2 、dy2 を加算します。すべてのパラメータは有限でなければなりません。

adjusted() およびsetRect()も参照してください 。

[constexpr noexcept] QRectF QRectF::adjusted(qreal dx1, qreal dy1, qreal dx2, qreal dy2) const

この矩形の既存の座標に、それぞれdx1 、dy1 、dx2 、dy2 を加えた新しい矩形を返します。すべてのパラメータは有限でなければなりません。

adjust()も参照してください 。

[constexpr noexcept] qreal QRectF::bottom() const

矩形の下辺の y 座標を返します。

setBottom()、bottomLeft()、およびbottomRight()も参照してください 。

[constexpr noexcept] QPointF QRectF::bottomLeft() const

矩形の左下隅の位置を返します。

setBottomLeft()、bottom()、およびleft()も参照してください 。

[constexpr noexcept] QPointF QRectF::bottomRight() const

矩形の右下隅の位置を返します。

setBottomRight()、bottom()、およびright()も参照してください 。

[constexpr noexcept] QPointF QRectF::center() const

矩形の中心点を返します。

moveCenter()も参照してください 。

[noexcept] bool QRectF::contains(const QPointF &point) const

指定されたpoint が矩形の内側または境界線上にある場合はtrue を返し、そうでない場合はfalse を返します。

intersects()も参照してください 。

[noexcept] bool QRectF::contains(const QRectF &rectangle) const

指定された `rectangle ` がこの矩形内にある場合は `true ` を返し、そうでない場合は `false` を返します。

[noexcept] bool QRectF::contains(qreal x, qreal y) const

点 (x,y) が矩形の内側または境界線上にある場合は `true ` を返し、そうでない場合は `false` を返します。

[static noexcept] QRectF QRectF::fromCGRect(CGRect rect)

CGRectrect からQRectF を作成します。

toCGRect()も参照してください 。

[static, since 6.5] QRectF QRectF::fromDOMRect(emscripten::val domRect)

DOMRect（https://www.w3.org/TR/geometry-1/）domRect をQRectF に変換します。渡されたパラメータが DOMRect でない場合、動作は未定義となります。

この関数は Qt 6.5 で導入されました。

toDOMRect()も参照してください 。

[constexpr] void QRectF::getCoords(qreal *x1, qreal *y1, qreal *x2, qreal *y2) const

矩形の左上隅の位置を *x1 および *y1 に、右下隅の位置を *x2 および *y2 に取得します。

setCoords() およびgetRect()も参照してください 。

[constexpr] void QRectF::getRect(qreal *x, qreal *y, qreal *width, qreal *height) const

矩形の左上隅の位置を *x および *y に、その寸法を *width および *height に抽出します。

setRect() およびgetCoords()も参照してください 。

[constexpr noexcept] qreal QRectF::height() const

矩形の高さを返します。

setHeight()、width()、およびsize()も参照してください 。

[noexcept] QRectF QRectF::intersected(const QRectF &rectangle) const

この矩形と、指定されたrectangle との共通部分を返します。なお、r.intersected(s) はr & s と同等であることに注意してください。

intersects()、united()、およびoperator&=()も参照してください 。

[noexcept] bool QRectF::intersects(const QRectF &rectangle) const

この矩形が指定されたrectangle と交差する場合（つまり、両者の間に空ではない重なり部分がある場合）、true を返し、そうでない場合はfalse を返します。

交差する矩形は、intersected() 関数を使用して取得できます。

contains()も参照してください 。

[constexpr noexcept] bool QRectF::isEmpty() const

矩形が空の場合は `true ` を返し、それ以外の場合は `false` を返します。

空の矩形は、width() <= 0 またはheight() <= 0 です。空の矩形は無効です（つまり、isEmpty() == !isValid() です）。

normalized() 関数を使用すると、角が入れ替わった矩形を取得できます。

isNull()、isValid()、およびnormalized()も参照してください 。

[constexpr noexcept] bool QRectF::isNull() const

矩形がヌル矩形の場合はtrue を返し、それ以外の場合はfalse を返します。

ヌル矩形とは、幅と高さの両方が 0 に設定されている矩形のことです。ヌル矩形は空であるため、無効です。

isEmpty() およびisValid()も参照してください 。

[constexpr noexcept] bool QRectF::isValid() const

矩形が有効な場合は `true ` を返し、そうでない場合は `false` を返します。

有効な矩形は、width() > 0 かつheight() > 0 です。なお、交差などの非自明な演算は、無効な矩形に対しては定義されていません。有効な矩形は空ではありません（すなわち、isValid() == !isEmpty() です）。

isNull()、isEmpty()、およびnormalized()も参照してください 。

[constexpr noexcept] qreal QRectF::left() const

矩形の左端の x 座標を返します。x() と同等です。

setLeft()、topLeft()、およびbottomLeft()も参照してください 。

[constexpr noexcept] QRectF QRectF::marginsAdded(const QMarginsF &margins) const

margins によって拡大された矩形を返します。

operator+=()、marginsRemoved()、およびoperator-=()も参照してください 。

[constexpr noexcept] QRectF QRectF::marginsRemoved(const QMarginsF &margins) const

矩形から「margins 」を削除し、そのサイズを縮小します。

marginsAdded()、operator+=()、およびoperator-=()も参照してください 。

[constexpr noexcept] void QRectF::moveBottom(qreal y)

矩形を垂直方向に移動させ、矩形の下端を指定された有限のy 座標に固定します。矩形のサイズは変更されません。

bottom()、setBottom()、およびmoveTop()も参照してください 。

[constexpr noexcept] void QRectF::moveBottomLeft(const QPointF &position)

指定されたposition を左下隅として、矩形を移動します。矩形のサイズは変更されません。

setBottomLeft()、moveBottom()、およびmoveLeft()も参照してください 。

[constexpr noexcept] void QRectF::moveBottomRight(const QPointF &position)

指定されたposition を右下隅として、矩形を移動します。矩形のサイズは変更されません。

setBottomRight()、moveBottom()、およびmoveRight()も参照してください 。

[constexpr noexcept] void QRectF::moveCenter(const QPointF &position)

指定されたposition の位置を中央点として、長方形を移動します。長方形のサイズは変更されません。

center()も参照してください 。

[constexpr noexcept] void QRectF::moveLeft(qreal x)

矩形を水平方向に移動させ、矩形の左端を指定された有限のx 座標に固定します。矩形のサイズは変更されません。

left()、setLeft()、およびmoveRight()も参照してください 。

[constexpr noexcept] void QRectF::moveRight(qreal x)

矩形を水平方向に移動させ、矩形の右端を指定された有限のx 座標に合わせます。矩形のサイズは変更されません。

right()、setRight()、およびmoveLeft()も参照してください 。

[constexpr noexcept] void QRectF::moveTo(qreal x, qreal y)

左上隅を指定された位置に固定したまま、矩形を移動します（x 、y ）。矩形のサイズは変更されません。両方のパラメータは有限でなければなりません。

translate() およびmoveTopLeft()も参照してください 。

[constexpr noexcept] void QRectF::moveTo(const QPointF &position)

指定されたposition を左上隅として、矩形を移動します。

[constexpr noexcept] void QRectF::moveTop(qreal y)

矩形を垂直方向に移動させ、矩形の上辺を指定された有限のy 座標に固定します。矩形のサイズは変更されません。

top()、setTop()、およびmoveBottom()も参照してください 。

[constexpr noexcept] void QRectF::moveTopLeft(const QPointF &position)

指定されたposition を左上隅として、矩形を移動します。矩形のサイズは変更されません。

setTopLeft()、moveTop()、およびmoveLeft()も参照してください 。

[constexpr noexcept] void QRectF::moveTopRight(const QPointF &position)

指定された座標position を右上隅として、矩形を移動します。矩形のサイズは変更されません。

setTopRight()、moveTop()、およびmoveRight()も参照してください 。

[noexcept] QRectF QRectF::normalized() const

正規化された矩形、すなわち、幅と高さが非負の矩形を返します。

width() < 0 の場合、この関数は左隅と右隅を入れ替え、height() < 0 の場合、上隅と下隅を入れ替えます。

isValid() およびisEmpty()も参照してください 。

[constexpr noexcept] qreal QRectF::right() const

矩形の右端のx座標を返します。

setRight()、topRight()、およびbottomRight()も参照してください 。

[constexpr noexcept] void QRectF::setBottom(qreal y)

矩形の下辺を、指定された有限のy 座標に設定します。高さが変わる場合がありますが、矩形の上辺が変わることはありません。

bottom() およびmoveBottom()も参照してください 。

[constexpr noexcept] void QRectF::setBottomLeft(const QPointF &position)

長方形の左下隅を、指定されたposition に設定します。サイズは変更される場合がありますが、長方形の右上隅は決して変更されません。

bottomLeft() およびmoveBottomLeft()も参照してください 。

[constexpr noexcept] void QRectF::setBottomRight(const QPointF &position)

長方形の右下隅を、指定されたposition に設定します。サイズは変更される場合がありますが、長方形の左上隅は決して変更されません。

bottomRight() およびmoveBottomRight()も参照してください 。

[constexpr noexcept] void QRectF::setCoords(qreal x1, qreal y1, qreal x2, qreal y2)

矩形の左上隅の座標を (x1,y1) に、右下隅の座標を (x2,y2) に設定します。すべてのパラメータは有限値でなければなりません。

getCoords() およびsetRect()も参照してください 。

[constexpr noexcept] void QRectF::setHeight(qreal height)

矩形の高さを、指定された有限の値height に設定します。下辺は変更されますが、上辺は変更されません。

height() およびsetSize()も参照してください 。

[constexpr noexcept] void QRectF::setLeft(qreal x)

矩形の左端を、指定された有限のx 座標に設定します。幅が変わる場合がありますが、矩形の右端が変わることはありません。

setX() と同等です。

left() およびmoveLeft()も参照してください 。

[constexpr noexcept] void QRectF::setRect(qreal x, qreal y, qreal width, qreal height)

矩形の左上隅の座標を (x,y) に設定し、そのサイズを指定されたwidth およびheight に設定します。すべてのパラメータは有限でなければなりません。

getRect() およびsetCoords()も参照してください 。

[constexpr noexcept] void QRectF::setRight(qreal x)

矩形の右端を、指定された有限のx 座標に設定します。幅が変わる場合がありますが、矩形の左端が変わることはありません。

right() およびmoveRight()も参照してください 。

[constexpr noexcept] void QRectF::setSize(const QSizeF &size)

矩形のサイズを、指定された有限のsize に設定します。左上隅の位置は変更されません。

size()、setWidth()、およびsetHeight()も参照してください 。

[constexpr noexcept] void QRectF::setTop(qreal y)

矩形の上辺を、指定された有限のy 座標に設定します。高さが変わる場合がありますが、矩形の下辺が変わることはありません。

setY() と同等です。

top() およびmoveTop()も参照してください 。

[constexpr noexcept] void QRectF::setTopLeft(const QPointF &position)

矩形の左上隅を、指定されたposition に設定します。サイズは変更される場合がありますが、矩形の右下隅は決して変更されません。

topLeft() およびmoveTopLeft()も参照してください 。

[constexpr noexcept] void QRectF::setTopRight(const QPointF &position)

長方形の右上隅を、指定されたposition に設定します。サイズは変更される場合がありますが、長方形の左下隅は決して変更されません。

topRight() およびmoveTopRight()も参照してください 。

[constexpr noexcept] void QRectF::setWidth(qreal width)

矩形の幅を、指定された有限のwidth に設定します。右端は変更されますが、左端は変更されません。

width() およびsetSize()も参照してください 。

[constexpr noexcept] void QRectF::setX(qreal x)

矩形の左端を、指定された有限のx 座標に設定します。幅が変わる場合がありますが、矩形の右端は決して変わりません。

setLeft() と同等です。

x()、setY()、およびsetTopLeft()も参照してください 。

[constexpr noexcept] void QRectF::setY(qreal y)

矩形の上辺を、指定された有限のy 座標に設定します。高さが変わる場合がありますが、矩形の下辺は決して変わりません。

setTop() と同等です。

y()、setX()、およびsetTopLeft()も参照してください 。

[constexpr noexcept] QSizeF QRectF::size() const

矩形のサイズを返します。

setSize()、width()、およびheight()も参照してください 。

[noexcept] QRect QRectF::toAlignedRect() const

この矩形の値に基づいて、この矩形を完全に包含する最小の整数矩形であるQRect を返します。

toRect()も参照してください 。

[noexcept] CGRect QRectF::toCGRect() const

QRectF から CGRect を作成します。

fromCGRect()も参照してください 。

[since 6.5] emscripten::val QRectF::toDOMRect() const

このオブジェクトを DOMRect（https://www.w3.org/TR/geometry-1/）に変換します。

この関数は Qt 6.5 で導入されました。

fromDOMRect()も参照してください 。

[constexpr noexcept] QRect QRectF::toRect() const

この矩形の値に基づいて、QRect を返します。なお、返される矩形の座標は、最も近い整数に丸められます。

QRectF()、toAlignedRect()、およびQRect::toRectF()も参照してください 。

[constexpr noexcept] qreal QRectF::top() const

矩形の上辺の y 座標を返します。y() と同等です。

setTop()、topLeft()、およびtopRight()も参照してください 。

[constexpr noexcept] QPointF QRectF::topLeft() const

矩形の左上隅の位置を返します。

setTopLeft()、top()、およびleft()も参照してください 。

[constexpr noexcept] QPointF QRectF::topRight() const

矩形の右上隅の位置を返します。

setTopRight()、top()、およびright()も参照してください 。

[constexpr noexcept] void QRectF::translate(qreal dx, qreal dy)

現在の位置を基準として、矩形をx軸方向にdx 、y軸方向にdy だけ移動させます。正の値は、矩形を右方向および下方向に移動させます。両方のパラメータは有限値でなければなりません。

moveTopLeft()、moveTo()、およびtranslated()も参照してください 。

[constexpr noexcept] void QRectF::translate(const QPointF &offset)

矩形を、offset 。x() を x 軸方向に、offset 。y() を y 軸方向に、現在の位置を基準として移動させます。

[constexpr noexcept] QRectF QRectF::translated(qreal dx, qreal dy) const

現在の位置を基準として、x 軸方向にdx 、y 軸方向にdy だけ平行移動させた矩形のコピーを返します。正の値は、矩形を右方向および下方向に移動させます。両方のパラメータは有限でなければなりません。

translate()も参照してください 。

[constexpr noexcept] QRectF QRectF::translated(const QPointF &offset) const

現在の位置を基準として、x 軸方向にはoffset.x()、y 軸方向にはoffset.y() の量だけ平行移動させた矩形のコピーを返します。

[constexpr noexcept] QRectF QRectF::transposed() const

幅と高さが入れ替わった矩形のコピーを返します：

QRectF r = {1.5, 5.1, 4.2, 2.4};
r = r.transposed(); // r == {1.5, 5.1, 2.4, 4.2}

QSizeF::transposed()も参照してください 。

[noexcept] QRectF QRectF::united(const QRectF &rectangle) const

この矩形と、指定されたrectangle の境界矩形を返します。

intersected()も参照してください 。

[constexpr noexcept] qreal QRectF::width() const

矩形の幅を返します。

setWidth()、height()、およびsize()も参照してください 。

[constexpr noexcept] qreal QRectF::x() const

矩形の左端のx座標を返します。left() と同等です。

setX()、y()、およびtopLeft()も参照してください 。

[constexpr noexcept] qreal QRectF::y() const

矩形の上辺の y 座標を返します。top() と同等です。

setY()、x()、およびtopLeft()も参照してください 。

[noexcept] QRectF QRectF::operator&(const QRectF &rectangle) const

この矩形と指定されたrectangle との共通部分を返します。共通部分がない場合は、空の矩形を返します。

operator&=() およびintersected()も参照してください 。

[noexcept] QRectF &QRectF::operator&=(const QRectF &rectangle)

この長方形と、指定されたrectangle との交点を求めます。

intersected() およびoperator&()も参照してください 。

[constexpr noexcept] QRectF &QRectF::operator+=(const QMarginsF &margins)

margins を矩形に追加し、矩形を拡大します。

marginsAdded()、marginsRemoved()、およびoperator-=()も参照してください 。

[constexpr noexcept] QRectF &QRectF::operator-=(const QMarginsF &margins)

margins によって縮小された矩形を返します。

marginsRemoved()、operator+=()、およびmarginsAdded()も参照してください 。

[noexcept] QRectF QRectF::operator|(const QRectF &rectangle) const

この矩形と指定されたrectangle の境界矩形を返します。

united() およびoperator|=()も参照してください 。

[noexcept] QRectF &QRectF::operator|=(const QRectF &rectangle)

この長方形を、指定されたrectangle と結合します。

united() およびoperator|()も参照してください 。