---
title: SAIFCheckBox
summary: API reference for SAIFCheckBox.
status: draft
owner: SAIF Documentation Team
last_reviewed: 2026-08-17
library: SAIF.Presentation.Web.Controls.V2
reference_type: package
---

# 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](../../business-rules.md#br-v2-003-read-only-input-controls-render-as-static-images-not-native-controls)).

## 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](../../business-rules.md#br-v2-003-read-only-input-controls-render-as-static-images-not-native-controls). |

## 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