このページでは

QRadialGradient Class

QRadialGradient クラスは、QBrush と組み合わせて、放射状グラデーションブラシを指定するために使用されます。詳細...

ヘッダー: #include <QRadialGradient>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
継承元: QGradient

パブリック関数

QRadialGradient()
QRadialGradient(const QPointF &center, qreal radius)
QRadialGradient(const QPointF &center, qreal radius, const QPointF &focalPoint)
QRadialGradient(qreal cx, qreal cy, qreal radius)
QRadialGradient(const QPointF &center, qreal centerRadius, const QPointF &focalPoint, qreal focalRadius)
QRadialGradient(qreal cx, qreal cy, qreal radius, qreal fx, qreal fy)
QRadialGradient(qreal cx, qreal cy, qreal centerRadius, qreal fx, qreal fy, qreal focalRadius)
QPointF center() const
qreal centerRadius() const
QPointF focalPoint() const
qreal focalRadius() const
qreal radius() const
void setCenter(const QPointF &center)
void setCenter(qreal x, qreal y)
void setCenterRadius(qreal radius)
void setFocalPoint(const QPointF &focalPoint)
void setFocalPoint(qreal x, qreal y)
void setFocalRadius(qreal radius)
void setRadius(qreal radius)

詳細な説明

Qtは、単純な放射状グラデーションと拡張放射状グラデーションの両方をサポートしています。

単純な放射状グラデーションは、焦点と、それを囲む円上の端点との間で色を補間します。拡張放射状グラデーションは、焦点円と中心円との間で色を補間します。 2 つの円によって定義される円錐の外側の点は透明になります。単純な放射状グラデーションの場合、焦点点は中心円の内側にくるように調整されますが、拡張放射状グラデーションでは、焦点点は任意の位置に設定できます。

端点の外側では、現在設定されているspread メソッドに応じて、グラデーションがパディング、反転、または繰り返し処理されます。

グラデーションの色は、QGradientStop 型のストップポイント、すなわち位置と色を使用して定義されます。 ストップポイントを定義するには、QGradient::setColorAt() またはQGradient::setStops() 関数を使用します。グラデーション領域をどのように塗りつぶすかは、そのグラデーションのストップポイントの完全なセットによって決定されます。ストップポイントが指定されていない場合、0 で黒、1 で白となるグラデーションが使用されます。

QGradient から継承された関数に加え、QRadialGradientクラスは、グラデーションの中心、焦点、半径をそれぞれ返すcenter()、focalPoint()、およびradius()関数を提供します。

QLinearGradient 、QConicalGradient 、および「グラデーションの例」も参照してください 。

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

QRadialGradient::QRadialGradient()

中心と焦点が (0, 0) にある、半径 1 の単純な放射状グラデーションを作成します。

QRadialGradient::QRadialGradient(const QPointF &center, qreal radius)

指定されたcenter 、radius 、および円の中心を焦点として、単純な放射状グラデーションを作成します。

QGradient::setColorAt() およびQGradient::setStops()も参照してください 。

QRadialGradient::QRadialGradient(const QPointF &center, qreal radius, const QPointF &focalPoint)

指定されたcenter 、radius 、およびfocalPoint を用いて、単純な放射状グラデーションを作成します。

注: 指定された焦点が、center 点とradius によって定義される円の外側にある場合 、その焦点は、center からfocalPoint への直線と円が交わる点上に位置するように再調整されます。

QGradient::setColorAt() およびQGradient::setStops()も参照してください 。

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal radius)

(cx,cy) を中心とし、指定されたradius を持つ単純な放射状グラデーションを作成します。焦点点は円の中心に位置します。

QGradient::setColorAt() およびQGradient::setStops()も参照してください 。

QRadialGradient::QRadialGradient(const QPointF &center, qreal centerRadius, const QPointF &focalPoint, qreal focalRadius)

指定されたcenter 、centerRadius 、focalPoint 、およびfocalRadius を使用して、拡張ラジアルグラデーションを作成します。

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal radius, qreal fx, qreal fy)

指定された中心(cx 、cy )、radius 、および焦点(fx 、fy )を用いて、単純な放射状グラデーションを作成します。

注: 指定された焦点( 、 )が、中心(cx 、cy )と半径(radius )によって定義される円の外側にある場合、 その焦点は、中心から焦点への直線と円との交点に再調整されます。

QGradient::setColorAt() およびQGradient::setStops()も参照してください 。

QRadialGradient::QRadialGradient(qreal cx, qreal cy, qreal centerRadius, qreal fx, qreal fy, qreal focalRadius)

指定された中心 (cx,cy)、中心半径centerRadius 、焦点 (fx,fy)、および焦点半径focalRadius を用いて、拡張ラジアルグラデーションを生成します。

QPointF QRadialGradient::center() const

この放射状グラデーションの中心を論理座標で返します。

setCenter() およびQGradient::stops()も参照してください 。

qreal QRadialGradient::centerRadius() const

この放射状グラデーションの中心半径を論理座標で返します。

setCenterRadius() およびQGradient::stops()も参照してください 。

QPointF QRadialGradient::focalPoint() const

この放射状グラデーションの焦点を論理座標で返します。

setFocalPoint() およびQGradient::stops()も参照してください 。

qreal QRadialGradient::focalRadius() const

この放射状グラデーションの焦点半径を論理座標で返します。

setFocalRadius() およびQGradient::stops()も参照してください 。

qreal QRadialGradient::radius() const

この放射状グラデーションの半径を論理座標で返します。

centerRadius() と同等です。

setRadius() およびQGradient::stops()も参照してください 。

void QRadialGradient::setCenter(const QPointF &center)

この放射状グラデーションの中心を、論理座標でcenter に設定します。

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

void QRadialGradient::setCenter(qreal x, qreal y)

この放射状グラデーションの中心を、論理座標で (x,y) に設定します。

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

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

void QRadialGradient::setCenterRadius(qreal radius)

この放射状グラデーションの中心半径を、論理座標でradius

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

void QRadialGradient::setFocalPoint(const QPointF &focalPoint)

この放射状グラデーションの焦点位置を、論理座標でfocalPoint に設定します。

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

void QRadialGradient::setFocalPoint(qreal x, qreal y)

この放射状グラデーションの焦点を、論理座標で (x,y) に設定します。

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

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

void QRadialGradient::setFocalRadius(qreal radius)

この放射状グラデーションの焦点半径を、論理座標でradius

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

void QRadialGradient::setRadius(qreal radius)

この放射状グラデーションの半径を、論理座標でradius

setCenterRadius() と同等です

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

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.