class

AEmptyState

Module
Arc
Header
#include "Arc/Widgets/AEmptyState.h"
Namespace
Arcf

Properties

TypeNameDescription
static constexpr floatkSidePaddingDefault 16.0f.
ArcDelegate<void()>OnAction
ArcDelegate<void()>OnLink

Public functions

ReturnsNameDescription
ARC_WIDGET_ARGS
voidConstruct
TSharedPtr<AEmptyState>NoResultsThe search-no-results variant: search-x, "No results", the query quoted in the body and, given a suggestion, a "Did you mean" link.
std::stringSuggestCorrectionThe candidate closest to query by edit distance, or "" when none is close enough to be the word that was meant.
voidSetIcon
voidSetTitle
voidSetBody
voidSetLinkText
voidSetActionLabel
voidSetSize
voidSetBackdropOff where the host already draws a busy field of its own (a graph canvas's grid): two textures on one another read as noise.
boolHasBackdrop
voidSet
const std::string&GetIcon
const std::string&GetTitle
const std::string&GetBody
const std::string&GetLinkText
std::stringGetActionLabel
TSharedPtr<AWidget>GetActionWidgetThe action button, to anchor a menu the action opens under it.
boolShowsBackdropWhether the point-cloud field paints (off in High Contrast).
voidGenerateBackdropThe texture dots the backdrop draws in rect around content, with their final alpha (texel x 0.14 x radial fade).
FArcEmptyStateLayoutComputeLayout
floatGetRequiredHeightThe height the state needs in a rect width wide (0 is the 260 it asks for), its 16 px padding above and below included, for a host that sizes a list or a menu row to fit it.
voidPaintInRectPaints the state into rect for a host that draws its rows itself (a palette or dropdown painted in an overlay) instead of parenting widgets.
ArcVec2ComputeDesiredSize
voidArrangeChildren
int32_tOnPaint
CReplyOnMouseButtonDown
EAccessibleRoleGetAccessibleRole
std::stringGetAccessibleName
const char*GetTypeName

Function details

ARC_WIDGET_ARGS

C++
ARC_WIDGET_ARGS(AEmptyState) ARC_ARG(std::string, Icon) ARC_ARG(std::string, Title) ARC_ARG(std::string, Body) ARC_ARG(std::string, ActionLabel) ARC_ARG(std::string, LinkText) ARC_ARG(EArcEmptyStateSize, Size) ARC_ARG(bool, NoBackdrop) ARC_WIDGET_ARGS_END() static constexpr float kCompactHeight = 200.0f

Construct

C++
void Construct(const CArguments& args)

NoResults

C++
static TSharedPtr<AEmptyState> NoResults(const std::string& query, const std::string& suggestion = std::string())

The search-no-results variant: search-x, "No results", the query quoted in the body and, given a suggestion, a "Did you mean" link.

SuggestCorrection

C++
static std::string SuggestCorrection(const std::string& query, const std::vector<std::string>& candidates)

The candidate closest to query by edit distance, or "" when none is close enough to be the word that was meant.

SetIcon

C++
void SetIcon(const std::string& icon)

SetTitle

C++
void SetTitle(const std::string& title)

SetBody

C++
void SetBody(const std::string& body)

SetLinkText

C++
void SetLinkText(const std::string& text)

SetActionLabel

C++
void SetActionLabel(const std::string& label)

SetSize

C++
void SetSize(EArcEmptyStateSize size)

SetBackdrop

C++
void SetBackdrop(bool enabled)

Off where the host already draws a busy field of its own (a graph canvas's grid): two textures on one another read as noise.

HasBackdrop

C++
bool HasBackdrop() const

Set

C++
void Set(const std::string& icon, const std::string& title, const std::string& body)

GetIcon

C++
const std::string& GetIcon() const

GetTitle

C++
const std::string& GetTitle() const

GetBody

C++
const std::string& GetBody() const

GetLinkText

C++
const std::string& GetLinkText() const

GetActionLabel

C++
std::string GetActionLabel() const

GetActionWidget

C++
TSharedPtr<AWidget> GetActionWidget() const

The action button, to anchor a menu the action opens under it.

ShowsBackdrop

C++
static bool ShowsBackdrop()

Whether the point-cloud field paints (off in High Contrast).

GenerateBackdrop

C++
static void GenerateBackdrop(const ArcRect& rect, const ArcRect& content, std::vector<FArcPointCloudDot>& out)

The texture dots the backdrop draws in rect around content, with their final alpha (texel x 0.14 x radial fade). Empty in High Contrast.

ComputeLayout

C++
FArcEmptyStateLayout ComputeLayout(const ArcRect& rect) const

GetRequiredHeight

C++
float GetRequiredHeight(float width = 0.0f) const

The height the state needs in a rect width wide (0 is the 260 it asks for), its 16 px padding above and below included, for a host that sizes a list or a menu row to fit it.

PaintInRect

C++
void PaintInRect(CArcUIRenderer& renderer, const ArcRect& rect)

Paints the state into rect for a host that draws its rows itself (a palette or dropdown painted in an overlay) instead of parenting widgets. The rect becomes the cached geometry hit tests read.

ComputeDesiredSize

C++
ArcVec2 ComputeDesiredSize(float scale) const override

ArrangeChildren

C++
void ArrangeChildren(const CGeometry& geo) override

OnPaint

C++
int32_t OnPaint(const CArcPaintArgs& args, const CGeometry& geo, CArcUIRenderer& renderer, int32_t layerId) const override

OnMouseButtonDown

C++
CReply OnMouseButtonDown(const CGeometry& geo, const CPointerEvent& event) override

GetAccessibleRole

C++
EAccessibleRole GetAccessibleRole() const override

GetAccessibleName

C++
std::string GetAccessibleName() const override

GetTypeName

C++
const char* GetTypeName() const override
Generated from Arc/Widgets/AEmptyState.h via arc.json · Nov 5, 2026Version 1.0.0