QScrollBar Class

詳しい説明

スクロールバーは、ユーザがドキュメントの一部にアクセスするためのコントロールです。これは、ドキュメント内のユーザの現在位置と、ドキュメントの表示量を視覚的に示すものです。スクロールバーは通常、より正確なナビゲーションを可能にする他のコントロールを備えています。Qt では、各プラットフォームに適した方法でスクロール・バーを表示します。

他のウィジェットにスクロール・ビューを提供する必要がある場合は、QScrollArea クラスを使用する方が便利です。これは、ビューポート・ウィジェットとスクロール・バーを提供するからです。QScrollBar は、QAbstractScrollArea を使用する特殊なウィジェットに対して同様の機能を実装する必要がある場合に便利です。例えば、QAbstractItemView をサブクラス化する場合などです。スライダーコントロールが指定された範囲内の値を取得するために使用される他のほとんどの状況では、QSlider クラスの方がニーズに適しているかもしれません。

各スクロール・バーには、スライダーがスクロール・バーの開始位置からどのくらい離れているかを示す値があります。この値は、value() で取得し、setValue() で設定します。この値は常に、minimum() からmaximum() までの、スクロールバーに定義された値の範囲内にある。許容値の範囲は、setMinimum() およびsetMaximum() で設定できる。最小値では、スライダーの上端 (垂直スクロールバーの場合) または左端 (水平スクロールバーの場合) がスクロールバーの上端 (または左端) になります。最大値では、スライダーの下端（または右端）はスクロールバーの下端（または右端）になります。

スライダーの長さは通常、ページステップの値に関連しており、通常、スクロールビューで表示されるドキュメント領域の割合を表します。ページステップは、ユーザーがPage Up とPage Down キーを押したときに値が変化する量であり、setPageStep() で設定される。行ステップで定義された値に対するより小さな変更はカーソル・キーを使って行われ、この量はsetSingleStep （）で設定される。

使用される値の範囲は、スクロールバー・ウィジェットの実際のサイズとは無関係であることに注意。範囲とページステップの値を選択するときに、これを考慮する必要はない。

スライダーの長さを考慮する必要があるため、スクロールバーに指定される値の範囲は、QSlider の場合とは異なって決定されることがよくあります。100行のドキュメントがあり、ウィジェットに20行しか表示できない場合、ページステップを20、最小値を0、最大値を80とするスクロールバーを作成することができます。この場合、5つの "ページ "を持つスクロールバーになります。

ドキュメントの長さ、スクロールバーで使用する値の範囲、およびページステップの関係は、多くの一般的な状況では単純です。スクロールバーの値の範囲は、ドキュメントの長さを表す値から選択したページステップを引くことによって決まります。このような場合は、次の式が便利です:document length=maximum() -minimum() +pageStep()。

QScrollBar は整数範囲のみを提供します。QScrollBarは非常に大きな数値を扱いますが、現在の画面のスクロールバーは、約10万ピクセル以上の範囲を有用に表現できないことに注意してください。それ以上になると、ユーザーがキーボードやマウスを使ってスライダーを操作することが難しくなり、スクロール矢印の使用も制限されます。

ScrollBar はQAbstractSlider から包括的なシグナルセットを継承しています：

• valueChanged() は、スクロールバーの値が変更されたときに発行されます。tracking()は、ユーザーとの対話中にこのシグナルが発せられるかどうかを決定します。
• rangeChanged() は、スクロールバーの値の範囲が変更されたときに発せられます。
• sliderPressed() は、ユーザーがスライダーをドラッグし始めたときに発せられます。
• sliderMoved() は、ユーザーがスライダーをドラッグしたときに発せられます。
• sliderReleased() は、ユーザーがスライダーを離したときに発せられます。
• actionTriggered() は、ユーザー操作またはtriggerAction() 関数によってスクロール・バーが変更されたときに発せられます。

スクロールバーはキーボードで操作できますが、デフォルトのfocusPolicy() はQt::NoFocus です。スクロールバーでキーボード操作を有効にするにはsetFocusPolicy() を使用します：

• 左/右は、水平スクロールバーを1ステップ移動させます。
• Up/Downは、垂直スクロールバーを1ステップ移動します。
• PageUp は1ページ分上に移動します。
• PageDownは1ページ下に移動する。
• Homeは先頭（最小）に移動します。
• Endは最後（最大）に移動します。

スライダー自体は、triggerAction() 関数を使用することで、スクロールバーコントロールとのユーザーインタラクションをシミュレートして制御することができます。これは、共通の値の範囲を使用する多くの異なるウィジェットがある場合に便利です。

ほとんどのGUIスタイルでは、pageStep() の値を使用してスライダーのサイズを計算します。