PaddingSpec

PaddingSpec

#include <Style.hpp>

Specifies padding on all four sides of a widget’s content area.

Padding is the space between a widget’s border and its content. All values are in cells (characters) — percentage-based padding is not supported since it would require knowing the widget’s final size in advance.

Example Usage:

style.padding = [PaddingSpec::all](/api/core/paddingspec#all)(1);          // 1 cell on all sides
style.padding = [PaddingSpec::xy](/api/core/paddingspec#xy)(2, 1);        // 2 left/right, 1 top/bottom
style.padding = {.top = 1, .bottom = 1};      // manual per-side

Public Attributes

Return	Name	Description
int	top	Padding on the top edge (in cells)
int	bottom	Padding on the bottom edge (in cells)
int	left	Padding on the left edge (in cells)
int	right	Padding on the right edge (in cells)

---

top

int top = 0

Padding on the top edge (in cells)

---

bottom

int bottom = 0

Padding on the bottom edge (in cells)

---

left

int left = 0

Padding on the left edge (in cells)

---

right

int right = 0

Padding on the right edge (in cells)

Public Static Methods

Return	Name	Description
PaddingSpec	all static inline	Creates equal padding on all four sides.
PaddingSpec	xy static inline	Creates padding with separate horizontal and vertical values.
PaddingSpec	none static inline	Creates zero padding on all sides.

---

all

static inline

static inline PaddingSpec all(int v)

Creates equal padding on all four sides.

Parameters

• v The number of cells to pad on each side

---

xy

static inline

static inline PaddingSpec xy(int x, int y)

Creates padding with separate horizontal and vertical values.

Parameters

• x Padding on the left and right edges (in cells)

• y Padding on the top and bottom edges (in cells)

---

none

static inline

static inline PaddingSpec none()

Creates zero padding on all sides.