ComponentOne中文技术文档
页面树结构
转至元数据结尾
转至元数据起始

在程序运行时C1DateEdit 控件获得焦点的时候，如果在键盘上点击回车键或者Tab键，或者使用鼠标点击其他控件，
C1DateEdit 控件会丢失焦点，当同时当前日期会被自动填充至控件。
如果不希望C1DateEdit 控件在丢失焦点的时候被填充，参照下面的步骤：使用设计器：

  1. 创建一个新的.NET 程序，添加C1DateEdit控件和C1TextBox控件到表单上。
  2. 在属性窗口设置C1DateEdit.NullText属性为 "｛Empty Value｝"。

运行程序选中 C1Date Edit 控件，使用鼠标或者键盘让 C1TextBox 获得焦点，当前时间会显示在 C1DateEdit 控件中。

注意到焦点确实被移至C1TextBox 控件，但是当前日期被填充至C1DateEdit。

  1. 使用属性窗口将C1DateEdit1的DateTimeInput属性更改为False，C1DateEdit1的EmptyAsNull属性更改为True.
  2. 运行程序点击C1DateEdit 和C1TextBox控件。


注意到焦点被移至C1TextBox，C1DateEdit 控件将继续保留空值。

使用代码：

  1. 创建一个 .NET工程，并且添加 C1Input 控件的引用。

在代码中导入C1Input的命名空间。
Visual Basic

Visual Basic

Imports C1.Win.C1Input

C#

C#

using C1.Win.C1Input;

  1. 在Form_Load 事件中添加C1DateEdit控件和C1TextBox 控件。

Visual Basic

Visual Basic

Dim X As New C1DateEdit
Controls.Add(X)
X.Location = New Point(50, 40)
Dim Y As New C1TextBox
Controls.Add(Y)
Y.Location = New Point(100, 80)

C#

C#

C1DateEdit X = new C1DateEdit();
Controls.Add(X);
X.Location = new Point(50, 40);

C1TextBox Y = new C1TextBox();
Controls.Add(Y);
Y.Location = new Point(100, 80);

  1. 为了设置空值的时候控件显示的字符，添加下面的代码：

Visual Basic

Visual Basic

X.NullText = "{Empty Value}"

C#

C#

X.NullText = "{Empty Value}";

运行程序选中 C1Date Edit 控件，使用鼠标或者键盘让 C1TextBox 获得焦点，当前时间会显示在 C1DateEdit 中。

  1. 如果需要在 C1Date Edit 丢失焦点的时候保留空值，使用下面的代码：

Visual Basic

Visual Basic

X.DateTimeInput = False
X.EmptyAsNull = False

C#

C#

X.DateTimeInput = False;
X.EmptyAsNull = False;

  1. 运行程序点击C1TextBox控件，将焦点移至C1TextBox，C1DateEdit 控件将继续保留空值。

为C1Input控件显示带颜色边框

边框的颜色可以应用到C1DateEdit，C1Label，C1NumericEdit，C1DropDownControl，以及C1TextBox控件上。在设计时为在设计时为C1DropDownControl创建带颜色的边框创建带颜色的边框

  1. 添加一个C1DropDownControl至窗体。
  2. 导航到C1DropDownControl的属性窗体，并设置BorderStyle属性为"FixedSingle"。
  3. 设置C1DropDownControl的BorderColor属性的值为"Red"。

当边框颜色变化时显示一个消息框当边框颜色变化时显示一个消息框
使用以下代码为C1DropDownControl添加一个带有颜色的边框：
Visual Basic

Visual Basic

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
Dim dropdown As New C1DropDownControl Me.Controls.Add(dropdown) dropdown.BorderStyle = BorderStyle.FixedSingle dropdown.BorderColor = Color.Red
End Sub

C#

C#

private void Form1_Load(object sender, EventArgs e) { C1DropDownControl dropdown = new C1DropDownControl(); this.Controls.Add(dropdown); dropdown.BorderStyle = BorderStyle.FixedSingle; dropdown.BorderColor = Color.Red;
}

本主题说明如下：

FixedSingle样式的红色边框将添加到C1DropDownControl。

当边框颜色变化时显示一个消息框

您可以使用BorderColorChanged事件，该事件在BorderColor属性的值发生变化时触发。为了在C1TextBox边框颜色发生变化时创建一个消息框，请完成以下步骤：

  1. 向您的窗体添加一个C1TextBox。
  2. 导航至C1TextBox的属性窗体，并修改BorderStyle属性为"FixedSingle"。
  3. 向C1TextBox控件添加对MouseClick事件的处理，以改变C1TextBox的边框颜色为紫色。

Visual Basic

Visual Basic

Private Sub C1TextBox1_MouseClick(ByVal sender As System.Object, ByVal e As
System.Windows.Forms.MouseEventArgs) Handles C1TextBox1.MouseClick
C1TextBox1.BorderColor = Color.Purple
End Sub

C#

C#

private void c1TextBox1_MouseClick(object sender, MouseEventArgs e) { c1TextBox1.BorderColor = Color.Purple;
}

  1. 向C1TextBox1添加BorderColorChanged事件处理，以显示一个消息框提示用户边框的颜色发生了变化。

Visual Basic

Visual Basic

Private Sub C1TextBox1_BorderColorChanged(ByVal sender As System.Object, ByVal e
As System.EventArgs) Handles C1TextBox1.BorderColorChanged
MessageBox.Show("The C1TextBox1 border color change to purple")
End Sub

C#

C#

private void c1TextBox1_BorderColorChanged(object sender, EventArgs e) {
MessageBox.Show("The c1TextBox1 border color changed to purple");
}

本主题说明如下：本主题说明如下：
当您鼠标单击C1TextBox控件时，边框颜色将变为紫色。一旦该颜色变为紫色，将触发BorderColorChanged，此时将出现一个消息框，提示用户边框的颜色发生了变化。

设置输入法模式

ImeMode属性可以被用作设置C1Input控件的输入法编辑器（IME）模式。输入法编辑器是一个程序，允许用户输入复杂的字符或符号，如日文汉字字符，至输入控件，使用一个基础的键盘。
下表介绍ImeMode属性可用的属性值。

值值

描述描述

On

表示IME为开启状态。中文或日文特定的字符或符号可以输入。仅针对日文，简体中文以及繁体中文有效。

Off

表示IME为关闭状态。该对象和英文输入模式行为一致。仅针对日文，简体中文以及繁体中文有效。

Disable

表示输入法是禁用的。这意味着IME窗口被隐藏，并且用户无法通过键盘切换IME为打开状态。

Hiragana

平假名双字节字符。仅针对日文输入法有效。

Katakana

片假名双字节字符。仅针对日文输入法有效。

KatakanaHalf

单字节片假名字符。仅针对日文输入法有效。

AlphaFull

双字节字符的字母和数字。仅针对韩文和日文输入法有效。

Alpha

单字节字符的字母和数字。仅针对韩文和日文输入法有效。

HangulFull

韩文双字节字符。只针对韩文输入法有效。

NoControl

None （默认值）。

Inherit

表示输入法模式继承自父控件。

Close

表示IME为关闭状态。只适用于中文输入法。

Hangul

韩文单字节字符。只适用于韩文输入法。

OnHalf

表示输入法为HalfShape。只适用于中文输入法。

完成以下步骤，以更改C1Input控件的输入法模式：

  1. 创建一个新的Windows应用程序工程。放置一个C1Input控件（C1TextBox，C1ComboBox，C1DateEdit，

C1DropDownControl 或者 C1NumericEdit）至窗体。

  1. 从属性窗体，设置ImeMode属性为您需要的值。

移动焦点

该功能使得在不同控件之间导航更容易，同时允许您向C1Input（C1TextBox，C1ComboBox，C1DateEdit，
C1DropDownControl 以及 C1NumericEdit）控件添加键盘导航支持。以下属性允许您移动焦点至C1Input控件或者从
C1Input控件移出焦点。
ExitOnLastChar:当输入的文本长度达到最大长度限制，如MaxLength属性定义的值，或者当输入掩码填充完毕时，从C1Input控件移出焦点。其默认值为False。
ExitOnLeftRightKey:当左或者右方向键按下时，将焦点从C1Input控件移出。其默认值是None。
TabStop:指示当焦点在C1Input控件的上一个控件时，按下TAB键是否允许接收焦点至C1Input控件。其默认值是
True。
下表描述了上述属性可用的选项值和行为。

属性属性

可能的值可能的值

描述描述

ExitOnLastChar

True

当输入的文本长度达到使用MaxLength定义的最大长度显示，或者当输入掩码填充完毕时，允许从C1Input控件

 

 

移动焦点至下一个控件。

 

False

当输入的文本长度达到使用MaxLength定义的最大长度
显示，或者当输入掩码填充完毕时，不会自动地从
C1Input控件移动焦点至下一个控件。

ExitOnLeftRightKey

None

当方向键按下时，不会从C1Input控件移动焦点到上一个或下一个控件。

 

Left

当左方向键被按下时，允许位于C1Input控件左侧的焦点移动到C1Input控件的上一个控件。

 

Right

当右方向键被按下时，允许位于C1Input控件右侧的焦点移动到C1Input控件的下一个控件。

 

Both

当相关的按键被按下时，允许焦点从C1Input的最左侧或者最右侧移动到上一个或者下一个控件。

TabStop

True

当焦点在C1Input控件的上一个控件时，按下TAB键允许接收焦点至C1Input控件。

 

False

当焦点在C1Input控件的上一个控件时，按下TAB键允许禁止焦点至C1Input控件。

完成以下步骤来启用或禁用C1Input控件的功能：

  1. 创建一个新的Windows应用程序工程。放置一个C1Input控件（C1TextBox，C1ComboBox，C1DateEdit， C1DropDownControl 或者 C1NumericEdit）至窗体。
  2. 从属性窗体中，设置一个或全部的以下属性为您期望的设置。

设置ExitOnLastChar为True或False，启用或禁用当输入的文本达到最大长度限制时，从控件移出焦点。
ExitOnLeftRightKey为Left，Right或者Both，以启用当按下相应的方向按键时，从控件移出焦点。设置TabStop属性为True或False，以启用或禁用当Tab键按下时，是否移动焦点到C1Input控件上。

选择特定的日历类型

位于C1DateEdit以及C1NumericEdit 控件上的CalendarType属性，允许您选择特定的非默认日历。C1DateEdit 以及 C1NumericEdit 支持以下日历类型：
Default
ChineseLuniSolarCalendar
EastAsianLunisolarCalendar
GregorianCalendar
HebrewCalendar
HijriCalendar
JapaneseCalendar
JapaneseLunisolarCalendar
JulianCalendar
KoreanCalendar
KoreanLunisolarCalendar
TaiwanCalendar
TaiwanLunisolarCalendar
ThaiBuddhistCalendar
UmAlQuraCalendar
完成以下步骤以修改C1Input控件的日历类型：

  1. 创建一个新的Windows应用程序工程。在窗体上放置一个C1Input控件（C1DateEdit或者C1NumericEdit）。
  2. 从属性窗口设置CalendarType属性为您期望的值。
  • 无标签