Selection Inputs

Assembly: TheTechIdea.Beep.WPF.Controls · XAML namespace: xmlns:beep="clr-namespace:TheTechIdea.Beep.WPF.Controls;assembly=TheTechIdea.Beep.WPF.Controls"

Chrome knobs. Every control here also exposes ControlStyle (BeepControlStyle) and Theme (string) — CLR wrappers over the inherited BeepChrome attached properties, so they are not repeated in the tables below.

BeepCheckBox

A themed native CheckBox. IsChecked, IsThreeState and the Checked/Unchecked/Indeterminate events are inherited; this control adds a Text label wrapper and the validation surface.

Base type: class BeepCheckBox : System.Windows.Controls.CheckBox, IBeepThemeable, IBeepValidatable

Property	Type	Description
Text	string	Label text; forwarded to the inherited `Content` so WinForms-style `Text="…"` markup works.
ApplyThemeOnImage	bool	When true, any leading/trailing icon is tinted with the current theme foreground.
IsRequired	bool	IBeepValidatable: marks the field mandatory.
IsEditable	bool	IBeepValidatable: whether the field accepts edits. Default true.
ToolTipText	string	IBeepValidatable: tooltip / helper text.
HasError	bool	IBeepValidatable: current error flag.
ValidationError	string	IBeepValidatable: current validation message.
ComponentName	string	IBeepValidatable: component identifier for the field-presenter flow.

<beep:BeepCheckBox Text="Accept terms"
                   IsChecked="{Binding Accepted, Mode=TwoWay}"
                   IsRequired="True" ControlStyle="Material3"/>

BeepRadioButton

A themed native RadioButton. IsChecked, GroupName and the group-exclusion logic are inherited; this control adds a Text label wrapper.

Base type: class BeepRadioButton : System.Windows.Controls.RadioButton, IBeepThemeable

Property	Type	Description
Text	string	Label text; forwarded to the inherited `Content`.
ApplyThemeOnImage	bool	When true, any leading/trailing icon is tinted with the current theme foreground.

<beep:BeepRadioButton Text="Standard" GroupName="Plan" IsChecked="True" ControlStyle="Fluent"/>

BeepRadioGroup

An ItemsControl that renders a set of mutually exclusive radio options from a SimpleItem source.

Base type: class BeepRadioGroup : System.Windows.Controls.ItemsControl

Property	Type	Description
ListItems	IEnumerable	Beep item source — an `IEnumerable` of `SimpleItem`. Forwards to the inherited `ItemsSource`.

<beep:BeepRadioGroup ListItems="{Binding PlanOptions}" ControlStyle="Material3"/>

BeepComboBox

A themed native ComboBox over SimpleItem rows, with placeholder text, a style variant, a list-of-values (LOV) surface, and validation. It hides the inherited SelectedItem with a SimpleItem-typed one.

Base type: class BeepComboBox : System.Windows.Controls.ComboBox, IBeepValidatable

Property	Type	Description
ComboBoxStyle	ComboBoxStyle	Chrome variant of the combo box. Default `Default`.
ListItems	IEnumerable	Beep item source — `IEnumerable` of `SimpleItem`. Forwards to the inherited `ItemsSource`.
PlaceholderText	string	Placeholder / hint text shown when nothing is selected.
IsLovMode	bool	True when the combo operates in list-of-values (LOV) mode.
AutoDisplayLov	bool	Whether the LOV picker auto-opens as the user types.
AutoDisplayMinChars	int	Minimum characters typed before the auto-display LOV triggers. Default 1.
IsRequired	bool	IBeepValidatable: marks the field mandatory.
ToolTipText	string	IBeepValidatable: tooltip / helper text.
HasError	bool	IBeepValidatable: current error flag.
ValidationError	string	IBeepValidatable: current validation message.
ComponentName	string	IBeepValidatable: component identifier for the field-presenter flow.

SelectedItem is a new SimpleItem CLR property (not a DP) that hides Selector.SelectedItem so consumers read .Text / .Value without casting.

<beep:BeepComboBox ListItems="{Binding Countries}"
                   SelectedItem="{Binding SelectedCountry, Mode=TwoWay}"
                   PlaceholderText="Select a country"
                   ControlStyle="Fluent"/>

BeepDropDownCheckBoxSelect

A multi-select drop-down: it derives BeepComboBox for the working combo template and SimpleItem ListItems/SelectedItem, and adds a checkable (CheckBox) item variant so rows can be multi-selected.

Base type: class BeepDropDownCheckBoxSelect : BeepComboBox, IBeepThemeable

No own DependencyProperties — it inherits the full BeepComboBox surface (ListItems, PlaceholderText, the LOV and validation members) and contributes the checkbox item variant plus a BasedOn skin style.

<beep:BeepDropDownCheckBoxSelect ListItems="{Binding Tags}"
                                 PlaceholderText="Pick tags"
                                 ControlStyle="Material3"/>

BeepSlider

A themed native Slider. Value, Minimum, Maximum, ticks and orientation all come from the base Slider; the look comes from the skin.

Base type: class BeepSlider : System.Windows.Controls.Slider

No own DependencyProperties — use the inherited Slider members (Value, Minimum, Maximum, TickFrequency, …) plus the ControlStyle / Theme knobs.

<beep:BeepSlider Minimum="0" Maximum="100"
                 Value="{Binding Volume, Mode=TwoWay}"
                 ControlStyle="Apple"/>

BeepStarRating

A horizontal row of rating stars built on ItemsControl. The constructor applies a horizontal items panel so the stars lay out in a row, and the skin template draws the star glyphs.

Base type: class BeepStarRating : System.Windows.Controls.ItemsControl

No own DependencyProperties — the stars are driven through the inherited ItemsControl surface (Items / ItemsSource) and the per-skin template, together with the ControlStyle / Theme knobs.

<beep:BeepStarRating ItemsSource="{Binding Stars}" ControlStyle="Material3"/>

On this page