MultiListControl¶
Composes a textbox, an image button, and a checkbox list into a single drop-down multi-select control, auto-closing the list on focus loss so pages get multi-select UX without wiring the three constituent controls themselves BR-V2-061.
Purpose¶
- Assembles the textbox/button/checkbox-list composite and wires the drop-down show/hide behavior BR-V2-061.
- Auto-closes the checkbox list when focus leaves the control BR-V2-063.
- Ships its client-side assets as embedded web resources rather than requiring separate deployment BR-V2-064.
Context¶
- Namespace:
SAIF.Presentation.Web.Controls.V2 - Assembly/package:
SAIF.Presentation.Web.Controls.V2(packaged inSAIF.BOF.Presentation.Web.Infragistics111.nuspec)
Public members¶
| Member | Signature | Purpose |
|---|---|---|
| IsTextEditable | Public Property IsTextEditable As Boolean |
Determines whether the summary textbox accepts direct keyboard entry in addition to checkbox-driven selection. |
| ListDatasource | Public Property ListDatasource As Object |
Data source bound to the internal checkbox list of selectable items. |
| TextDatasource | Public Property TextDatasource As Object |
Data source used to render the display text shown in the summary textbox. |
| WildCardItem | Public Property WildCardItem As String |
Text of a special item, when present, that behaves as a select-all/none wildcard. |
| CreateChildControls | Protected Overrides Sub CreateChildControls() |
Builds the textbox, image button, and checkbox list child controls. |
| DataBind | Public Overrides Sub DataBind() |
Binds ListDatasource/TextDatasource to the composed child controls. |
Behavioral notes¶
- Registers
MultiList.jsas an embedded web resource so the show/close/focus-loss behavior works without a separate script deployment BR-V2-064.
Constraints and usage notes¶
ListDatasourceandTextDatasourcemust be kept in a compatible shape/order since the control correlates them positionally.
Sources¶
SAIF.Presentation.Web.Controls.V2/MultiListControl.vb