chfei/HandyControl
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
3.5.1
HandyControl/skills/handycontrol-wpf-native-styles/references/usage.md
T
chfei 5d81c475c8
Build / build (push) Canceled after 0s
Details
feat(skills): add HandyControl WPF component skills
2026-10-27 09:12:40 +08:00

218 lines
14 KiB
Markdown
Raw Permalink Blame History

# 原生 WPF 控件样式
这里处理 `System.Windows.Controls` 的原生类型。需要扩展控件功能时才选 `HandyControl.Controls` 下的类型。先按实际 CLR 类型选择样式，不能将一个同名扩展类型的样式套在原生类型上。
```xml
<StackPanel>
<Button Content="保存" Style="{StaticResource ButtonPrimary}"
Command="{Binding SaveCommand}"/>
<TextBox Margin="0,12,0,0" Style="{StaticResource TextBoxExtend}"
hc:InfoElement.Title="用户名" hc:InfoElement.Placeholder="请输入用户名"
Text="{Binding UserName, UpdateSourceTrigger=PropertyChanged}"/>
</StackPanel>
```
片段依赖 App.xaml 的皮肤和主题字典、hc 命名空间，以及使用方 DataContext。原生 PasswordBox 不提供可直接按 TextBox 方式绑定的 Text 属性；需要密码绑定时按实际控件方案实现。
附加属性来自 `Controls/Attach`：检查 InfoElement、TitleElement、BorderElement、IconElement 等的 Get/Set 方法和对应模板的使用位置。设置附加属性不代表任意模板都会展示它。
下面的显式 Style 键从本仓库各原生控件样式源文件生成；不是所有键都适用于控件本身（例如某些键针对子元素），使用前在源文件核对 TargetType。隐式样式和 BasedOn 链不在本清单展开。
## border
[src/Shared/HandyControl_Shared/Themes/Styles/Border.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Border.xaml)
显式样式键：`BorderRegion`、`BorderTipBaseStyle`、`BorderTipPrimary`、`BorderTipDanger`、`BorderTipWarning`、`BorderTipInfo`、`BorderTipSuccess`、`BorderVerticallySplitter`、`BorderHorizontallySplitter`、`BorderCircular`、`BorderClip`、`BorderCircularClip`
## button
[src/Shared/HandyControl_Shared/Themes/Styles/Button.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Button.xaml)
显式样式键：`ButtonDefault`、`ButtonDefault.Small`、`ButtonPrimary`、`ButtonPrimary.Small`、`ButtonSuccess`、`ButtonSuccess.Small`、`ButtonInfo`、`ButtonInfo.Small`、`ButtonWarning`、`ButtonWarning.Small`、`ButtonDanger`、`ButtonDanger.Small`、`ButtonIcon`、`ButtonIcon.Small`、`ButtonIconCircular`、`ButtonIconCircular.Small`、`ButtonDashed`、`ButtonDashed.Small`、`ButtonDashedPrimary`、`ButtonDashedPrimary.Small`、`ButtonDashedSuccess`、`ButtonDashedSuccess.Small`、`ButtonDashedInfo`、`ButtonDashedInfo.Small`、`ButtonDashedWarning`、`ButtonDashedWarning.Small`、`ButtonDashedDanger`、`ButtonDashedDanger.Small`、`ButtonCustom`、`ButtonGroupItemDefault`、`ButtonGroupItemHorizontalFirst`、`ButtonGroupItemHorizontalLast`、`ButtonGroupItemSingle`、`ButtonGroupItemVerticalFirst`、`ButtonGroupItemVerticalLast`
## calendar
[src/Shared/HandyControl_Shared/Themes/Styles/Calendar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Calendar.xaml)
显式样式键：`CalendarButtonStyle`、`CalendarDayButtonStyle`、`CalendarBaseStyle`
## checkBox
[src/Shared/HandyControl_Shared/Themes/Styles/CheckBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/CheckBox.xaml)
显式样式键：
## comboBox
[src/Shared/HandyControl_Shared/Themes/Styles/ComboBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ComboBox.xaml)
显式样式键：`ComboBoxItem.Small`、`ComboBox.Small`、`ComboBoxExtend`、`ComboBoxExtend.Small`、`ComboBoxPlus.Small`
## contentControl
[src/Shared/HandyControl_Shared/Themes/Styles/ContentControl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ContentControl.xaml)
显式样式键：
## contextMenu
[src/Shared/HandyControl_Shared/Themes/Styles/ContextMenu.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ContextMenu.xaml)
显式样式键：`ContextMenu.Small`
## dataGrid
[src/Shared/HandyControl_Shared/Themes/Styles/DataGrid.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/DataGrid.xaml)
显式样式键：`DataGridBaseStyle`、`DataGridCellStyle.Small`、`DataGridRowStyle.Small`、`DataGridColumnHeaderStyle.Small`、`DataGrid.Small`
## datePicker
[src/Shared/HandyControl_Shared/Themes/Styles/DatePicker.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/DatePicker.xaml)
显式样式键：`DatePicker.Small`、`DatePickerExtend`、`DatePickerExtend.Small`、`DatePickerPlus.Small`
## expander
[src/Shared/HandyControl_Shared/Themes/Styles/Expander.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Expander.xaml)
显式样式键：`Expander.Small`
## flowDocument
[src/Shared/HandyControl_Shared/Themes/Styles/FlowDocument.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/FlowDocument.xaml)
显式样式键：
## frame
[src/Shared/HandyControl_Shared/Themes/Styles/Frame.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Frame.xaml)
显式样式键：
## groupBox
[src/Shared/HandyControl_Shared/Themes/Styles/GroupBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/GroupBox.xaml)
显式样式键：`GroupBox.Small`、`GroupBoxOriginal`、`GroupBoxTab`、`GroupBoxTab.Small`
## label
[src/Shared/HandyControl_Shared/Themes/Styles/Label.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Label.xaml)
显式样式键：`LabelDefault`、`LabelDefault.Small`、`LabelPrimary`、`LabelPrimary.Small`、`LabelSuccess`、`LabelSuccess.Small`、`LabelInfo`、`LabelInfo.Small`、`LabelWarning`、`LabelWarning.Small`、`LabelDanger`、`LabelDanger.Small`
## listBox
[src/Shared/HandyControl_Shared/Themes/Styles/ListBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ListBox.xaml)
显式样式键：`ListBoxItemBaseStyle.Small`、`ListBox.Small`、`ListBoxItemCustom`、`ListBoxCustom`、`WrapPanelHorizontalListBox`、`WrapPanelVerticalListBox`、`StackPanelHorizontalListBox`、`StackPanelVerticalListBox`
## listView
[src/Shared/HandyControl_Shared/Themes/Styles/ListView.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ListView.xaml)
显式样式键：`ListViewBaseStyle`、`ListViewItemBaseStyle.Small`、`ListView.Small`
## menu
[src/Shared/HandyControl_Shared/Themes/Styles/Menu.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Menu.xaml)
显式样式键：`Menu.Small`
## passwordBox
[src/Shared/HandyControl_Shared/Themes/Styles/PasswordBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/PasswordBox.xaml)
显式样式键：`PasswordBox.Small`、`PasswordBoxExtend`、`PasswordBoxExtend.Small`、`PasswordBoxPlus.Small`
## progressBar
[src/Shared/HandyControl_Shared/Themes/Styles/ProgressBar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ProgressBar.xaml)
显式样式键：`ProgressBarSuccess`、`ProgressBarInfo`、`ProgressBarWarning`、`ProgressBarDanger`、`ProgressBarPrimaryStripe`、`ProgressBarSuccessStripe`、`ProgressBarInfoStripe`、`ProgressBarWarningStripe`、`ProgressBarDangerStripe`、`ProgressBarSuccessCircle`、`ProgressBarInfoCircle`、`ProgressBarWarningCircle`、`ProgressBarDangerCircle`、`ProgressBarSuccessWave`、`ProgressBarInfoWave`、`ProgressBarWarningWave`、`ProgressBarDangerWave`、`ProgressBarFlat`
## radioButton
[src/Shared/HandyControl_Shared/Themes/Styles/RadioButton.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/RadioButton.xaml)
显式样式键：`RadioButtonSameAsButtonDefault`、`RadioButtonSameAsButtonDefault.Small`、`RadioButtonSameAsButtonPrimary`、`RadioButtonSameAsButtonPrimary.Small`、`RadioButtonSameAsButtonSuccess`、`RadioButtonSameAsButtonSuccess.Small`、`RadioButtonSameAsButtonInfo`、`RadioButtonSameAsButtonInfo.Small`、`RadioButtonSameAsButtonWarning`、`RadioButtonSameAsButtonWarning.Small`、`RadioButtonSameAsButtonDanger`、`RadioButtonSameAsButtonDanger.Small`、`RadioButtonIcon`、`RadioButtonIcon.Small`、`RadioGroupItemDefault`、`RadioGroupItemHorizontalFirst`、`RadioGroupItemHorizontalLast`、`RadioGroupItemSingle`、`RadioGroupItemVerticalFirst`、`RadioGroupItemVerticalLast`
## richTextBox
[src/Shared/HandyControl_Shared/Themes/Styles/RichTextBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/RichTextBox.xaml)
显式样式键：`TextBoxBaseBaseStyle`、`RichTextBoxBaseStyle`
## scrollViewer
[src/Shared/HandyControl_Shared/Themes/Styles/ScrollViewer.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ScrollViewer.xaml)
显式样式键：`ScrollViewerUpDownRepeatButtonStyle`、`ScrollViewerUpDown`
## separator
[src/Shared/HandyControl_Shared/Themes/Styles/Separator.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Separator.xaml)
显式样式键：
## slider
[src/Shared/HandyControl_Shared/Themes/Styles/Slider.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Slider.xaml)
显式样式键：
## statusBar
[src/Shared/HandyControl_Shared/Themes/Styles/StatusBar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/StatusBar.xaml)
显式样式键：
## tabControl
[src/Shared/HandyControl_Shared/Themes/Styles/TabControl.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TabControl.xaml)
显式样式键：`TabItemSliding`、`TabControlSliding`、`TabItemInLine`、`TabControlInLine`、`TabItemCapsuleDefault`、`TabItemCapsuleHorizontalFirst`、`TabItemCapsuleHorizontalLast`、`TabItemCapsuleSingle`、`TabItemCapsuleVerticalFirst`、`TabItemCapsuleVerticalLast`、`TabControlCapsule`、`TabControlCapsuleSolid`
## textBlock
[src/Shared/HandyControl_Shared/Themes/Styles/TextBlock.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TextBlock.xaml)
显式样式键：`TextBlockDefault`、`TextBlockDefaultAccent`、`TextBlockDefaultPrimary`、`TextBlockDefaultDanger`、`TextBlockDefaultWarning`、`TextBlockDefaultInfo`、`TextBlockDefaultSuccess`、`TextBlockDefaultSecLight`、`TextBlockDefaultThiLight`、`TextBlockLarge`、`TextBlockTitle`、`TextBlockSubTitle`、`TextBlockLargeBold`、`TextBlockTitleBold`、`TextBlockSubTitleBold`、`TextBlockDefaultBold`
## textBox
[src/Shared/HandyControl_Shared/Themes/Styles/TextBox.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TextBox.xaml)
显式样式键：`TextBox.Small`、`TextBoxExtend`、`TextBoxExtend.Small`、`TextBoxPlus.Small`
## toggleButton
[src/Shared/HandyControl_Shared/Themes/Styles/ToggleButton.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ToggleButton.xaml)
显式样式键：`ToggleButtonDefault`、`ToggleButtonDefault.Small`、`ToggleButtonPrimary`、`ToggleButtonPrimary.Small`、`ToggleButtonSuccess`、`ToggleButtonSuccess.Small`、`ToggleButtonInfo`、`ToggleButtonInfo.Small`、`ToggleButtonWarning`、`ToggleButtonWarning.Small`、`ToggleButtonDanger`、`ToggleButtonDanger.Small`、`ToggleButtonIcon`、`ToggleButtonIcon.Small`、`ToggleButtonIconPrimary`、`ToggleButtonIconPrimary.Small`、`ToggleButtonIconSuccess`、`ToggleButtonIconSuccess.Small`、`ToggleButtonIconInfo`、`ToggleButtonIconInfo.Small`、`ToggleButtonIconWarning`、`ToggleButtonIconWarning.Small`、`ToggleButtonIconDanger`、`ToggleButtonIconDanger.Small`、`ToggleButtonIconTransparent`、`ToggleButtonIconTransparent.Small`、`ToggleButtonSwitch`、`ToggleButtonSwitch.Small`、`ToggleButtonFlip`、`ToggleButtonFlip.Small`、`ToggleButtonCustom`、`ToggleButtonGroupItemDefault`、`ToggleButtonGroupItemHorizontalFirst`、`ToggleButtonGroupItemHorizontalLast`、`ToggleButtonGroupItemSingle`、`ToggleButtonGroupItemVerticalFirst`、`ToggleButtonGroupItemVerticalLast`、`ToggleButtonLoadingPrimary`、`ToggleButtonLoading`、`ToggleButtonLoadingSuccess`、`ToggleButtonLoadingInfo`、`ToggleButtonLoadingWarning`、`ToggleButtonLoadingDanger`
## toolBar
[src/Shared/HandyControl_Shared/Themes/Styles/ToolBar.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ToolBar.xaml)
显式样式键：
## toolTip
[src/Shared/HandyControl_Shared/Themes/Styles/ToolTip.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/ToolTip.xaml)
显式样式键：
## treeView
[src/Shared/HandyControl_Shared/Themes/Styles/TreeView.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/TreeView.xaml)
显式样式键：`TreeViewItemBaseStyle.Small`、`TreeView.Small`
## window
[src/Shared/HandyControl_Shared/Themes/Styles/Window.xaml](https://github.com/HandyOrg/HandyControl/blob/master/src/Shared/HandyControl_Shared/Themes/Styles/Window.xaml)
显式样式键：`WindowWin10`、`WindowBlur`、`WindowGlow`
Reference in new issue View Git Blame Copy Permalink