Skip to content

SAIFCheckBox

SAIFCheckBox is a CheckBox subclass that adds a [ReadOnly] rendering mode: when set, it renders a visually-hidden native checkbox (to preserve ViewState round-tripping) alongside a static checked/unchecked image and label, instead of the interactive native checkbox (BR-V2-003).

Purpose

  • Provide a consistent "locked field" visual convention for checkboxes across the SAIF UI, without losing the checked value across postbacks.

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

Inherited public members

SAIFCheckBox inherits from CheckBox (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 checkbox immediately posts the page back to the server.
Checked Public Property Checked As Boolean Current selected state of the checkbox.
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 checkbox.
TextAlign Public Property TextAlign As TextAlign Controls whether the label renders before or after the checkbox input.
ValidationGroup Public Property ValidationGroup As String Validator group name evaluated when the checkbox participates in validation-triggering postbacks.
CheckedChanged Public Event CheckedChanged As EventHandler Standard change event raised after the checked state changes on postback.

Standard CheckBox/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 checkbox off-screen (position: absolute; left: -10000px) so its posted value is preserved even though it is not visible.
  • The rendered <img> source (Cb_checked.bmp/cb_unchecked.bmp) and label placement (before or after the image) depend on Checked and TextAlign.

Constraints and usage notes

  • The read-only image paths (/Resources/Images/Cb_checked.bmp, /Resources/Images/cb_unchecked.bmp) are hardcoded and must exist in the hosting application's /Resources/Images/ folder.

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