CheckBoxList.CellPadding Property
Gets or sets the distance (in pixels) between the border and contents of the cell.
[Visual Basic] Public Overridable Property CellPadding As Integer [C#] public virtual int CellPadding {get; set;} [C++] public: __property virtual int get_CellPadding(); public: __property virtual void set_CellPadding(int); [JScript] public function get CellPadding() : int; public function set CellPadding(int);
Property Value
The distance (in pixels) between the border and contents of the cell. The default is -1, which indicates this property is not set.
Remarks
Use this property to control the spacing between the contents of a cell and the cell's border in the CheckBoxList control.
The padding amount specified is added to all four sides of a cell with the height of the tallest cell and width of the widest cell in the CheckBoxList control. The resulting cell size is applied uniformly to all cells in the CheckBoxList control.
Example
[Visual Basic, C#, JScript] The following example demonstrates how to use the CellPadding property to specify that the cell padding for the CheckBoxList control is 5 pixels.
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script language="VB" runat="server"> Sub Check_Clicked(sender As Object, e As EventArgs) Dim i As Integer Message.Text = "Selected Item(s):<br><br>" For i=0 To checkboxlist1.Items.Count - 1 If checkboxlist1.Items(i).Selected Then Message.Text += checkboxlist1.Items(i).Text + "<br>" End If Next End Sub </script> </head> <body> <form action="checkboxlist.aspx" method="post" runat="server"> <h3>CheckBoxList Example</h3> <asp:CheckBoxList id="checkboxlist1" AutoPostBack="True" CellPadding="5" CellSpacing="5" RepeatColumns="2" RepeatDirection="Vertical" RepeatLayout="Flow" TextAlign="Right" OnSelectedIndexChanged="Check_Clicked" runat="server"> <asp:ListItem>Item 1</asp:ListItem> <asp:ListItem>Item 2</asp:ListItem> <asp:ListItem>Item 3</asp:ListItem> <asp:ListItem>Item 4</asp:ListItem> <asp:ListItem>Item 5</asp:ListItem> <asp:ListItem>Item 6</asp:ListItem> </asp:CheckBoxList> <br><br> <asp:label id="Message" runat="server"/> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script language="C#" runat="server"> void Check_Clicked(Object sender, EventArgs e) { Message.Text = "Selected Item(s):<br><br>"; for (int i=0; i<checkboxlist1.Items.Count; i++) { if (checkboxlist1.Items[i].Selected) Message.Text += checkboxlist1.Items[i].Text + "<br>"; } } </script> </head> <body> <form action="checkboxlist.aspx" method="post" runat="server"> <h3>CheckBoxList Example</h3> <asp:CheckBoxList id="checkboxlist1" AutoPostBack="True" CellPadding="5" CellSpacing="5" RepeatColumns="2" RepeatDirection="Vertical" RepeatLayout="Flow" TextAlign="Right" OnSelectedIndexChanged="Check_Clicked" runat="server"> <asp:ListItem>Item 1</asp:ListItem> <asp:ListItem>Item 2</asp:ListItem> <asp:ListItem>Item 3</asp:ListItem> <asp:ListItem>Item 4</asp:ListItem> <asp:ListItem>Item 5</asp:ListItem> <asp:ListItem>Item 6</asp:ListItem> </asp:CheckBoxList> <br><br> <asp:label id="Message" runat="server"/> </form> </body> </html> [JScript] <%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> <script language="JScript" runat="server"> function Check_Clicked(sender : Object, e : EventArgs) { Message.Text = "Selected Item(s):<br><br>"; for (var i : int = 0; i<checkboxlist1.Items.Count; i++) { if (checkboxlist1.Items[i].Selected) Message.Text += checkboxlist1.Items[i].Text + "<br>"; } } </script> </head> <body> <form action="checkboxlist.aspx" method="post" runat="server"> <h3>CheckBoxList Example</h3> <asp:CheckBoxList id="checkboxlist1" AutoPostBack="True" CellPadding="5" CellSpacing="5" RepeatColumns="2" RepeatDirection="Vertical" RepeatLayout="Flow" TextAlign="Right" OnSelectedIndexChanged="Check_Clicked" runat="server"> <asp:ListItem>Item 1</asp:ListItem> <asp:ListItem>Item 2</asp:ListItem> <asp:ListItem>Item 3</asp:ListItem> <asp:ListItem>Item 4</asp:ListItem> <asp:ListItem>Item 5</asp:ListItem> <asp:ListItem>Item 6</asp:ListItem> </asp:CheckBoxList> <br><br> <asp:label id="Message" runat="server"/> </form> </body> </html> [Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <script runat="server"> Sub Check_Clicked(sender as Object, e As EventArgs) Message.Text = "Selected Item(s):<br><br>" ' Iterate through the Items collection of the CheckBoxList ' control and display the selected items. Dim i As Integer For i=0 To checkboxlist1.Items.Count - 1 If checkboxlist1.Items(i).Selected Then Message.Text &= checkboxlist1.Items(i).Text & "<br>" End If Next End Sub Sub Index_Change(sender as Object, e As EventArgs) ' Set the cell padding and cell spacing based on the selection ' from the drop down-list controls. Notice that cell padding and ' cell spacing only applies when the RepeatLayout property is set ' to RepeatLayout.Table. checkboxlist1.CellPadding = CellPaddingList.SelectedIndex checkboxlist1.CellSpacing = CellSpacingList.SelectedIndex End Sub </script> </head> <body> <form runat="server"> <h3> CheckBoxList CellPadding and CellSpacing Example </h3> Select items from the CheckBoxList. <br><br> <asp:CheckBoxList id="checkboxlist1" AutoPostBack="True" CellPadding="5" CellSpacing="5" RepeatColumns="2" RepeatDirection="Vertical" RepeatLayout="Table" TextAlign="Right" OnSelectedIndexChanged="Check_Clicked" runat="server"> <asp:ListItem>Item 1</asp:ListItem> <asp:ListItem>Item 2</asp:ListItem> <asp:ListItem>Item 3</asp:ListItem> <asp:ListItem>Item 4</asp:ListItem> <asp:ListItem>Item 5</asp:ListItem> <asp:ListItem>Item 6</asp:ListItem> </asp:CheckBoxList> <br><br> <asp:label id="Message" runat="server"/> <hr> Select different values for the cell padding and cell spacing. <table cellpadding="5"> <tr> <td> CellPadding: </td> <td> CellSpacing: </td> </tr> <tr> <td> <asp:DropDownList id="CellPaddingList" AutoPostBack="True" OnSelectedIndexChanged="Index_Change" runat="server"> <asp:ListItem>0</asp:ListItem> <asp:ListItem>1</asp:ListItem> <asp:ListItem>2</asp:ListItem> <asp:ListItem>3</asp:ListItem> <asp:ListItem>4</asp:ListItem> <asp:ListItem Selected="True">5</asp:ListItem> </asp:DropDownList> </td> <td> <asp:DropDownList id="CellSpacingList" AutoPostBack="True" OnSelectedIndexChanged="Index_Change" runat="server"> <asp:ListItem>0</asp:ListItem> <asp:ListItem>1</asp:ListItem> <asp:ListItem>2</asp:ListItem> <asp:ListItem>3</asp:ListItem> <asp:ListItem>4</asp:ListItem> <asp:ListItem Selected="True">5</asp:ListItem> </asp:DropDownList> </td> </tr> </table> </form> </body> </html> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <script runat="server"> void Check_Clicked(Object sender, EventArgs e) { Message.Text = "Selected Item(s):<br><br>"; // Iterate through the Items collection of the CheckBoxList // control and display the selected items. for (int i=0; i<checkboxlist1.Items.Count; i++) { if (checkboxlist1.Items[i].Selected) { Message.Text += checkboxlist1.Items[i].Text + "<br>"; } } } void Index_Change(Object sender, EventArgs e) { // Set the cell padding and cell spacing based on the selection // from the drop-down list controls. Notice that cell padding and // cell spacing only applies when the RepeatLayout property is set // to RepeatLayout.Table. checkboxlist1.CellPadding = CellPaddingList.SelectedIndex; checkboxlist1.CellSpacing = CellSpacingList.SelectedIndex; } </script> </head> <body> <form runat="server"> <h3> CheckBoxList CellPadding and CellSpacing Example </h3> Select items from the CheckBoxList. <br><br> <asp:CheckBoxList id="checkboxlist1" AutoPostBack="True" CellPadding="5" CellSpacing="5" RepeatColumns="2" RepeatDirection="Vertical" RepeatLayout="Table" TextAlign="Right" OnSelectedIndexChanged="Check_Clicked" runat="server"> <asp:ListItem>Item 1</asp:ListItem> <asp:ListItem>Item 2</asp:ListItem> <asp:ListItem>Item 3</asp:ListItem> <asp:ListItem>Item 4</asp:ListItem> <asp:ListItem>Item 5</asp:ListItem> <asp:ListItem>Item 6</asp:ListItem> </asp:CheckBoxList> <br><br> <asp:label id="Message" runat="server"/> <hr> Select different values for the cell padding and cell spacing. <table cellpadding="5"> <tr> <td> CellPadding: </td> <td> CellSpacing: </td> </tr> <tr> <td> <asp:DropDownList id="CellPaddingList" AutoPostBack="True" OnSelectedIndexChanged="Index_Change" runat="server"> <asp:ListItem>0</asp:ListItem> <asp:ListItem>1</asp:ListItem> <asp:ListItem>2</asp:ListItem> <asp:ListItem>3</asp:ListItem> <asp:ListItem>4</asp:ListItem> <asp:ListItem Selected="True">5</asp:ListItem> </asp:DropDownList> </td> <td> <asp:DropDownList id="CellSpacingList" AutoPostBack="True" OnSelectedIndexChanged="Index_Change" runat="server"> <asp:ListItem>0</asp:ListItem> <asp:ListItem>1</asp:ListItem> <asp:ListItem>2</asp:ListItem> <asp:ListItem>3</asp:ListItem> <asp:ListItem>4</asp:ListItem> <asp:ListItem Selected="True">5</asp:ListItem> </asp:DropDownList> </td> </tr> </table> </form> </body> </html>
[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
CheckBoxList Class | CheckBoxList Members | System.Web.UI.WebControls Namespace | CellSpacing