ScrollBar クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
スクロール バー コントロールの基本的な機能を実装します。
public ref class ScrollBar abstract : System::Windows::Forms::Controlpublic abstract class ScrollBar : System.Windows.Forms.Control[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class ScrollBar : System.Windows.Forms.Controltype ScrollBar = class
inherit Control[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ScrollBar = class
inherit ControlPublic MustInherit Class ScrollBar
Inherits Control- 継承
- 派生
- 属性
例
次の例では、 VScrollBar を作成して初期化し、 Formに追加します。
private:
void InitializeMyScrollBar()
{
// Create and initialize a VScrollBar.
VScrollBar^ vScrollBar1 = gcnew VScrollBar;
// Dock the scroll bar to the right side of the form.
vScrollBar1->Dock = DockStyle::Right;
// Add the scroll bar to the form.
Controls->Add( vScrollBar1 );
}
private void InitializeMyScrollBar()
{
// Create and initialize a VScrollBar.
VScrollBar vScrollBar1 = new VScrollBar();
// Dock the scroll bar to the right side of the form.
vScrollBar1.Dock = DockStyle.Right;
// Add the scroll bar to the form.
Controls.Add(vScrollBar1);
}
Private Sub InitializeMyScrollBar()
' Create and initialize a VScrollBar.
Dim vScrollBar1 As New VScrollBar()
' Dock the scroll bar to the right side of the form.
vScrollBar1.Dock = DockStyle.Right
' Add the scroll bar to the form.
Controls.Add(vScrollBar1)
End Sub
注釈
通常、 ScrollBar クラスから直接継承することはありません。 独自のスクロール バー クラスを作成するには、 VScrollBar または HScrollBar クラスから継承します。
Note
スクロール ボックスは、スクロールサムと呼ばれることもあります。
スクロール バー コントロールの値範囲を調整するには、 Minimum プロパティと Maximum プロパティを設定します。 スクロール ボックスの移動距離を調整するには、 SmallChange プロパティと LargeChange プロパティを設定します。 スクロール ボックスの開始点を調整するには、コントロールが最初に表示されるときに Value プロパティを設定します。
ユーザー インターフェイスのガイドラインでは、 SmallChange プロパティと LargeChange プロパティは、見えない部分を含む合計サイズではなく、ユーザーに表示されるビューのサイズに対して相対的に設定されることをお勧めします。 たとえば、大きな画像を表示するスクロール バーがある画像ボックスがある場合、 SmallChange プロパティと LargeChange プロパティは、画像のサイズではなく、画像ボックスのサイズに対して相対的に設定する必要があります。
コンストラクター
| 名前 | 説明 |
|---|---|
| ScrollBar() |
ScrollBar クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| AccessibilityObject |
コントロールに割り当てられた AccessibleObject を取得します。 (継承元 Control) |
| AccessibleDefaultActionDescription |
アクセシビリティ クライアント アプリケーションで使用するコントロールの既定のアクションの説明を取得または設定します。 (継承元 Control) |
| AccessibleDescription |
アクセシビリティ クライアント アプリケーションで使用されるコントロールの説明を取得または設定します。 (継承元 Control) |
| AccessibleName |
アクセシビリティ クライアント アプリケーションで使用されるコントロールの名前を取得または設定します。 (継承元 Control) |
| AccessibleRole |
コントロールのアクセス可能なロールを取得または設定します。 (継承元 Control) |
| AllowDrop |
ユーザーがドラッグしたデータをコントロールが受け入れられるかどうかを示す値を取得または設定します。 (継承元 Control) |
| Anchor |
コントロールがバインドされるコンテナーの端を取得または設定し、コントロールのサイズを親と共に変更する方法を決定します。 (継承元 Control) |
| AutoScrollOffset |
ScrollControlIntoView(Control)でこのコントロールをスクロールする場所を取得または設定します。 (継承元 Control) |
| AutoSize |
ScrollBarがコンテンツに合わせて自動的にサイズ変更されるかどうかを示す値を取得または設定します。 |
| BackColor |
コントロールの背景色を取得または設定します。 |
| BackgroundImage |
コントロールに表示される背景イメージを取得または設定します。 |
| BackgroundImageLayout |
ImageLayout列挙体で定義されている背景画像のレイアウトを取得または設定します。 |
| BindingContext |
コントロールの BindingContext を取得または設定します。 (継承元 Control) |
| Bottom |
コントロールの下端とコンテナーのクライアント領域の上端との間の距離をピクセル単位で取得します。 (継承元 Control) |
| Bounds |
親コントロールに対する非クライアント要素を含むコントロールのサイズと位置をピクセル単位で取得または設定します。 (継承元 Control) |
| CanEnableIme |
IME サポートを有効にするために、 ImeMode プロパティをアクティブな値に設定できるかどうかを示す値を取得します。 (継承元 Control) |
| CanFocus |
コントロールがフォーカスを受け取ることができるかどうかを示す値を取得します。 (継承元 Control) |
| CanRaiseEvents |
コントロールでイベントを発生できるかどうかを判断します。 (継承元 Control) |
| CanSelect |
コントロールを選択できるかどうかを示す値を取得します。 (継承元 Control) |
| Capture |
コントロールがマウスをキャプチャしたかどうかを示す値を取得または設定します。 (継承元 Control) |
| CausesValidation |
コントロールがフォーカスを受け取ったときに検証を必要とするコントロールに対して検証を実行するかどうかを示す値を取得または設定します。 (継承元 Control) |
| ClientRectangle |
コントロールのクライアント領域を表す四角形を取得します。 (継承元 Control) |
| ClientSize |
コントロールのクライアント領域の高さと幅を取得または設定します。 (継承元 Control) |
| CompanyName |
コントロールを含むアプリケーションの会社または作成者の名前を取得します。 (継承元 Control) |
| Container |
IContainerを含むComponentを取得します。 (継承元 Component) |
| ContainsFocus |
コントロールまたはその子コントロールの 1 つが現在入力フォーカスを持っているかどうかを示す値を取得します。 (継承元 Control) |
| ContextMenu |
コントロールに関連付けられているショートカット メニューを取得または設定します。 (継承元 Control) |
| ContextMenuStrip |
このコントロールに関連付けられている ContextMenuStrip を取得または設定します。 (継承元 Control) |
| Controls |
コントロール内に含まれるコントロールのコレクションを取得します。 (継承元 Control) |
| Created |
コントロールが作成されたかどうかを示す値を取得します。 (継承元 Control) |
| CreateParams |
コントロール ハンドルの作成時に必要な作成パラメーターを取得します。 |
| Cursor |
マウス ポインターがコントロールの上にあるときに表示されるカーソルを取得または設定します。 (継承元 Control) |
| DataBindings |
コントロールのデータ バインディングを取得します。 (継承元 Control) |
| DefaultCursor |
コントロールの既定のカーソルを取得または設定します。 (継承元 Control) |
| DefaultImeMode |
このコントロールでサポートされている既定の入力メソッド エディター (IME) モードを取得します。 |
| DefaultMargin |
ScrollBar コントロールのエッジとその内容の間の既定の距離を取得します。 |
| DefaultMaximumSize |
コントロールの既定の最大サイズとして指定されている長さと高さをピクセル単位で取得します。 (継承元 Control) |
| DefaultMinimumSize |
コントロールの既定の最小サイズとして指定されている長さと高さをピクセル単位で取得します。 (継承元 Control) |
| DefaultPadding |
コントロールの内容の既定の内部間隔 (ピクセル単位) を取得します。 (継承元 Control) |
| DefaultSize |
コントロールの既定のサイズを取得します。 (継承元 Control) |
| DesignMode |
Componentが現在デザイン モードであるかどうかを示す値を取得します。 (継承元 Component) |
| DeviceDpi |
コントロールが現在表示されているディスプレイ デバイスの DPI 値を取得します。 (継承元 Control) |
| DisplayRectangle |
コントロールの表示領域を表す四角形を取得します。 (継承元 Control) |
| Disposing |
基底 Control クラスが破棄中かどうかを示す値を取得します。 (継承元 Control) |
| Dock |
親コントロールにドッキングされるコントロールの境界線を取得または設定し、コントロールのサイズを親コントロールと共に変更する方法を決定します。 (継承元 Control) |
| DoubleBuffered |
ちらつきを減らすか防止するために、このコントロールがセカンダリ バッファーを使用してそのサーフェスを再描画する必要があるかどうかを示す値を取得または設定します。 (継承元 Control) |
| Enabled |
コントロールがユーザーの操作に応答できるかどうかを示す値を取得または設定します。 (継承元 Control) |
| Events |
この Componentにアタッチされているイベント ハンドラーの一覧を取得します。 (継承元 Component) |
| Focused |
コントロールに入力フォーカスがあるかどうかを示す値を取得します。 (継承元 Control) |
| Font |
コントロールによって表示されるテキストのフォントを取得または設定します。 |
| FontHeight |
コントロールのフォントの高さを取得または設定します。 (継承元 Control) |
| ForeColor |
スクロール バー コントロールの前景色を取得または設定します。 |
| Handle |
コントロールがバインドされているウィンドウ ハンドルを取得します。 (継承元 Control) |
| HasChildren |
コントロールに 1 つ以上の子コントロールが含まれているかどうかを示す値を取得します。 (継承元 Control) |
| Height |
コントロールの高さを取得または設定します。 (継承元 Control) |
| ImeMode |
このコントロールでサポートされている入力メソッド エディター (IME) モードを取得または設定します。 |
| ImeModeBase |
コントロールの IME モードを取得または設定します。 (継承元 Control) |
| InvokeRequired |
呼び出し元がコントロールを作成したスレッドとは異なるスレッド上にあるため、呼び出し元がコントロールへのメソッド呼び出しを行うときに呼び出し元が呼び出しメソッドを呼び出す必要があるかどうかを示す値を取得します。 (継承元 Control) |
| IsAccessible |
コントロールがアクセシビリティ アプリケーションに表示されるかどうかを示す値を取得または設定します。 (継承元 Control) |
| IsDisposed |
コントロールが破棄されたかどうかを示す値を取得します。 (継承元 Control) |
| IsHandleCreated |
コントロールにハンドルが関連付けられているかどうかを示す値を取得します。 (継承元 Control) |
| IsMirrored |
コントロールがミラー化されているかどうかを示す値を取得します。 (継承元 Control) |
| LargeChange |
スクロール ボックスが大きな距離に移動したときに、 Value プロパティに追加または減算する値を取得または設定します。 |
| LayoutEngine |
コントロールのレイアウト エンジンのキャッシュされたインスタンスを取得します。 (継承元 Control) |
| Left |
コントロールの左端からコンテナーのクライアント領域の左端までの距離をピクセル単位で取得または設定します。 (継承元 Control) |
| Location |
コンテナーの左上隅を基準としたコントロールの左上隅の座標を取得または設定します。 (継承元 Control) |
| Margin |
コントロール間のスペースを取得または設定します。 (継承元 Control) |
| Maximum |
スクロール可能範囲の値の上限を取得または設定します。 |
| MaximumSize |
GetPreferredSize(Size)が指定できる上限であるサイズを取得または設定します。 (継承元 Control) |
| Minimum |
スクロール可能範囲の値の下限を取得または設定します。 |
| MinimumSize |
GetPreferredSize(Size)が指定できる下限のサイズを取得または設定します。 (継承元 Control) |
| Name |
コントロールの名前を取得または設定します。 (継承元 Control) |
| Padding |
コントロール内のパディングを取得または設定します。 (継承元 Control) |
| Parent |
コントロールの親コンテナーを取得または設定します。 (継承元 Control) |
| PreferredSize |
コントロールが収まる四角形領域のサイズを取得します。 (継承元 Control) |
| ProductName |
コントロールを含むアセンブリの製品名を取得します。 (継承元 Control) |
| ProductVersion |
コントロールを含むアセンブリのバージョンを取得します。 (継承元 Control) |
| RecreatingHandle |
コントロールがハンドルを現在再作成しているかどうかを示す値を取得します。 (継承元 Control) |
| Region |
コントロールに関連付けられているウィンドウ領域を取得または設定します。 (継承元 Control) |
| RenderRightToLeft |
古い.
このプロパティは廃止されました。 (継承元 Control) |
| ResizeRedraw |
サイズ変更時にコントロール自体を再描画するかどうかを示す値を取得または設定します。 (継承元 Control) |
| Right |
コントロールの右端とコンテナーのクライアント領域の左端との間の距離 (ピクセル単位) を取得します。 (継承元 Control) |
| RightToLeft |
右から左へのフォントを使用してロケールをサポートするようにコントロールの要素を配置するかどうかを示す値を取得または設定します。 (継承元 Control) |
| ScaleChildren |
子コントロールのスケーリングを決定する値を取得します。 (継承元 Control) |
| ScaleScrollBarForDpiChange |
ウィンドウの DPI に従ってスクロール バーを拡大縮小するフラグを取得または設定します。 |
| ShowFocusCues |
コントロールにフォーカスの四角形を表示するかどうかを示す値を取得します。 (継承元 Control) |
| ShowKeyboardCues |
キーボード アクセラレータの表示と非表示を切り替えるために、ユーザー インターフェイスが適切な状態であるかどうかを示す値を取得します。 (継承元 Control) |
| Site |
コントロールのサイトを取得または設定します。 (継承元 Control) |
| Size |
コントロールの高さと幅を取得または設定します。 (継承元 Control) |
| SmallChange |
スクロール ボックスが小さい距離に移動したときに、 Value プロパティに追加または減算する値を取得または設定します。 |
| TabIndex |
コンテナー内のコントロールのタブ オーダーを取得または設定します。 (継承元 Control) |
| TabStop |
Tab キーを使用して、ユーザーが ScrollBar コントロールにフォーカスを与えることができるかどうかを示す値を取得または設定します。 |
| Tag |
コントロールに関するデータを含むオブジェクトを取得または設定します。 (継承元 Control) |
| Text |
このコントロールに関連付けられているテキストを取得または設定します。 |
| Top |
コントロールの上端とそのコンテナーのクライアント領域の上端との間の距離をピクセル単位で取得または設定します。 (継承元 Control) |
| TopLevelControl |
別のWindows フォーム コントロールによって親にされていない親コントロールを取得します。 通常、これはコントロールが含まれている最も外側の Form です。 (継承元 Control) |
| UseWaitCursor |
現在のコントロールとすべての子コントロールに対して待機カーソルを使用するかどうかを示す値を取得または設定します。 (継承元 Control) |
| Value |
スクロール バー コントロールのスクロール ボックスの現在位置を表す数値を取得または設定します。 |
| Visible |
コントロールとそのすべての子コントロールを表示するかどうかを示す値を取得または設定します。 (継承元 Control) |
| Width |
コントロールの幅を取得または設定します。 (継承元 Control) |
| WindowTarget |
このプロパティは、このクラスには関係ありません。 (継承元 Control) |
メソッド
イベント
| 名前 | 説明 |
|---|---|
| AutoSizeChanged |
AutoSize プロパティの値が変化したときに発生します。 |
| BackColorChanged |
BackColor プロパティの値が変化したときに発生します。 |
| BackgroundImageChanged |
BackgroundImage プロパティの値が変化したときに発生します。 |
| BackgroundImageLayoutChanged |
BackgroundImageLayout プロパティの値が変化したときに発生します。 |
| BindingContextChanged |
BindingContext プロパティの値が変化したときに発生します。 (継承元 Control) |
| CausesValidationChanged |
CausesValidation プロパティの値が変化したときに発生します。 (継承元 Control) |
| ChangeUICues |
フォーカスまたはキーボード のユーザー インターフェイス (UI) キューが変更されたときに発生します。 (継承元 Control) |
| Click |
StandardClick ビット フラグが派生クラスで |
| ClientSizeChanged |
ClientSize プロパティの値が変化したときに発生します。 (継承元 Control) |
| ContextMenuChanged |
ContextMenu プロパティの値が変化したときに発生します。 (継承元 Control) |
| ContextMenuStripChanged |
ContextMenuStrip プロパティの値が変化したときに発生します。 (継承元 Control) |
| ControlAdded |
新しいコントロールが Control.ControlCollectionに追加されたときに発生します。 (継承元 Control) |
| ControlRemoved |
コントロールが Control.ControlCollectionから削除されたときに発生します。 (継承元 Control) |
| CursorChanged |
Cursor プロパティの値が変化したときに発生します。 (継承元 Control) |
| Disposed |
コンポーネントが Dispose() メソッドの呼び出しによって破棄されるときに発生します。 (継承元 Component) |
| DockChanged |
Dock プロパティの値が変化したときに発生します。 (継承元 Control) |
| DoubleClick |
ScrollBar コントロールがダブルクリックされたときに発生します。 |
| DpiChangedAfterParent |
親コントロールまたはフォームの DPI が変更された後に、コントロールの DPI 設定がプログラムによって変更されたときに発生します。 (継承元 Control) |
| DpiChangedBeforeParent |
親コントロールまたはフォームの DPI 変更イベントが発生する前に、コントロールの DPI 設定がプログラムによって変更されたときに発生します。 (継承元 Control) |
| DragDrop |
ドラッグ アンド ドロップ操作が完了したときに発生します。 (継承元 Control) |
| DragEnter |
オブジェクトがコントロールの境界にドラッグされたときに発生します。 (継承元 Control) |
| DragLeave |
オブジェクトがコントロールの境界からドラッグされたときに発生します。 (継承元 Control) |
| DragOver |
オブジェクトがコントロールの境界上にドラッグされたときに発生します。 (継承元 Control) |
| EnabledChanged |
Enabled プロパティ値が変更されたときに発生します。 (継承元 Control) |
| Enter |
コントロールが入力されたときに発生します。 (継承元 Control) |
| FontChanged |
Font プロパティの値が変化したときに発生します。 |
| ForeColorChanged |
ForeColor プロパティの値が変化したときに発生します。 |
| GiveFeedback |
ドラッグ操作中に発生します。 (継承元 Control) |
| GotFocus |
コントロールがフォーカスを受け取ったときに発生します。 (継承元 Control) |
| HandleCreated |
コントロールのハンドルが作成されたときに発生します。 (継承元 Control) |
| HandleDestroyed |
コントロールのハンドルが破棄処理中に発生します。 (継承元 Control) |
| HelpRequested |
ユーザーがコントロールのヘルプを要求したときに発生します。 (継承元 Control) |
| ImeModeChanged |
ImeMode プロパティの値が変化したときに発生します。 |
| Invalidated |
コントロールの表示に再描画が必要な場合に発生します。 (継承元 Control) |
| KeyDown |
コントロールにフォーカスがあるときにキーが押されたときに発生します。 (継承元 Control) |
| KeyPress |
コントロールにフォーカスがあるときに文字、スペース、またはバックスペース キーが押されたときに発生します。 (継承元 Control) |
| KeyUp |
コントロールにフォーカスがあるときにキーが離されたときに発生します。 (継承元 Control) |
| Layout |
コントロールの子コントロールの位置を変更する必要があるときに発生します。 (継承元 Control) |
| Leave |
入力フォーカスがコントロールから離れると発生します。 (継承元 Control) |
| LocationChanged |
Location プロパティ値が変更されたときに発生します。 (継承元 Control) |
| LostFocus |
コントロールがフォーカスを失ったときに発生します。 (継承元 Control) |
| MarginChanged |
コントロールの余白が変更されたときに発生します。 (継承元 Control) |
| MouseCaptureChanged |
コントロールがマウス キャプチャを失ったときに発生します。 (継承元 Control) |
| MouseClick |
ユーザーがマウスで ScrollBar コントロールをクリックしたときに発生します。 |
| MouseDoubleClick |
ユーザーがマウスで ScrollBar コントロールをダブルクリックしたときに発生します。 |
| MouseDown |
マウス ポインターがコントロールの上にあり、ユーザーがマウス ボタンを押したときに発生します。 |
| MouseEnter |
マウス ポインターがコントロールに入ったときに発生します。 (継承元 Control) |
| MouseHover |
マウス ポインターがコントロール上にあるときに発生します。 (継承元 Control) |
| MouseLeave |
マウス ポインターがコントロールから離れると発生します。 (継承元 Control) |
| MouseMove |
ユーザーがマウス ポインターをコントロールの上に移動したときに発生します。 |
| MouseUp |
ユーザーがマウス ポインターをコントロールの上に移動し、マウス ボタンを離したときに発生します。 |
| MouseWheel |
コントロールにフォーカスがあるときにマウス ホイールが移動したときに発生します。 (継承元 Control) |
| Move |
コントロールが移動されたときに発生します。 (継承元 Control) |
| PaddingChanged |
コントロールのパディングが変更されたときに発生します。 (継承元 Control) |
| Paint |
コントロールが再描画されたときに発生します。 |
| ParentChanged |
Parent プロパティ値が変更されたときに発生します。 (継承元 Control) |
| PreviewKeyDown |
フォーカスがこのコントロールにある間にキーが押されたときに、 KeyDown イベントの前に発生します。 (継承元 Control) |
| QueryAccessibilityHelp |
AccessibleObjectがアクセシビリティ アプリケーションにヘルプを提供しているときに発生します。 (継承元 Control) |
| QueryContinueDrag |
ドラッグ アンド ドロップ操作中に発生し、ドラッグ ソースがドラッグ アンド ドロップ操作を取り消す必要があるかどうかを判断できるようにします。 (継承元 Control) |
| RegionChanged |
Region プロパティの値が変化したときに発生します。 (継承元 Control) |
| Resize |
コントロールのサイズが変更されたときに発生します。 (継承元 Control) |
| RightToLeftChanged |
RightToLeft プロパティ値が変更されたときに発生します。 (継承元 Control) |
| Scroll |
マウスまたはキーボードの操作によってスクロール ボックスが移動されたときに発生します。 |
| SizeChanged |
Size プロパティ値が変更されたときに発生します。 (継承元 Control) |
| StyleChanged |
コントロール スタイルが変更されたときに発生します。 (継承元 Control) |
| SystemColorsChanged |
システムの色が変更されたときに発生します。 (継承元 Control) |
| TabIndexChanged |
TabIndex プロパティ値が変更されたときに発生します。 (継承元 Control) |
| TabStopChanged |
TabStop プロパティ値が変更されたときに発生します。 (継承元 Control) |
| TextChanged |
Text プロパティの値が変化したときに発生します。 |
| Validated |
コントロールの検証が完了したときに発生します。 (継承元 Control) |
| Validating |
コントロールが検証中に発生します。 (継承元 Control) |
| ValueChanged | |
| VisibleChanged |
Visible プロパティ値が変更されたときに発生します。 (継承元 Control) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
DragDrop イベントを発生させます。 (継承元 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
DragEnter イベントを発生させます。 (継承元 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
DragLeave イベントを発生させます。 (継承元 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
DragOver イベントを発生させます。 (継承元 Control) |