|
| 1 | +--- |
| 2 | +title: Telerik.Web.UI.RadButtonList |
| 3 | +page_title: |
| 4 | +description: |
| 5 | +slug: Telerik.Web.UI.RadButtonList |
| 6 | +--- |
| 7 | + |
| 8 | +# Telerik.Web.UI.RadButtonList : Telerik.Web.UI.RadWebControl |
| 9 | + |
| 10 | +## Methods |
| 11 | + |
| 12 | +### get_visible |
| 13 | + |
| 14 | +Gets the current visibility state of the button list control. |
| 15 | + |
| 16 | +#### Parameters |
| 17 | + |
| 18 | +#### Returns |
| 19 | + |
| 20 | +`Boolean` The current visibility state of the button list control. |
| 21 | + |
| 22 | +### set_visible |
| 23 | + |
| 24 | +Sets the current visibility state of the button list control. |
| 25 | + |
| 26 | +#### Parameters |
| 27 | + |
| 28 | +##### value `Boolean` |
| 29 | + |
| 30 | +The new visibility state of the button list control. |
| 31 | + |
| 32 | +#### Returns |
| 33 | + |
| 34 | +`None` |
| 35 | + |
| 36 | +### get_enabled |
| 37 | + |
| 38 | +Gets whether the button list control is enabled. |
| 39 | + |
| 40 | +#### Parameters |
| 41 | + |
| 42 | +#### Returns |
| 43 | + |
| 44 | +`Boolean` A value that indicates whether the button list control is enabled. |
| 45 | + |
| 46 | +### set_enabled |
| 47 | + |
| 48 | +Specifies if the button list control is enabled. |
| 49 | + |
| 50 | +#### Parameters |
| 51 | + |
| 52 | +##### value `Boolean` |
| 53 | + |
| 54 | +A value that determines whether the button list control will be enabled. |
| 55 | + |
| 56 | +#### Returns |
| 57 | + |
| 58 | +`None` |
| 59 | + |
| 60 | +### get_selectedIndex |
| 61 | + |
| 62 | +Gets the index of the selected item of the button list control. |
| 63 | + |
| 64 | +#### Parameters |
| 65 | + |
| 66 | +#### Returns |
| 67 | + |
| 68 | +`Number` The selected index. |
| 69 | + |
| 70 | +### set_selectedIndex |
| 71 | + |
| 72 | +Sets the index of the selected item of the button list control. |
| 73 | + |
| 74 | +#### Parameters |
| 75 | + |
| 76 | +##### value `Number` |
| 77 | + |
| 78 | +The index of the item that will be selected. |
| 79 | + |
| 80 | +#### Returns |
| 81 | + |
| 82 | +`None` |
| 83 | + |
| 84 | +### get_items |
| 85 | + |
| 86 | +Gets a collection of the items. |
| 87 | + |
| 88 | +#### Parameters |
| 89 | + |
| 90 | +#### Returns |
| 91 | + |
| 92 | +`Telerik.Web.UI.ButtonListItem[]` The collection of items. |
| 93 | + |
| 94 | +### get_toolTip |
| 95 | + |
| 96 | +Gets the text displayed when the mouse pointer hovers over the button list control. |
| 97 | + |
| 98 | +#### Parameters |
| 99 | + |
| 100 | +#### Returns |
| 101 | + |
| 102 | +`String` The current text of the tooltip. |
| 103 | + |
| 104 | +### set_toolTip |
| 105 | + |
| 106 | +Sets the text displayed when the mouse pointer hovers over the button list control. |
| 107 | + |
| 108 | +#### Parameters |
| 109 | + |
| 110 | +##### value `String` |
| 111 | + |
| 112 | +The text that will appear in the tooltip. |
| 113 | + |
| 114 | +#### Returns |
| 115 | + |
| 116 | +`None` |
| 117 | + |
| 118 | +### get_width |
| 119 | + |
| 120 | +Gets the width of the button list control. |
| 121 | + |
| 122 | +#### Parameters |
| 123 | + |
| 124 | +#### Returns |
| 125 | + |
| 126 | +`Number` The width of the button list control. |
| 127 | + |
| 128 | +### set_width |
| 129 | + |
| 130 | +Sets the width of the button list control. |
| 131 | + |
| 132 | +#### Parameters |
| 133 | + |
| 134 | +##### value `Number` |
| 135 | + |
| 136 | +The width that will be applied to the button list control. |
| 137 | + |
| 138 | +#### Returns |
| 139 | + |
| 140 | +`None` |
| 141 | + |
| 142 | +### get_height |
| 143 | + |
| 144 | +Gets the height of the button list control. |
| 145 | + |
| 146 | +#### Parameters |
| 147 | + |
| 148 | +#### Returns |
| 149 | + |
| 150 | +`Number` The height of the button list control. |
| 151 | + |
| 152 | +### set_height |
| 153 | + |
| 154 | +Sets the height of the button list control. |
| 155 | + |
| 156 | +#### Parameters |
| 157 | + |
| 158 | +##### value `Number` |
| 159 | + |
| 160 | +The height that will be applied to the button list control. |
| 161 | + |
| 162 | +#### Returns |
| 163 | + |
| 164 | +`None` |
| 165 | + |
| 166 | +### get_validationGroup |
| 167 | + |
| 168 | +Gets the name of validation group to which the button list control is assigned. |
| 169 | + |
| 170 | +#### Parameters |
| 171 | + |
| 172 | +#### Returns |
| 173 | + |
| 174 | +`String` The current validation group name. |
| 175 | + |
| 176 | +### set_validationGroup |
| 177 | + |
| 178 | +Sets the name of validation group to which the button list control is assigned. |
| 179 | + |
| 180 | +#### Parameters |
| 181 | + |
| 182 | +##### value `String` |
| 183 | + |
| 184 | +The name of the validation group that will be assigned. |
| 185 | + |
| 186 | +#### Returns |
| 187 | + |
| 188 | +`None` |
| 189 | + |
| 190 | +## Events |
| 191 | + |
| 192 | +### selectedIndexChanging |
| 193 | + |
| 194 | +The selectedIndexChanging event is fired before the selected item is changed. You can cancel it. |
| 195 | + |
| 196 | +#### Event Data |
| 197 | + |
| 198 | +##### sender `Telerik.Web.UI.RadButtonList` |
| 199 | + |
| 200 | +The instance of the RadButtonList that raised the event. |
| 201 | + |
| 202 | +##### args `Telerik.Web.UI.ButtonListCancelEventArgs` |
| 203 | + |
| 204 | +The event arguments. |
| 205 | + |
| 206 | +### selectedIndexChanged |
| 207 | + |
| 208 | +The selectedIndexChanged event is fired when the selected item is changed. It is subsequent to the selectedIndexChanging event. |
| 209 | + |
| 210 | +#### Event Data |
| 211 | + |
| 212 | +##### sender `Telerik.Web.UI.RadButtonList` |
| 213 | + |
| 214 | +The instance of the RadButtonList that raised the event. |
| 215 | + |
| 216 | +##### args `Sys.EventArgs` |
| 217 | + |
| 218 | +The event arguments. |
| 219 | + |
| 220 | +### load |
| 221 | + |
| 222 | +The load event is fired when the radio button list is initialized. |
| 223 | + |
| 224 | +#### Event Data |
| 225 | + |
| 226 | +##### sender `Telerik.Web.UI.RadButtonList` |
| 227 | + |
| 228 | +The instance of the RadButtonList that raised the event. |
| 229 | + |
| 230 | +##### args `Sys.EventArgs` |
| 231 | + |
| 232 | +The event arguments. |
| 233 | + |
| 234 | +### itemCheckedChanging |
| 235 | + |
| 236 | +The itemCheckedChanging event is fired before selected state of an item is changed. It is cancellable. |
| 237 | + |
| 238 | +#### Event Data |
| 239 | + |
| 240 | +##### sender `Telerik.Web.UI.RadButtonList` |
| 241 | + |
| 242 | +The instance of the RadButtonList that raised the event. |
| 243 | + |
| 244 | +##### args `Telerik.Web.UI.ButtonListCancelEventArgs` |
| 245 | + |
| 246 | +The event arguments. |
| 247 | + |
| 248 | +### itemCheckedChanged |
| 249 | + |
| 250 | +The itemCheckedChanged event is fired when the selected state of an item is changed. It is subsequent to the itemCheckedChanging event. |
| 251 | + |
| 252 | +#### Event Data |
| 253 | + |
| 254 | +##### sender `Telerik.Web.UI.RadButtonList` |
| 255 | + |
| 256 | +The instance of the RadButtonList that raised the event. |
| 257 | + |
| 258 | +##### args `Telerik.Web.UI.ButtonListEventArgs` |
| 259 | + |
| 260 | +The event arguments. |
| 261 | + |
| 262 | +### itemClicking |
| 263 | + |
| 264 | +The itemClicking event is fired before an item in the list is clicked. It is cancellable. |
| 265 | + |
| 266 | +#### Event Data |
| 267 | + |
| 268 | +##### sender `Telerik.Web.UI.RadButtonList` |
| 269 | + |
| 270 | +The instance of the RadButtonList that raised the event. |
| 271 | + |
| 272 | +##### args `Telerik.Web.UI.ButtonListCancelEventArgs` |
| 273 | + |
| 274 | +The event arguments. |
| 275 | + |
| 276 | +### itemClicked |
| 277 | + |
| 278 | +The itemClicked event is fired when an item in the list is clicked. It is subsequent to the itemClicking event. |
| 279 | + |
| 280 | +#### Event Data |
| 281 | + |
| 282 | +##### sender `Telerik.Web.UI.RadButtonList` |
| 283 | + |
| 284 | +The instance of the RadButtonList that raised the event. |
| 285 | + |
| 286 | +##### args `Telerik.Web.UI.ButtonListEventArgs` |
| 287 | + |
| 288 | +The event arguments. |
| 289 | + |
| 290 | +### itemLoad |
| 291 | + |
| 292 | +The itemLoad event is fired when an item in the list is initialized. |
| 293 | + |
| 294 | +#### Event Data |
| 295 | + |
| 296 | +##### sender `Telerik.Web.UI.RadButtonList` |
| 297 | + |
| 298 | +The instance of the RadButtonList that raised the event. |
| 299 | + |
| 300 | +##### args `Telerik.Web.UI.ButtonListEventArgs` |
| 301 | + |
| 302 | +The event arguments. |
| 303 | + |
| 304 | +### itemMouseOver |
| 305 | + |
| 306 | +The itemMouseOver event is fired when the mouse hovers over an item in the list. |
| 307 | + |
| 308 | +#### Event Data |
| 309 | + |
| 310 | +##### sender `Telerik.Web.UI.RadButtonList` |
| 311 | + |
| 312 | +The instance of the RadButtonList that raised the event. |
| 313 | + |
| 314 | +##### args `Telerik.Web.UI.ButtonListEventArgs` |
| 315 | + |
| 316 | +The event arguments. |
| 317 | + |
| 318 | +### itemMouseOut |
| 319 | + |
| 320 | +The itemMouseOut event is fired when the mouse leaves a radio button list item. |
| 321 | + |
| 322 | +#### Event Data |
| 323 | + |
| 324 | +##### sender `Telerik.Web.UI.RadButtonList` |
| 325 | + |
| 326 | +The instance of the RadButtonList that raised the event. |
| 327 | + |
| 328 | +##### args `Telerik.Web.UI.ButtonListEventArgs` |
| 329 | + |
| 330 | +The event arguments. |
| 331 | + |
0 commit comments