文字框類控制元件

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等。