120 KiB
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 合并 |