格式设置
支持格式设置机制的 DevExpress 控件都包含 FormatInfo 类的属性,它们指定了用于为不同控件元素设置格式的配置。 FormatInfo 类声明了两个可以在设计时刻使用的属性: FormatInfo.FormatType 和 FormatInfo.FormatString。
FormatInfo.FormatType 属性要设置为一个适当的值,以指示将要设置格式的值的类型。
FormatInfo.FormatType 取值 | 说明 |
---|---|
FormatType.Numeric | 指明要对数值设置格式。 |
FormatType.DateTime | 指明要对日期/时间值设置格式。 |
FormatType.None | 不设置格式。 |
FormatType.Custom | 指明:
- 使用 复合格式设置功能 为字符串值设置格式,或者 - 使用自定义格式提供程序来设置格式,在 自定义格式设置 主题进行了叙述。 |
FormatInfo.FormatString 属性需要被设置为一个格式说明符,或由格式说明符组成的格式字符串。 将依照指定的模式来为值设置格式。
有一组预定义的格式说明符,用于为数字和日期/时间值设置格式。 输出结果取决于最终用户计算机的区域设置。 但是,这些说明符允许你根据预定义格式,对值设置格式 (例如,一个日期/时间值可以根据系统中预定义的格式,被设置为短日期、长日期或完整日期/时间格式)。
如果你需要更强大的格式设置控制,那么你需要使用自定义格式字符串。 这些格式字符串允许你构造自己的格式模式,把自定义文本添加到格式值中,为正数或负数值指定不同的格式等。 但是,当使用自定义格式字符串时,你不能总是为值设置好格式,因为要考虑用户的区域选项来正确地显示它们。 在这种情况下,最好是在运行时刻构造格式字符串,以便于区域设置可以被考虑进去。 Thread.CurrentThread.CurrentCulture 属性可以用于实现这一目的。
注意 |
---|
要设置 FormatInfo.FormatString,则只应该在修改 FormatInfo.FormatType 属性之后进行。 否则,格式字符串会丢失。 |
请参阅 格式说明符 主题了解关于可用的格式说明符的信息。
DevExpress 控件公开的格式设置属性
下表列出了 DevExpress WinForms 控件公开的 FormatInfo 类型的属性:
DevExpress 控件 | 格式设置属性 |
---|---|
XtraGrid | GridColumn.DisplayFormat - 设置列值的格式。 |
XtraEditors |
RepositoryItem.DisplayFormat - 设置未获得焦点的编辑器值的格式;
RepositoryItem.EditFormat - 设置获得焦点的编辑器值的格式。 要允许最终用户在编辑器内根据指定的模式输入文本,则使用掩码。 即使是在显示模式下(某个编辑器不是活动的编辑器),掩码也可以用于为值设置格式。 |
XtraTreeList | TreeListColumn.Format - 为列值设置格式。 |
XtraVerticalGrid | RowProperties.Format - 为行值设置格式。 |
XtraPivotGrid |
PivotGridFieldBase.CellFormat - 为数据区内的值设置格式;
PivotGridFieldBase.ValueFormat - 为列标头区和行标头区内的值设置格式; PivotGridFieldBase.TotalCellFormat - 为合计设置格式; PivotGridFieldBase.GrandTotalCellFormat - 为总计设置格式。 |