HScrollBar 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示標準 Windows 水平捲軸。
public ref class HScrollBar : System::Windows::Forms::ScrollBarpublic class HScrollBar : System.Windows.Forms.ScrollBar[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class HScrollBar : System.Windows.Forms.ScrollBartype HScrollBar = class
inherit ScrollBar[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type HScrollBar = class
inherit ScrollBarPublic Class HScrollBar
Inherits ScrollBar- 繼承
- 屬性
範例
下列範例會建立 並初始化 ， HScrollBar 並將加入至 Form。
private:
void InitializeMyScrollBar()
{
// Create and initialize an HScrollBar.
HScrollBar^ hScrollBar1 = gcnew HScrollBar;
// Dock the scroll bar to the bottom of the form.
hScrollBar1->Dock = DockStyle::Bottom;
// Add the scroll bar to the form.
Controls->Add( hScrollBar1 );
}
private void InitializeMyScrollBar()
{
// Create and initialize an HScrollBar.
HScrollBar hScrollBar1 = new HScrollBar();
// Dock the scroll bar to the bottom of the form.
hScrollBar1.Dock = DockStyle.Bottom;
// Add the scroll bar to the form.
Controls.Add(hScrollBar1);
}
Private Sub InitializeMyScrollBar()
' Create and initialize an HScrollBar.
Dim hScrollBar1 As New HScrollBar()
' Dock the scroll bar to the bottom of the form.
hScrollBar1.Dock = DockStyle.Bottom
' Add the scroll bar to the form.
Controls.Add(hScrollBar1)
End Sub
備註
大部分需要滾動條的控件都已經提供它們，而且不需要此控件。 例如，多行 TextBox 控件、 ListBox、 和 也是如此 ComboBox。
您可以使用此控件，在未提供自己的滾動條的容器中實作捲動，例如 PictureBox 或 用於使用者輸入數值數據。 數值數據可以顯示在控件中，或用於程式代碼中。 Minimum和 Maximum 屬性會決定使用者可以選取的值範圍。 屬性 LargeChange 會決定在滾動條內，但在滾動盒外按兩下的效果。 屬性 SmallChange 會決定單擊控件每一端滾動箭頭的效果。
建構函式
| HScrollBar() |
初始化 HScrollBar 類別的新執行個體。 |
屬性
| AccessibilityObject |
取得指定給控制項的 AccessibleObject。 (繼承來源 Control) |
| AccessibleDefaultActionDescription |
取得或設定協助用戶端應用程式所使用的控制項的預設動作描述。 (繼承來源 Control) |
| AccessibleDescription |
取得或設定協助工具用戶端應用程式使用之控制項的描述。 (繼承來源 Control) |
| AccessibleName |
取得或設定協助工具用戶端應用程式使用的控制項名稱。 (繼承來源 Control) |
| AccessibleRole |
取得或設定控制項的可存取角色。 (繼承來源 Control) |
| AllowDrop |
取得或設定值，指出控制項是否能接受使用者拖放上來的資料。 (繼承來源 Control) |
| Anchor |
取得或設定控制項繫結至的容器邊緣，並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
| AutoScrollOffset |
取得或設定此控制項在 ScrollControlIntoView(Control) 中要捲動到哪一個位置。 (繼承來源 Control) |
| AutoSize |
取得或設定值，指出是否自動調整 ScrollBar 的大小，以容納其內容。 (繼承來源 ScrollBar) |
| BackColor |
取得或設定控制項的背景色彩。 (繼承來源 ScrollBar) |
| BackgroundImage |
取得或設定在控制項中顯示的背景影像。 (繼承來源 ScrollBar) |
| BackgroundImageLayout |
取得或設定在 ImageLayout 列舉類型中所定義的背景影像配置。 (繼承來源 ScrollBar) |
| BindingContext |
取得或設定控制項的 BindingContext。 (繼承來源 Control) |
| Bottom |
取得控制項下邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 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 |
取得控制項的資料繫結 (Data Binding)。 (繼承來源 Control) |
| DataContext |
取得或設定數據系結用途的數據內容。 這是環境屬性。 (繼承來源 Control) |
| DefaultCursor |
取得或設定控制項的預設游標。 (繼承來源 Control) |
| DefaultImeMode |
取得這個控制項所支援的預設輸入法 (IME) 模式。 (繼承來源 ScrollBar) |
| DefaultMargin |
取得 ScrollBar 控制項邊緣與其內容間的預設距離。 (繼承來源 ScrollBar) |
| DefaultMaximumSize |
取得指定為控制項的預設大小之最大值的長度和高度 (單位為像素)。 (繼承來源 Control) |
| DefaultMinimumSize |
取得指定為控制項的預設大小之最小值的長度和高度 (單位為像素)。 (繼承來源 Control) |
| DefaultPadding |
取得控制項內容的預設內部間距，以像素為單位。 (繼承來源 Control) |
| DefaultSize |
取得控制項的預設大小。 |
| DesignMode |
取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component) |
| DeviceDpi |
取得目前顯示控制項的顯示裝置的 DPI 值。 (繼承來源 Control) |
| DisplayRectangle |
取得表示控制項顯示區域的矩形。 (繼承來源 Control) |
| Disposing |
取得值，指出基底 Control 類別是否正在處置的過程中。 (繼承來源 Control) |
| Dock |
取得或設定停駐在其父控制項的控制項框線，並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
| DoubleBuffered |
取得或設定值，指出這個控制項是否應使用次要緩衝區重繪其介面，以減少或防止重繪閃動 (Flicker)。 (繼承來源 Control) |
| Enabled |
取得或設定值，指出控制項是否可回應使用者互動。 (繼承來源 Control) |
| Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
| Focused |
取得指示控制項是否擁有輸入焦點的值。 (繼承來源 Control) |
| Font |
取得或設定控制項顯示之文字字型。 (繼承來源 ScrollBar) |
| FontHeight |
取得或設定控制項字型的高度。 (繼承來源 Control) |
| ForeColor |
取得或設定捲軸控制項的前景色彩。 (繼承來源 ScrollBar) |
| Handle |
取得控制項要繫結的目標視窗控制代碼。 (繼承來源 Control) |
| HasChildren |
取得指示控制項是否包含一或多個子控制項的值。 (繼承來源 Control) |
| Height |
取得或設定控制項的高度。 (繼承來源 Control) |
| ImeMode |
取得或設定這個控制項支援的輸入法 (IME) 模式。 (繼承來源 ScrollBar) |
| ImeModeBase |
取得或設定控制項的 IME 模式。 (繼承來源 Control) |
| InvokeRequired |
取得一個值。這個值會指示是否由於呼叫端是在建立控制項之執行緒以外的執行緒，因此在進行控制項的方法呼叫時，應呼叫叫用 (Invoke) 方法。 (繼承來源 Control) |
| IsAccessible |
取得或設定值，指出可及性應用程式是否見得到控制項。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
指出這個控件的其中一個上階是否已月臺，以及該月臺在 DesignMode 中。 這是唯讀的屬性。 (繼承來源 Control) |
| IsDisposed |
取得指示控制項是否已經處置的值。 (繼承來源 Control) |
| IsHandleCreated |
取得指示控制項是否有相關控制代碼的值。 (繼承來源 Control) |
| IsMirrored |
取得值，指出是否左右反轉控制項。 (繼承來源 Control) |
| LargeChange |
取得或設定當捲動方塊大距離移動時，會從 Value 屬性加或減的值。 (繼承來源 ScrollBar) |
| LayoutEngine |
取得控制項之配置引擎的快取執行個體。 (繼承來源 Control) |
| Left |
取得或設定控制項左邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| Location |
取得或設定對應至控制項容器左上角之控制項左上角的座標。 (繼承來源 Control) |
| Margin |
取得或設定控制項之間的空格。 (繼承來源 Control) |
| Maximum |
取得或設定可捲動範圍的上限值。 (繼承來源 ScrollBar) |
| MaximumSize |
取得或設定 GetPreferredSize(Size) 可以指定的上限大小。 (繼承來源 Control) |
| Minimum |
取得或設定可捲動範圍的下限值。 (繼承來源 ScrollBar) |
| 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 |
取得控制項右邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| RightToLeft |
取得或設定值，指出控制項的項目是否對齊，以支援使用由右至左字型的地區設定。 (繼承來源 Control) |
| ScaleChildren |
取得值，以判斷子控制項的縮放。 (繼承來源 Control) |
| ScaleScrollBarForDpiChange |
取得或設定旗標，讓捲軸根據視窗的 DPI 進行縮放。 (繼承來源 ScrollBar) |
| ShowFocusCues |
取得指示控制項是否應顯示焦點矩形 (Focus Rectangle) 的值。 (繼承來源 Control) |
| ShowKeyboardCues |
取得值，指出使用者介面是否處於可顯示或隱藏鍵盤快速鍵的適當狀態下。 (繼承來源 Control) |
| Site |
取得或設定控制項的站台。 (繼承來源 Control) |
| Size |
取得或設定控制項的高度和寬度。 (繼承來源 Control) |
| SmallChange |
取得或設定當捲動方塊小距離移動時，會加入或從 Value 屬性減少的數值。 (繼承來源 ScrollBar) |
| TabIndex |
取得或設定控制項容器中的控制項定位順序。 (繼承來源 Control) |
| TabStop |
取得或設定值，指出使用者是否可使用 TAB 鍵，將焦點 (Focus) 給予 ScrollBar 控制項。 (繼承來源 ScrollBar) |
| Tag |
取得或設定物件，其包含控制項相關資料。 (繼承來源 Control) |
| Text |
取得或設定這個控制項的相關文字。 (繼承來源 ScrollBar) |
| Top |
取得或設定控制項上邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| TopLevelControl |
取得沒有其他 Windows Form 父控制項的父控制項。 通常，這會是內含控制項最外層的 Form。 (繼承來源 Control) |
| UseWaitCursor |
取得或設定值，指出是否將等待游標用於目前控制項和所有子控制項。 (繼承來源 Control) |
| Value |
取得或設定表示捲軸控制項上的捲動方塊目前位置的數值。 (繼承來源 ScrollBar) |
| Visible |
取得或設定值，這個值指出是否顯示控制項及其所有子控制項。 (繼承來源 Control) |
| Width |
取得或設定控制項的寬度。 (繼承來源 Control) |
| WindowTarget |
這個屬性與這個類別無關。 (繼承來源 Control) |
方法
事件
| AutoSizeChanged |
發生於 AutoSize 屬性的值變更時。 (繼承來源 ScrollBar) |
| BackColorChanged |
發生於 BackColor 屬性的值變更時。 (繼承來源 ScrollBar) |
| BackgroundImageChanged |
發生於 BackgroundImage 屬性的值變更時。 (繼承來源 ScrollBar) |
| BackgroundImageLayoutChanged |
發生於 BackgroundImageLayout 屬性的值變更時。 (繼承來源 ScrollBar) |
| 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 控制項時。 (繼承來源 ScrollBar) |
| DpiChangedAfterParent |
發生於某個控制項的父控制項或表單已變更之後，以程式設計方式變更其 DPI 設定時。 (繼承來源 Control) |
| DpiChangedBeforeParent |
發生於某個控制項的父控制項或表單發生 DPI 變更事件之前，以程式設計方式變更其 DPI 設定時。 (繼承來源 Control) |
| DragDrop |
發生於拖放作業完成時。 (繼承來源 Control) |
| DragEnter |
發生於將物件拖曳至控制項邊框時。 (繼承來源 Control) |
| DragLeave |
發生於將物件拖出控制項界限時。 (繼承來源 Control) |
| DragOver |
發生於將物件拖曳至控制項邊框上方時。 (繼承來源 Control) |
| EnabledChanged |
發生於 Enabled 屬性值變更時。 (繼承來源 Control) |
| Enter |
發生於輸入控制項時。 (繼承來源 Control) |
| FontChanged |
發生於 Font 屬性的值變更時。 (繼承來源 ScrollBar) |
| ForeColorChanged |
發生於 ForeColor 屬性的值變更時。 (繼承來源 ScrollBar) |
| GiveFeedback |
發生於拖曳作業時。 (繼承來源 Control) |
| GotFocus |
發生於控制項取得焦點時。 (繼承來源 Control) |
| HandleCreated |
發生於為控制項建立控制代碼時。 (繼承來源 Control) |
| HandleDestroyed |
發生於終結控制項的控制代碼時。 (繼承來源 Control) |
| HelpRequested |
發生於使用者要求控制項的說明時。 (繼承來源 Control) |
| ImeModeChanged |
發生於 ImeMode 屬性的值變更時。 (繼承來源 ScrollBar) |
| Invalidated |
發生於控制項的顯示需要重新繪製時。 (繼承來源 Control) |
| KeyDown |
發生於按下按鍵且焦點在控制項時。 (繼承來源 Control) |
| KeyPress |
發生於 控制項有焦點，並按下字元空格鍵或退格鍵時。 (繼承來源 Control) |
| KeyUp |
發生於放開按鍵且焦點在控制項時。 (繼承來源 Control) |
| Layout |
發生於控制項應重新調整其子控制項位置時。 (繼承來源 Control) |
| Leave |
發生於輸入焦點離開控制項時。 (繼承來源 Control) |
| LocationChanged |
發生於 Location 屬性值變更時。 (繼承來源 Control) |
| LostFocus |
發生於控制項遺失焦點時。 (繼承來源 Control) |
| MarginChanged |
發生於控制項的邊界變更時。 (繼承來源 Control) |
| MouseCaptureChanged |
發生於控制項遺失滑鼠捕捉時。 (繼承來源 Control) |
| MouseClick |
發生於使用者用滑鼠按一下 ScrollBar 控制項時。 (繼承來源 ScrollBar) |
| MouseDoubleClick |
發生於使用者用滑鼠按兩下 ScrollBar 控制項時。 (繼承來源 ScrollBar) |
| MouseDown |
發生於滑鼠指標位於控制項上方，且使用者按下滑鼠按鍵時。 (繼承來源 ScrollBar) |
| MouseEnter |
發生於滑鼠指標進入控制項時。 (繼承來源 Control) |
| MouseHover |
發生於滑鼠指標停留在控制項上時。 (繼承來源 Control) |
| MouseLeave |
發生於滑鼠指標離開控制項時。 (繼承來源 Control) |
| MouseMove |
發生於使用者將滑鼠指標移至控制項上方時。 (繼承來源 ScrollBar) |
| MouseUp |
發生於使用者將滑鼠指標移至控制項上方，並放開滑鼠按鍵時。 (繼承來源 ScrollBar) |
| MouseWheel |
發生於滑鼠滾輪移動且焦點在控制項時。 (繼承來源 Control) |
| Move |
發生於控制項移動時。 (繼承來源 Control) |
| PaddingChanged |
發生於控制項的邊框間距變更時。 (繼承來源 Control) |
| Paint |
發生於重繪控制項時。 (繼承來源 ScrollBar) |
| ParentChanged |
發生在 Parent 屬性值變更時。 (繼承來源 Control) |
| PreviewKeyDown |
發生於焦點位於這個控制項上時並按下鍵盤按鍵的 KeyDown 事件之前。 (繼承來源 Control) |
| QueryAccessibilityHelp |
發生於 AccessibleObject 為協助工具應用程式提供說明時。 (繼承來源 Control) |
| QueryContinueDrag |
發生於拖放作業時，讓拖曳來源能夠決定是否應取消拖放作業。 (繼承來源 Control) |
| RegionChanged |
發生於 Region 屬性的值變更時。 (繼承來源 Control) |
| Resize |
發生於重設控制項大小時。 (繼承來源 Control) |
| RightToLeftChanged |
發生在 RightToLeft 屬性值變更時。 (繼承來源 Control) |
| Scroll |
發生於捲動方塊已經由滑鼠或鍵盤動作移動時。 (繼承來源 ScrollBar) |
| SizeChanged |
發生在 Size 屬性值變更時。 (繼承來源 Control) |
| StyleChanged |
發生於控制項樣式變更時。 (繼承來源 Control) |
| SystemColorsChanged |
發生於系統色彩變更時。 (繼承來源 Control) |
| TabIndexChanged |
發生在 TabIndex 屬性值變更時。 (繼承來源 Control) |
| TabStopChanged |
發生在 TabStop 屬性值變更時。 (繼承來源 Control) |
| TextChanged |
發生於 Text 屬性的值變更時。 (繼承來源 ScrollBar) |
| Validated |
發生於控制項完成驗證時。 (繼承來源 Control) |
| Validating |
發生於驗證控制項時。 (繼承來源 Control) |
| ValueChanged |
發生於使用 Value 事件或程式設計的方式來變更 Scroll 屬性時。 (繼承來源 ScrollBar) |
| VisibleChanged |
發生在 Visible 屬性值變更時。 (繼承來源 Control) |
明確介面實作
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
