CalendarEx 日历控件
控件名称
CalendarEx
中文名称
日历控件
控件优点
CalendarEx 是一个功能丰富的日历控件，支持日期选择、农历显示、范围限制、自定义标记等功能。适用于日期选择、日程管理、数据展示等场景。
主要特性
- 日期选择：支持单日期选择
- 农历显示：支持显示农历日期，融合 ChineseDate 类库，支持多种农历格式
- 范围限制：支持设置可选日期范围
- 自定义标记：支持自定义日期文本和标记
- 多种模式：支持凸出和扁平两种显示模式
- 日期导航：支持月份切换和快速跳转
重要参数说明
基本属性
| 属性名 |
类型 |
默认值 |
说明 |
Date |
DateTime |
当前日期 |
当前选中的日期 |
DisplayDate |
DateTime |
当前日期 |
当前显示的月份 |
DisplayMode |
CalendarDisplayMode |
Elevated |
显示模式 |
ShowChinese |
bool |
false |
是否显示农历 |
ChineseDateFormat |
ChineseDateFormat |
DayOnly |
农历显示格式 |
ShowWeekDay |
bool |
true |
是否显示星期几 |
WorkDayOnly |
bool |
false |
是否只显示工作日 |
显示模式（CalendarDisplayMode）
| 模式值 |
说明 |
Elevated |
凸出模式（类似按钮，有立体感） |
Flat |
扁平模式（只有激活的日期高亮） |
农历显示格式（ChineseDateFormat）
| 格式值 |
说明 |
示例 |
DayOnly |
只显示农历日 |
初一、初二、十五 |
MonthDay |
显示农历月日 |
正月初一、正月十四 |
Full |
完整格式（天干地支+月日） |
甲子年正月初一 |
WithAnimal |
带生肖 |
鼠年正月初一 |
EraOnly |
仅显示天干地支 |
甲子、乙丑 |
AnimalOnly |
仅显示生肖 |
鼠、牛、虎 |
范围限制
| 属性名 |
类型 |
默认值 |
说明 |
MinDate |
DateTime? |
null |
最小可选日期 |
MaxDate |
DateTime? |
null |
最大可选日期 |
外观属性
| 属性名 |
类型 |
默认值 |
说明 |
PrimaryColor |
Color |
#1890ff |
主题色（选中日期） |
TodayColor |
Color |
#ff8000 |
今天标识颜色 |
TextColor |
Color |
Black |
日期文本颜色 |
WeekDayTextColor |
Color |
#969696 |
星期几文本颜色 |
OtherMonthTextColor |
Color |
Silver |
其他月份文本颜色 |
DisabledTextColor |
Color |
#3c3c3c |
禁用日期文本颜色 |
BackgroundColor |
Color |
White |
控件背景色 |
DayBackgroundColor |
Color |
AliceBlue |
日期背景色 |
SelectedDayColor |
Color |
#1890ff |
选中日期颜色 |
ActivedForeColor |
Color |
White |
选中日期字体颜色 |