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