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- 繼承
- 衍生
- 屬性
範例
以下範例創建並初始化 a 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 OR HScrollBar 類別。
備註
捲軸盒有時也被稱為捲軸拇指。
要調整捲動列控制的值範圍，請設定 Minimum and Maximum 屬性。 要調整滾動框移動的距離，請設定 SmallChange 和 LargeChange 屬性。 要調整滾動方塊的起始點，請在控制項初次顯示時設定屬性 Value 。
使用者介面指引建議 和 LargeChange 屬性是SmallChange相對於使用者所看到的檢視大小設定，而非以包含未顯示部分的總大小為基準。 舉例來說，如果你有一個帶有滾動條的圖片框，顯示一張大圖片， SmallChange 且屬性 LargeChange 應該是相對於圖片框的大小設定，而不是圖片的大小。
建構函式
| 名稱 | Description |
|---|---|
| ScrollBar() |
初始化 ScrollBar 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| 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 |
會取得一個值，表示該屬性是否 ImeMode 能被設定為主動值，以支援 IME。 (繼承來源 Control) |
| CanFocus |
會獲得一個值，表示控制點是否能獲得焦點。 (繼承來源 Control) |
| CanRaiseEvents |
判斷事件是否能在控制組上引發。 (繼承來源 Control) |
| CanSelect |
會得到一個值，表示是否可以選擇該控制項。 (繼承來源 Control) |
| Capture |
取得或設定一個值，表示控制器是否已捕捉該滑鼠。 (繼承來源 Control) |
| CausesValidation |
取得或設定一個值，指示該控制是否導致在收到焦點時對需要驗證的控制項進行驗證。 (繼承來源 Control) |
| ClientRectangle |
取得代表控制區客戶端區域的矩形。 (繼承來源 Control) |
| ClientSize |
取得或設定控制區客戶區域的高度與寬度。 (繼承來源 Control) |
| CompanyName |
取得包含控制權的公司名稱或應用程式的創建者名稱。 (繼承來源 Control) |
| Container |
得到 IContainer 包含 Component的 。 (繼承來源 Component) |
| ContainsFocus |
會獲得一個值，表示該控制項或其子控制項目前是否擁有輸入焦點。 (繼承來源 Control) |
| ContextMenu |
已淘汰.
取得或設定與控制鍵相關的捷徑選單。 (繼承來源 Control) |
| ContextMenuStrip |
取得或設定 ContextMenuStrip 與此控制相關聯的 (繼承來源 Control) |
| Controls |
取得控制中包含的控制項集合。 (繼承來源 Control) |
| Created |
會得到一個值，表示控制是否已被建立。 (繼承來源 Control) |
| CreateParams |
當控制句柄建立時，會取得所需的建立參數。 |
| Cursor |
當滑鼠指標位於控制器上時，會顯示或設定游標。 (繼承來源 Control) |
| DataBindings |
取得控制項的資料綁定。 (繼承來源 Control) |
| DataContext |
取得或設定資料上下文以進行資料綁定。 這是一個環境音屬性。 (繼承來源 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 |
會取得一個值，表示該控制是否包含一個或多個子控制項。 (繼承來源 Control) |
| Height |
取得或設定控制點的高度。 (繼承來源 Control) |
| ImeMode |
取得或設定此控制項所支援的輸入法編輯器（IME）模式。 |
| ImeModeBase |
取得或設定控制的 IME 模式。 (繼承來源 Control) |
| InvokeRequired |
會獲得一個值，表示呼叫者在呼叫控制項時是否必須呼叫呼叫方法，因為呼叫者使用的執行緒與該控制項建立的執行緒不同。 (繼承來源 Control) |
| IsAccessible |
取得或設定一個值，指示該控制項是否對無障礙應用程式可見。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
顯示該控制點的前祖是否被設置在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
| IsDisposed |
會有一個值，表示控制權是否已被處理掉。 (繼承來源 Control) |
| IsHandleCreated |
會得到一個值，表示該控制項是否有與其相關的 handle。 (繼承來源 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 元素是否對齊以支援使用右至左字型的區域。 (繼承來源 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 Forms 控制項保護的父控制權。 通常，這是控制所包含的最 Form 外層。 (繼承來源 Control) |
| UseWaitCursor |
取得或設定一個值，指示是否使用等待游標來控制目前的控制項及所有子控制項。 (繼承來源 Control) |
| Value |
取得或設定一個數值，代表滾動條控制中滾動框的當前位置。 |
| Visible |
取得或設定一個值，表示該控制項及其所有子控制項是否被顯示。 (繼承來源 Control) |
| Width |
設定或設定控制寬度。 (繼承來源 Control) |
| WindowTarget |
此性質對此類別無關。 (繼承來源 Control) |
方法
事件
| 名稱 | Description |
|---|---|
| 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) |
| DataContextChanged |
發生於 DataContext 屬性的值變更時。 (繼承來源 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) |
明確介面實作
| 名稱 | Description |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
