QRect Class

メンバ関数ドキュメント

[constexpr noexcept] QRect::QRect()

ヌル矩形を構築します。

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

[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QPoint &bottomRight)

与えられたtopLeft とbottomRight の両方の角を含む矩形を構築します。

bottomRight がtopLeft よりも高くて左側にある場合，定義される長方形はコーナーを含まない代わりになります。

setTopLeft(),setBottomRight(),span()も参照 。

[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QSize &size)

指定されたtopLeft 隅と指定されたsize を持つ矩形を作成します。

setTopLeft() およびsetSize()も参照 。

[constexpr noexcept] QRect::QRect(int x, int y, int width, int height)

(x,y) を左上隅とし、与えられたwidth とheight を持つ矩形を構築します。

setRect()も参照 。

[constexpr noexcept] void QRect::adjust(int dx1, int dy1, int dx2, int dy2)

dx1,dy1,dx2 およびdy2 を、矩形の既存の座標にそれぞれ追加します。

adjusted() およびsetRect()も参照 。

[constexpr noexcept] QRect QRect::adjusted(int dx1, int dy1, int dx2, int dy2) const

この矩形の既存の座標に、dx1,dy1,dx2 およびdy2 をそれぞれ追加した新しい矩形を返します。

adjust()も参照 。

[constexpr noexcept] int QRect::bottom() const

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

歴史的な理由により、この関数はtop() +height() - 1 を返すことに注意。真の y 座標を取得するにはy() +height() を使用する。

setBottom(),bottomLeft(),bottomRight()も参照 。

[constexpr noexcept] QPoint QRect::bottomLeft() const

矩形の左下隅の位置を返します。歴史的な理由により、この関数はQPoint(left(),top() +height() - 1) を返すことに注意。

setBottomLeft(),bottom(),left()も参照 。

[constexpr noexcept] QPoint QRect::bottomRight() const

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

歴史的な理由により、この関数はQPoint(left() +width() -1,top() +height() - 1) を返すことに注意。

setBottomRight(),bottom(),right()も参照 。

[constexpr noexcept] QPoint QRect::center() const

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

moveCenter()も参照 。

[noexcept] bool QRect::contains(const QPoint &point, bool proper = false) const

与えられたpoint が矩形の内側または端にある場合はtrue を返し、そうでない場合はfalse を返します。proper が真の場合、この関数は、与えられたpoint が矩形の内側にある（つまり、端にない）場合にのみtrue を返します。

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

[noexcept] bool QRect::contains(const QRect &rectangle, bool proper = false) const

これはオーバーロードされた関数です。

与えられたrectangle がこの矩形の内側にある場合はtrue を返します。そうでない場合はfalse を返します。proper が真の場合、この関数はrectangle が完全にこの矩形の内側にある（端にない）場合にのみtrue を返します。

[noexcept] bool QRect::contains(int x, int y) const

これはオーバーロードされた関数です。

点（x,y ）がこの矩形の内側にある場合はtrue を返し、そうでない場合はfalse を返します。

[noexcept] bool QRect::contains(int x, int y, bool proper) const

これはオーバーロードされた関数です。

点 (x,y) が矩形の内側または辺上にある場合はtrue を返し、そうでない場合はfalse を返します。proper が真の場合，この関数は，点が完全に矩形の内側にある（辺上にない）場合にのみtrue を返します．

[constexpr] void QRect::getCoords(int *x1, int *y1, int *x2, int *y2) const

矩形の左上隅の位置を *x1 と *y1 に，右下隅の位置を *x2 と *y2 に抽出します．

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

[constexpr] void QRect::getRect(int *x, int *y, int *width, int *height) const

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

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

[constexpr noexcept] int QRect::height() const

矩形の高さを返します。

setHeight()、width() およびsize()も参照 。

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

この矩形と与えられたrectangle との交点を返します。r.intersected(s) はr & s と等価であることに注意。

intersects()、united() およびoperator&=()も参照 。

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

この矩形が，与えられたrectangle と交差する（つまり，両方の矩形内に少なくとも1つのピクセルが存在する）場合はtrue を返し，そうでない場合はfalse を返します．

交差矩形は，intersected() 関数を用いて取得することができます．

contains （）も参照してください 。

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

矩形が空の場合はtrue を返し，そうでない場合はfalse を返します．

空の矩形は，left() >right() またはtop() >bottom() を持つ．空の矩形は無効です （すなわち、 isEmpty() == !isValid())）。

角が入れ替わった矩形を取得するにはnormalized() 関数を使用します。

isNull(),isValid(),normalized()も参照 。

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

矩形がヌル矩形の場合はtrue を返し、そうでない場合はfalse を返します。

ヌル矩形は、幅と高さの両方が 0 に設定されます（すなわち、right() ==left() - 1 およびbottom() ==top() - 1）。ヌル矩形もまた空であり、したがって無効である。

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

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

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

有効な矩形は、left() <=right() およびtop() <=bottom() を持つ。無効な矩形に対しては，交点のような非自明な操作は定義されないことに注意してください．有効な矩形は空ではない (すなわち， isValid() == !isEmpty())．

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

[constexpr noexcept] int QRect::left() const

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

setLeft()、topLeft() およびbottomLeft()も参照 。

[constexpr noexcept] QRect QRect::marginsAdded(const QMargins &margins) const

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

operator+=()、marginsRemoved() およびoperator-=()も参照 。

[constexpr noexcept] QRect QRect::marginsRemoved(const QMargins &margins) const

margins を矩形から削除して縮小します。

marginsAdded()、operator+=() およびoperator-=()も参照 。

[constexpr noexcept] void QRect::moveBottom(int y)

矩形を垂直に移動し、矩形の下辺を与えられたy 座標に残します。矩形のサイズは変更されません。

bottom()、setBottom()、moveTop()も参照 。

[constexpr noexcept] void QRect::moveBottomLeft(const QPoint &position)

矩形を移動し、左下端を与えられたposition に置きます。矩形のサイズは変更されません。

setBottomLeft()、moveBottom()、およびmoveLeft()も参照 。

[constexpr noexcept] void QRect::moveBottomRight(const QPoint &position)

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

setBottomRight()、moveRight() およびmoveBottom()も参照 。

[constexpr noexcept] void QRect::moveCenter(const QPoint &position)

矩形を移動し、中心点を与えられたposition に置きます。矩形のサイズは変更されません。

center()も参照 。

[constexpr noexcept] void QRect::moveLeft(int x)

矩形を水平に移動し、矩形の左端を、与えられたx 座標に残します。矩形のサイズは変更されません。

left()、setLeft()、moveRight() も参照 。

[constexpr noexcept] void QRect::moveRight(int x)

矩形の右端を、与えられたx 座標に置いたまま、矩形を水平方向に移動します。矩形のサイズは変更されません。

right()、setRight()、moveLeft()も参照 。

[constexpr noexcept] void QRect::moveTo(const QPoint &position)

矩形を移動し、左上端を与えられたposition に置きます。

[constexpr noexcept] void QRect::moveTo(int x, int y)

矩形を移動し、左上隅を指定された位置 (x,y) に残します。矩形のサイズは変更されません。

translate() およびmoveTopLeft()も参照 。

[constexpr noexcept] void QRect::moveTop(int y)

矩形を垂直に移動し、矩形の上辺を、与えられたy 座標に残します。矩形のサイズは変更されません。

top()、setTop() およびmoveBottom()も参照 。

[constexpr noexcept] void QRect::moveTopLeft(const QPoint &position)

矩形を移動し、左上端を与えられたposition に置きます。矩形のサイズは変更されません。

setTopLeft()、moveTop()、およびmoveLeft()も参照 。

[constexpr noexcept] void QRect::moveTopRight(const QPoint &position)

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

setTopRight()、moveTop() およびmoveRight()も参照 。

[noexcept] QRect QRect::normalized() const

正規化された矩形，つまり，幅と高さが負でない矩形を返します．

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

isValid() およびisEmpty()も参照 。

[constexpr noexcept] int QRect::right() const

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

歴史的な理由により、この関数はleft() +width() - 1 を返すことに注意。真の x 座標を取得するにはx() +width() を使用する。

setRight(),topRight(),bottomRight()も参照 。

[constexpr noexcept] void QRect::setBottom(int y)

矩形の下辺を、与えられたy 座標に設定します。高さを変更することはできますが、矩形の上辺を変更することはありません。

bottom() およびmoveBottom()も参照 。

[constexpr noexcept] void QRect::setBottomLeft(const QPoint &position)

矩形の左下隅を、与えられたposition に設定します。サイズは変更されるかもしれませんが、矩形の右上隅が変更されることはありません。

bottomLeft() およびmoveBottomLeft()も参照 。

[constexpr noexcept] void QRect::setBottomRight(const QPoint &position)

矩形の右下隅を、与えられたposition に設定します。サイズは変更されるかもしれませんが、矩形の左上隅は決して変更されません。

bottomRight() およびmoveBottomRight()も参照 。

[constexpr noexcept] void QRect::setCoords(int x1, int y1, int x2, int y2)

矩形の左上隅の座標を (x1,y1) に、右下隅の座標を (x2,y2) に設定します。

getCoords() およびsetRect()も参照 。

[constexpr noexcept] void QRect::setHeight(int height)

矩形の高さを、与えられたheight に設定します。下辺は変更されますが、上辺は変更されません。

height() およびsetSize()も参照 。

[constexpr noexcept] void QRect::setLeft(int x)

矩形の左端を、与えられたx 座標に設定します。幅を変更することはできますが、矩形の右端を変更することはありません。

setX() と同等。

left() およびmoveLeft()も参照 。

[constexpr noexcept] void QRect::setRect(int x, int y, int width, int height)

矩形の左上隅の座標を (x,y) に、サイズを指定されたwidth とheight に設定します。

getRect() およびsetCoords()も参照 。

[constexpr noexcept] void QRect::setRight(int x)

矩形の右端を、与えられたx 座標に設定します。幅を変更することはできますが、矩形の左端を変更することはありません。

right() およびmoveRight()も参照 。

[constexpr noexcept] void QRect::setSize(const QSize &size)

矩形のサイズを、与えられたsize に設定します。左上隅は移動しません。

size()、setWidth() およびsetHeight() も参照 。

[constexpr noexcept] void QRect::setTop(int y)

矩形の上辺を、与えられたy 座標に設定します。高さを変更することはできますが、矩形の下辺を変更することはありません。

setY() と同等。

top() およびmoveTop()も参照 。

[constexpr noexcept] void QRect::setTopLeft(const QPoint &position)

矩形の左上隅を、与えられたposition に設定します。サイズを変更することはできますが、矩形の右下隅を変更することはありません。

topLeft() およびmoveTopLeft()も参照 。

[constexpr noexcept] void QRect::setTopRight(const QPoint &position)

矩形の右上隅を、与えられたposition に設定します。サイズは変更されるかもしれませんが、矩形の左下隅が変更されることはありません。

topRight() およびmoveTopRight()も参照 。

[constexpr noexcept] void QRect::setWidth(int width)

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

width() およびsetSize() も参照 。

[constexpr noexcept] void QRect::setX(int x)

矩形の左辺を、与えられたx 座標に設定します。幅を変更することはできますが、矩形の右端を変更することはありません。

setLeft() と同等。

x()、setY() およびsetTopLeft()も参照 。

[constexpr noexcept] void QRect::setY(int y)

矩形の上辺を、与えられたy 座標に設定します。高さを変更することはできますが、矩形の下辺を変更することはありません。

setTop() と同等。

y()、setX() およびsetTopLeft()も参照 。

[constexpr noexcept] QSize QRect::size() const

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

setSize()、width() およびheight()も参照 。

[static constexpr noexcept, since 6.0] QRect QRect::span(const QPoint &p1, const QPoint &p2)

p1 とp2 の 2 点にまたがる矩形を返します。

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

[noexcept] CGRect QRect::toCGRect() const

QRect から CGRect を作成します。

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

[constexpr noexcept, since 6.4] QRectF QRect::toRectF() const

この矩形を浮動小数点精度の矩形として返します。

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

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

[constexpr noexcept] int QRect::top() const

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

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

[constexpr noexcept] QPoint QRect::topLeft() const

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

setTopLeft()、top() およびleft() も参照 。

[constexpr noexcept] QPoint QRect::topRight() const

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

歴史的な理由により、この関数はQPoint(left() +width() -1,top()) を返すことに注意。

setTopRight(),top(),right()も参照 。

[constexpr noexcept] void QRect::translate(int dx, int dy)

矩形dx を x 軸に沿って、dy を y 軸に沿って、現在の位置から相対的に移動させる。正の値を指定すると、矩形は右と下に移動します。

moveTopLeft()、moveTo()、translated()も参照 。

[constexpr noexcept] void QRect::translate(const QPoint &offset)

これはオーバーロードされた関数です。

矩形offset.x() を x 軸方向に、offset.y() を y 軸方向に、現在の位置から相対的に移動します。

[constexpr noexcept] QRect QRect::translated(int dx, int dy) const

dx を x 軸に沿っ て、dy を y 軸に沿っ て、 カ レ ン ト 位置に相対的に移動 さ せた矩形のコピーを返 し ます。正の値を指定すると、矩形は右と下に移動します。

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

[constexpr noexcept] QRect QRect::translated(const QPoint &offset) const

これはオーバーロードされた関数です。

offset.x() を x 軸に沿っ て、offset.y() を y 軸に沿っ て、 現在の位置から相対的に移動させた矩形のコピーを返します。

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

幅と高さを交換した矩形のコピーを返します：

QRect r = {15, 51, 42, 24};
r = r.transposed(); // r == {15, 51, 24, 42}

QSize::transposed()も参照 。

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

この矩形と与えられたrectangle の外接矩形を返します。

intersected()も参照 。

[constexpr noexcept] int QRect::width() const

矩形の幅を返します。

setWidth()、height() およびsize()も参照 。

[constexpr noexcept] int QRect::x() const

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

setX()、y() およびtopLeft()も参照 。

[constexpr noexcept] int QRect::y() const

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

setY()、x() およびtopLeft()も参照 。

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

この矩形と与えられたrectangle との交点を返します。交点がない場合は空の矩形を返します。

operator&=() およびintersected()も参照 。

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

この矩形と与えられたrectangle との交点を返します。

intersected() およびoperator&()も参照 。

[constexpr noexcept] QRect &QRect::operator+=(const QMargins &margins)

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

marginsAdded()、marginsRemoved() およびoperator-=()も参照 。

[constexpr noexcept] QRect &QRect::operator-=(const QMargins &margins)

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

marginsRemoved()、operator+=() およびmarginsAdded()も参照 。

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

この矩形と与えられたrectangle の外接矩形を返します。

operator|=() およびunited()も参照 。

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

この矩形を，与えられたrectangle と結合します．

united() およびoperator|()も参照 。