QScrollEvent Class
QScrollEvent クラスは、スクロール時に送信されます。詳細...
| ヘッダー: | #include <QScrollEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 継承元: | QEvent |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QScrollEventはEventクラス群の一部です。
パブリック型
| enum | ScrollState { ScrollStarted, ScrollUpdated, ScrollFinished } |
パブリック関数
| QScrollEvent(const QPointF &contentPos, const QPointF &overshootDistance, QScrollEvent::ScrollState scrollState) | |
| QPointF | contentPos() const |
| QPointF | overshootDistance() const |
| QScrollEvent::ScrollState | scrollState() const |
保護された関数
| QScrollEvent(QScrollEvent &&) | |
| QScrollEvent & | operator=(QScrollEvent &&) |
| QScrollEvent & | operator=(const QScrollEvent &other) |
詳細な説明
スクロールイベントは、受信オブジェクトをスクロールすべきであることを示すために送信されます。通常、受信オブジェクトは、QWidget やQGraphicsObject のような視覚的なオブジェクトである必要があります。
2つのソースから競合するQScrollEventが送信されないよう、注意を払う必要があります。ただし、QScroller::scrollTo を使用する場合は安全です。
QScrollPrepareEvent およびQScrollerも参照してください 。
メンバ型のドキュメント
enum QScrollEvent::ScrollState
この列挙型は、スクロールイベントが取り得る状態を表します。
| 定数 | 値 | 説明 |
|---|---|---|
QScrollEvent::ScrollStarted | 0 | スクロールアクティビティの最初のスクロールイベントに対して設定されます。 |
QScrollEvent::ScrollUpdated | 1 | スクロールアクティビティの最初と最後のスクロールイベントを除く、すべてのスクロールイベントに設定されます。 |
QScrollEvent::ScrollFinished | 2 | スクロールアクティビティの最後のスクロールイベントに対して設定されます。 |
関連項目: QScrollEvent::scrollState()。
メンバ関数のドキュメント
QScrollEvent::QScrollEvent(const QPointF &contentPos, const QPointF &overshootDistance, QScrollEvent::ScrollState scrollState)
新しい QScrollEvent を作成します。contentPos は新しいコンテンツの位置、overshootDistance は新しいオーバーシュート距離、scrollState はこのスクロールイベントが最初、最後、またはその間のいずれであるかを示します。
[protected delete] QScrollEvent::QScrollEvent(QScrollEvent &&)
QScrollEvent のインスタンスをMoveコンストラクタで生成します。この関数は削除されています。
QPointF QScrollEvent::contentPos() const
新しいスクロール位置を返します。
QPointF QScrollEvent::overshootDistance() const
新しいオーバーシュート距離を返します。「オーバーシュート」という用語の説明については、QScroller を参照してください。
QScrollerも参照してください 。
QScrollEvent::ScrollState QScrollEvent::scrollState() const
現在のスクロール状態を、ScrollStateFlag 値の組み合わせとして返します。このスクロールイベントがスクロール中のアクティビティにおける最初の(または最後の)イベントである場合、ScrollStarted (またはScrollFinished )が設定されます。 なお、アクティビティが単一のQScrollEvent で構成されている場合、両方の値が同時に設定される可能性があることに注意してください。その間の他のすべてのスクロールイベントでは、状態がScrollUpdated に設定されます。
たとえば、ウィジェットは、スクロールの開始時および終了時に選択状態を元に戻すことができます。
[protected delete] QScrollEvent &QScrollEvent::operator=(QScrollEvent &&)
other をこのQScrollEvent インスタンスに割り当てます。この関数は削除されます。
[noexcept protected default] QScrollEvent &QScrollEvent::operator=(const QScrollEvent &other)
other をこのQScrollEvent インスタンスにコピーして割り当てます。
© 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.