Skip to content

SAIFRadioButtonList

SAIFRadioButtonList is a RadioButtonList subclass extending the same read-only static-image rendering convention as SAIFRadioButton to a list of radio items, rendered as an HTML table (BR-V2-003).

Purpose

  • Provide a consistent "locked field" visual convention for radio-button lists (matching SAIFRadioButton's single-item behavior) across the SAIF UI.

Context

  • Namespace: SAIF.Presentation.Web.Controls.V2
  • Assembly/package: Compiled into SAIF.BOF.Presentation.Web.Infragistics103*

Public members

Member Signature Purpose
[ReadOnly] Property [ReadOnly] As Boolean Switches the control from its native interactive RadioButtonList rendering to a static <table> of checked/unchecked images and labels, per BR-V2-003.

Inherited public members

SAIFRadioButtonList inherits from RadioButtonList (System.Web.UI.WebControls), a framework base class rather than a documented SAIF dependency library.

Member Signature Purpose
AutoPostBack Public Property AutoPostBack As Boolean Determines whether changing the selected item immediately posts the page back to the server.
Items Public ReadOnly Property Items As ListItemCollection Collection of selectable radio-button-list items managed by the control.
RepeatColumns Public Property RepeatColumns As Integer Controls how many item columns render before the layout wraps to a new row.
RepeatDirection Public Property RepeatDirection As RepeatDirection Controls whether items lay out horizontally or vertically.
RepeatLayout Public Property RepeatLayout As RepeatLayout Chooses the HTML layout pattern used to render the item list.
SelectedIndex Public Property SelectedIndex As Integer Index of the currently selected item in the list.
SelectedItem Public ReadOnly Property SelectedItem As ListItem Currently selected radio-button-list item.
SelectedValue Public Property SelectedValue As String Value of the currently selected item.
TextAlign Public Property TextAlign As TextAlign Controls whether item labels render before or after their radio inputs.
SelectedIndexChanged Public Event SelectedIndexChanged As EventHandler Standard list-selection change event raised after postback.

Standard RadioButtonList/Control members (ID, ClientID, Controls, Visible, DataBind, FindControl, etc.) are not re-documented here as they are unmodified framework behavior**.

Behavioral notes

  • RenderItems lays items into <tr>/<td> cells honoring RepeatDirection, mirroring SAIFCheckBoxList's layout approach but without the RepeatColumns-based branching present in that control*.

Constraints and usage notes

  • The read-only image paths (/Resources/Images/rb_checked.gif, /Resources/Images/rb_unchecked.gif) are hardcoded and must exist in the hosting application.

Note: Statements marked with * were inferred from code structure, naming conventions, or contextual evidence where direct confirmation was not available in source artifacts. Statements marked with ** could not be confirmed; treat as unknown until verified.

Sources

  • SAIF.Presentation.Web.Controls.V2\SAIFRadioButtonList.vb