1752 lines
120 KiB
Markdown
1752 lines
120 KiB
Markdown
# 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 | |