QRegion Class

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

QRegion::QRegion()

空の領域を作成します。

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

QRegion::QRegion(const QBitmap &bm)

ビットマップbm から領域を構築します。

結果として得られる領域は、ビットマップ `bm ` 内の、`Qt::color1` に該当するピクセルで構成されます。これは、各ピクセルが 1×1 の長方形であるかのように扱われます。

このコンストラクタは、使用時に描画速度を低下させるような複雑な領域を作成する場合があります。なお、マスクされたピクマップの描画は、QPixmap::setMask() を使用することで、はるかに高速に行うことができます。

QRegion::QRegion(const QPolygon &a, Qt::FillRule fillRule = Qt::OddEvenFill)

点配列 `a ` から、`fillRule` で指定された塗りつぶしルールに従って多角形領域を構築します。

fillRule がQt::WindingFill の場合、多角形領域はワインディングアルゴリズムを使用して定義されます。Qt::OddEvenFill の場合、奇数・偶数塗りつぶしアルゴリズムが使用されます。

QRegion::QRegion(int x, int y, int w, int h, QRegion::RegionType t = Rectangle)

長方形または楕円形の領域を作成します。

t がRectangle の場合、領域は塗りつぶされた長方形（x,y,w,h ）となります。t がEllipse の場合、領域は中心が(x +w / 2,y +h / 2)、サイズが(w,h)の塗りつぶされた楕円となります。

QRegion::QRegion(const QRect &r, QRegion::RegionType t = Rectangle)

r の矩形を基に、領域タイプを「t 」として領域を作成します。

矩形が不正な場合、null の領域が作成されます。

QRegion::RegionTypeも参照してください 。

QRegion::QRegion(const QRegion &r)

r に等しい新しい領域を作成します。

[noexcept] QRegion::QRegion(QRegion &&other)

other から新しい領域をムーブコンストラクトで生成します。呼び出し後、other は null になります。

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

[noexcept] QRegion::const_iterator QRegion::begin() const

その領域を構成する、互いに重ならない矩形の範囲の先頭を指すconst_iterator を返します。

すべての矩形の和集合は、元の領域と等しくなります。

rbegin()、cbegin()、およびend()も参照してください 。

[noexcept] QRect QRegion::boundingRect() const

この領域の境界矩形を返します。領域が空の場合、QRect::isNull() の矩形が返されます。

[noexcept] QRegion::const_iterator QRegion::cbegin() const

begin() と同じです。

[noexcept] QRegion::const_iterator QRegion::cend() const

end() と同じです。

bool QRegion::contains(const QPoint &p) const

領域に点p が含まれている場合はtrue を返し、そうでない場合はfalse を返します。

bool QRegion::contains(const QRect &r) const

領域が矩形r と重なる場合は `true ` を返し、そうでない場合は `false` を返します。

[noexcept] QRegion::const_reverse_iterator QRegion::crbegin() const

rbegin() と同じです。

[noexcept] QRegion::const_reverse_iterator QRegion::crend() const

rend() と同じです。

[noexcept] QRegion::const_iterator QRegion::end() const

その領域を構成する、互いに重ならない矩形の末尾の1つ先を指すconst_iterator を返します。

すべての矩形の和集合は、元の領域と等しくなります。

rend()、cend()、およびbegin()も参照してください 。

[static, since 6.0] QRegion QRegion::fromHRGN(HRGN hrgn)

指定された `hrgn` と同等の `QRegion ` を返します。

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

QRegion QRegion::intersected(const QRect &rect) const

この領域と、指定されたrect との共通部分を領域として返します。

subtracted()、united()、およびxored()も参照してください 。

QRegion QRegion::intersected(const QRegion &r) const

この領域とr の交差領域を返します。

図は、2つの楕円領域の共通部分を表しています。

subtracted()、united()、およびxored()も参照してください 。

bool QRegion::intersects(const QRect &rect) const

この領域が `rect` と交差する場合は `true ` を返し、そうでない場合は `false` を返します。

bool QRegion::intersects(const QRegion &region) const

この領域が `region` と交差する場合は `true ` を返し、そうでない場合は `false` を返します。

bool QRegion::isEmpty() const

領域が空の場合は `true ` を返し、それ以外の場合は `false` を返します。空の領域とは、点を一切含まない領域のことです。

例：

QRegion r1(10, 10, 20, 20);
r1.isEmpty();               // false

QRegion r3;
r3.isEmpty();               // true

QRegion r2(40, 40, 20, 20);
r3 = r1.intersected(r2);    // r3: intersection of r1 and r2
r3.isEmpty();               // true

r3 = r1.united(r2);         // r3: union of r1 and r2
r3.isEmpty();               // false

bool QRegion::isNull() const

領域が空の場合、true を返し、そうでない場合はfalse を返します。空の領域とは、点を一切含まない領域のことです。この関数は、isEmpty

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

[noexcept] QRegion::const_reverse_iterator QRegion::rbegin() const

その領域を構成する、互いに重ならない長方形の範囲の先頭を指すconst_reverse_iterator を返します。

すべての矩形の和集合は、元の領域と等しくなります。

begin()、crbegin()、およびrend()も参照してください 。

[noexcept] int QRegion::rectCount() const

この領域を構成する矩形の数を返します。end() - begin() と同じです。

[noexcept, since 6.8] QSpan<const QRect> QRegion::rects() const

その領域を構成する、互いに重ならない矩形の範囲を返します。この範囲は、この領域に対して変更を伴う（非const）メソッドが次に呼び出されるまで有効です。

すべての矩形の和集合は、元の領域と等しくなります。

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

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

[noexcept] QRegion::const_reverse_iterator QRegion::rend() const

その領域を構成する、互いに重ならない矩形の範囲の末尾の1つ先を指すconst_reverse_iterator を返します。

すべての矩形の和集合は、元の領域と等しくなります。

end()、crend()、およびrbegin()も参照してください 。

[since 6.8] void QRegion::setRects(QSpan<const QRect> rects)

rects で指定された矩形の配列を使用して、領域を設定します。矩形はY-X順に最適にソートされている必要があり、以下の制約を満たす必要があります：

• 矩形同士が交差してはなりません。
• 同じ上端座標を持つすべての矩形は、同じ高さを持たなければなりません。
• 2つの矩形が水平方向に隣接してはならない（その場合は、1つのより幅の広い矩形に結合されるべきである）。
• 矩形は、Yを主要なソートキー、Xを副次的なソートキーとして、昇順でソートされている必要があります。

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

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

QRegion QRegion::subtracted(const QRegion &r) const

この領域からr を差し引いた領域を返します。

図は、左側の楕円から右側の楕円を差し引いた結果を示しています（left - right ）。

intersected()、united()、およびxored()も参照してください 。

[noexcept] void QRegion::swap(QRegion &other)

この領域をother と入れ替えます。この操作は非常に高速で、失敗することはありません。

[since 6.0] HRGN QRegion::toHRGN() const

指定された領域と同等の HRGN を返します。

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

void QRegion::translate(int dx, int dy)

領域dx を X 軸方向に、dy を Y 軸方向に変位（移動）させます。

void QRegion::translate(const QPoint &point)

point.x()の領域を x 軸に沿って、point.y()の領域を y 軸に沿って、現在の位置を基準として平行移動させます。正の値指定すると、領域は右方向および下方向に移動します。

指定されたpoint へ平行移動します。

QRegion QRegion::translated(int dx, int dy) const

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

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

QRegion QRegion::translated(const QPoint &p) const

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

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

QRegion QRegion::united(const QRect &rect) const

この領域と、指定されたrect の和集合となる領域を返します。

intersected()、subtracted()、およびxored()も参照してください 。

QRegion QRegion::united(const QRegion &r) const

この領域とr の和集合となる領域を返します。

図は、2つの楕円領域の和集合を示しています。

intersected()、subtracted()、およびxored()も参照してください 。

QRegion QRegion::xored(const QRegion &r) const

この領域とr の排他的論理和（XOR）となる領域を返します。

図は、2つの楕円形領域の排他的論理和を示しています。

intersected()、united()、およびsubtracted()も参照してください 。

QRegion::operator QVariant() const

その領域をQVariant

bool QRegion::operator!=(const QRegion &other) const

この領域が `other ` の領域と異なる場合は `true ` を返し、そうでない場合は `false` を返します。

QRegion QRegion::operator&(const QRegion &r) const

この領域に対してintersected()関数を適用し、r とします。r1&r2 は、r1.intersected(r2) と同等です。

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

QRegion QRegion::operator&(const QRect &r) const

QRegion &QRegion::operator&=(const QRegion &r)

この領域に対して関数 `intersected()` を適用し、`r ` を行い、その結果をこの領域に代入します。`r1&=r2 ` は、`r1 = r1.intersected(r2)` と同等です。

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

QRegion &QRegion::operator&=(const QRect &r)

QRegion QRegion::operator+(const QRegion &r) const

この領域に対して、united() 関数を適用し、r を行います。r1+r2 は、r1.united(r2) と同等です。

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

QRegion QRegion::operator+(const QRect &r) const

QRegion &QRegion::operator+=(const QRect &rect)

この領域と、指定されたrect との和集合となる領域を返します。

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

QRegion &QRegion::operator+=(const QRegion &r)

この領域に対してunited()関数を適用し、r を行い、その結果をこの領域に代入します。r1+=r2 は、r1 = r1.united(r2) と同等です。

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

QRegion QRegion::operator-(const QRegion &r) const

この領域に対して、subtracted() 関数を適用し、r を実行します。r1-r2 は、r1.subtracted(r2) と同等です。

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

QRegion &QRegion::operator-=(const QRegion &r)

この領域に対して関数 `subtracted()` を適用し、`r ` を行い、その結果をこの領域に代入します。`r1-=r2 ` は `r1 = r1.subtracted(r2)` と同等です。

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

[noexcept] QRegion &QRegion::operator=(QRegion &&other)

other をこのQRegion インスタンスに割り当てます。

QRegion &QRegion::operator=(const QRegion &r)

このリージョンにr を割り当て、そのリージョンへの参照を返します。

bool QRegion::operator==(const QRegion &r) const

その領域が `r` と等しい場合は `true ` を返し、そうでない場合は `false` を返します。

QRegion QRegion::operator^(const QRegion &r) const

この領域に対して、xored() 関数を適用します。また、r 。r1^r2 は、r1.xored(r2) と同等です。

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

QRegion &QRegion::operator^=(const QRegion &r)

この領域に対してxored()関数を適用し、r を行い、その結果をこの領域に代入します。r1^=r2 は、r1 = r1.xored(r2) と同等です。

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

QRegion QRegion::operator|(const QRegion &r) const

この領域に対して、united() 関数を適用し、r を行います。r1|r2 は、r1.united(r2) と同等です。

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

QRegion &QRegion::operator|=(const QRegion &r)

この領域にunited()関数を適用し、r を行い、その結果をこの領域に代入します。r1|=r2 は、r1 = r1.united(r2) と同等です。

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