DotNetBar for WinForms是一個擁有89個組件的用戶界面控件套包，用戶可以使用Visual Studio 2005-2015輕松地創建專業的用戶界面。十多年來DotNetBar幫助開發人員輕松地創建易用的專業Windows Forms (WinForms) 用戶界面。

點擊立即下載DotNetBar for WinForms

DotNetBar for WinForms中的TokenEditor控件是一個高級的文本框控件，它可以解析輸入并將其轉換為零件集（令牌）。這與現代電子郵件客戶端中的電子郵件地址輸入文本框非常相似，但更加靈活。每個文本部分的令牌在被接受之前都會經過驗證，因此如果未通過驗證，則可以將其拒絕。這是此控件的外觀示例：

TokenEditor控件的關鍵是EditToken對象。用戶輸入的文本將轉換為EditToken并在被接受之前進行驗證。EditToken對象使您可以將Value（例如，電子郵件地址）和Text（例如，電子郵件地址的實際名稱）與令牌相關聯，并在選定時分配要顯示在令牌文本旁邊的圖像或符號。

TokenEditor提供自動完成下拉列表，該列表將根據用戶輸入進行過濾，并允許您從預定義的令牌列表中選擇令牌。TokenEditor.Tokens集合存儲下拉列表中顯示的EditToken對象的列表：

此代碼顯示了如何填充令牌集合的示例，因此自動完成彈出窗口將顯示值：

// Load data into the TokenEditor for stored already recognized email addresses
tokenEmails.Tokens.Add(new EditToken("shawnsmith@yahoo.com", "Shawn Smith"));
tokenEmails.Tokens.Add(new EditToken("petebarley@gmail.com", "Pete Barley"));
tokenEmails.Tokens.Add(new EditToken("tobyhuck@email.com", "Toby Huck"));
tokenEmails.Tokens.Add(new EditToken("stevenratcliffe@proliancelimited.com", "Steven Ratcliffe"));
tokenEmails.Tokens.Add(new EditToken("dennissmith@gmail.com", "Dennis Smith"));

分隔符和驗證

當用戶在TokenEditor中輸入文本時，控件將監視Separators集合中列出的字符，遇到這些字符時，將對該文本進行解析，將其轉換為EditToken對象，并在接受該令牌并將其添加到SelectedTokens集合中之前，將ValidateToken事件設置為 引發您提供修改和驗證EditToken對象的機會。默認情況下，分隔符集合的逗號為“，”，分號為“;” 添加了用作標記分隔符的字符。

ValidateToken事件用于在將令牌添加到SelectedTokens集合之前對其進行驗證。ValidateTokenEventArgs是事件中提供的事件參數。您可以將IsValid屬性設置為false以拒絕令牌，例如，如果您正在驗證電子郵件地址，則代碼將如下所示：

Regex _MailRegex = new Regex(@"^[-a-z0-9!#$%&'*+/=?^_`{|}~]+(?:\.[-a-z0-9!#$%&'*+/=?^_`{|}~]+)*@(?:[a-z0-9]([-a-z0-9]{0,61}[a-z0-9])?\.)*(?:aero|arpa|asia|biz|cat|com|coop|edu|gov|info|int|jobs|mil|mobi|museum|name|net|org|pro|tel|travel|[a-z][a-z])$", RegexOptions.Compiled);
private void tokenEmails_ValidateToken(object sender, DevComponents.DotNetBar.Controls.ValidateTokenEventArgs ea)
{
    // Validate email address before allowing it into the SelectedTokens collection
    ea.IsValid = _MailRegex.IsMatch(ea.Token.Value);
}

• IsNewToken –指示令牌是用戶輸入的文本中新創建的Token還是Tokens集合中的現有Token。
• Token-返回對EditToken對象的引用，如果通過驗證，該引用將添加到SelectedTokens集合中，即IsValid = true（默認設置）。如果需要，可以對此對象執行修改。

從DotNetBar的12.2版本開始，就在Token編輯器控件中添加了功能，因此您可以將其用作多選組合框控件。為此，只需將CheckBoxesVisible和DropDownButtonVisible屬性設置為true，即可在Token編輯器中獲得下拉按鈕，以顯示帶有項目選擇的彈出窗口，并且彈出窗口將使用復選框指示當前選擇并允許選擇/取消選擇項目。由于默認情況下TokenEditor允許通過鍵盤輸入項來輸入新項，以禁止簡單地處理ValidateToken事件，并且如果事件參數IsNewToken屬性為true，則將IsValid = false設置為拒絕新項…

關鍵特性

• BackgroundStyle –返回一個對象，該對象定義控件背景的外觀及其邊框。
• CheckBoxesVisible –指示打開彈出窗口時是否在標記列表旁邊顯示復選框。 與DropDownButtonVisible屬性結合使用時，可以創建多選樣式組合框控件。
• DropDownButtonVisible –指示控件內部是否顯示下拉按鈕，單擊該按鈕可顯示彈出窗口。
• DropDownHeight –指示自動完成下拉菜單的高度。
• DropDownWidth –指示自動完成下拉菜單的寬度。
• EnablePopupResize –指示最終用戶是否可以調整自動完成彈出窗口的大小。
• EnterKeyValidatesToken –指示是否在將Token文本輸入到文本框中時按Enter鍵嘗試驗證Token并將文本轉換為Token。
• IsPopupOpen –指示是否打開自動完成彈出窗口。
• MaxHeightLines –表示當AutoSizeHeight = true時，控件將增加到的最大行數。 設置為0表示無限增長。
• PopupCloseButtonVisible –指示多列彈出窗口關閉按鈕是否可見。
• PreservePopupSize –指示如果最終用戶調整彈出窗口的大小，是否在彈出顯示之間保留自動完成的彈出窗口大小。
• ReadOnly –指示最終用戶可以添加還是刪除Token。默認值為false。
• RemoveTokenButtonVisible –指示是否在單個Token上顯示“刪除Token”按鈕，以便可以將其從選擇中刪除。
• 分隔符–分隔符的集合，用于將輸入的文本劃分為標記。
• Tokens–可供選擇的Token的集合。
• ValidateTokenTextOnLostFocus –指示當控件失去焦點時是否驗證輸入到Token編輯器中的任何文本并將其轉換為Token。

關鍵事件

• AutoCompletePopupOpened –打開自動完成彈出窗口后發生。
• BeforeAutoCompletePopupOpen –在打開自動完成彈出窗口之前發生，并允許您取消打開彈出窗口。
• RemoveToken –在最終用戶從SelectedTokens中刪除Token之前發生。
• SelectedTokensChanged –當SelectedTokens集合更改時發生。
• ValidateToken –當從自動完成列表中選擇一個Token或將最終用戶的文本輸入解析為令牌以對其進行驗證時，將發生ValidateToken。

關注慧聚IT微信公眾號???，了解產品的最新動態及最新資訊。