Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]ASP.NET WebForms Controls
 [Collapse]ASP.NET MVC Extensions
  [Expand]Product Information
  [Expand]Getting Started
  [Expand]Common Concepts
  [Expand]Grid View
  [Expand]Card View
  [Expand]Vertical Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]HTML Editor
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Expand]Navigation and Layout Extensions
  [Expand]File Management
  [Expand]Multi-Use Site Extensions
  [Expand]Charts
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Tree List
  [Collapse]Data Editor Extensions
    Editor List
    Main Features
   [Expand]Common Concepts
   [Collapse]Editor Types
    [Expand]BinaryImage
    [Expand]Button
    [Expand]ButtonEdit
    [Expand]Calendar
    [Expand]Captcha
    [Expand]CheckBox
    [Collapse]CheckBoxList
      Overview - CheckBoxList
      CheckBoxList Main Features
    [Expand]ColorEdit
    [Expand]ComboBox
    [Expand]DateEdit
    [Expand]DropDownEdit
    [Expand]GridLookup
    [Expand]HyperLink
    [Expand]Image
    [Expand]Label
    [Expand]ListBox
    [Expand]Memo
    [Expand]ProgressBar
    [Expand]RadioButton
    [Expand]RadioButtonList
    [Expand]SpinEdit
    [Expand]TextBox
    [Expand]TimeEdit
    [Expand]TokenBox
    [Expand]TrackBar
    [Expand]ValidationSummary
   [Expand]Strongly-Typed Editor Types
  [Expand]Report Extensions
  [Expand]SpellChecker
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

CheckBoxList Main Features

The CheckBoxList editor is a check box group that provides end-users with the ability to select multiple items.

The CheckBoxList supports both data-bound and unbound modes. This means that its contents can be generated dynamically by binding the editor to a data source, as well as manually populating the control's item collection.

Selection

The items selected within CheckBoxList can be determined by iterating through all list items and inspecting an item's ListEditItem.Selected property, or by using specific properties declared at the editor level (ASPxCheckBoxList.SelectedItems, ASPxCheckBoxList.SelectedIndices, ASPxCheckBoxList.SelectedValues). You can easily select/unselect all editor items by using the SelectAll/UnselectAll methods that are available on both server (ASPxCheckBoxList.SelectAll/ASPxCheckBoxList.UnselectAll) and client (ASPxClientCheckBoxList.SelectAll/ASPxClientCheckBoxList.UnselectAll) sides.

Layout Customization

The CheckBoxList layout is flexibly customized. You can display check box items in several columns using the CheckBoxListSettings.Properties.RepeatColumns (CheckListPropertiesBase.RepeatColumns), set a direction of items within the editor (horizontal or vertical through the CheckBoxListSettings.Properties.RepeatDirection (CheckListPropertiesBase.RepeatDirection) property), and specify whether items are aligned within a table or rendered without any table structure using the CheckBoxListSettings.Properties.RepeatLayout (CheckListPropertiesBase.RepeatLayout).

Custom Item Images

The CheckBoxList editor allows you to specify images for its items. You can specify one image for all items within the control using the CheckBoxListSettings.Properties.ItemImage (ASPxCheckListBase.ItemImage) property, or set a particular image for each item using the item's CheckBoxListSettings.Properties.ImageUrl (ListEditItem.ImageUrl) property.

How would you rate this topic?​​​​​​​