Files

1752 lines
120 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Windows Forms 标准控件属性手册(工具箱 45 条目,穷尽版)
> 生成来源:反射 .NET Framework 4.8 GAC 程序集(设计器 PropertyGrid 可见性、DefaultValue、DesignerSerializationVisibility 全量提取)。
> 序列化列:**Content 集合**=逐条目生成;不序列化=属性面板隐藏/不生成代码;非默认才写=与默认值相同则省略(SharpDevelop 序列化器行为);(RO)=只读。
## 0. 共享基类属性总表
每个控件的"继承属性"行只列名称;各基类完整属性表(含类型/默认值)在此节查一次即可。
### 基类 Control(70 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AccessibilityObject(RO) | AccessibleObject | | 不序列化 | |
| AccessibleDefaultActionDescription | String | | 不序列化 | |
| AccessibleDescription | String | | — | |
| AccessibleName | String | | — | 无障碍名称 |
| AccessibleRole | AccessibleRole | Default | 非默认才写 | 无障碍角色 |
| AllowDrop | Boolean | False | 非默认才写 | |
| Anchor | AnchorStyles | Top, Left | 非默认才写 | 默认 Top,Left 才省略 |
| AutoScrollOffset | Point | {X=0,Y=0} | 不序列化 | |
| LayoutEngine(RO) | LayoutEngine | | 不序列化 | |
| BackgroundImage | Image | | — | 背景图 |
| BackgroundImageLayout | ImageLayout | Tile | 非默认才写 | 背景图布局 |
| BindingContext | BindingContext | | 不序列化 | |
| Bottom(RO) | Int32 | | 不序列化 | |
| Bounds | Rectangle | | 不序列化 | |
| CanFocus(RO) | Boolean | | 不序列化 | |
| CanSelect(RO) | Boolean | | 不序列化 | |
| Capture | Boolean | | 不序列化 | |
| CausesValidation | Boolean | True | 非默认才写 | 默认 True 才省略 |
| ClientRectangle(RO) | Rectangle | | 不序列化 | |
| ClientSize | Size | | 不序列化 | |
| CompanyName(RO) | String | | 不序列化 | |
| ContainsFocus(RO) | Boolean | | 不序列化 | |
| ContextMenu | ContextMenu | | 不序列化 | 已过时,用 ContextMenuStrip |
| ContextMenuStrip | ContextMenuStrip | | — | |
| Controls(RO) | ControlCollection | | 不序列化 | |
| Created(RO) | Boolean | | 不序列化 | |
| Cursor | Cursor | | — | 鼠标指针 |
| DataBindings(RO) | ControlBindingsCollection | | **Content 集合** | |
| DeviceDpi(RO) | Int32 | | 不序列化 | |
| DisplayRectangle(RO) | Rectangle | | 不序列化 | |
| IsDisposed(RO) | Boolean | | 不序列化 | |
| Disposing(RO) | Boolean | | 不序列化 | |
| Dock | DockStyle | None | 非默认才写 | Fill/Top/Bottom/Left/Right,默认 None 才省略 |
| Enabled | Boolean | | — | 禁用时才写 False |
| Focused(RO) | Boolean | | 不序列化 | |
| Font | Font | | — | 继承父容器字体,改了才写 |
| ForeColor | Color | | — | |
| Handle(RO) | IntPtr | | 不序列化 | |
| HasChildren(RO) | Boolean | | 不序列化 | |
| Height | Int32 | | 不序列化 | |
| IsHandleCreated(RO) | Boolean | | 不序列化 | |
| InvokeRequired(RO) | Boolean | | 不序列化 | |
| IsAccessible | Boolean | | 不序列化 | |
| IsMirrored(RO) | Boolean | | 不序列化 | |
| Left | Int32 | | 不序列化 | |
| Location | Point | | — | 坐标(Dpi 影响实际值,以设计器生成为准) |
| Margin | Padding | | — | 外边距(布局引擎用) |
| MaximumSize | Size | | — | 最大尺寸限制 |
| MinimumSize | Size | | — | 最小尺寸限制 |
| Name | String | | 不序列化 | 控件标识符=代码字段名,设计器必写 |
| Parent | Control | | 不序列化 | |
| ProductName(RO) | String | | 不序列化 | |
| ProductVersion(RO) | String | | 不序列化 | |
| RecreatingHandle(RO) | Boolean | | 不序列化 | |
| Region | Region | | 不序列化 | |
| Right(RO) | Int32 | | 不序列化 | |
| RightToLeft | RightToLeft | | — | 默认 Inherit |
| Site | ISite | | — | |
| Size | Size | | — | 尺寸 |
| TabIndex | Int32 | | — | Tab 顺序,通常按添加顺序写 |
| TabStop | Boolean | True | 非默认才写 | |
| Tag | Object | | — | 自定义数据 |
| Top | Int32 | | 不序列化 | |
| TopLevelControl(RO) | Control | | 不序列化 | |
| UseWaitCursor | Boolean | False | 非默认才写 | 等待光标 |
| Visible | Boolean | | — | 隐藏时才写 False |
| Width | Int32 | | 不序列化 | |
| WindowTarget | IWindowTarget | | 不序列化 | |
| PreferredSize(RO) | Size | | 不序列化 | |
| Padding | Padding | | — | 内边距 |
### 基类 Component(1 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| Container(RO) | IContainer | | 不序列化 | |
### 基类 ButtonBase(17 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoEllipsis | Boolean | False | 非默认才写 | |
| AutoSize | Boolean | | — | |
| BackColor | Color | | — | |
| FlatStyle | FlatStyle | Standard | 非默认才写 | |
| FlatAppearance(RO) | FlatButtonAppearance | | **Content 集合** | |
| Image | Image | | — | |
| ImageAlign | ContentAlignment | MiddleCenter | 非默认才写 | |
| ImageIndex | Int32 | -1 | 非默认才写 | |
| ImageKey | String | | — | |
| ImageList | ImageList | | — | |
| ImeMode | ImeMode | | 不序列化 | |
| Text | String | | — | |
| TextAlign | ContentAlignment | MiddleCenter | 非默认才写 | |
| TextImageRelation | TextImageRelation | Overlay | 非默认才写 | |
| UseMnemonic | Boolean | True | 非默认才写 | |
| UseCompatibleTextRendering | Boolean | False | 非默认才写 | |
| UseVisualStyleBackColor | Boolean | | — | |
### 基类 TextBoxBase(21 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AcceptsTab | Boolean | False | 非默认才写 | |
| ShortcutsEnabled | Boolean | True | 非默认才写 | |
| AutoSize | Boolean | True | 不序列化 | |
| BackColor | Color | | — | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BorderStyle | BorderStyle | Fixed3D | 非默认才写 | |
| CanUndo(RO) | Boolean | | 不序列化 | |
| ForeColor | Color | | — | |
| HideSelection | Boolean | True | 非默认才写 | |
| Lines | String[] | | 不序列化 | |
| MaxLength | Int32 | 32767 | 非默认才写 | |
| Modified | Boolean | | 不序列化 | |
| Padding | Padding | | 不序列化 | |
| PreferredHeight(RO) | Int32 | | 不序列化 | |
| ReadOnly | Boolean | False | 非默认才写 | |
| SelectedText | String | | 不序列化 | |
| SelectionLength | Int32 | | 不序列化 | |
| SelectionStart | Int32 | | 不序列化 | |
| TextLength(RO) | Int32 | | 不序列化 | |
| WordWrap | Boolean | True | 非默认才写 | |
### 基类 ListControl(6 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| DisplayMember | String | | — | |
| FormatInfo | IFormatProvider | | 不序列化 | |
| FormatString | String | | — | |
| FormattingEnabled | Boolean | False | 非默认才写 | |
| ValueMember | String | | — | |
| SelectedValue | Object | | 不序列化 | |
### 基类 ScrollBar(15 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoSize | Boolean | | 不序列化 | |
| BackColor | Color | | 不序列化 | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| ForeColor | Color | | 不序列化 | |
| Font | Font | | 不序列化 | |
| ImeMode | ImeMode | | 不序列化 | |
| LargeChange | Int32 | 10 | 非默认才写 | |
| Maximum | Int32 | 100 | 非默认才写 | |
| Minimum | Int32 | 0 | 非默认才写 | |
| SmallChange | Int32 | 1 | 非默认才写 | |
| TabStop | Boolean | False | 非默认才写 | |
| Text | String | | 不序列化 | |
| Value | Int32 | 0 | 非默认才写 | |
| ScaleScrollBarForDpiChange | Boolean | True | 非默认才写 | |
### 基类 UpDownBase(21 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoScroll | Boolean | | 不序列化 | |
| AutoScrollMargin | Size | | 不序列化 | |
| AutoScrollMinSize | Size | | 不序列化 | |
| AutoSize | Boolean | | — | |
| BackColor | Color | | — | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BorderStyle | BorderStyle | Fixed3D | 非默认才写 | |
| ContextMenu | ContextMenu | | — | |
| ContextMenuStrip | ContextMenuStrip | | — | |
| DockPadding(RO) | DockPaddingEdges | | 不序列化 | |
| Focused(RO) | Boolean | | 不序列化 | |
| ForeColor | Color | | — | |
| InterceptArrowKeys | Boolean | True | 非默认才写 | |
| MaximumSize | Size | | — | |
| MinimumSize | Size | | — | |
| PreferredHeight(RO) | Int32 | | 不序列化 | |
| ReadOnly | Boolean | False | 非默认才写 | |
| Text | String | | — | |
| TextAlign | HorizontalAlignment | Left | 非默认才写 | |
| UpDownAlign | LeftRightAlignment | Right | 非默认才写 | |
### 基类 ScrollableControl(4 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoScrollPosition | Point | | 不序列化 | |
| DisplayRectangle(RO) | Rectangle | | — | |
| HorizontalScroll(RO) | HScrollProperties | | 不序列化 | |
| VerticalScroll(RO) | VScrollProperties | | 不序列化 | |
### 基类 ContainerControl(7 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoScaleDimensions | SizeF | | 不序列化 | |
| AutoScaleMode | AutoScaleMode | | 不序列化 | |
| AutoValidate | AutoValidate | | 不序列化 | |
| BindingContext | BindingContext | | 不序列化 | |
| ActiveControl | Control | | 不序列化 | |
| CurrentAutoScaleDimensions(RO) | SizeF | | 不序列化 | |
| ParentForm(RO) | Form | | 不序列化 | |
### 基类 Panel(5 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoSize | Boolean | | — | |
| AutoSizeMode | AutoSizeMode | GrowOnly | 非默认才写 | |
| BorderStyle | BorderStyle | None | 非默认才写 | |
| TabStop | Boolean | False | 非默认才写 | |
| Text | String | | 不序列化 | |
### 基类 Label(1 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoSize | Boolean | False | 非默认才写 | |
### 基类 ToolStrip(26 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoScroll | Boolean | | 不序列化 | |
| AutoScrollMargin | Size | | 不序列化 | |
| AutoScrollMinSize | Size | | 不序列化 | |
| AutoScrollPosition | Point | | 不序列化 | |
| AllowDrop | Boolean | | — | |
| AllowMerge | Boolean | True | 非默认才写 | |
| BackColor | Color | | — | |
| BindingContext | BindingContext | | — | |
| CausesValidation | Boolean | False | 不序列化 | |
| Controls(RO) | ControlCollection | | 不序列化 | |
| Cursor | Cursor | | 不序列化 | |
| ForeColor | Color | | 不序列化 | |
| HasChildren(RO) | Boolean | | 不序列化 | |
| HorizontalScroll(RO) | HScrollProperties | | 不序列化 | |
| ImageScalingSize | Size | {Width=16, Height=16} | 非默认才写 | |
| ImageList | ImageList | | 不序列化 | |
| IsCurrentlyDragging(RO) | Boolean | | 不序列化 | |
| Items(RO) | ToolStripItemCollection | | **Content 集合** | |
| IsDropDown(RO) | Boolean | | 不序列化 | |
| LayoutSettings | LayoutSettings | | 不序列化 | |
| Orientation(RO) | Orientation | | 不序列化 | |
| Renderer | ToolStripRenderer | | 不序列化 | |
| RenderMode | ToolStripRenderMode | | — | |
| ShowItemToolTips | Boolean | True | 非默认才写 | |
| TabStop | Boolean | False | 非默认才写 | |
| VerticalScroll(RO) | VScrollProperties | | 不序列化 | |
### 基类 ToolStripDropDown(28 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AllowItemReorder | Boolean | | 不序列化 | |
| AllowTransparency | Boolean | | 不序列化 | |
| Anchor | AnchorStyles | | 不序列化 | |
| AutoSize | Boolean | True | 非默认才写 | |
| AutoClose | Boolean | True | 非默认才写 | |
| CanOverflow | Boolean | False | 不序列化 | |
| ContextMenu | ContextMenu | | 不序列化 | |
| ContextMenuStrip | ContextMenuStrip | | 不序列化 | |
| DefaultDropDownDirection | ToolStripDropDownDirection | | — | |
| Dock | DockStyle | None | 不序列化 | |
| DropShadowEnabled | Boolean | | — | |
| Font | Font | | — | |
| GripDisplayStyle(RO) | ToolStripGripDisplayStyle | | 不序列化 | |
| GripRectangle(RO) | Rectangle | | 不序列化 | |
| GripMargin | Padding | | 不序列化 | |
| GripStyle | ToolStripGripStyle | Hidden | 不序列化 | |
| IsAutoGenerated(RO) | Boolean | | 不序列化 | |
| Location | Point | | 不序列化 | |
| Opacity | Double | 1 | 不序列化 | |
| OverflowButton(RO) | ToolStripOverflowButton | | 不序列化 | |
| OwnerItem | ToolStripItem | | 不序列化 | |
| Region | Region | | 不序列化 | |
| RightToLeft | RightToLeft | | — | |
| Stretch | Boolean | | 不序列化 | |
| TextDirection | ToolStripTextDirection | Horizontal | 不序列化 | |
| TopLevel | Boolean | | 不序列化 | |
| TabIndex | Int32 | | 不序列化 | |
| Visible | Boolean | False | 不序列化 | |
### 基类 ToolStripDropDownMenu(5 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| DisplayRectangle(RO) | Rectangle | | — | |
| LayoutEngine(RO) | LayoutEngine | | — | |
| LayoutStyle | ToolStripLayoutStyle | Flow | 非默认才写 | |
| ShowImageMargin | Boolean | True | 非默认才写 | |
| ShowCheckMargin | Boolean | False | 非默认才写 | |
### 基类 CommonDialog(1 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| Tag | Object | | — | |
### 基类 FileDialog(16 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AddExtension | Boolean | True | 非默认才写 | |
| CheckPathExists | Boolean | True | 非默认才写 | |
| DefaultExt | String | | — | |
| DereferenceLinks | Boolean | True | 非默认才写 | |
| FileName | String | | — | |
| FileNames(RO) | String[] | | 不序列化 | |
| Filter | String | | — | |
| FilterIndex | Int32 | 1 | 非默认才写 | |
| InitialDirectory | String | | — | |
| RestoreDirectory | Boolean | False | 非默认才写 | |
| ShowHelp | Boolean | False | 非默认才写 | |
| SupportMultiDottedExtensions | Boolean | False | 非默认才写 | |
| Title | String | | — | |
| ValidateNames | Boolean | True | 非默认才写 | |
| CustomPlaces(RO) | FileDialogCustomPlacesCollection | | 不序列化 | |
| AutoUpgradeEnabled | Boolean | True | 非默认才写 | |
### 基类 Form(20 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| ActiveMdiChild(RO) | Form | | 不序列化 | |
| AllowTransparency | Boolean | | 不序列化 | |
| AutoSizeMode | AutoSizeMode | GrowOnly | 非默认才写 | |
| ClientSize | Size | | — | |
| DesktopBounds | Rectangle | | 不序列化 | |
| DesktopLocation | Point | | 不序列化 | |
| DialogResult | DialogResult | | 不序列化 | |
| IsMdiChild(RO) | Boolean | | 不序列化 | |
| IsRestrictedWindow(RO) | Boolean | | 不序列化 | |
| MainMenuStrip | MenuStrip | | — | |
| MdiChildren(RO) | Form[] | | 不序列化 | |
| MdiParent | Form | | 不序列化 | |
| MergedMenu(RO) | MainMenu | | 不序列化 | |
| Modal(RO) | Boolean | | 不序列化 | |
| OwnedForms(RO) | Form[] | | 不序列化 | |
| Owner | Form | | 不序列化 | |
| RestoreBounds(RO) | Rectangle | | 不序列化 | |
| ShowIcon | Boolean | True | 非默认才写 | |
| TabIndex | Int32 | | 不序列化 | |
| TopLevel | Boolean | | 不序列化 | |
### 基类 WebBrowserBase(14 个属性)
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| ActiveXInstance(RO) | Object | | 不序列化 | |
| Site | ISite | | — | |
| BackColor | Color | | 不序列化 | |
| Font | Font | | 不序列化 | |
| ForeColor | Color | | 不序列化 | |
| ImeMode | ImeMode | | 不序列化 | |
| AllowDrop | Boolean | | 不序列化 | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| Cursor | Cursor | | 不序列化 | |
| Enabled | Boolean | | 不序列化 | |
| RightToLeft | RightToLeft | | 不序列化 | |
| Text | String | | 不序列化 | |
| UseWaitCursor | Boolean | | 不序列化 | |
## 事件约定(全部控件共用,基类声明)
- 常用:Click、DoubleClick、MouseDown/MouseUp/MouseMove/MouseEnter/MouseLeave、MouseWheel、KeyDown/KeyPress/KeyUp、GotFocus/LostFocus、Enter/Leave、TextChanged、EnabledChanged、VisibleChanged、SizeChanged、LocationChanged、Resize、Paint、Validating/Validated、HandleCreated/HandleDestroyed、Disposed。
- 各控件**特有事件**在下面各节"自有事件"行列出(如 CheckBox.CheckedChanged、ComboBox.SelectedIndexChanged)。
---
## 常用控件
### Button — 标准按钮。Click 事件处理一切点击。
自有属性(2 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoSizeMode | AutoSizeMode | GrowOnly | 非默认才写 | |
| DialogResult | DialogResult | None | 非默认才写 | 作 Form.AcceptButton/CancelButton 时的返回值 |
- 继承 ButtonBase(17 个):AutoEllipsis, AutoSize, BackColor, FlatStyle, FlatAppearance(RO), Image, ImageAlign, ImageIndex, ImageKey, ImageList, ImeMode, Text, TextAlign, TextImageRelation, UseMnemonic, UseCompatibleTextRendering, UseVisualStyleBackColor
- 继承 Control(70 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BackgroundImage, BackgroundImageLayout, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding
- 继承 Component(1 个):Container(RO)
自有事件:DoubleClick(EH);MouseDoubleClick(MouseEH)
- Button 双击在设计器生成 Click 处理器。
- Always:`UseVisualStyleBackColor = true`(与出厂外观一致但 SD 总写)。
- AcceptButton/CancelButton(Form 上)引用 Button 时按字段名连接。
### CheckBox — 复选框。
自有属性(7 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| Appearance | Appearance | Normal | 非默认才写 | |
| AutoCheck | Boolean | True | 非默认才写 | |
| CheckAlign | ContentAlignment | MiddleLeft | 非默认才写 | |
| Checked | Boolean | False | 非默认才写 | 是否勾选 |
| CheckState | CheckState | Unchecked | 非默认才写 | 三态值 |
| TextAlign | ContentAlignment | MiddleLeft | 非默认才写 | |
| ThreeState | Boolean | False | 非默认才写 | 启用 Indeterminate 态 |
- 继承 ButtonBase(16 个):AutoEllipsis, AutoSize, BackColor, FlatStyle, FlatAppearance(RO), Image, ImageAlign, ImageIndex, ImageKey, ImageList, ImeMode, Text, TextImageRelation, UseMnemonic, UseCompatibleTextRendering, UseVisualStyleBackColor
- 继承 Control(70 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BackgroundImage, BackgroundImageLayout, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding
- 继承 Component(1 个):Container(RO)
自有事件:AppearanceChanged(EH);DoubleClick(EH);MouseDoubleClick(MouseEH);CheckedChanged(EH);CheckStateChanged(EH)
- Always:`UseVisualStyleBackColor = true`;`AutoSize = true` 视设计。
- 运行时读 Checked;三态用 CheckState + ThreeState=true。
### ComboBox — 下拉框。Items 为 Content 字符串集合(逐条 Add)。
自有属性(31 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoCompleteMode | AutoCompleteMode | None | 非默认才写 | |
| AutoCompleteSource | AutoCompleteSource | None | 非默认才写 | |
| AutoCompleteCustomSource | AutoCompleteStringCollection | | **Content 集合** | |
| BackColor | Color | | — | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| DataSource | Object | | — | |
| DrawMode | DrawMode | Normal | 非默认才写 | |
| DropDownWidth | Int32 | | — | |
| DropDownHeight | Int32 | 106 | 非默认才写 | |
| DroppedDown | Boolean | | 不序列化 | |
| FlatStyle | FlatStyle | Standard | 非默认才写 | 默认 Standard |
| Focused(RO) | Boolean | | — | |
| ForeColor | Color | | — | |
| IntegralHeight | Boolean | True | 非默认才写 | |
| ItemHeight | Int32 | | — | |
| Items(RO) | ObjectCollection | | **Content 集合** | 下拉项集合(Content) |
| MaxDropDownItems | Int32 | 8 | 非默认才写 | |
| MaximumSize | Size | | — | |
| MinimumSize | Size | | — | |
| MaxLength | Int32 | 0 | 非默认才写 | |
| Padding | Padding | | 不序列化 | |
| PreferredHeight(RO) | Int32 | | 不序列化 | |
| SelectedIndex | Int32 | | 不序列化 | |
| SelectedItem | Object | | 不序列化 | |
| SelectedText | String | | 不序列化 | |
| SelectionLength | Int32 | | 不序列化 | |
| SelectionStart | Int32 | | 不序列化 | |
| Sorted | Boolean | False | 非默认才写 | |
| DropDownStyle | ComboBoxStyle | DropDown | 非默认才写 | DropDown 可输入 / DropDownList 只可选 / Simple 列表平铺 |
| Text | String | | — | |
- 继承 ListControl(6 个):DisplayMember, FormatInfo, FormatString, FormattingEnabled, ValueMember, SelectedValue
- 继承 Control(65 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);PaddingChanged(EH);DoubleClick(EH);DrawItem(DrawItemEH);DropDown(EH);MeasureItem(MeasureItemEH);SelectedIndexChanged(EH);SelectionChangeCommitted(EH);DropDownStyleChanged(EH);Paint(PaintEH);TextUpdate(EH);DropDownClosed(EH)
- DropDownStyle=DropDownList 只可选;DropDown 可输入(默认)。
- 运行时取 SelectedIndex/SelectedItem/Text。
### Label — 静态文本。
自有属性(20 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoSize | Boolean | False | 非默认才写 | |
| AutoEllipsis | Boolean | False | 非默认才写 | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BorderStyle | BorderStyle | None | 非默认才写 | |
| FlatStyle | FlatStyle | Standard | 非默认才写 | |
| Image | Image | | — | |
| ImageIndex | Int32 | -1 | 非默认才写 | |
| ImageKey | String | | — | |
| ImageList | ImageList | | — | |
| ImageAlign | ContentAlignment | MiddleCenter | 非默认才写 | |
| LiveSetting | AutomationLiveSetting | Off | 非默认才写 | |
| ImeMode | ImeMode | | 不序列化 | |
| PreferredHeight(RO) | Int32 | | 不序列化 | |
| PreferredWidth(RO) | Int32 | | 不序列化 | |
| TabStop | Boolean | False | 不序列化 | |
| TextAlign | ContentAlignment | TopLeft | 非默认才写 | |
| Text | String | | — | |
| UseCompatibleTextRendering | Boolean | False | 非默认才写 | |
| UseMnemonic | Boolean | True | 非默认才写 | |
- 继承 Control(68 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BackColor, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding
- 继承 Component(1 个):Container(RO)
自有事件:AutoSizeChanged(EH);BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);ImeModeChanged(EH);KeyUp(KeyEH);KeyDown(KeyEH);KeyPress(KeyPressEH);TabStopChanged(EH);TextAlignChanged(EH)
- Always:`AutoSize = true`(SD 对 Label 总写)。
- TabStop/ImeMode 被隐藏(标签不参与焦点)。
### RadioButton — 单选钮;同容器内自动互斥(按 GroupBox/Panel 分组)。
自有属性(6 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoCheck | Boolean | True | 非默认才写 | |
| Appearance | Appearance | Normal | 非默认才写 | |
| CheckAlign | ContentAlignment | MiddleLeft | 非默认才写 | |
| Checked | Boolean | False | 非默认才写 | |
| TabStop | Boolean | False | 非默认才写 | |
| TextAlign | ContentAlignment | MiddleLeft | 非默认才写 | |
- 继承 ButtonBase(16 个):AutoEllipsis, AutoSize, BackColor, FlatStyle, FlatAppearance(RO), Image, ImageAlign, ImageIndex, ImageKey, ImageList, ImeMode, Text, TextImageRelation, UseMnemonic, UseCompatibleTextRendering, UseVisualStyleBackColor
- 继承 Control(69 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BackgroundImage, BackgroundImageLayout, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding
- 继承 Component(1 个):Container(RO)
自有事件:AppearanceChanged(EH);DoubleClick(EH);MouseDoubleClick(MouseEH);CheckedChanged(EH)
- Always:`UseVisualStyleBackColor = true`。
- 运行时读 Checked;CheckedChanged 事件。
### TextBox — 单行/多行文本框。
自有属性(11 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AcceptsReturn | Boolean | False | 非默认才写 | |
| AutoCompleteMode | AutoCompleteMode | None | 非默认才写 | |
| AutoCompleteSource | AutoCompleteSource | None | 非默认才写 | |
| AutoCompleteCustomSource | AutoCompleteStringCollection | | **Content 集合** | |
| CharacterCasing | CharacterCasing | Normal | 非默认才写 | |
| Multiline | Boolean | | — | 多行开关;true 时 Height 可调 |
| PasswordChar | Char | | 非默认才写 | 掩码字符,取值如 '*' |
| ScrollBars | ScrollBars | None | 非默认才写 | |
| Text | String | | — | |
| TextAlign | HorizontalAlignment | Left | 非默认才写 | |
| UseSystemPasswordChar | Boolean | False | 非默认才写 | 用系统圆点掩码 |
- 继承 TextBoxBase(21 个):AcceptsTab, ShortcutsEnabled, AutoSize, BackColor, BackgroundImage, BackgroundImageLayout, BorderStyle, CanUndo(RO), ForeColor, HideSelection, Lines, MaxLength, Modified, Padding, PreferredHeight(RO), ReadOnly, SelectedText, SelectionLength, SelectionStart, TextLength(RO), WordWrap
- 继承 Control(67 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:TextAlignChanged(EH)
- Multiline=true 时才写 Multiline、ScrollBars、WordWrap、AcceptsReturn。
- 密码框写 PasswordChar(char)或 UseSystemPasswordChar=true;ImeMode=Disable 常配。
---
## 其他控件
### CheckedListBox — 带勾选框的列表;Items 为 Content 集合。
自有属性(13 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| CheckOnClick | Boolean | False | 非默认才写 | |
| CheckedIndices(RO) | CheckedIndexCollection | | 不序列化 | |
| CheckedItems(RO) | CheckedItemCollection | | 不序列化 | |
| DataSource | Object | | 不序列化 | |
| DisplayMember | String | | 不序列化 | |
| DrawMode | DrawMode | | 不序列化 | |
| ItemHeight | Int32 | | 不序列化 | |
| Items(RO) | ObjectCollection | | **Content 集合** | |
| SelectionMode | SelectionMode | | — | |
| ThreeDCheckBoxes | Boolean | False | 非默认才写 | |
| UseCompatibleTextRendering | Boolean | False | 非默认才写 | |
| ValueMember | String | | 不序列化 | |
| Padding | Padding | | 不序列化 | |
- 继承 ListBox(25 个):BackColor, BackgroundImage, BackgroundImageLayout, BorderStyle, ColumnWidth, UseCustomTabOffsets, Font, ForeColor, HorizontalExtent, HorizontalScrollbar, IntegralHeight, Items(RO), MultiColumn, PreferredHeight(RO), RightToLeft, ScrollAlwaysVisible, SelectedIndex, SelectedIndices(RO), SelectedItem, SelectedItems(RO), Sorted, Text, TopIndex, UseTabStops, CustomTabOffsets(RO)
- 继承 ListControl(4 个):FormatInfo, FormatString, FormattingEnabled, SelectedValue
- 继承 Control(66 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:DataSourceChanged(EH);DisplayMemberChanged(EH);ItemCheck(ItemCheckEH);Click(EH);MouseClick(MouseEH);DrawItem(DrawItemEH);MeasureItem(MeasureItemEH);ValueMemberChanged(EH)
- CheckOnClick=true 才能点行即勾选。
- 运行时读 CheckedIndices/CheckedItems。
### DateTimePicker — 日期时间选择。
自有属性(23 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| BackColor | Color | | 不序列化 | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| CalendarForeColor | Color | | — | |
| CalendarFont | Font | | — | |
| CalendarTitleBackColor | Color | | — | |
| CalendarTitleForeColor | Color | | — | |
| CalendarTrailingForeColor | Color | | — | |
| CalendarMonthBackground | Color | | — | |
| Checked | Boolean | True | 非默认才写 | |
| CustomFormat | String | | — | 自定义格式串(如 yyyy-MM-dd HH:mm) |
| DropDownAlign | LeftRightAlignment | Left | 非默认才写 | |
| ForeColor | Color | | 不序列化 | |
| Format | DateTimePickerFormat | | — | Long/Short/Time/Custom |
| MaxDate | DateTime | | — | |
| MinDate | DateTime | | — | |
| Padding | Padding | | 不序列化 | |
| PreferredHeight(RO) | Int32 | | 不序列化 | |
| RightToLeftLayout | Boolean | False | 非默认才写 | |
| ShowCheckBox | Boolean | False | 非默认才写 | |
| ShowUpDown | Boolean | False | 非默认才写 | 上下钮替代日历 |
| Text | String | | 不序列化 | |
| Value | DateTime | | — | 当前值(运行时设) |
- 继承 Control(68 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:BackColorChanged(EH);BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);Click(EH);DoubleClick(EH);ForeColorChanged(EH);FormatChanged(EH);Paint(PaintEH);MouseClick(MouseEH);MouseDoubleClick(MouseEH);PaddingChanged(EH);TextChanged(EH);CloseUp(EH);RightToLeftLayoutChanged(EH);ValueChanged(EH);DropDown(EH)
- **Value/Checked 绝不写进 Designer.cs**(运行时状态)。
- CustomFormat 需配 Format=Custom;ShowCheckBox=true 允许不选。
### DomainUpDown — 上下钮字符串选择器;Items 为 Content 集合。
自有属性(6 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| Items(RO) | DomainUpDownItemCollection | | **Content 集合** | |
| Padding | Padding | | 不序列化 | |
| SelectedIndex | Int32 | -1 | 不序列化 | |
| SelectedItem | Object | | 不序列化 | |
| Sorted | Boolean | False | 非默认才写 | |
| Wrap | Boolean | False | 非默认才写 | |
- 继承 UpDownBase(21 个):AutoScroll, AutoScrollMargin, AutoScrollMinSize, AutoSize, BackColor, BackgroundImage, BackgroundImageLayout, BorderStyle, ContextMenu, ContextMenuStrip, DockPadding(RO), Focused(RO), ForeColor, InterceptArrowKeys, MaximumSize, MinimumSize, PreferredHeight(RO), ReadOnly, Text, TextAlign, UpDownAlign
- 继承 ContainerControl(7 个):AutoScaleDimensions, AutoScaleMode, AutoValidate, BindingContext, ActiveControl, CurrentAutoScaleDimensions(RO), ParentForm(RO)
- 继承 ScrollableControl(4 个):AutoScrollPosition, DisplayRectangle(RO), HorizontalScroll(RO), VerticalScroll(RO)
- 继承 Control(60 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:PaddingChanged(EH);SelectedItemChanged(EH)
### FlowLayoutPanel — 流式布局容器,子控件自动排列。
自有属性(3 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| LayoutEngine(RO) | LayoutEngine | | — | |
| FlowDirection | FlowDirection | LeftToRight | 非默认才写 | 排列方向 |
| WrapContents | Boolean | True | 非默认才写 | 是否换行换列 |
- 继承 Panel(5 个):AutoSize, AutoSizeMode, BorderStyle, TabStop, Text
- 继承 ScrollableControl(8 个):AutoScroll, AutoScrollMargin, AutoScrollPosition, AutoScrollMinSize, DisplayRectangle(RO), HorizontalScroll(RO), VerticalScroll(RO), DockPadding(RO)
- 继承 Control(69 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, BackColor, BackgroundImage, BackgroundImageLayout, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding, ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:无。
- FlowDirection+WrapContents 控制排布;子控件用 Margin/FlowBreak 控制间距换行。
### GroupBox — 分组容器(带标题边框)。
自有属性(8 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AllowDrop | Boolean | | 不序列化 | |
| AutoSize | Boolean | | — | |
| AutoSizeMode | AutoSizeMode | GrowOnly | 非默认才写 | |
| DisplayRectangle(RO) | Rectangle | | — | |
| FlatStyle | FlatStyle | Standard | 非默认才写 | |
| TabStop | Boolean | | 不序列化 | |
| Text | String | | — | |
| UseCompatibleTextRendering | Boolean | False | 非默认才写 | |
- 继承 Control(69 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, Anchor, AutoScrollOffset, LayoutEngine(RO), BackColor, BackgroundImage, BackgroundImageLayout, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding, ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:AutoSizeChanged(EH);TabStopChanged(EH);Click(EH);MouseClick(MouseEH);DoubleClick(EH);MouseDoubleClick(MouseEH);KeyUp(KeyEH);KeyDown(KeyEH);KeyPress(KeyPressEH);MouseDown(MouseEH);MouseUp(MouseEH);MouseMove(MouseEH);MouseEnter(EH);MouseLeave(EH)
- 内部控件相对其 Client 区域定位;Text=组标题。
### HScrollBar — 水平滚动条。Value/Minimum/Maximum/LargeChange/SmallChange 是核心;Scroll/ValueChanged 事件。
自有属性:无(全部继承)。
- 继承 ScrollBar(15 个):AutoSize, BackColor, BackgroundImage, BackgroundImageLayout, ForeColor, Font, ImeMode, LargeChange, Maximum, Minimum, SmallChange, TabStop, Text, Value, ScaleScrollBarForDpiChange
- 继承 Control(65 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding
- 继承 Component(1 个):Container(RO)
自有事件:无。
### LinkLabel — 超链接标签;LinkClicked 事件。
自有属性(13 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| ActiveLinkColor | Color | | — | |
| DisabledLinkColor | Color | | — | |
| FlatStyle | FlatStyle | | 不序列化 | |
| LinkArea | LinkArea | | — | |
| LinkBehavior | LinkBehavior | SystemDefault | 非默认才写 | |
| LinkColor | Color | | — | |
| Links(RO) | LinkCollection | | 不序列化 | |
| LinkVisited | Boolean | False | 非默认才写 | |
| TabStop | Boolean | | — | |
| Text | String | | — | |
| Padding | Padding | | — | |
| VisitedLinkColor | Color | | — | |
| UseCompatibleTextRendering | Boolean | | — | |
- 继承 Label(16 个):AutoSize, AutoEllipsis, BackgroundImage, BackgroundImageLayout, BorderStyle, Image, ImageIndex, ImageKey, ImageList, ImageAlign, LiveSetting, ImeMode, PreferredHeight(RO), PreferredWidth(RO), TextAlign, UseMnemonic
- 继承 Control(67 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BackColor, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO)
- 继承 Component(1 个):Container(RO)
自有事件:TabStopChanged(EH);LinkClicked(LinkLabelLinkClickedEH)
- LinkArea 指定可点区域(默认整段)。
### ListBox — 列表框;Items 为 Content 集合(逐条 Add)。
自有属性(29 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| BackColor | Color | | — | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BorderStyle | BorderStyle | Fixed3D | 非默认才写 | |
| ColumnWidth | Int32 | 0 | 非默认才写 | |
| UseCustomTabOffsets | Boolean | False | 不序列化 | |
| DrawMode | DrawMode | Normal | 非默认才写 | |
| Font | Font | | — | |
| ForeColor | Color | | — | |
| HorizontalExtent | Int32 | 0 | 非默认才写 | |
| HorizontalScrollbar | Boolean | False | 非默认才写 | |
| IntegralHeight | Boolean | True | 非默认才写 | |
| ItemHeight | Int32 | 13 | 非默认才写 | |
| Items(RO) | ObjectCollection | | **Content 集合** | |
| MultiColumn | Boolean | False | 非默认才写 | |
| PreferredHeight(RO) | Int32 | | 不序列化 | |
| RightToLeft | RightToLeft | | — | |
| ScrollAlwaysVisible | Boolean | False | 非默认才写 | |
| SelectedIndex | Int32 | | 不序列化 | |
| SelectedIndices(RO) | SelectedIndexCollection | | 不序列化 | |
| SelectedItem | Object | | 不序列化 | |
| SelectedItems(RO) | SelectedObjectCollection | | 不序列化 | |
| SelectionMode | SelectionMode | One | 非默认才写 | |
| Sorted | Boolean | False | 非默认才写 | |
| Text | String | | 不序列化 | |
| TopIndex | Int32 | | 不序列化 | |
| UseTabStops | Boolean | True | 非默认才写 | |
| CustomTabOffsets(RO) | IntegerCollection | | 不序列化 | |
| Padding | Padding | | 不序列化 | |
- 继承 ListControl(7 个):DataSource, DisplayMember, FormatInfo, FormatString, FormattingEnabled, ValueMember, SelectedValue
- 继承 Control(66 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);TextChanged(EH);Click(EH);MouseClick(MouseEH);PaddingChanged(EH);Paint(PaintEH);DrawItem(DrawItemEH);MeasureItem(MeasureItemEH);SelectedIndexChanged(EH)
- SelectionMode=One 默认;MultiExtended 多选。
- 运行时读 SelectedIndex/SelectedItem(s)。
### ListView — 列表视图:View=Details 时 Columns+Items 两层 Content(codegen.md §8 有模板)。
自有属性(46 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| Activation | ItemActivation | Standard | 非默认才写 | |
| Alignment | ListViewAlignment | Top | 非默认才写 | |
| AllowColumnReorder | Boolean | False | 非默认才写 | |
| AutoArrange | Boolean | True | 非默认才写 | |
| BackColor | Color | | — | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BackgroundImageTiled | Boolean | False | 非默认才写 | |
| BorderStyle | BorderStyle | Fixed3D | 非默认才写 | |
| CheckBoxes | Boolean | False | 非默认才写 | 行首勾选框 |
| CheckedIndices(RO) | CheckedIndexCollection | | 不序列化 | |
| CheckedItems(RO) | CheckedListViewItemCollection | | 不序列化 | |
| Columns(RO) | ColumnHeaderCollection | | **Content 集合** | 列集合(Content,Details 视图用) |
| FocusedItem | ListViewItem | | 不序列化 | |
| ForeColor | Color | | — | |
| FullRowSelect | Boolean | False | 非默认才写 | |
| GridLines | Boolean | False | 非默认才写 | |
| Groups(RO) | ListViewGroupCollection | | **Content 集合** | 分组集合(Content) |
| HeaderStyle | ColumnHeaderStyle | Clickable | 非默认才写 | |
| HideSelection | Boolean | True | 非默认才写 | |
| HotTracking | Boolean | False | 非默认才写 | |
| HoverSelection | Boolean | False | 非默认才写 | |
| InsertionMark(RO) | ListViewInsertionMark | | 不序列化 | |
| Items(RO) | ListViewItemCollection | | **Content 集合** | 行集合(Content) |
| LabelEdit | Boolean | False | 非默认才写 | |
| LabelWrap | Boolean | True | 非默认才写 | |
| LargeImageList | ImageList | | — | |
| ListViewItemSorter | IComparer | | 不序列化 | |
| MultiSelect | Boolean | True | 非默认才写 | |
| OwnerDraw | Boolean | False | 非默认才写 | |
| RightToLeftLayout | Boolean | False | 非默认才写 | |
| Scrollable | Boolean | True | 非默认才写 | |
| SelectedIndices(RO) | SelectedIndexCollection | | 不序列化 | |
| SelectedItems(RO) | SelectedListViewItemCollection | | 不序列化 | |
| ShowGroups | Boolean | True | 非默认才写 | |
| SmallImageList | ImageList | | — | |
| ShowItemToolTips | Boolean | False | 非默认才写 | |
| Sorting | SortOrder | None | 非默认才写 | |
| StateImageList | ImageList | | — | |
| Text | String | | 不序列化 | |
| TileSize | Size | | — | |
| TopItem | ListViewItem | | 不序列化 | |
| UseCompatibleStateImageBehavior | Boolean | True | 不序列化 | |
| View | View | LargeIcon | 非默认才写 | LargeIcon/Details/SmallIcon/List/Tile |
| VirtualListSize | Int32 | 0 | 非默认才写 | |
| VirtualMode | Boolean | False | 非默认才写 | |
| Padding | Padding | | 不序列化 | |
- 继承 Control(69 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BackgroundImage, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:BackgroundImageLayoutChanged(EH);RightToLeftLayoutChanged(EH);TextChanged(EH);AfterLabelEdit(LabelEditEH);BeforeLabelEdit(LabelEditEH);CacheVirtualItems(CacheVirtualItemsEH);ColumnClick(ColumnClickEH);ColumnReordered(ColumnReorderedEH);ColumnWidthChanged(ColumnWidthChangedEH);ColumnWidthChanging(ColumnWidthChangingEH);DrawColumnHeader(DrawListViewColumnHeaderEH);DrawItem(DrawListViewItemEH);DrawSubItem(DrawListViewSubItemEH);ItemActivate(EH);ItemCheck(ItemCheckEH);ItemChecked(ItemCheckedEH);ItemDrag(ItemDragEH);ItemMouseHover(ListViewItemMouseHoverEH);ItemSelectionChanged(ListViewItemSelectionChangedEH);PaddingChanged(EH);Paint(PaintEH);RetrieveVirtualItem(RetrieveVirtualItemEH);SearchForVirtualItem(SearchForVirtualItemEH);SelectedIndexChanged(EH);VirtualItemsSelectionRangeChanged(ListViewVirtualItemsSelectionRangeChangedEH)
- Columns 列集合 + Items 行集合(每行 ListViewItem 有 SubItems)——由设计器生成嵌套代码。
- 常用组合:View=Details、FullRowSelect=true、GridLines=true、HideSelection=false。
### MaskedTextBox — 掩码文本框:Mask 属性约束输入格式。
自有属性(33 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AcceptsTab | Boolean | | 不序列化 | |
| AllowPromptAsInput | Boolean | True | 非默认才写 | |
| AsciiOnly | Boolean | False | 非默认才写 | |
| BeepOnError | Boolean | False | 非默认才写 | |
| CanUndo(RO) | Boolean | | 不序列化 | |
| Culture | CultureInfo | | — | |
| CutCopyMaskFormat | MaskFormat | IncludeLiterals | 非默认才写 | |
| FormatProvider | IFormatProvider | | 不序列化 | |
| HidePromptOnLeave | Boolean | False | 非默认才写 | |
| InsertKeyMode | InsertKeyMode | Default | 非默认才写 | |
| IsOverwriteMode(RO) | Boolean | | 不序列化 | |
| Lines | String[] | | 不序列化 | |
| Mask | String | | — | 掩码(如 0000-00-00、(999) 000-0000) |
| MaskCompleted(RO) | Boolean | | 不序列化 | |
| MaskFull(RO) | Boolean | | 不序列化 | |
| MaskedTextProvider(RO) | MaskedTextProvider | | 不序列化 | |
| MaxLength | Int32 | | 不序列化 | |
| Multiline | Boolean | | 不序列化 | |
| PasswordChar | Char | | 非默认才写 | |
| PromptChar | Char | _ | 非默认才写 | |
| ReadOnly | Boolean | | — | |
| RejectInputOnFirstFailure | Boolean | False | 非默认才写 | |
| ResetOnPrompt | Boolean | True | 非默认才写 | |
| ResetOnSpace | Boolean | True | 非默认才写 | |
| SkipLiterals | Boolean | True | 非默认才写 | |
| SelectedText | String | | — | |
| Text | String | | — | |
| TextLength(RO) | Int32 | | 不序列化 | |
| TextAlign | HorizontalAlignment | Left | 非默认才写 | |
| TextMaskFormat | MaskFormat | IncludeLiterals | 非默认才写 | |
| UseSystemPasswordChar | Boolean | False | 非默认才写 | |
| ValidatingType | Type | | 不序列化 | |
| WordWrap | Boolean | | 不序列化 | |
- 继承 TextBoxBase(13 个):ShortcutsEnabled, AutoSize, BackColor, BackgroundImage, BackgroundImageLayout, BorderStyle, ForeColor, HideSelection, Modified, Padding, PreferredHeight(RO), SelectionLength, SelectionStart
- 继承 Control(67 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:AcceptsTabChanged(EH);IsOverwriteModeChanged(EH);MaskChanged(EH);MaskInputRejected(MaskInputRejectedEH);MultilineChanged(EH);TextAlignChanged(EH);TypeValidationCompleted(TypeValidationEH)
- MaskInputRejected 处理非法输入;TypeValidationCompleted 配 ValidatingType。
### MonthCalendar — 月历控件。
自有属性(30 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AnnuallyBoldedDates | DateTime[] | | — | |
| BackColor | Color | | — | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BoldedDates | DateTime[] | | — | |
| CalendarDimensions | Size | | — | |
| FirstDayOfWeek | Day | Default | 非默认才写 | |
| ForeColor | Color | | — | |
| ImeMode | ImeMode | | 不序列化 | |
| MaxDate | DateTime | | — | |
| MaxSelectionCount | Int32 | 7 | 非默认才写 | |
| MinDate | DateTime | | — | |
| MonthlyBoldedDates | DateTime[] | | — | |
| Padding | Padding | | 不序列化 | |
| RightToLeftLayout | Boolean | False | 非默认才写 | |
| ScrollChange | Int32 | 0 | 非默认才写 | |
| SelectionEnd | DateTime | | 不序列化 | |
| SelectionStart | DateTime | | 不序列化 | |
| SelectionRange | SelectionRange | | — | |
| ShowToday | Boolean | True | 非默认才写 | |
| ShowTodayCircle | Boolean | True | 非默认才写 | |
| ShowWeekNumbers | Boolean | False | 非默认才写 | |
| SingleMonthSize(RO) | Size | | 不序列化 | |
| Size | Size | | 不序列化 | |
| Text | String | | 不序列化 | |
| TodayDate | DateTime | | — | |
| TodayDateSet(RO) | Boolean | | 不序列化 | |
| TitleBackColor | Color | | — | |
| TitleForeColor | Color | | — | |
| TrailingForeColor | Color | | — | |
- 继承 Control(66 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO)
- 继承 Component(1 个):Container(RO)
自有事件:BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);ImeModeChanged(EH);PaddingChanged(EH);TextChanged(EH);Click(EH);DateChanged(DateRangeEH);DateSelected(DateRangeEH);DoubleClick(EH);MouseClick(MouseEH);MouseDoubleClick(MouseEH);Paint(PaintEH);RightToLeftLayoutChanged(EH)
- DateChanged/DateSelected 事件;SelectionRange 运行时设。
### NumericUpDown — 数值上下钮。
自有属性(10 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| Accelerations(RO) | NumericUpDownAccelerationCollection | | 不序列化 | |
| DecimalPlaces | Int32 | 0 | 非默认才写 | |
| Hexadecimal | Boolean | False | 非默认才写 | |
| Increment | Decimal | | — | |
| Maximum | Decimal | | — | |
| Minimum | Decimal | | — | |
| Padding | Padding | | 不序列化 | |
| Text | String | | 不序列化 | |
| ThousandsSeparator | Boolean | False | 非默认才写 | |
| Value | Decimal | | — | |
- 继承 UpDownBase(20 个):AutoScroll, AutoScrollMargin, AutoScrollMinSize, AutoSize, BackColor, BackgroundImage, BackgroundImageLayout, BorderStyle, ContextMenu, ContextMenuStrip, DockPadding(RO), Focused(RO), ForeColor, InterceptArrowKeys, MaximumSize, MinimumSize, PreferredHeight(RO), ReadOnly, TextAlign, UpDownAlign
- 继承 ContainerControl(7 个):AutoScaleDimensions, AutoScaleMode, AutoValidate, BindingContext, ActiveControl, CurrentAutoScaleDimensions(RO), ParentForm(RO)
- 继承 ScrollableControl(4 个):AutoScrollPosition, DisplayRectangle(RO), HorizontalScroll(RO), VerticalScroll(RO)
- 继承 Control(60 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:PaddingChanged(EH);TextChanged(EH);ValueChanged(EH)
- Minimum/Maximum/Increment/DecimalPlaces;Value 运行时读写;ValueChanged 事件。
### Panel — 通用容器面板。
自有属性(5 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoSize | Boolean | | — | |
| AutoSizeMode | AutoSizeMode | GrowOnly | 非默认才写 | |
| BorderStyle | BorderStyle | None | 非默认才写 | |
| TabStop | Boolean | False | 非默认才写 | |
| Text | String | | 不序列化 | |
- 继承 ScrollableControl(8 个):AutoScroll, AutoScrollMargin, AutoScrollPosition, AutoScrollMinSize, DisplayRectangle(RO), HorizontalScroll(RO), VerticalScroll(RO), DockPadding(RO)
- 继承 Control(70 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BackColor, BackgroundImage, BackgroundImageLayout, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding, ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:AutoSizeChanged(EH);KeyUp(KeyEH);KeyDown(KeyEH);KeyPress(KeyPressEH);TextChanged(EH)
- BorderStyle=FixedSingle/Fixed3D 才写;AutoScroll=true 才写。
### PictureBox — 图片框。
自有属性(16 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AllowDrop | Boolean | | 不序列化 | |
| BorderStyle | BorderStyle | None | 非默认才写 | |
| CausesValidation | Boolean | | 不序列化 | |
| ErrorImage | Image | | — | |
| ForeColor | Color | | 不序列化 | |
| Font | Font | | 不序列化 | |
| Image | Image | | — | 图片(经资源文件序列化) |
| ImageLocation | String | | — | |
| InitialImage | Image | | — | |
| ImeMode | ImeMode | | 不序列化 | |
| RightToLeft | RightToLeft | | 不序列化 | |
| SizeMode | PictureBoxSizeMode | Normal | 非默认才写 | Normal/StretchImage/AutoSize/CenterImage/Zoom |
| TabStop | Boolean | | 不序列化 | |
| TabIndex | Int32 | | 不序列化 | |
| Text | String | | 不序列化 | |
| WaitOnLoad | Boolean | False | 非默认才写 | |
- 继承 Control(65 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BackColor, BackgroundImage, BackgroundImageLayout, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), Site, Size, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding
- 继承 Component(1 个):Container(RO)
自有事件:CausesValidationChanged(EH);ForeColorChanged(EH);FontChanged(EH);ImeModeChanged(EH);LoadCompleted(AsyncCompletedEH);LoadProgressChanged(ProgressChangedEH);RightToLeftChanged(EH);SizeModeChanged(EH);TabStopChanged(EH);TabIndexChanged(EH);TextChanged(EH);Enter(EH);KeyUp(KeyEH);KeyDown(KeyEH);KeyPress(KeyPressEH);Leave(EH)
- Image 序列化为 resources(ImageListStream/资源),SD 生成 `(System.Drawing.Image)(resources.GetObject(...))`。
- SizeMode=StretchImage 常用;ImageLocation+WaitOnLoad 走 URL 加载。
### ProgressBar — 进度条。Minimum/Maximum/Value/Step;Marquee 模式配 Style=Marquee。
自有属性(16 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AllowDrop | Boolean | | 不序列化 | |
| BackgroundImage | Image | | 不序列化 | |
| Style | ProgressBarStyle | Blocks | 非默认才写 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| CausesValidation | Boolean | | 不序列化 | |
| Font | Font | | 不序列化 | |
| ImeMode | ImeMode | | 不序列化 | |
| MarqueeAnimationSpeed | Int32 | 100 | 非默认才写 | |
| Maximum | Int32 | 100 | 非默认才写 | |
| Minimum | Int32 | 0 | 非默认才写 | |
| Padding | Padding | | 不序列化 | |
| RightToLeftLayout | Boolean | False | 非默认才写 | |
| Step | Int32 | 10 | 非默认才写 | |
| TabStop | Boolean | | 不序列化 | |
| Text | String | | 不序列化 | |
| Value | Int32 | 0 | 非默认才写 | 当前值(运行时设) |
- 继承 Control(65 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BackColor, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO)
- 继承 Component(1 个):Container(RO)
自有事件:BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);CausesValidationChanged(EH);FontChanged(EH);ImeModeChanged(EH);PaddingChanged(EH);RightToLeftLayoutChanged(EH);TabStopChanged(EH);TextChanged(EH);DoubleClick(EH);MouseDoubleClick(MouseEH);KeyUp(KeyEH);KeyDown(KeyEH);KeyPress(KeyPressEH);Enter(EH);Leave(EH);Paint(PaintEH)
- **Value 是运行时状态,不写进 Designer.cs**。
### PropertyGrid — 属性网格:运行时 SelectedObject=某对象即显示其属性。
自有属性(43 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoScroll | Boolean | | 不序列化 | |
| BackColor | Color | | — | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BrowsableAttributes | AttributeCollection | | 不序列化 | |
| CanShowCommands(RO) | Boolean | | 不序列化 | |
| CategoryForeColor | Color | ControlText | 非默认才写 | |
| CommandsBackColor | Color | | — | |
| CommandsForeColor | Color | | — | |
| CommandsLinkColor | Color | | — | |
| CommandsActiveLinkColor | Color | | — | |
| CommandsDisabledLinkColor | Color | | — | |
| CommandsBorderColor | Color | ControlDark | 非默认才写 | |
| CommandsVisible(RO) | Boolean | | 不序列化 | |
| CommandsVisibleIfAvailable | Boolean | True | 非默认才写 | |
| ContextMenuDefaultLocation(RO) | Point | | 不序列化 | |
| Controls(RO) | ControlCollection | | 不序列化 | |
| ForeColor | Color | | 不序列化 | |
| HelpBackColor | Color | Control | 非默认才写 | |
| HelpForeColor | Color | ControlText | 非默认才写 | |
| HelpBorderColor | Color | ControlDark | 非默认才写 | |
| HelpVisible | Boolean | True | 非默认才写 | |
| SelectedItemWithFocusBackColor | Color | Highlight | 非默认才写 | |
| SelectedItemWithFocusForeColor | Color | HighlightText | 非默认才写 | |
| DisabledItemForeColor | Color | GrayText | 非默认才写 | |
| CategorySplitterColor | Color | Control | 非默认才写 | |
| CanShowVisualStyleGlyphs | Boolean | True | 非默认才写 | |
| LineColor | Color | InactiveBorder | 非默认才写 | |
| Padding | Padding | | 不序列化 | |
| PropertySort | PropertySort | CategorizedAlphabetical | 非默认才写 | |
| PropertyTabs(RO) | PropertyTabCollection | | 不序列化 | |
| SelectedObject | Object | | — | |
| SelectedObjects | Object[] | | 不序列化 | |
| SelectedTab(RO) | PropertyTab | | 不序列化 | |
| SelectedGridItem | GridItem | | 不序列化 | |
| Site | ISite | | — | |
| Text | String | | 不序列化 | |
| LargeButtons | Boolean | False | 非默认才写 | |
| ToolbarVisible | Boolean | True | 非默认才写 | |
| ViewBackColor | Color | Window | 非默认才写 | |
| ViewForeColor | Color | WindowText | 非默认才写 | |
| ViewBorderColor | Color | ControlDark | 非默认才写 | |
| UseCompatibleTextRendering | Boolean | False | 非默认才写 | |
- 继承 ContainerControl(7 个):AutoScaleDimensions, AutoScaleMode, AutoValidate, BindingContext, ActiveControl, CurrentAutoScaleDimensions(RO), ParentForm(RO)
- 继承 ScrollableControl(7 个):AutoScrollMargin, AutoScrollPosition, AutoScrollMinSize, DisplayRectangle(RO), HorizontalScroll(RO), VerticalScroll(RO), DockPadding(RO)
- 继承 Control(64 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);ForeColorChanged(EH);PaddingChanged(EH);TextChanged(EH);KeyDown(KeyEH);KeyPress(KeyPressEH);KeyUp(KeyEH);MouseDown(MouseEH);MouseUp(MouseEH);MouseMove(MouseEH);MouseEnter(EH);MouseLeave(EH);PropertyValueChanged(PropertyValueChangedEH);PropertyTabChanged(PropertyTabChangedEH);PropertySortChanged(EH);SelectedGridItemChanged(SelectedGridItemChangedEH);SelectedObjectsChanged(EH)
### RichTextBox — 富文本框。
自有属性(39 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AllowDrop | Boolean | | 不序列化 | |
| AutoSize | Boolean | False | 不序列化 | |
| AutoWordSelection | Boolean | False | 非默认才写 | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BulletIndent | Int32 | 0 | 非默认才写 | |
| CanRedo(RO) | Boolean | | 不序列化 | |
| DetectUrls | Boolean | True | 非默认才写 | |
| EnableAutoDragDrop | Boolean | False | 非默认才写 | |
| ForeColor | Color | | — | |
| Font | Font | | — | |
| LanguageOption | RichTextBoxLanguageOptions | | 不序列化 | |
| MaxLength | Int32 | 2147483647 | 非默认才写 | |
| Multiline | Boolean | True | 非默认才写 | |
| RedoActionName(RO) | String | | 不序列化 | |
| RichTextShortcutsEnabled | Boolean | True | 不序列化 | |
| RightMargin | Int32 | 0 | 非默认才写 | |
| Rtf | String | | 不序列化 | |
| ScrollBars | RichTextBoxScrollBars | Both | 非默认才写 | |
| SelectionAlignment | HorizontalAlignment | Left | 不序列化 | |
| SelectionBullet | Boolean | False | 不序列化 | |
| SelectionCharOffset | Int32 | 0 | 不序列化 | |
| SelectionColor | Color | | 不序列化 | |
| SelectionBackColor | Color | | 不序列化 | |
| SelectionFont | Font | | 不序列化 | |
| SelectionHangingIndent | Int32 | 0 | 不序列化 | |
| SelectionIndent | Int32 | 0 | 不序列化 | |
| SelectionLength | Int32 | | 不序列化 | |
| SelectionProtected | Boolean | False | 不序列化 | |
| SelectedRtf | String | | 不序列化 | |
| SelectionRightIndent | Int32 | 0 | 不序列化 | |
| SelectionTabs | Int32[] | | 不序列化 | |
| SelectedText | String | | 不序列化 | |
| SelectionType(RO) | RichTextBoxSelectionTypes | | 不序列化 | |
| ShowSelectionMargin | Boolean | False | 非默认才写 | |
| Text | String | | — | |
| TextLength(RO) | Int32 | | 不序列化 | |
| UndoActionName(RO) | String | | 不序列化 | |
| ZoomFactor | Single | 1 | 非默认才写 | |
- 继承 TextBoxBase(13 个):AcceptsTab, ShortcutsEnabled, BackColor, BorderStyle, CanUndo(RO), HideSelection, Lines, Modified, Padding, PreferredHeight(RO), ReadOnly, SelectionStart, WordWrap
- 继承 Control(65 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, Anchor, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);ContentsResized(ContentsResizedEH);DragDrop(DragEH);DragEnter(DragEH);DragLeave(EH);DragOver(DragEH);GiveFeedback(GiveFeedbackEH);QueryContinueDrag(QueryContinueDragEH);HScroll(EH);LinkClicked(LinkClickedEH);ImeChange(EH);Protected(EH);SelectionChanged(EH);VScroll(EH)
- Text 存纯文本;Rtf 隐藏(运行时用)。
- Selection* 属性运行时用于格式化选区。
### SplitContainer — 双面板分隔容器:Panel1/Panel2 各装控件,SplitterDistance 定分隔位置。
自有属性(28 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoScroll | Boolean | False | 不序列化 | |
| AutoScrollOffset | Point | {X=0,Y=0} | 不序列化 | |
| AutoScrollMinSize | Size | | 不序列化 | |
| AutoScrollMargin | Size | | 不序列化 | |
| AutoScrollPosition | Point | | 不序列化 | |
| AutoSize | Boolean | | 不序列化 | |
| BackgroundImage | Image | | — | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BindingContext | BindingContext | | 不序列化 | |
| BorderStyle | BorderStyle | None | 非默认才写 | |
| Controls(RO) | ControlCollection | | 不序列化 | |
| Dock | DockStyle | | — | |
| FixedPanel | FixedPanel | None | 非默认才写 | 缩放时保持哪侧不变 |
| IsSplitterFixed | Boolean | False | 非默认才写 | |
| Orientation | Orientation | Vertical | 非默认才写 | |
| Panel1(RO) | SplitterPanel | | **Content 集合** | 左/上面板(Content,子控件挂其 Controls) |
| Padding | Padding | | 不序列化 | |
| Panel1Collapsed | Boolean | False | 非默认才写 | |
| Panel2Collapsed | Boolean | False | 非默认才写 | |
| Panel1MinSize | Int32 | 25 | 非默认才写 | |
| Panel2(RO) | SplitterPanel | | **Content 集合** | 右/下面板(Content) |
| Panel2MinSize | Int32 | 25 | 非默认才写 | |
| SplitterDistance | Int32 | 50 | 非默认才写 | 分隔条位置 px |
| SplitterIncrement | Int32 | 1 | 非默认才写 | |
| SplitterRectangle(RO) | Rectangle | | 不序列化 | |
| SplitterWidth | Int32 | 4 | 非默认才写 | |
| TabStop | Boolean | True | 非默认才写 | |
| Text | String | | 不序列化 | |
- 继承 ContainerControl(6 个):AutoScaleDimensions, AutoScaleMode, AutoValidate, ActiveControl, CurrentAutoScaleDimensions(RO), ParentForm(RO)
- 继承 ScrollableControl(4 个):DisplayRectangle(RO), HorizontalScroll(RO), VerticalScroll(RO), DockPadding(RO)
- 继承 Control(63 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, LayoutEngine(RO), BackColor, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Enabled, Focused(RO), Font, ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:AutoSizeChanged(EH);ControlAdded(ControlEH);ControlRemoved(ControlEH);PaddingChanged(EH);BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);SplitterMoving(SplitterCancelEH);SplitterMoved(SplitterEH);TextChanged(EH)
- 生成顺序:先写 SplitterDistance/FixedPanel,再往 Panel1.Controls/Panel2.Controls 加子控件。
- Orientation=Horizontal 为上下分割(默认 Vertical 左右)。
### TabControl — 选项卡容器;TabPages 集合(每个 TabPage 独立容器)。
自有属性(22 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| Alignment | TabAlignment | Top | 非默认才写 | |
| Appearance | TabAppearance | Normal | 非默认才写 | |
| BackColor | Color | | 不序列化 | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| ForeColor | Color | | 不序列化 | |
| DisplayRectangle(RO) | Rectangle | | — | |
| DrawMode | TabDrawMode | Normal | 非默认才写 | |
| HotTrack | Boolean | False | 非默认才写 | |
| ImageList | ImageList | | — | |
| ItemSize | Size | | — | |
| Multiline | Boolean | False | 非默认才写 | |
| Padding | Point | | — | |
| RightToLeftLayout | Boolean | False | 非默认才写 | |
| RowCount(RO) | Int32 | | 不序列化 | |
| SelectedIndex | Int32 | -1 | 不序列化 | 默认选中页(-1 无) |
| SelectedTab | TabPage | | 不序列化 | |
| SizeMode | TabSizeMode | Normal | 非默认才写 | |
| ShowToolTips | Boolean | False | 非默认才写 | |
| TabCount(RO) | Int32 | | 不序列化 | |
| TabPages(RO) | TabPageCollection | | 不序列化 | 页集合(Content,经 Controls.Add 生成) |
| Text | String | | 不序列化 | |
- 继承 Control(68 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding, ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:BackColorChanged(EH);BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);ForeColorChanged(EH);TextChanged(EH);DrawItem(DrawItemEH);RightToLeftLayoutChanged(EH);SelectedIndexChanged(EH);Selecting(TabControlCancelEH);Selected(TabControlEH);Deselecting(TabControlCancelEH);Deselected(TabControlEH);Paint(PaintEH)
- TabPages 逐个生成:`new System.Windows.Forms.TabPage()` → 设 Text/UseVisualStyleBackColor → `tabControl1.Controls.Add(tabPageN)`。
- Always:每个 TabPage `UseVisualStyleBackColor = true`。
- 运行时切换 SelectedIndex/SelectTab。
### TableLayoutPanel — 表格布局容器:ColumnCount/RowCount 定网格,子控件带布局属性。
自有属性(10 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| LayoutEngine(RO) | LayoutEngine | | — | |
| LayoutSettings | TableLayoutSettings | | 不序列化 | |
| BorderStyle | BorderStyle | | 不序列化 | |
| CellBorderStyle | TableLayoutPanelCellBorderStyle | None | 非默认才写 | |
| Controls(RO) | TableLayoutControlCollection | | 不序列化 | |
| ColumnCount | Int32 | 0 | 非默认才写 | 列数 |
| GrowStyle | TableLayoutPanelGrowStyle | AddRows | 非默认才写 | 满格后扩展方式 |
| RowCount | Int32 | 0 | 非默认才写 | 行数 |
| RowStyles(RO) | TableLayoutRowStyleCollection | | 不序列化 | 行高风格集合(Content) |
| ColumnStyles(RO) | TableLayoutColumnStyleCollection | | 不序列化 | 列宽风格集合(Content) |
- 继承 Panel(4 个):AutoSize, AutoSizeMode, TabStop, Text
- 继承 ScrollableControl(8 个):AutoScroll, AutoScrollMargin, AutoScrollPosition, AutoScrollMinSize, DisplayRectangle(RO), HorizontalScroll(RO), VerticalScroll(RO), DockPadding(RO)
- 继承 Control(69 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, BackColor, BackgroundImage, BackgroundImageLayout, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, ForeColor, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding, ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:CellPaint(TableLayoutCellPaintEH)
- 子控件生成时附 SetColumn/SetRow/SetColumnSpan/SetRowSpan + Dock=Fill 常配。
- ColumnStyles/RowStyles 是 Content 集合(ColumnStyle/RowStyle 条目,SizeType+Width/Height)。
### ToolTip — 提示组件(托盘组件):为各控件提供 ToolTip,Designer.cs 生成 `new ToolTip(components)` + `toolTip1.SetToolTip(this.button1, "提示")`。
自有属性(16 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| Active | Boolean | True | 非默认才写 | |
| AutomaticDelay | Int32 | 500 | 非默认才写 | |
| AutoPopDelay | Int32 | | — | |
| BackColor | Color | Info | 非默认才写 | |
| ForeColor | Color | InfoText | 非默认才写 | |
| IsBalloon | Boolean | False | 非默认才写 | |
| InitialDelay | Int32 | | — | |
| OwnerDraw | Boolean | False | 非默认才写 | |
| ReshowDelay | Int32 | | — | |
| ShowAlways | Boolean | False | 非默认才写 | |
| StripAmpersands | Boolean | False | 非默认才写 | |
| Tag | Object | | — | |
| ToolTipIcon | ToolTipIcon | None | 非默认才写 | 提示图标 |
| ToolTipTitle | String | | — | 提示标题 |
| UseAnimation | Boolean | True | 非默认才写 | |
| UseFading | Boolean | True | 非默认才写 | |
- 继承 Component(2 个):Site, Container(RO)
自有事件:Draw(DrawToolTipEH);Popup(PopupEH)
- Always:`toolTip1.SetToolTip(...)` 逐控件生成。
### TrackBar — 滑杆。Minimum/Maximum/TickFrequency/Value;ValueChanged/Scroll 事件。
自有属性(17 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoSize | Boolean | True | 非默认才写 | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| Font | Font | | 不序列化 | |
| ForeColor | Color | | 不序列化 | |
| ImeMode | ImeMode | | 不序列化 | |
| LargeChange | Int32 | 5 | 非默认才写 | |
| Maximum | Int32 | 10 | 非默认才写 | |
| Minimum | Int32 | 0 | 非默认才写 | |
| Orientation | Orientation | Horizontal | 非默认才写 | |
| Padding | Padding | | 不序列化 | |
| RightToLeftLayout | Boolean | False | 非默认才写 | |
| SmallChange | Int32 | 1 | 非默认才写 | |
| Text | String | | 不序列化 | |
| TickStyle | TickStyle | BottomRight | 非默认才写 | |
| TickFrequency | Int32 | 1 | 非默认才写 | |
| Value | Int32 | 0 | 非默认才写 | |
- 继承 Control(66 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BackColor, BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO)
- 继承 Component(1 个):Container(RO)
自有事件:AutoSizeChanged(EH);BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);FontChanged(EH);ForeColorChanged(EH);ImeModeChanged(EH);PaddingChanged(EH);TextChanged(EH);Click(EH);DoubleClick(EH);MouseClick(MouseEH);MouseDoubleClick(MouseEH);RightToLeftLayoutChanged(EH);Scroll(EH);Paint(PaintEH);ValueChanged(EH)
### TreeView — 树视图;Nodes 递归 Content 集合(codegen.md §8 模板)。
自有属性(35 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| BackColor | Color | | — | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BorderStyle | BorderStyle | Fixed3D | 非默认才写 | |
| CheckBoxes | Boolean | False | 非默认才写 | |
| ForeColor | Color | | — | |
| FullRowSelect | Boolean | False | 非默认才写 | |
| HideSelection | Boolean | True | 非默认才写 | |
| HotTracking | Boolean | False | 非默认才写 | |
| ImageIndex | Int32 | -1 | 非默认才写 | |
| ImageKey | String | | — | |
| ImageList | ImageList | | — | |
| StateImageList | ImageList | | — | |
| Indent | Int32 | | — | |
| ItemHeight | Int32 | | — | |
| LabelEdit | Boolean | False | 非默认才写 | |
| LineColor | Color | Black | 非默认才写 | |
| Nodes(RO) | TreeNodeCollection | | **Content 集合** | 节点集合(Content,可递归) |
| DrawMode | TreeViewDrawMode | Normal | 非默认才写 | |
| PathSeparator | String | \ | 非默认才写 | |
| Padding | Padding | | 不序列化 | |
| RightToLeftLayout | Boolean | False | 非默认才写 | |
| Scrollable | Boolean | True | 非默认才写 | |
| SelectedImageIndex | Int32 | -1 | 非默认才写 | |
| SelectedImageKey | String | | — | |
| SelectedNode | TreeNode | | 不序列化 | |
| ShowLines | Boolean | True | 非默认才写 | |
| ShowNodeToolTips | Boolean | False | 非默认才写 | |
| ShowPlusMinus | Boolean | True | 非默认才写 | |
| ShowRootLines | Boolean | True | 非默认才写 | |
| Sorted | Boolean | False | 不序列化 | |
| TreeViewNodeSorter | IComparer | | 不序列化 | |
| Text | String | | 不序列化 | |
| TopNode | TreeNode | | 不序列化 | |
| VisibleCount(RO) | Int32 | | 不序列化 | |
- 继承 Control(68 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);PaddingChanged(EH);TextChanged(EH);BeforeLabelEdit(NodeLabelEditEH);AfterLabelEdit(NodeLabelEditEH);BeforeCheck(TreeViewCancelEH);AfterCheck(TreeViewEH);BeforeCollapse(TreeViewCancelEH);AfterCollapse(TreeViewEH);BeforeExpand(TreeViewCancelEH);AfterExpand(TreeViewEH);DrawNode(DrawTreeNodeEH);ItemDrag(ItemDragEH);NodeMouseHover(TreeNodeMouseHoverEH);BeforeSelect(TreeViewCancelEH);AfterSelect(TreeViewEH);Paint(PaintEH);NodeMouseClick(TreeNodeMouseClickEH);NodeMouseDoubleClick(TreeNodeMouseClickEH);RightToLeftLayoutChanged(EH)
- Nodes 生成:`new TreeNode("文本")` 嵌套 → `treeView1.Nodes.AddRange(new TreeNode[] { ... })`。
- AfterSelect 是主事件。
### VScrollBar — 垂直滚动条。同 HScrollBar。
自有属性(1 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| RightToLeft | RightToLeft | | 不序列化 | |
- 继承 ScrollBar(15 个):AutoSize, BackColor, BackgroundImage, BackgroundImageLayout, ForeColor, Font, ImeMode, LargeChange, Maximum, Minimum, SmallChange, TabStop, Text, Value, ScaleScrollBarForDpiChange
- 继承 Control(64 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), Cursor, DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), Site, Size, TabIndex, Tag, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding
- 继承 Component(1 个):Container(RO)
自有事件:RightToLeftChanged(EH)
### WebBrowser — 内嵌 IE 内核浏览器。
自有属性(23 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AllowNavigation | Boolean | True | 非默认才写 | |
| AllowWebBrowserDrop | Boolean | True | 非默认才写 | |
| ScriptErrorsSuppressed | Boolean | False | 非默认才写 | |
| WebBrowserShortcutsEnabled | Boolean | True | 非默认才写 | |
| CanGoBack(RO) | Boolean | | 不序列化 | |
| CanGoForward(RO) | Boolean | | 不序列化 | |
| Document(RO) | HtmlDocument | | 不序列化 | |
| DocumentStream | Stream | | 不序列化 | |
| DocumentText | String | | 不序列化 | |
| DocumentTitle(RO) | String | | 不序列化 | |
| DocumentType(RO) | String | | 不序列化 | |
| EncryptionLevel(RO) | WebBrowserEncryptionLevel | | 不序列化 | |
| IsBusy(RO) | Boolean | | 不序列化 | |
| IsOffline(RO) | Boolean | | 不序列化 | |
| IsWebBrowserContextMenuEnabled | Boolean | True | 非默认才写 | |
| ObjectForScripting | Object | | 不序列化 | |
| Padding | Padding | | 不序列化 | |
| ReadyState(RO) | WebBrowserReadyState | | 不序列化 | |
| StatusText(RO) | String | | 不序列化 | |
| Url | Uri | | — | 起始 URL(可设计器写,但一般运行时导航) |
| Version(RO) | Version | | 不序列化 | |
| ScrollBarsEnabled | Boolean | True | 非默认才写 | |
| Focused(RO) | Boolean | | — | |
- 继承 WebBrowserBase(14 个):ActiveXInstance(RO), Site, BackColor, Font, ForeColor, ImeMode, AllowDrop, BackgroundImage, BackgroundImageLayout, Cursor, Enabled, RightToLeft, Text, UseWaitCursor
- 继承 Control(59 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), BindingContext, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, CausesValidation, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Controls(RO), Created(RO), DataBindings(RO), DeviceDpi(RO), DisplayRectangle(RO), IsDisposed(RO), Disposing(RO), Dock, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), Size, TabIndex, TabStop, Tag, Top, TopLevelControl(RO), Visible, Width, WindowTarget, PreferredSize(RO)
- 继承 Component(1 个):Container(RO)
自有事件:PaddingChanged(EH);CanGoBackChanged(EH);CanGoForwardChanged(EH);DocumentCompleted(WebBrowserDocumentCompletedEH);DocumentTitleChanged(EH);EncryptionLevelChanged(EH);FileDownload(EH);Navigated(WebBrowserNavigatedEH);Navigating(WebBrowserNavigatingEH);NewWindow(CancelEH);ProgressChanged(WebBrowserProgressChangedEH);StatusTextChanged(EH)
- Url 运行时赋值;DocumentCompleted 后操作 Document。
- 程序集含 COM 引用生成(Microsoft.mshtml)才可强类型操作 DOM。
---
## 菜单和工具栏
### ContextMenuStrip — 右键菜单:Items Content 集合;控件经 ContextMenuStrip 属性关联。
自有属性(1 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| SourceControl(RO) | Control | | 不序列化 | |
- 继承 ToolStripDropDownMenu(5 个):DisplayRectangle(RO), LayoutEngine(RO), LayoutStyle, ShowImageMargin, ShowCheckMargin
- 继承 ToolStripDropDown(28 个):AllowItemReorder, AllowTransparency, Anchor, AutoSize, AutoClose, CanOverflow, ContextMenu, ContextMenuStrip, DefaultDropDownDirection, Dock, DropShadowEnabled, Font, GripDisplayStyle(RO), GripRectangle(RO), GripMargin, GripStyle, IsAutoGenerated(RO), Location, Opacity, OverflowButton(RO), OwnerItem, Region, RightToLeft, Stretch, TextDirection, TopLevel, TabIndex, Visible
- 继承 ToolStrip(26 个):AutoScroll, AutoScrollMargin, AutoScrollMinSize, AutoScrollPosition, AllowDrop, AllowMerge, BackColor, BindingContext, CausesValidation, Controls(RO), Cursor, ForeColor, HasChildren(RO), HorizontalScroll(RO), ImageScalingSize, ImageList, IsCurrentlyDragging(RO), Items(RO), IsDropDown(RO), LayoutSettings, Orientation(RO), Renderer, RenderMode, ShowItemToolTips, TabStop, VerticalScroll(RO)
- 继承 ScrollableControl(1 个):DockPadding(RO)
- 继承 Control(52 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AutoScrollOffset, BackgroundImage, BackgroundImageLayout, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), Created(RO), DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Enabled, Focused(RO), Handle(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Right(RO), Site, Size, Tag, Text, Top, TopLevelControl(RO), UseWaitCursor, Width, WindowTarget, PreferredSize(RO), Padding, ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:无。
- Items 生成同菜单模板(codegen.md §7);目标控件写 `this.listBox1.ContextMenuStrip = this.contextMenuStrip1;`。
### MenuStrip — 主菜单栏:Items 顶层菜单(ToolStripMenuItem 可嵌套 DropDownItems)。
自有属性(5 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| CanOverflow | Boolean | False | 不序列化 | |
| GripStyle | ToolStripGripStyle | Hidden | 非默认才写 | |
| ShowItemToolTips | Boolean | False | 非默认才写 | |
| Stretch | Boolean | True | 非默认才写 | |
| MdiWindowListItem | ToolStripMenuItem | | — | |
- 继承 ToolStrip(39 个):AutoSize, AutoScroll, AutoScrollMargin, AutoScrollMinSize, AutoScrollPosition, AllowDrop, AllowItemReorder, AllowMerge, Anchor, BackColor, BindingContext, CausesValidation, Controls(RO), Cursor, Font, DefaultDropDownDirection, Dock, DisplayRectangle(RO), ForeColor, GripDisplayStyle(RO), GripMargin, GripRectangle(RO), HasChildren(RO), HorizontalScroll(RO), ImageScalingSize, ImageList, IsCurrentlyDragging(RO), Items(RO), IsDropDown(RO), LayoutSettings, LayoutStyle, LayoutEngine(RO), OverflowButton(RO), Orientation(RO), Renderer, RenderMode, TabStop, TextDirection, VerticalScroll(RO)
- 继承 ScrollableControl(1 个):DockPadding(RO)
- 继承 Control(59 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AutoScrollOffset, BackgroundImage, BackgroundImageLayout, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Created(RO), DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Enabled, Focused(RO), Handle(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Text, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding, ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:MenuActivate(EH);MenuDeactivate(EH)
- 嵌套模板见 codegen.md §7;TopToolStrip 的 Text 总写。
### StatusStrip — 状态栏(底部 ToolStrip,Table 布局)。
自有属性(9 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| CanOverflow | Boolean | False | 不序列化 | |
| Dock | DockStyle | Bottom | 非默认才写 | |
| GripStyle | ToolStripGripStyle | Hidden | 非默认才写 | |
| LayoutStyle | ToolStripLayoutStyle | Table | 非默认才写 | |
| Padding | Padding | | 不序列化 | |
| ShowItemToolTips | Boolean | False | 非默认才写 | |
| SizingGrip | Boolean | True | 非默认才写 | |
| SizeGripBounds(RO) | Rectangle | | 不序列化 | |
| Stretch | Boolean | True | 非默认才写 | |
- 继承 ToolStrip(37 个):AutoSize, AutoScroll, AutoScrollMargin, AutoScrollMinSize, AutoScrollPosition, AllowDrop, AllowItemReorder, AllowMerge, Anchor, BackColor, BindingContext, CausesValidation, Controls(RO), Cursor, Font, DefaultDropDownDirection, DisplayRectangle(RO), ForeColor, GripDisplayStyle(RO), GripMargin, GripRectangle(RO), HasChildren(RO), HorizontalScroll(RO), ImageScalingSize, ImageList, IsCurrentlyDragging(RO), Items(RO), IsDropDown(RO), LayoutSettings, LayoutEngine(RO), OverflowButton(RO), Orientation(RO), Renderer, RenderMode, TabStop, TextDirection, VerticalScroll(RO)
- 继承 ScrollableControl(1 个):DockPadding(RO)
- 继承 Control(58 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AutoScrollOffset, BackgroundImage, BackgroundImageLayout, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Created(RO), DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Enabled, Focused(RO), Handle(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Text, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:PaddingChanged(EH)
- 通常放 ToolStripStatusLabel(SizingGrip 默认 true)。
### ToolStrip — 工具栏:Items Content 集合(ToolStripButton/Label/SplitButton/DropDownButton/TextBox/ComboBox/Separator)。
自有属性(43 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoSize | Boolean | True | 非默认才写 | |
| AutoScroll | Boolean | | 不序列化 | |
| AutoScrollMargin | Size | | 不序列化 | |
| AutoScrollMinSize | Size | | 不序列化 | |
| AutoScrollPosition | Point | | 不序列化 | |
| AllowDrop | Boolean | | — | |
| AllowItemReorder | Boolean | False | 非默认才写 | |
| AllowMerge | Boolean | True | 非默认才写 | |
| Anchor | AnchorStyles | | — | |
| BackColor | Color | | — | |
| BindingContext | BindingContext | | — | |
| CanOverflow | Boolean | True | 非默认才写 | |
| CausesValidation | Boolean | False | 不序列化 | |
| Controls(RO) | ControlCollection | | 不序列化 | |
| Cursor | Cursor | | 不序列化 | |
| Font | Font | | — | |
| DefaultDropDownDirection | ToolStripDropDownDirection | | 不序列化 | |
| Dock | DockStyle | Top | 非默认才写 | |
| DisplayRectangle(RO) | Rectangle | | — | |
| ForeColor | Color | | 不序列化 | |
| GripStyle | ToolStripGripStyle | Visible | 非默认才写 | |
| GripDisplayStyle(RO) | ToolStripGripDisplayStyle | | 不序列化 | |
| GripMargin | Padding | | — | |
| GripRectangle(RO) | Rectangle | | 不序列化 | |
| HasChildren(RO) | Boolean | | 不序列化 | |
| HorizontalScroll(RO) | HScrollProperties | | 不序列化 | |
| ImageScalingSize | Size | {Width=16, Height=16} | 非默认才写 | |
| ImageList | ImageList | | 不序列化 | |
| IsCurrentlyDragging(RO) | Boolean | | 不序列化 | |
| Items(RO) | ToolStripItemCollection | | **Content 集合** | 工具栏项集合(Content) |
| IsDropDown(RO) | Boolean | | 不序列化 | |
| LayoutSettings | LayoutSettings | | 不序列化 | |
| LayoutStyle | ToolStripLayoutStyle | | — | |
| LayoutEngine(RO) | LayoutEngine | | — | |
| OverflowButton(RO) | ToolStripOverflowButton | | 不序列化 | |
| Orientation(RO) | Orientation | | 不序列化 | |
| Stretch | Boolean | False | 非默认才写 | |
| Renderer | ToolStripRenderer | | 不序列化 | |
| RenderMode | ToolStripRenderMode | | — | |
| ShowItemToolTips | Boolean | True | 非默认才写 | |
| TabStop | Boolean | False | 非默认才写 | |
| TextDirection | ToolStripTextDirection | Horizontal | 非默认才写 | |
| VerticalScroll(RO) | VScrollProperties | | 不序列化 | |
- 继承 ScrollableControl(1 个):DockPadding(RO)
- 继承 Control(59 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AutoScrollOffset, BackgroundImage, BackgroundImageLayout, Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, ContextMenuStrip, Created(RO), DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Enabled, Focused(RO), Handle(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, Tag, Text, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding, ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:AutoSizeChanged(EH);BeginDrag(EH);CausesValidationChanged(EH);ControlAdded(ControlEH);CursorChanged(EH);ControlRemoved(ControlEH);EndDrag(EH);ForeColorChanged(EH);ItemAdded(ToolStripItemEH);ItemClicked(ToolStripItemClickedEH);ItemRemoved(ToolStripItemEH);LayoutCompleted(EH);LayoutStyleChanged(EH);PaintGrip(PaintEH);RendererChanged(EH)
- 项常用属性:Name/Text/DisplayStyle(Image|Text|ImageAndText)/Image/ToolTipText/Click 事件。
- 图标来自关联 ImageList 时写 ImageKey/ImageScaling=SizeToFit。
### ToolStripContainer — 四边工具栏面板 + 中央内容面板。
自有属性(20 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AutoScroll | Boolean | | 不序列化 | |
| AutoScrollMargin | Size | | 不序列化 | |
| AutoScrollMinSize | Size | | 不序列化 | |
| BackColor | Color | | 不序列化 | |
| BackgroundImage | Image | | 不序列化 | |
| BackgroundImageLayout | ImageLayout | | 不序列化 | |
| BottomToolStripPanel(RO) | ToolStripPanel | | **Content 集合** | |
| BottomToolStripPanelVisible | Boolean | True | 非默认才写 | |
| ContentPanel(RO) | ToolStripContentPanel | | **Content 集合** | |
| CausesValidation | Boolean | | 不序列化 | |
| ContextMenuStrip | ContextMenuStrip | | 不序列化 | |
| Cursor | Cursor | | 不序列化 | |
| ForeColor | Color | | 不序列化 | |
| LeftToolStripPanel(RO) | ToolStripPanel | | **Content 集合** | |
| LeftToolStripPanelVisible | Boolean | True | 非默认才写 | |
| RightToolStripPanel(RO) | ToolStripPanel | | **Content 集合** | |
| RightToolStripPanelVisible | Boolean | True | 非默认才写 | |
| TopToolStripPanel(RO) | ToolStripPanel | | **Content 集合** | |
| TopToolStripPanelVisible | Boolean | True | 非默认才写 | |
| Controls(RO) | ControlCollection | | 不序列化 | |
- 继承 ContainerControl(7 个):AutoScaleDimensions, AutoScaleMode, AutoValidate, BindingContext, ActiveControl, CurrentAutoScaleDimensions(RO), ParentForm(RO)
- 继承 ScrollableControl(5 个):AutoScrollPosition, DisplayRectangle(RO), HorizontalScroll(RO), VerticalScroll(RO), DockPadding(RO)
- 继承 Control(64 个):AccessibilityObject(RO), AccessibleDefaultActionDescription, AccessibleDescription, AccessibleName, AccessibleRole, AllowDrop, Anchor, AutoSize, AutoScrollOffset, LayoutEngine(RO), Bottom(RO), Bounds, CanFocus(RO), CanSelect(RO), Capture, ClientRectangle(RO), ClientSize, CompanyName(RO), ContainsFocus(RO), ContextMenu, Created(RO), DataBindings(RO), DeviceDpi(RO), IsDisposed(RO), Disposing(RO), Dock, Enabled, Focused(RO), Font, Handle(RO), HasChildren(RO), Height, IsHandleCreated(RO), InvokeRequired(RO), IsAccessible, IsMirrored(RO), Left, Location, Margin, MaximumSize, MinimumSize, Name, Parent, ProductName(RO), ProductVersion(RO), RecreatingHandle(RO), Region, Right(RO), RightToLeft, Site, Size, TabIndex, TabStop, Tag, Text, Top, TopLevelControl(RO), UseWaitCursor, Visible, Width, WindowTarget, PreferredSize(RO), Padding, ImeMode
- 继承 Component(1 个):Container(RO)
自有事件:BackColorChanged(EH);BackgroundImageChanged(EH);BackgroundImageLayoutChanged(EH);CausesValidationChanged(EH);ContextMenuStripChanged(EH);CursorChanged(EH);ForeColorChanged(EH)
- ContentPanel 装主内容;各 *ToolStripPanelVisible=false 隐藏不用的边。
---
## 对话框与共享组件(工具箱同列"Windows Forms"分类)
### ColorDialog — 颜色对话框(组件,运行时 ShowDialog)。
自有属性(7 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AllowFullOpen | Boolean | True | 非默认才写 | |
| AnyColor | Boolean | False | 非默认才写 | |
| Color | Color | | — | |
| CustomColors | Int32[] | | 不序列化 | |
| FullOpen | Boolean | False | 非默认才写 | |
| ShowHelp | Boolean | False | 非默认才写 | |
| SolidColorOnly | Boolean | False | 非默认才写 | |
- 继承 CommonDialog(1 个):Tag
- 继承 Component(2 个):Site, Container(RO)
自有事件:无。
- 对话框组件的"结果型"属性(Color 等)运行时读写;设计器只配置外观开关。
### ErrorProvider — 错误提示组件:`errorProvider1.SetError(control, "消息")` 标记控件旁的错误图标。
自有属性(9 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| Site | ISite | | — | |
| BlinkStyle | ErrorBlinkStyle | BlinkIfDifferentError | 非默认才写 | |
| ContainerControl | ContainerControl | | — | |
| RightToLeft | Boolean | False | 非默认才写 | |
| Tag | Object | | — | |
| DataSource | Object | | — | |
| DataMember | String | | — | |
| BlinkRate | Int32 | 250 | 非默认才写 | |
| Icon | Icon | | — | |
- 继承 Component(1 个):Container(RO)
自有事件:RightToLeftChanged(EH)
- BlinkRate/BlinkStyle 外观;ContainerControl/DataSource 绑定场景用。
### FontDialog — 字体对话框。ShowColor=true 才能用 Color。
自有属性(15 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| AllowSimulations | Boolean | True | 非默认才写 | |
| AllowVectorFonts | Boolean | True | 非默认才写 | |
| AllowVerticalFonts | Boolean | True | 非默认才写 | |
| AllowScriptChange | Boolean | True | 非默认才写 | |
| Color | Color | Black | 非默认才写 | |
| FixedPitchOnly | Boolean | False | 非默认才写 | |
| Font | Font | | — | |
| FontMustExist | Boolean | False | 非默认才写 | |
| MaxSize | Int32 | 0 | 非默认才写 | |
| MinSize | Int32 | 0 | 非默认才写 | |
| ScriptsOnly | Boolean | False | 非默认才写 | |
| ShowApply | Boolean | False | 非默认才写 | |
| ShowColor | Boolean | False | 非默认才写 | |
| ShowEffects | Boolean | True | 非默认才写 | |
| ShowHelp | Boolean | False | 非默认才写 | |
- 继承 CommonDialog(1 个):Tag
- 继承 Component(2 个):Site, Container(RO)
自有事件:Apply(EH)
### FolderBrowserDialog — 文件夹选择对话框。SelectedPath 运行时读写。
自有属性(4 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| ShowNewFolderButton | Boolean | True | 非默认才写 | |
| SelectedPath | String | | — | |
| RootFolder | SpecialFolder | Desktop | 非默认才写 | |
| Description | String | | — | |
- 继承 CommonDialog(1 个):Tag
- 继承 Component(2 个):Site, Container(RO)
自有事件:HelpRequest(EH)
### ImageList — 图片列表组件:Images 集合经 ImageListStreamer 资源序列化。
自有属性(8 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| ColorDepth | ColorDepth | | — | 色深(建议先定尺寸色深再放图) |
| Handle(RO) | IntPtr | | 不序列化 | |
| HandleCreated(RO) | Boolean | | 不序列化 | |
| Images(RO) | ImageCollection | | 不序列化 | 图片集合(经资源流序列化) |
| ImageSize | Size | | — | 统一图片尺寸(改后清空 Images) |
| ImageStream | ImageListStreamer | | 不序列化 | |
| Tag | Object | | — | |
| TransparentColor | Color | | — | |
- 继承 Component(2 个):Site, Container(RO)
自有事件:RecreateHandle(EH)
- Designer.cs 生成 `(resources.GetObject("imageList1.ImageStream"))`;ColorDepth/ImageSize 改动会让资源重生成。
- 被 ListView/TreeView/ToolStrip 等通过 ImageList+ImageIndex/ImageKey 引用。
### HelpProvider — 帮助组件:`helpProvider1.SetHelpString(control, "...")` / SetShowHelp。
自有属性(2 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| HelpNamespace | String | | — | |
| Tag | Object | | — | |
- 继承 Component(2 个):Site, Container(RO)
自有事件:无。
- HelpNamespace 指向 .chm 时走 F1 帮助主题。
### OpenFileDialog — 打开文件对话框。
自有属性(6 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| CheckFileExists | Boolean | True | 非默认才写 | |
| Multiselect | Boolean | False | 非默认才写 | |
| ReadOnlyChecked | Boolean | False | 非默认才写 | |
| ShowReadOnly | Boolean | False | 非默认才写 | |
| SafeFileName(RO) | String | | 不序列化 | |
| SafeFileNames(RO) | String[] | | 不序列化 | |
- 继承 FileDialog(16 个):AddExtension, CheckPathExists, DefaultExt, DereferenceLinks, FileName, FileNames(RO), Filter, FilterIndex, InitialDirectory, RestoreDirectory, ShowHelp, SupportMultiDottedExtensions, Title, ValidateNames, CustomPlaces(RO), AutoUpgradeEnabled
- 继承 CommonDialog(1 个):Tag
- 继承 Component(2 个):Site, Container(RO)
自有事件:无。
- Filter 格式 "文本文件|*.txt|所有文件|*.*";FileName/初始目录运行时读写;Multiselect=true 后读 FileNames。
- **运行时结果(FileName 等)绝不写进 Designer.cs**。
### SaveFileDialog — 保存文件对话框。OverwritePrompt=true 默认覆盖确认。
自有属性(2 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| CreatePrompt | Boolean | False | 非默认才写 | |
| OverwritePrompt | Boolean | True | 非默认才写 | |
- 继承 FileDialog(17 个):AddExtension, CheckFileExists, CheckPathExists, DefaultExt, DereferenceLinks, FileName, FileNames(RO), Filter, FilterIndex, InitialDirectory, RestoreDirectory, ShowHelp, SupportMultiDottedExtensions, Title, ValidateNames, CustomPlaces(RO), AutoUpgradeEnabled
- 继承 CommonDialog(1 个):Tag
- 继承 Component(2 个):Site, Container(RO)
自有事件:无。
- 同 OpenFileDialog 的 Filter/运行时规则。
### Timer — 窗体定时器(托盘组件)。Tick 事件 + Start()/Stop()。
自有属性(3 个):
| 属性 | 类型 | 默认值 | 序列化 | 说明 |
|---|---|---|---|---|
| Tag | Object | | — | |
| Enabled | Boolean | False | 非默认才写 | |
| Interval | Int32 | 100 | 非默认才写 | |
- 继承 Component(2 个):Site, Container(RO)
自有事件:Tick(EH)
- **Enabled 是运行时状态,绝不写进 Designer.cs**(设计器总生成 Enabled=false 之前的 Interval——Interval 可写)。
- Interval 毫秒。
---
## ToolStripItem 公共属性(菜单/工具栏条目,生成代码时挂在每个项上)
| 属性 | 说明 |
|---|---|
| Name | 字段名 |
| Text | 显示文本(&助记符) |
| Image | 图标(配 ImageScaling) |
| DisplayStyle | Text/Image/ImageAndText/None |
| ToolTipText | 悬浮提示 |
| ShortcutKeys | 快捷键(ToolStripMenuItem) |
| ShortcutKeyDisplayString | 快捷键显示文本 |
| Checked | 勾选态(ToolStripMenuItem) |
| CheckOnClick | 点击切换勾选 |
| Enabled | 禁用态 |
| Visible | 隐藏 |
| ImageScaling | SizeToFit 随 ImageScalingSize 缩放 |
| TextImageRelation | 图文相对位置 |
| Alignment | MenuItem 对齐 |
| Overflow | Never=不进溢出区 |
| MergeAction/MergeIndex | MDI 合并 |