如何使用UltraDateTimeEditor

1.0 摘要

 

本文将介绍UltraDateTimeEditor的常规使用。

2.0 内容

(1)   UltraDateTimeEditor是用来获取日期时间的控件. 如下图所示：

(2)设置UltraDateTimeEditor显示的格式

      根据操作系统的环境, UltraDateTimeEditor会有默认的显示格式,如在中文XP系统下会是下面的效果:

     

 但有时可能需要显示其他语言环境下的格式, 可通过Format Provider来改变Format,如下图,或直接在属性中修改该属性

     

      弹出下面的界面,这里选美国:

     

     

      或者可以通过代码实现:

            System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo("en-US");

            ultraDateTimeEditor1.FormatProvider = culture;

 

      Format 就会变成下面的形式:

     

(3) UltraDateTimeEditor中的掩码显示模式

下图中, 我们可以看到UltraDateTimeEditor中显示的一个日期,其中下划线叫Prompt, “年””月””日”叫Literals,它们的作用只是在输入日期时给人一种提示,本身并不影响日期的值, 当输入完成离开该控件时,如果不再需要显示它们, 可以通过MaskDisplayMode属性来实现.

      

  MaskDisplayMode可以确定当UltraDateTimeEditor失去focus时Prompt及Literals的是否显示.如IncludeLiterals只显示Literals, IncludeBoth则都显示.

      

(4)设置不同的掩码输入

      在中文XP操作系统中UltraDateTimeEditor的默认的掩码输入是Date1,也就是下面的效果:

     

      有时候可能除了要输入日期,还需要输入时间, 这时可通过设置MaskInput属性来实现,

     

      下面设置红色框中的掩码输入

     

      效果将变成如下：

       

(5)取得UltraDateTimeEditor中的值,

可通过ultraDateTimeEditor的value属性获得:

ultraLabel1.Text = ultraDateTimeEditor1.Value.ToString();

得到的值是如下, 这种格式是根据当前操作系统环境得到的:

             

       (6)设置UltraDateTimeEditor的值

              设置UltraDateTimeEditor值除了通过在下拉框中选择外也可以在代码中赋值,

              UltraDateTimeEditor接受的值是DateTime型的,如下所示:

            DateTime dtSet = new DateTime(2007, 1, 1);

            ultraDateTimeEditor1.Value = dtSet;

 

(7)设置日期的可选范围

在设计时可通过MaxDate和MinDate设定:

在运行时设定:

            // Declare 2 variables of type DateTime; one for the MinDate and one for the MaxDate

            DateTime dtStart = new DateTime(2007, 1, 1);

            DateTime dtEnd = new DateTime(2007, 12, 31);

 

            // Assign the date values to the element's MinDate and MaxDate properties

            this.ultraDateTimeEditor1.MinDate = dtStart;

            this.ultraDateTimeEditor1.MaxDate = dtEnd;