Skip to content

SAIFRadioButton

SAIFRadioButton is a RadioButton subclass mirroring SAIFCheckBox's [ReadOnly] static-image rendering convention for radio buttons: a visually-hidden native radio button preserves ViewState, while a static checked/unchecked image and label render in its place (BR-V2-003).

Purpose

  • Provide a consistent "locked field" visual convention for radio buttons across the SAIF UI, matching SAIFCheckBox's pattern.

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 RadioButton rendering to the static image + hidden-radio-button convention, per BR-V2-003.

Inherited public members

SAIFRadioButton inherits from RadioButton (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 radio button immediately posts the page back to the server.
Checked Public Property Checked As Boolean Current selected state of the radio button.
GroupName Public Property GroupName As String Groups related radio buttons so only one can be selected at a time in the browser.
InputAttributes Public ReadOnly Property InputAttributes As AttributeCollection Additional HTML attributes rendered on the underlying <input> element.
Text Public Property Text As String Label text rendered alongside the radio button.
TextAlign Public Property TextAlign As TextAlign Controls whether the label renders before or after the radio button input.
ValidationGroup Public Property ValidationGroup As String Validator group name evaluated when the radio button participates in validation-triggering postbacks.
CheckedChanged Public Event CheckedChanged As EventHandler Standard change event raised after the selected state changes on postback.

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

Behavioral notes

  • Render positions the hidden native radio button off-screen so its posted value is preserved, then renders rb_checked.gif/rb_unchecked.gif alongside the label per TextAlign.

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\SAIFRadioButton.vb