C#：C#控件系列二 （文本框类控件）

文本框类控件

1. Label 控件

1.1. 常用属性：

1.1.1. Text属性：用来设置或返回标签控件中显示的文本信息。

1.1.2. AutoSize属性：用来获取或设置一个值，该值指示是否自动调整控件的大小以完整显示其内容。

——  取值为true时，控件将自动调整到刚好能容纳文本时的大小；

——  取值为false时，控件的大小为设计时的大小。默认值为false。

1.1.3. Anchor属性：用来确定此控件与其容器控件的固定关系的。

——  所谓容器控件指的是这样一种情况：

——  往往在控件之中还有一个控件，例如最典型的就是窗体控件中会包含很多的控件，像标签控件、文本框等。

——  这时称包含控件的控件为容器控件或父控件，而父控件称为子控件。

——  这时将遇到一个问题，即子控件与父控件的位置关系问题，

——  即当父控件的位置、大小变化时，子控件按照什么样的原则改变其位置、大小。

——  Anchor属性就规定了这个原则。对于 Anchor 属性，可以设定 Top、Bottom、Right、Left中的任意几种，。

1.1.4. BackColor属性：用来获取或设置控件的背景色。

——  当该属性值设置为Color.Transparent 时，标签将透明显示，即背景色不再显示出来。

1.1.5. BorderStyle属性：用来设置或返回边框。

——  有三种选择：

——  BorderStyle.None 为无边框（默认），

——  BorderStyle.FixedSingle为固定单边框，

——  orderStyle.Fixed3D 为三维边框。

1.1.6. TabIndex属性：用来设置或返回对象的Tab键顺序。

1.1.7. Enabled 属性：用来设置或返回控件的状态。

——  值为 true 时允许使用控件，

——  值为 false时禁止使用控件。

2. TextBox 控件

2.1. 主要属性：

2.1.1. Text属性：Text属性是文本框最重要的属性，因为要显示的文本就包含在Text属性中。

——  默认情况下，最多可在一个文本框中输入2048个字符。

——  如果将MultiLine属性设置为true，则最多可输入32KB的文本。

——  Text属性可以在设计时使用【属性】窗口设置，也可以在运行时用代码设置或者通过用户输入来设置。

——  可以在运行时通过读取Text属性来获得文本框的当前内容。

2.1.2. MaxLength 属性：用来设置文本框允许输入字符的最大长度，该属性值为 0 时，不限制输入的字符数。

2.1.3. MultiLine属性：用来设置文本框中的文本是否可以输入多行并以多行显示。

——  值为 true时，允许多行显示。

——  值为false时不允许多行显示，一旦文本超过文本框宽度时，超过部分不显示。

2.1.4. HideSelection属性：用来决定当焦点离开文本框后，选中的文本是否还以选中的方式显示，

——  值为true，则不以选中的方式显示，

——  值为false将依旧以选中的方式显示。

2.1.5. ReadOnly属性：用来获取或设置一个值，该值指示文本框中的文本是否为只读。

——  值为true时为只读，

——  值为 false时可读可写。

2.1.6. PasswordChar 属性：是一个字符串类型，允许设置一个字符，运行程序时，将输入到Text 的内容全部显示为该属性值，从而起到保密作用，通常用来输入口令或密码。UseSystemPasswordChar属性作用与其类似，默认为false，设置为true时，输入将显示为●；

2.1.7. ScrollBars属性： 用来设置滚动条模式，

——  有四种选择：

——  ScrollBars.None （无滚动条），

——  ScrollBars.Horizontal（水平滚动条），

——  ScrollBars.Vertical（垂直滚动条），

——  ScrollBars.Both（水平和垂直滚动条）。

——  注意：只有当MultiLine属性为true时，该属性值才有效。

——  在WordWrap属性值为true时，水平滚动条将不起作用

2.1.8. SelectionLength属性：用来获取或设置文本框中选定的字符数。只能在代码中使用，值为0 时，表示未选中任何字符。

2.1.9. SelectionStart属性：用来获取或设置文本框中选定的文本起始点。只能在代码中使用，第一个字符的位置为0，第二个字符的位置为1，依此类推。

2.1.10. SelectedText 属性：用来获取或设置一个字符串，该字符串指示控件中当前选定的文本。只能在代码中使用。

2.1.11. Lines：该属性是一个数组属性，用来获取或设置文本框控件中的文本行。即文本框中的每一行存放在 Lines数组的一个元素中。

2.1.12. Modified：用来获取或设置一个值，该值指示自创建文本框控件或上次设置该控件的内容后，用户是否修改了该控件的内容。

——  值为true表示修改过，

——  值为false表示没有修改过。

2.1.13. TextLength属性：用来获取控件中文本的长度。

2.1.14. WordWrap：用来指示多行文本框控件在输入的字符超过一行宽度时是否自动换行到下一行的开始，

——    值为true，表示自动换到下一行的开始，

——    值为false表示不自动换到下一行的开始。

2.1.15. AutoCompleteMode 属性：

——    Suggest：通过下拉列表显示所有匹配的

——    Append：将最匹配的项补全到已输入的内容中，并选中推荐的内容

——    SuggestAppend：Suggest和Append的结合

——    None：禁用自动补全

2.1.16. AutoCompleteMode 属性：当设置成 CustomSource 时，与 AutoCompleteCustomSource 属性配合使用，对象类型为 AutoCompleteStringCollection

2.2. 常用方法：

2.2.1. AppendText方法：把一个字符串添加到文件框中文本的后面，调用的一般格式如下：

——  文本框对象.AppendText(str)

——  参数 str 是要添加的字符串。

2.2.2. Clear方法：从文本框控件中清除所有文本。调用的一般格式如下：

——  文本框对象.Clear()

2.2.3. Focus方法：是为文本框设置焦点。

——  如果焦点设置成功，值为true，否则为false。

——  调用的一般格式如下：

——  文本框对象.Focus()

2.2.4. Copy方法：将文本框中的当前选定内容复制到剪贴板上。调用的一般格式如下：

——  文本框对象.Copy()

2.2.5. Cut方法：将文本框中的当前选定内容移动到剪贴板上。调用的一般格式如下：

——  文本框对象.Cut()

2.2.6. Paste方法：用剪贴板的内容替换文本框中的当前选定内容。调用的一般格式如下：

——  文本框对象.Paste()

2.2.7. Undo 方法：撤销文本框中的上一个编辑操作。调用的一般格式如下：

——  文本框对象.Undo()

2.2.8. ClearUndo方法：从该文本框的撤销缓冲区中清除关于最近操作的信息，根据应用程序的状态，可以使用此方法防止重复执行撤销操作。调用的一般格式如下：

——  文本框对象.ClearUndo()

2.2.9. Select方法：用来在文本框中设置选定文本。调用的一般格式如下：

——  文本框对象.Select(start,length)，

——  该方法有两个参数，

——  第一个参数start用来设定文本框中当前选定文本的第一个字符的位置，

——  第二个参数length用来设定要选择的字符数。

2.2.10. SelectAll方法：用来选定文本框中的所有文本。调用的一般格式如下：

——    文本框对象.SelectAll()

2.3. 常用事件：

2.3.1. GotFocus事件：该事件在文本框接收焦点时发生。

2.3.2. LostFocus事件：该事件在文本框失去焦点时发生。

2.3.3. TextChanged事件：该事件在Text属性值更改时发生。无论是通过编程修改还是用户交互更改文本框的 Text属性值，均会引发此事件。

3. RichTextBox控件

RichTextBox是一种既可以输入文本、 又可以编辑文本的文字处理控件，

与TextBox控件相比，RichTextBox控件的文字处理功能更加丰富，

不仅可以设定文字的颜色、 字体， 还具有字符串检索功能。

另外，RichTextBox控件还可以打开、编辑和存储.rtf格式文件、ASCII文本格式文件及Unicode编码格式的文件。

3.1. 常用属性：

上面介绍的 TextBox 控件所具有的属性，RichTextBox 控件基本上都具有，除此之外，该控件还具有一些其他属性。

3.1.1. RightMargin属性：用来设置或获取右侧空白的大小，单位是像素。

——  通过该属性可以设置右侧空白，如希望右侧空白为50像素，可使用如下语句：

——  RichTextBox1.RightMargin=RichTextBox1.Width-50;

3.1.2. Rtf属性：用来获取或设置RichTextBox控件中的文本，包括所有RTF格式代码。

——  可以使用此属性将RTF格式文本放到控件中以进行显示，或提取控件中的RTF格式文本。

——  此属性通常用于在RichTextBox控件和其他RTF源（如MicrosoftWord或 Windows写字板）之间交换信息。

3.1.3. SelectedRtf 属性：用来获取或设置控件中当前选定的 RTF格式的格式文本。

——  此属性使用户得以获取控件中的选定文本，包括RTF格式代码。

——  如果当前未选定任何文本，给该属性赋值将把所赋的文本插入到插入点处。

——  如果选定了文本，则给该属性所赋的文本值将替换掉选定文本。

3.1.4. SelectionColor属性：用来获取或设置当前选定文本或插入点处的文本颜色。

3.1.5. SelectionFont属性：用来获取或设置当前选定文本或插入点处的字体。

3.2. 常用方法：

前面介绍的 TextBox控件所具有的方法，RichTextBox 控件基本上都具有，除此之外，该控件还具有一些其他方法。

3.2.1. Redo方法：用来重做上次被撤销的操作。调用的一般格式如下：

——  RichTextBox对象.Redo()

3.2.2. Find方法：用来从RichTextBox控件中查找指定的字符串。

——  经常使用的调用格式如下：

——  [格式1]：RichTextBox对象.Find(str)

——  [功能]：在指定的“RichTextBox”控件中查找文本，并返回搜索文本的第一个字符在控件内的位置。如果未找到搜索字符串或者str参数指定的搜索字符串为空，则返回值为1。

——  [格式2]：RichTextBox对象.Find(str,RichTextBoxFinds)

——  [功能]：在“RichTextBox对象”指定的文本框中搜索 str参数中指定的文本，并返回文本的第一个字符在控件内的位置。如果返回负值，则未找到所搜索的文本字符串。还可以使用此方法搜索特定格式的文本。

——  参数RichTextBoxFinds指定如何在控件中执行文本搜索。

——  [格式3]：RichTextBox对象.Find(str,start,RichTextBoxFinds)

——  [功能]：这里Find方法与前面的格式2基本类似，不同的只是通过设置控件文本内的搜索起始位置来缩小文本搜索范围，

——  start参数表示开始搜索的位置。此功能使用户得以避开可能已搜索过的文本或已经知道不包含要搜索的特定文本的文本。如果在options参数中指定了RichTextBoxFinds.Reverse值，则start参数的值将指示反向搜索结束的位置，因为搜索是从文档底部开始的。

3.2.3. SaveFile方法：用来把RichTextBox中的信息保存到指定的文件中，调用格式有以下三种。

——  [格式1]：RichTextBox对象名.SaveFile(文件名);

——  [功能]：将 RichTextBox控件中的内容保存为RTF格式文件中。

——  [格式2]：RichTextBox对象名.SaveFile(文件名,文件类型);

——  [功能]：将RichTextBox控件中的内容保存为“文件类型”指定的格式文件中。

——  [格式3]：RichTextBox对象名.SaveFile(数据流,数据流类型);

——  [功能]：将RichTextBox控件中的内容保存为“数据流类型”指定的数据流类型文件中。

3.2.4. LoadFile方法：使用LoadFile方法可以将文本文件、RTF文件装入RichTextBox控件。主要的调用格式有以下三种：

——  [格式1]：RichTextBox对象名.LoadFile(文件名);

——  [功能]：将RTF格式文件或标准ASCII文本文件加载到RichTextBox控件中。

——  [格式2]：RichTextBox对象名.LoadFile(数据流,数据流类型);

——  [功能]：将现有数据流的内容加载到RichTextBox控件中。

——  [格式3]：RichTextBox对象名.LoadFile(文件名,文件类型);

——  [功能]：将特定类型的文件加载到RichTextBox控件中。

4. NumericUpDown 控件：

【Windows 窗体】控件组中的 NumericUpDown控件看起来像是一个文本框与一对用户可单击以调整值的箭头的组合。可以通过单击向上和向下按钮、按向上和向下箭头键来增大和减小数字，也可以直接输入数字。单击向上箭头键时，值向最大值方向增加；单击向下箭头键时，值向最小值方向减少。

4.1. 常用属性：

4.1.1. DecimalPlaces：获取或设置该控件中显示的小数位数。

4.1.2. Hexadecimal：获取或设置一个值，该值指示该控件是否以十六进制格式显示所包含的值。

4.1.3. Increment：获取或设置单击向上或向下按钮时，该控件递增或递减的值。

4.1.4. Maximum：获取或设置该控件的最大值。

4.1.5. Minimum：获取或设置该控件的最小值。

4.1.6. Value：获取或设置该控件的当前值。

与TextBox控件一样，NumericUpDown控件的常用事件有：

ValueChanged、GotFocus、LostFocus等。