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 がtrueの場合、この関数は、指定されたpoint が矩形の内側（つまり、境界線上ではない）にある場合にのみtrue を返します。

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

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

指定されたrectangle がこの矩形内にある場合、true を返します。そうでない場合はfalse を返します。proper がtrueの場合、この関数は、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 の場合、この関数は、点が矩形の内側に完全に収まっている（境界線上ではない）場合にのみ `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)

2つの点p1 とp2 を結ぶ長方形を返します。これには、両端の点およびその間のすべての領域が含まれます。

この関数は 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)

現在の位置を基準として、矩形をx軸方向にdx 、y軸方向にdy だけ移動させます。正の値を設定すると、矩形は右方向および下方向に移動します。

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

現在の位置を基準として、x 軸方向にdx 、y 軸方向にdy だけ平行移動させた矩形のコピーを返します。正の値は、矩形を右および下方向に移動させます。

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

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

現在の位置を基準として、x軸方向にはoffset.x()、y軸方向にはoffset.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|()も参照してください 。