QPaintEngineState Class
QPaintEngineState クラスは、アクティブなペイントエンジンの現在の状態に関する情報を提供します。詳細...
| ヘッダー: | #include <QPaintEngineState> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
注：このクラスのすべての関数は再入可能である。
パブリック関数
| QBrush | backgroundBrush() const |
| Qt::BGMode | backgroundMode() const |
| QBrush | brush() const |
| bool | brushNeedsResolving() const |
| QPointF | brushOrigin() const |
| Qt::ClipOperation | clipOperation() const |
| QPainterPath | clipPath() const |
| QRegion | clipRegion() const |
| QPainter::CompositionMode | compositionMode() const |
| QFont | font() const |
| bool | isClipEnabled() const |
| qreal | opacity() const |
| QPainter * | painter() const |
| QPen | pen() const |
| bool | penNeedsResolving() const |
| QPainter::RenderHints | renderHints() const |
| QPaintEngine::DirtyFlags | state() const |
| QTransform | transform() const |
詳細な説明
QPaintEngineState は、ペイントエンジンが前回更新されてから変更されたプロパティと、それらの現在の値を記録します。
どのプロパティが変更されたかは、state() 関数を使用していつでも取得できます。この関数は、QPaintEngine::DirtyFlag 値の論理和（OR）を格納するQPaintEngine::DirtyFlags 型のインスタンスを返します。QPaintEngine::DirtyFlag 列挙型は、プロパティが前回の更新以降に変更されたかどうかを定義します。
プロパティにダーティフラグが設定されている場合、対応する get 関数を使用してその現在の値を取得できます：
QPaintEngineState クラスは、現在ペイントエンジンを更新しているペインターへのポインタを返すpainter()関数も提供しています。
アクティブなペイントエンジンの現在の状態を表すこのクラスのインスタンスが、QPaintEngine::updateState() 関数の引数として渡されます。このクラスを直接使用する必要があるのは、独自のペイントエンジンを実装する場合のみです。
「QPaintEngine」も参照してください 。
メンバ関数のドキュメント
QBrush QPaintEngineState::backgroundBrush() const
現在のペイントエンジン状態における背景ブラシを返します。
この変数は、state() がQPaintEngine::DirtyBackground フラグを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
Qt::BGMode QPaintEngineState::backgroundMode() const
現在のペイントエンジン状態における背景モードを返します。
この変数は、state() がQPaintEngine::DirtyBackgroundMode フラグを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
QBrush QPaintEngineState::brush() const
現在のペイントエンジン状態にあるブラシを返します。
この変数は、state() がQPaintEngine::DirtyBrush フラグを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
bool QPaintEngineState::brushNeedsResolving() const
塗りつぶしの座標が、現在のレンダリング操作の範囲内に指定されており、（現在レンダリングされているプリミティブに関して）解決する必要があるかどうかを返します。
QPointF QPaintEngineState::brushOrigin() const
現在のペイントエンジン状態におけるブラシの原点を返します。
この変数は、state() がQPaintEngine::DirtyBrushOrigin フラグを含む組み合わせを返す場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
Qt::ClipOperation QPaintEngineState::clipOperation() const
現在のペイントエンジン状態におけるクリップ操作を返します。
この変数は、state() が、QPaintEngine::DirtyClipPath またはQPaintEngine::DirtyClipRegion フラグのいずれかを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
QPainterPath QPaintEngineState::clipPath() const
現在のペイントエンジン状態におけるクリップパスを返します。
この変数は、state() がQPaintEngine::DirtyClipPath フラグを含む組み合わせを返す場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
QRegion QPaintEngineState::clipRegion() const
現在のペイントエンジン状態におけるクリップ領域を返します。
この変数は、state() がQPaintEngine::DirtyClipRegion フラグを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
QPainter::CompositionMode QPaintEngineState::compositionMode() const
現在のペイントエンジンの状態における合成モードを返します。
この変数は、state() がQPaintEngine::DirtyCompositionMode フラグを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
QFont QPaintEngineState::font() const
現在のペイントエンジン状態のフォントを返します。
この変数は、state() がQPaintEngine::DirtyFont フラグを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
bool QPaintEngineState::isClipEnabled() const
現在のペイントエンジンの状態において、クリッピングが有効か無効かを返します。
この変数は、state() がQPaintEngine::DirtyClipEnabled フラグを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
qreal QPaintEngineState::opacity() const
現在のペイントエンジンの状態における不透明度を返します。
QPainter *QPaintEngineState::painter() const
現在、ペイントエンジンを更新しているペインターへのポインタを返します。
QPen QPaintEngineState::pen() const
現在のペイントエンジンの状態にあるペンを返します。
この変数は、state() がQPaintEngine::DirtyPen フラグを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
bool QPaintEngineState::penNeedsResolving() const
ストロークの座標が、現在のレンダリング操作の範囲内に指定されており、（現在レンダリングされているプリミティブに関して）解決する必要があるかどうかを返します。
QPainter::RenderHints QPaintEngineState::renderHints() const
現在のペイントエンジンの状態におけるレンダリングヒントを返します。
この変数は、state() がQPaintEngine::DirtyHints フラグを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
QPaintEngine::DirtyFlags QPaintEngineState::state() const
ペイントエンジンの状態を更新する際（つまり、QPaintEngine::updateState() 関数の呼び出し中）、更新が必要なプロパティのセットを識別するフラグの組み合わせを返します。
QPaintEngine::updateState()も参照してください 。
QTransform QPaintEngineState::transform() const
現在のペイントエンジン状態における行列を返します。
この変数は、state() がQPaintEngine::DirtyTransform フラグを含む組み合わせを返した場合にのみ使用してください。
state() およびQPaintEngine::updateState()も参照してください 。
© 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.
