UCheckBox

class UMG Blueprint Since 4.5

Inherits: UObjectBase › UObjectBaseUtility › UObject › UVisual › UWidget › UPanelWidget › UContentWidget › UCheckBox

#include "Components/CheckBox.h"

Description

A widget that toggles between Unchecked, Checked, and Undetermined states. Can be styled as a classic checkbox, radio button, or toggle button by changing its style asset.

Caveats & Gotchas

• SetIsChecked(bool) only transitions between Checked and Unchecked. To programmatically set Undetermined, use SetCheckedState(ECheckBoxState::Undetermined).
• OnCheckStateChanged fires for both user interaction and programmatic calls to SetCheckedState — guard against feedback loops if you call SetCheckedState from the delegate itself.
• To implement radio button behavior, group multiple UCheckBox widgets and manually uncheck siblings inside the OnCheckStateChanged delegate.

Example

Respond to checkbox toggle C++

MyCheckBox->OnCheckStateChanged.AddDynamic(this, &UMyWidget::OnCheckChanged);

void UMyWidget::OnCheckChanged(bool bIsChecked)
{
    bOptionEnabled = bIsChecked;
}

Version History

Introduced in: 4.5

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?