QAbstractScrollArea Class

    QSize areaSize = viewport()->size();
    QSize  widgetSize = widget->size();

    verticalScrollBar()->setPageStep(areaSize.height());
    horizontalScrollBar()->setPageStep(areaSize.width());
    verticalScrollBar()->setRange(0, widgetSize.height() - areaSize.height());
    horizontalScrollBar()->setRange(0, widgetSize.width() - areaSize.width());
    updateWidgetPosition();

    int hvalue = horizontalScrollBar()->value();
    int vvalue = verticalScrollBar()->value();
    QPoint topLeft = viewport()->rect().topLeft();

    widget->move(topLeft.x() - hvalue, topLeft.y() - vvalue);

メンバ関数の説明

[explicit] QAbstractScrollArea::QAbstractScrollArea(QWidget *parent = nullptr)

ビューポートを構築します。

parent 引数はQWidget コンストラクタに送られます。

[virtual noexcept] QAbstractScrollArea::~QAbstractScrollArea()

ビューポートを破棄します。

void QAbstractScrollArea::addScrollBarWidget(QWidget *widget, Qt::Alignment alignment)

alignment で指定された位置にスクロールバーウィジェットとしてwidget を追加する。

スクロールバー・ウィジェットは水平または垂直スクロールバーの隣に表示され、その両側に配置できます。スクロールバーウィジェットを常に表示させたい場合は、対応するスクロールバーの scrollBarPolicy をAlwaysOn に設定してください。

alignment には、水平スクロールバーに対応する Qt::Alignleft と 、または垂直スクロールバーに対応する と のいずれかを指定してください。Qt::AlignRight Qt::AlignTop Qt::AlignBottom

スクロールバー・ウィジェットを削除するには、ウィジェットのペアレントを変更するか、ウィジェットを削除します。また、QWidget::hide() でウィジェットを非表示にすることもできます。

スクロール バー ウィジェットは、現在のスタイルのスクロール バー ジオメトリに合わせてサイズが変更されます。以下は、水平スクロール バーのスクロール バー ウィジェットの場合です：

ウィジェットの高さは、スクロールバーの高さに合わせて設定されます。ウィジェットの幅を制御するには、QWidget::setMinimumWidth とQWidget::setMaximumWidth を使用するか、QWidget::sizeHint() を実装して水平サイズ・ポリシーを設定します。正方形のウィジェットにしたい場合は、QStyle::pixelMetric(QStyle::PM_ScrollBarExtent) を呼び出し、幅をこの値に設定します。

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

[override virtual protected] void QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e)

再実装：QWidget::contextMenuEvent(QContextMenuEvent *event)。

このイベント・ハンドラは、viewport() ウィジェットのコンテキスト・メニュー・イベントを受け取るために、サブクラスで再実装することができます。イベントはe で渡されます。

QWidget::contextMenuEvent()も参照 。

QWidget *QAbstractScrollArea::cornerWidget() const

2つのスクロールバーの間のコーナーにあるウィジェットを返します。

デフォルトでは、コーナーウィジェットは存在しません。

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

[override virtual protected] void QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event)

再インプリメント：QWidget::dragEnterEvent(QDragEnterEvent *event)。

このイベント・ハンドラは、viewport() ウィジェットのドラッグ入力イベント（event で渡される）を受け取るために、サブクラスで再実装することができます。

QWidget::dragEnterEvent()も参照してください 。

[override virtual protected] void QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)

再実装します：QWidget::dragLeaveEvent(QDragLeaveEvent *event)。

このイベントハンドラは、viewport() ウィジェットのドラッグ離脱イベント (event で渡される) を受け取るために、サブクラスで再実装できます。

QWidget::dragLeaveEvent()も参照してください 。

[override virtual protected] void QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)

再実装します：QWidget::dragMoveEvent(QDragMoveEvent *event)。

このイベントハンドラは、viewport() ウィジェットのドラッグ移動イベント (event で渡される) を受け取るために、サブクラスで再実装できます。

QWidget::dragMoveEvent()も参照してください 。

[override virtual protected] void QAbstractScrollArea::dropEvent(QDropEvent *event)

再実装します：QWidget::dropEvent(QDropEvent *event)。

このイベント・ハンドラは、viewport() ウィジェットのドロップ・イベント (event で渡される) を受け取るために、サブクラスで再実装できます。

QWidget::dropEvent()も参照してください 。

[override virtual protected] bool QAbstractScrollArea::event(QEvent *event)

再実装：QFrame::event(QEvent *e)。

これは、QAbstractScrollArea ウィジェット（スクロール・エリアviewport()ではありません）のメイン・イベント・ハンドラです。指定されたevent は一般的なイベント・オブジェクトで、そのタイプによっては適切なクラスにキャストする必要があります。

QEvent::type()も参照してください 。

QScrollBar *QAbstractScrollArea::horizontalScrollBar() const

水平スクロールバーを返します。

setHorizontalScrollBar()、horizontalScrollBarPolicy 、およびverticalScrollBar()も 参照。

[override virtual protected] void QAbstractScrollArea::keyPressEvent(QKeyEvent *e)

再インプリメント：QWidget::keyPressEvent(QKeyEvent *event)。

この関数は、キーが押されたときにキーイベントe で呼び出されます。この関数は、PageUp、PageDown、Up、Down、Left、Rightを処理し、その他のすべてのキー押下を無視します。

QSize QAbstractScrollArea::maximumViewportSize() const

スクロールバーに有効なスクロール範囲がないものとして、ビューポートのサイズを返します。

[override virtual] QSize QAbstractScrollArea::minimumSizeHint() const

プロパティQWidget::minimumSizeHint に対するアクセス関数を再実装しています。

[override virtual protected] void QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e)

再実装：QWidget::mouseDoubleClickEvent(QMouseEvent *event)。

このイベント・ハンドラは、viewport() ウィジェットのマウス・ダブル・クリック・イベントを受け取るために、サブクラスで再実装することができます。イベントはe で渡されます。

QWidget::mouseDoubleClickEvent()も参照してください 。

[override virtual protected] void QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)

再実装します：QWidget::mouseMoveEvent(QMouseEvent *event)。

このイベント・ハンドラは、viewport() ウィジェットのマウス移動イベントを受け取るために、サブクラスで再実装できます。イベントはe で渡されます。

QWidget::mouseMoveEvent()も参照してください 。

[override virtual protected] void QAbstractScrollArea::mousePressEvent(QMouseEvent *e)

再実装します：QWidget::mousePressEvent(QMouseEvent *event)。

このイベント・ハンドラは、viewport() ウィジェットのマウス押下イベントを受け取るために、サブクラスで再実装できます。イベントはe で渡されます。

デフォルトの実装では、デフォルトのポップアップ処理のためにQWidget::mousePressEvent() を呼び出します。

QWidget::mousePressEvent()も参照してください 。

[override virtual protected] void QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e)

再実装します：QWidget::mouseReleaseEvent(QMouseEvent *event)。

このイベント・ハンドラは、viewport() ウィジェットのマウス・リリース・イベントを受け取るために、サブクラスで再実装することができます。イベントはe で渡されます。

QWidget::mouseReleaseEvent()も参照してください 。

[override virtual protected] void QAbstractScrollArea::paintEvent(QPaintEvent *event)

再実装します：QFrame::paintEvent(QPaintEvent *)。

このイベント・ハンドラは、viewport() ウィジェットのペイント・イベント（event で渡される）を受け取るために、サブクラスで再実装することができます。

QWidget::paintEvent()も参照してください 。

[override virtual protected] void QAbstractScrollArea::resizeEvent(QResizeEvent *event)

再実装：QWidget::resizeEvent(QResizeEvent *event)。

このイベント・ハンドラは、viewport() ウィジェットのリサイズ・イベント（event で渡される）を受け取るために、サブクラスで再実装することができます。

resizeEvent()が呼び出されたとき、ビューポートはすでに新しいジオメトリを持っています：新しいサイズはQResizeEvent::size() 関数から、古いサイズはQResizeEvent::oldSize() からアクセスできます。

QWidget::resizeEvent()も参照 。

QWidgetList QAbstractScrollArea::scrollBarWidgets(Qt::Alignment alignment)

現在設定されているスクロールバーウィジェットのリストを返します。alignment は、4つの位置フラグの任意の組み合わせです。

addScrollBarWidget()も参照の こと。

[virtual protected] void QAbstractScrollArea::scrollContentsBy(int dx, int dy)

この仮想ハンドラは、スクロールバーがdx,dy によって移動され、その結果、ビューポートのコンテンツがそれに応じてスクロールされるべきときに呼び出されます。

デフォルトの実装では、単純にviewport() 全体でupdate() を呼び出します。サブクラスでは、最適化のためにこのハンドラを再実装したり、QScrollArea のように、コンテンツ・ウィジェットを移動させたりすることができます。パラメータdx とdy は、クラスがスクロールされるべき量を知るための便宜的なものです（ピクセルシフトを行う場合などに便利です）。これらの値を無視して、スクロール・バーが示す位置に直接スクロールすることもできます。

プログラム的にスクロールするためにこの関数を呼び出すのは誤りです。代わりにスクロール・バーを使用してください（たとえば、QScrollBar::setValue() を直接呼び出します）。

void QAbstractScrollArea::setCornerWidget(QWidget *widget)

2つのスクロールバーの間のコーナーにあるウィジェットをwidget に設定します。

また、スクロールバーのモードの少なくとも 1 つをAlwaysOn に設定したいと思うでしょう。

nullptr を渡すと、コーナーにウィジェットは表示されません。

以前のコーナー・ウィジェットはすべて非表示になります。

setCornerWidget()は、同じウィジェットで複数回呼び出すことができます。

ここで設定されたすべてのウィジェットは、他のコーナー・ウィジェット（またはnullptr ）を設定した後に別途ウィジェットを再保護しない限り、スクロール・エリアが破棄されるときに削除されます。

新しく設定されたウィジェットには、現在の親がないはずです。

デフォルトでは、コーナーウィジェットは存在しません。

cornerWidget(),horizontalScrollBarPolicy,horizontalScrollBarPolicyも参照してください 。

void QAbstractScrollArea::setHorizontalScrollBar(QScrollBar *scrollBar)

既存の水平スクロールバーをscrollBar で置き換え、以前のスクロールバーのスライダプロパティをすべて新しいスクロールバーに設定します。その後、以前のスクロールバーは削除されます。

QAbstractScrollArea すでにデフォルトで水平および垂直スクロールバーが提供されています。この関数を呼び出すと、デフォルトの水平スクロールバーを独自のカスタムスクロールバーに置き換えることができます。

horizontalScrollBar() およびsetVerticalScrollBar()も参照 。

void QAbstractScrollArea::setVerticalScrollBar(QScrollBar *scrollBar)

既存の垂直スクロール・バーをscrollBar で置き換え、以前のスクロール・バーのすべてのスライダ・プロパティを新しいスクロール・バーに設定します。その後、以前のスクロールバーは削除されます。

QAbstractScrollArea デフォルトでは、すでに垂直および水平スクロール・バーが提供されています。この関数を呼び出すと、デフォルトの垂直スクロールバーを独自のスクロールバーに置き換えることができます。

verticalScrollBar() およびsetHorizontalScrollBar()も参照 。

void QAbstractScrollArea::setViewport(QWidget *widget)

ビューポートを、与えられたwidget に設定する。QAbstractScrollArea は、与えられたwidget の所有権を持ちます。

widget がnullptr の場合、QAbstractScrollArea はビューポートに新しいQWidget インスタンスを割り当てます。

viewport()も参照 。

[protected] void QAbstractScrollArea::setViewportMargins(const QMargins &margins)

スクロール領域の周囲にmargins を設定します。これは、"ロックされた "行や列を持つスプレッドシートのようなアプリケーションに便利です。余白は空白のままです。使用されていない領域にウィジェットを配置します。

デフォルトではすべての余白はゼロです。

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

[protected] void QAbstractScrollArea::setViewportMargins(int left, int top, int right, int bottom)

left 、top 、right 、bottom に、スクロール領域の余白を設定します。これは "ロックされた "行や列を持つスプレッドシートのようなアプリケーションに便利です。余白は空白のままなので、未使用領域にウィジェットを配置します。

この関数はQTreeView とQTableView から頻繁に呼び出されるので、余白はQAbstractScrollArea サブクラスで実装する必要があることに注意してください。また、サブクラスがアイテムビューで使用される場合は、この関数を呼び出すべきではありません。

デフォルトでは、すべてのマージンはゼロです。

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

[virtual] void QAbstractScrollArea::setupViewport(QWidget *viewport)

このスロットは、setViewport(viewport) が呼び出された後に、QAbstractScrollArea によって呼び出されます。この関数をQAbstractScrollArea のサブクラスで再実装し、新しいviewport が使用される前に初期化します。

setViewport()も参照 。

[override virtual] QSize QAbstractScrollArea::sizeHint() const

再実装：QFrame::sizeHint() const.

スクロール領域の sizeHint プロパティを返します。サイズは、viewportSizeHint() を使用して決定され、必要に応じてスクロールバー用の余分なスペースが追加されます。

QScrollBar *QAbstractScrollArea::verticalScrollBar() const

垂直スクロールバーを返します。

setVerticalScrollBar()、verticalScrollBarPolicy 、およびhorizontalScrollBar()も参照してください 。

QWidget *QAbstractScrollArea::viewport() const

ビューポート・ウィジェットを返します。

ビューポート・ウィジェットの内容を取得するには、QScrollArea::widget() 関数を使用します。

setViewport() およびQScrollArea::widget()も参照して ください。

[virtual protected] bool QAbstractScrollArea::viewportEvent(QEvent *event)

スクロール・エリア（viewport （）ウィジェット）のメイン・イベント・ハンドラ。指定されたevent を処理し、妥当なデフォルト動作を提供するためにサブクラスから呼び出すことができます。

イベントが処理され、それ以上の処理が必要ないことをイベントシステムに示すためにtrue を返します。そうでない場合は、イベントがさらに伝播されるべきことを示すためにfalse を返します。

サブクラスでこの関数を再実装することもできますが、代わりに特殊なイベントハンドラのいずれかを使用することをお勧めします。

ビューポートイベントに特化したハンドラは以下のとおりです：paintEvent(),mousePressEvent(),mouseReleaseEvent(),mouseDoubleClickEvent(),mouseMoveEvent(),wheelEvent(),dragEnterEvent(),dragMoveEvent(),dragLeaveEvent(),dropEvent(),contextMenuEvent(),resizeEvent()。

[protected] QMargins QAbstractScrollArea::viewportMargins() const

スクロール領域のマージンを返します。デフォルトでは、マージンはすべて 0 です。

setViewportMargins()も参照ください 。

[virtual protected] QSize QAbstractScrollArea::viewportSizeHint() const

ビューポートの推奨サイズを返します。デフォルトの実装では、viewport()->sizeHint() を返します。このサイズは、スクロールバーが表示されていないビューポートのサイズであることに注意してください。

[override virtual protected] void QAbstractScrollArea::wheelEvent(QWheelEvent *e)

再実装：QWidget::wheelEvent(QWheelEvent *event)。

このイベント・ハンドラは、viewport() ウィジェットのホイール・イベントを受け取るために、サブクラスで再実装できます。イベントはe で渡されます。

QWidget::wheelEvent()も参照してください 。