Files
ctbjrj/.agents/skills/sd-enhanced-components/references/winforms-controls.md
T

120 KiB
Raw Blame History

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