ScrollableControl 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
定義支援自動捲動行為的控制項的基底類別。
public ref class ScrollableControl : System::Windows::Forms::Control
public ref class ScrollableControl : System::Windows::Forms::Control, IDisposable
public class ScrollableControl : System.Windows.Forms.Control
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class ScrollableControl : System.Windows.Forms.Control, IDisposable
public class ScrollableControl : System.Windows.Forms.Control, IDisposable
type ScrollableControl = class
inherit Control
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ScrollableControl = class
inherit Control
interface IComponent
interface IDisposable
type ScrollableControl = class
inherit Control
interface IComponent
interface IDisposable
Public Class ScrollableControl
Inherits Control
Public Class ScrollableControl
Inherits Control
Implements IDisposable
- 繼承
- 衍生
- 屬性
- 實作
備註
您通常不會直接使用 ScrollableControl 類別。 ContainerControl和 Panel 類別繼承自這個類別。
類別 ScrollableControl 可作為需要卷動之控件的基類。 若要讓控件視需要顯示滾動條,請將 AutoScroll 屬性設定為 true
,並將 屬性設定 AutoScrollMinSize 為所需的大小。 當控件的大小小於指定的最小大小,或子控件位於控件界限之外時,會顯示適當的滾動條。
開發自定義控制項以顯示滾動條來回應版面配置變更時,請設定 VScroll 和 HScroll 屬性。 如果任一滾動條不可見,請將對應的屬性設定為 false
,即使 AutoScroll 屬性設定為 true
。
您可以處理 Scroll 事件,以瞭解使用者或程式代碼何時捲動工作區。
以程式設計方式將控件新增至表單時,請使用 AutoScrollPosition 屬性將控件放在目前可檢視卷動區域內部或外部。
建構函式
ScrollableControl() |
初始化 ScrollableControl 類別的新執行個體。 |
欄位
ScrollStateAutoScrolling |
判斷 AutoScroll 屬性值。 |
ScrollStateFullDrag |
判斷使用者是否已啟用完整的視窗拖曳。 |
ScrollStateHScrollVisible |
判斷 HScroll 屬性值是否設定為 |
ScrollStateUserHasScrolled |
判斷使用者是否已捲動 ScrollableControl 控制項。 |
ScrollStateVScrollVisible |
判斷 VScroll 屬性值是否設定為 |
屬性
AccessibilityObject |
取得指定給控制項的 AccessibleObject。 (繼承來源 Control) |
AccessibleDefaultActionDescription |
取得或設定協助用戶端應用程式所使用的控制項的預設動作描述。 (繼承來源 Control) |
AccessibleDescription |
取得或設定協助工具用戶端應用程式使用之控制項的描述。 (繼承來源 Control) |
AccessibleName |
取得或設定協助工具用戶端應用程式使用的控制項名稱。 (繼承來源 Control) |
AccessibleRole |
取得或設定控制項的可存取角色。 (繼承來源 Control) |
AllowDrop |
取得或設定值,指出控制項是否能接受使用者拖放上來的資料。 (繼承來源 Control) |
Anchor |
取得或設定控制項繫結至的容器邊緣,並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
AutoScroll |
取得或設定值,指出容器是否可讓使用者捲動至任何放置在可視界限以外的控制項。 |
AutoScrollMargin |
取得或設定自動捲動邊界的大小。 |
AutoScrollMinSize |
取得或設定自動捲動大小的最小值。 |
AutoScrollOffset |
取得或設定此控制項在 ScrollControlIntoView(Control) 中要捲動到哪一個位置。 (繼承來源 Control) |
AutoScrollPosition |
取得或設定自動捲動的位置。 |
AutoSize |
這個屬性與這個類別無關。 (繼承來源 Control) |
BackColor |
取得或設定控制項的背景色彩。 (繼承來源 Control) |
BackgroundImage |
取得或設定在控制項中顯示的背景影像。 (繼承來源 Control) |
BackgroundImageLayout |
取得或設定在 ImageLayout 列舉類型中所定義的背景影像配置。 (繼承來源 Control) |
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) 模式。 (繼承來源 Control) |
DefaultMargin |
取得控制項之間的預設指定間距 (單位為像素)。 (繼承來源 Control) |
DefaultMaximumSize |
取得指定為控制項的預設大小之最大值的長度和高度 (單位為像素)。 (繼承來源 Control) |
DefaultMinimumSize |
取得指定為控制項的預設大小之最小值的長度和高度 (單位為像素)。 (繼承來源 Control) |
DefaultPadding |
取得控制項內容的預設內部間距,以像素為單位。 (繼承來源 Control) |
DefaultSize |
取得控制項的預設大小。 (繼承來源 Control) |
DesignMode |
取得值,指出 Component 目前是否處於設計模式。 (繼承來源 Component) |
DeviceDpi |
取得目前顯示控制項的顯示裝置的 DPI 值。 (繼承來源 Control) |
DisplayRectangle |
取得表示控制項之虛擬顯示區域的矩形。 |
Disposing |
取得值,指出基底 Control 類別是否正在處置的過程中。 (繼承來源 Control) |
Dock |
取得或設定停駐在其父控制項的控制項框線,並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
DockPadding |
取得控制項所有邊的停駐填補設定。 |
DoubleBuffered |
取得或設定值,指出這個控制項是否應使用次要緩衝區重繪其介面,以減少或防止重繪閃動 (Flicker)。 (繼承來源 Control) |
Enabled |
取得或設定值,指出控制項是否可回應使用者互動。 (繼承來源 Control) |
Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
Focused |
取得指示控制項是否擁有輸入焦點的值。 (繼承來源 Control) |
Font |
取得或設定控制項顯示之文字字型。 (繼承來源 Control) |
FontHeight |
取得或設定控制項字型的高度。 (繼承來源 Control) |
ForeColor |
取得或設定控制項的前景色彩。 (繼承來源 Control) |
Handle |
取得控制項要繫結的目標視窗控制代碼。 (繼承來源 Control) |
HasChildren |
取得指示控制項是否包含一或多個子控制項的值。 (繼承來源 Control) |
Height |
取得或設定控制項的高度。 (繼承來源 Control) |
HorizontalScroll |
取得與水平捲軸相關聯的特性。 |
HScroll |
取得或設定值,指出水平捲軸是否為可見的。 |
ImeMode |
取得或設定控制項的輸入法 (IME) 模式。 (繼承來源 Control) |
ImeModeBase |
取得或設定控制項的 IME 模式。 (繼承來源 Control) |
InvokeRequired |
取得一個值。這個值會指示是否由於呼叫端是在建立控制項之執行緒以外的執行緒,因此在進行控制項的方法呼叫時,應呼叫叫用 (Invoke) 方法。 (繼承來源 Control) |
IsAccessible |
取得或設定值,指出可及性應用程式是否見得到控制項。 (繼承來源 Control) |
IsAncestorSiteInDesignMode |
指出這個控件的其中一個上階是否已月臺,以及該月臺在 DesignMode 中。 這是唯讀的屬性。 (繼承來源 Control) |
IsDisposed |
取得指示控制項是否已經處置的值。 (繼承來源 Control) |
IsHandleCreated |
取得指示控制項是否有相關控制代碼的值。 (繼承來源 Control) |
IsMirrored |
取得值,指出是否左右反轉控制項。 (繼承來源 Control) |
LayoutEngine |
取得控制項之配置引擎的快取執行個體。 (繼承來源 Control) |
Left |
取得或設定控制項左邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
Location |
取得或設定對應至控制項容器左上角之控制項左上角的座標。 (繼承來源 Control) |
Margin |
取得或設定控制項之間的空格。 (繼承來源 Control) |
MaximumSize |
取得或設定 GetPreferredSize(Size) 可以指定的上限大小。 (繼承來源 Control) |
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) |
ShowFocusCues |
取得指示控制項是否應顯示焦點矩形 (Focus Rectangle) 的值。 (繼承來源 Control) |
ShowKeyboardCues |
取得值,指出使用者介面是否處於可顯示或隱藏鍵盤快速鍵的適當狀態下。 (繼承來源 Control) |
Site |
取得或設定控制項的站台。 (繼承來源 Control) |
Size |
取得或設定控制項的高度和寬度。 (繼承來源 Control) |
TabIndex |
取得或設定控制項容器中的控制項定位順序。 (繼承來源 Control) |
TabStop |
取得或設定值,指出使用者是否能使用 TAB 鍵,將焦點 (Focus) 給予這個控制項。 (繼承來源 Control) |
Tag |
取得或設定物件,其包含控制項相關資料。 (繼承來源 Control) |
Text |
取得或設定這個控制項的相關文字。 (繼承來源 Control) |
Top |
取得或設定控制項上邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
TopLevelControl |
取得沒有其他 Windows Form 父控制項的父控制項。 通常,這會是內含控制項最外層的 Form。 (繼承來源 Control) |
UseWaitCursor |
取得或設定值,指出是否將等待游標用於目前控制項和所有子控制項。 (繼承來源 Control) |
VerticalScroll |
取得與垂直捲軸相關聯的特性。 |
Visible |
取得或設定值,這個值指出是否顯示控制項及其所有子控制項。 (繼承來源 Control) |
VScroll |
取得或設定值,指出垂直捲軸是否為可見的。 |
Width |
取得或設定控制項的寬度。 (繼承來源 Control) |
WindowTarget |
這個屬性與這個類別無關。 (繼承來源 Control) |
方法
事件
AutoSizeChanged |
這個事件與這個類別無關。 (繼承來源 Control) |
BackColorChanged |
發生於 BackColor 屬性的值變更時。 (繼承來源 Control) |
BackgroundImageChanged |
發生於 BackgroundImage 屬性的值變更時。 (繼承來源 Control) |
BackgroundImageLayoutChanged |
發生於 BackgroundImageLayout 屬性變更時。 (繼承來源 Control) |
BindingContextChanged |
發生於 BindingContext 屬性的值變更時。 (繼承來源 Control) |
CausesValidationChanged |
發生於 CausesValidation 屬性的值變更時。 (繼承來源 Control) |
ChangeUICues |
發生於焦點或鍵盤使用者介面 (UI) 提示變更時。 (繼承來源 Control) |
Click |
發生於按下控制項時。 (繼承來源 Control) |
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 |
發生於按兩下控制項時。 (繼承來源 Control) |
DpiChangedAfterParent |
發生於某個控制項的父控制項或表單已變更之後,以程式設計方式變更其 DPI 設定時。 (繼承來源 Control) |
DpiChangedBeforeParent |
發生於某個控制項的父控制項或表單發生 DPI 變更事件之前,以程式設計方式變更其 DPI 設定時。 (繼承來源 Control) |
DragDrop |
發生於拖放作業完成時。 (繼承來源 Control) |
DragEnter |
發生於將物件拖曳至控制項邊框時。 (繼承來源 Control) |
DragLeave |
發生於將物件拖出控制項界限時。 (繼承來源 Control) |
DragOver |
發生於將物件拖曳至控制項邊框上方時。 (繼承來源 Control) |
EnabledChanged |
發生於 Enabled 屬性值變更時。 (繼承來源 Control) |
Enter |
發生於輸入控制項時。 (繼承來源 Control) |
FontChanged |
發生在 Font 屬性值變更時。 (繼承來源 Control) |
ForeColorChanged |
發生在 ForeColor 屬性值變更時。 (繼承來源 Control) |
GiveFeedback |
發生於拖曳作業時。 (繼承來源 Control) |
GotFocus |
發生於控制項取得焦點時。 (繼承來源 Control) |
HandleCreated |
發生於為控制項建立控制代碼時。 (繼承來源 Control) |
HandleDestroyed |
發生於終結控制項的控制代碼時。 (繼承來源 Control) |
HelpRequested |
發生於使用者要求控制項的說明時。 (繼承來源 Control) |
ImeModeChanged |
發生於 ImeMode 屬性變更時。 (繼承來源 Control) |
Invalidated |
發生於控制項的顯示需要重新繪製時。 (繼承來源 Control) |
KeyDown |
發生於按下按鍵且焦點在控制項時。 (繼承來源 Control) |
KeyPress |
發生於 控制項有焦點,並按下字元空格鍵或退格鍵時。 (繼承來源 Control) |
KeyUp |
發生於放開按鍵且焦點在控制項時。 (繼承來源 Control) |
Layout |
發生於控制項應重新調整其子控制項位置時。 (繼承來源 Control) |
Leave |
發生於輸入焦點離開控制項時。 (繼承來源 Control) |
LocationChanged |
發生於 Location 屬性值變更時。 (繼承來源 Control) |
LostFocus |
發生於控制項遺失焦點時。 (繼承來源 Control) |
MarginChanged |
發生於控制項的邊界變更時。 (繼承來源 Control) |
MouseCaptureChanged |
發生於控制項遺失滑鼠捕捉時。 (繼承來源 Control) |
MouseClick |
發生於使用滑鼠按一下控制項時。 (繼承來源 Control) |
MouseDoubleClick |
發生於以滑鼠按兩下控制項時。 (繼承來源 Control) |
MouseDown |
發生於滑鼠指標位於控制項上並按下滑鼠按鍵時。 (繼承來源 Control) |
MouseEnter |
發生於滑鼠指標進入控制項時。 (繼承來源 Control) |
MouseHover |
發生於滑鼠指標停留在控制項上時。 (繼承來源 Control) |
MouseLeave |
發生於滑鼠指標離開控制項時。 (繼承來源 Control) |
MouseMove |
發生於滑鼠指標移至控制項上時。 (繼承來源 Control) |
MouseUp |
發生於滑鼠指標位於控制項上並放開滑鼠按鍵時。 (繼承來源 Control) |
MouseWheel |
發生於滑鼠滾輪移動且焦點在控制項時。 (繼承來源 Control) |
Move |
發生於控制項移動時。 (繼承來源 Control) |
PaddingChanged |
發生於控制項的邊框間距變更時。 (繼承來源 Control) |
Paint |
發生於重繪控制項時。 (繼承來源 Control) |
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 屬性值變更時。 (繼承來源 Control) |
Validated |
發生於控制項完成驗證時。 (繼承來源 Control) |
Validating |
發生於驗證控制項時。 (繼承來源 Control) |
VisibleChanged |
發生在 Visible 屬性值變更時。 (繼承來源 Control) |
明確介面實作
IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |