Attributes per native widget

A <widget> has no universal fixed set of visual attributes. Its Python component or renderer chooses a native class, and that class determines which setters exist. This reference lists the current central AttributeParser names for each of the 16 native widget classes in the source snapshot, including inherited setters. Deprecated names and compatibility spellings are listed separately.

The counts below are computed from the current-name list. They describe recognised attribute names, not independent visual features. backgroundColor counts once even when it accepts both a solid colour and a gradient. Native setter existence is a dispatch check; each linked entry also explains XML conversion and content requirements.

Your XML	Where to look
`<eLabel … />`	`eLabel` below
`<ePixmap … />`	`ePixmap` below
`<eRectangle … />`	`eRectangle` below
`<widget source="…" render="Label" … />`	Label renderer, then `eLabel`
`<widget source="…" render="Progress" … />`	Progress renderer, then `eSlider`
`<widget name="…" … />`	The screen’s Python assignment, then GUI components
`<screen …>`	`eWindow` for central visual attributes; `readSkin` also consumes screen structure

name, source, render, addon and converter type belong to XML construction, so they do not appear in these counts. The API overview explains that stage. layout on an eStack is another structural setting: the loader selects its horizontal/vertical layout before applying the remaining attributes.

How to read the tables

Each row gives the meaning, a link to the value parser and the actual native setter. Only the listed value variants are supported. A label accepts a solid foregroundColor; it has no setForegroundGradient. A slider accepts both. A recognised method does not guarantee that content is present or that a renderer leaves the value unchanged after the next update.

Use listOrientation on a native listbox and orientation on a slider. Both classes have a method called setOrientation, but the enums and argument counts differ. Component-specific parsers can deliberately reuse a name: an addon with its own orientation handler follows that addon’s API.

The count excludes no-op AttributeParser handlers such as condition, layout and animationPaused. Some are interpreted earlier; others have no visual effect. It also excludes extra options consumed by Python, such as a Pixmap renderer’s pixmaps or RunningText’s options. Consult the renderer API or named-component API for those.

Filter native widgets by class, attribute, property or method

16 entries

Source snapshot f4135659cb. Current attribute counts exclude legacy names and structural XML names. Deprecated attributes and compatibility migrations have their own reference.

`eButton`

Native button derived from eLabel. It inherits the label attributes. Remote-control actions are connected in Python, not by a skin attribute.

lib/gui/ebutton.h, line 7 ↗

30 current central XML attribute names. Inherits eLabel. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (30)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`alphaTest`	Pixmap transparency: off, on (alpha test), or blend (smooth alpha blending). For eLabel and its subclasses, both on and blend enable text blending: setAlphatest maps any positive mode to the same boolean. The three-way pixmap distinction does not apply here. Case-sensitive options: on, off, blend. XML example, defaults and limitations	standard syntax: `setAlphatest`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. Inherited eLabel override: text outline, not the widget rectangle. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Inherited eLabel override: text outline, not the widget rectangle. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`font`	Registered font face or alias and size, for example Regular;28. It is not a font file path. Registered font face or alias, optionally followed by ;size. A numeric size is scaled vertically with the screen. Register the face before using it. XML example, defaults and limitations	standard syntax: `setFont`
`fontScale`	Automatic label font adjustment: size;offset or width;offset (default offset -4). size;offset or width;offset. Offset is an integer; omitted offset is -4. An offset of 0 does not call the setter. XML example, defaults and limitations	standard syntax: `setFontScale`
`foregroundColor`	Text/foreground colour. A gradient value is supported only by the slider foreground path. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setForegroundColor`
`horizontalAlignment`	Text alignment inside its rectangle: left, center, right or block. Case-sensitive options: left, center, right, block. XML example, defaults and limitations	standard syntax: `setHAlign`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`scrollText`	Scrolling text configuration as comma-separated key=value pairs; direction, delays, repeat, stepSize and mode. Comma-separated key=value pairs. direction: left/right/top/bottom; stepDelay, startDelay, endDelay: milliseconds; stepSize: pixels; repeat: integer; mode: cached/bounce/bounceCached/roll. Omitted sub-options start at stepDelay=100, startDelay=0, endDelay=0, repeat=0, stepSize=2; omit mode for normal scrolling. XML example, defaults and limitations	standard syntax: `setScrollText`
`shadowColor`	Colour of the label text shadow. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setShadowColor`
`shadowOffset`	x,y offset of the text shadow; scaled with the screen. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `setShadowOffset`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tabWidth`	Tab-stop width for supporting text widgets; auto uses the automatic width. Non-negative integer tab-stop width, or auto for automatic sizing. XML example, defaults and limitations	standard syntax: `setTabWidth`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`text`	Static text, translated before setText. Python or a renderer may replace it later. XML text string; escape & as & and < as <. Translated and set initially; renderer/Python updates can replace it. XML example, defaults and limitations	standard syntax: `setText`
`textBorderColor`	Explicit colour of the outline around glyphs; different from a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setTextBorderColor`
`textBorderWidth`	Explicit glyph-outline thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setTextBorderWidth`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`underline`	Enable or disable underlined label text. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setUnderline`
`verticalAlignment`	Text alignment inside the widget: top, center/middle or bottom. Case-sensitive options: top, center, middle, bottom. XML example, defaults and limitations	standard syntax: `setVAlign`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`wrap`	Text overflow mode: wrap, noWrap or ellipsis; current parser also accepts numeric strings. Case-sensitive options: ellipsis, noWrap, wrap. XML example, defaults and limitations	standard syntax: `setWrap`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (73)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
void setBorderWidth(int width) override — eLabel
void setBorderColor(const gRGB& col) override — eLabel
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setText(const std::string& string) — eLabel
void setMarkedPos(int markedPos) — eLabel
void setFont(gFont* font) — eLabel
gFont* getFont() — eLabel
void setVAlign(int align) — eLabel
void setHAlign(int align) — eLabel
void setForegroundColor(const gRGB& col) — eLabel
void setShadowColor(const gRGB& col) — eLabel
void setShadowOffset(const ePoint& offset) — eLabel
void setTextBorderColor(const gRGB& col) — eLabel
void setTextBorderWidth(int width) — eLabel
void setWrap(int wrap) — eLabel
void setNoWrap(int nowrap) — eLabel
void setUnderline(bool underline) — eLabel
void setScrollText(int direction, long delay, long startDelay, long endDelay, int repeat, int stepSize, int mode) — eLabel
void clearForegroundColor() — eLabel
int getWrap() const — eLabel
int getNoWrap() const — eLabel
void setAlphatest(int alphatest) — eLabel
void setTabWidth(int width) — eLabel
gRGB getForegroundColor(int styleID = 0) — eLabel
eSize calculateSize() — eLabel
static eSize calculateTextSize(gFont* font, const std::string& string, eSize targetSize, bool nowrap = false) — eLabel
void setFontScale(int scaleType, int size) — eLabel
void push() — eButton

`eCanvas`

Pixmap-derived drawing surface. A Canvas renderer consumes drawing instructions; font and text for those instructions are not eCanvas XML attributes.

lib/gui/ecanvas.h, line 6 ↗

18 current central XML attribute names. Inherits ePixmap. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (18)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`alphaTest`	Pixmap transparency: off, on (alpha test), or blend (smooth alpha blending). Case-sensitive options: on, off, blend. XML example, defaults and limitations	standard syntax: `setAlphatest`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`pixmap`	Resolved image path passed to LoadPixmap; PNG transparency is commonly used. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setPixmap`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`scale`	Pixmap scaling flags, for example none, scale, keepAspect or centerScaled. Not screen resolution scaling. Case-sensitive options: none, 0, scale, 1, keepAspect, leftTop, leftCenter, leftMiddle, leftBottom, centerTop, middleTop, centerScaled, middleScaled, centerBottom, middleBottom, rightTop, rightCenter, rightMiddle, rightBottom, moveLeftTop, moveLeftCenter, moveLeftMiddle, moveLeftBottom, moveCenterTop, moveMiddleTop, moveCenter, moveMiddle, moveCenterBottom, moveMiddleBottom, moveRightTop, moveRightCenter, moveRightMiddle, moveRightBottom, off, on, aspect, center, width, height, stretch, fill. XML example, defaults and limitations	standard syntax: `setPixmapScale`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (64)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
virtual void setBorderColor(const gRGB& color) — eWidget
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setPixmap(gPixmap* pixmap) — ePixmap
void setPixmapFromFile(const char* filename, bool autoDetect = false) — ePixmap
void setAlphatest(int alphatest) — ePixmap
void setScale(int scale) — ePixmap
void setPixmapScale(int flags) — ePixmap
void setPixmapScaleFlags(int flags) — ePixmap
void setAniPixmapFromFile(const char* filename, bool autostart = false) — ePixmap
void startAnimation(bool once = false) — ePixmap
void stopAnimation() — ePixmap
eSize getPixmapSize() const — ePixmap
void setSize(eSize size) — eCanvas
void clear(gRGB color) — eCanvas
void fillRect(eRect rect, gRGB color) — eCanvas
void drawLine(int x0, int y0, int x1, int y1, gRGB color) — eCanvas
void writeText(eRect where, gRGB fg, gRGB bg, gFont *font, const char *string, int flags) — eCanvas
void drawRotatedLine(int ox, int oy, int x0, int y0, int x1, int y1, float angle, bool cw, gRGB color) — eCanvas

`eGauge`

Native analogue gauge used by clock renderers. The Python renderer supplies values; the XML parser supplies geometry and the supported image attributes.

lib/gui/egauge.h, line 6 ↗

15 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (15)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (49)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
void setBorderColor(const gRGB &color) — eGauge
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setValue(int val) — eGauge

`eInput`

Native input widget. This is distinct from the commonly used Python Components.Input.Input, whose createWidget returns eLabel. Look up the actual component before selecting attributes.

lib/gui/einput.h, line 9 ↗

16 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (16)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`font`	Registered font face or alias and size, for example Regular;28. It is not a font file path. Registered font face or alias, optionally followed by ;size. A numeric size is scaled vertically with the screen. Register the face before using it. XML example, defaults and limitations	standard syntax: `setFont`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (51)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
virtual void setBorderColor(const gRGB& color) — eWidget
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setContent(eInputContent *cnt) — eInput
void setOverwriteMode(int o) — eInput
void setFont(gFont *font) — eInput

`eLabel`

Text label with font, alignment, wrapping, outline, shadow and text scrolling. borderColor/borderWidth address the text outline; use widgetBorderColor/widgetBorderWidth for the rectangular widget border.

lib/gui/elabel.h, line 34 ↗

30 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (30)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`alphaTest`	Pixmap transparency: off, on (alpha test), or blend (smooth alpha blending). For eLabel and its subclasses, both on and blend enable text blending: setAlphatest maps any positive mode to the same boolean. The three-way pixmap distinction does not apply here. Case-sensitive options: on, off, blend. XML example, defaults and limitations	standard syntax: `setAlphatest`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. Overrides the base implementation: colours the text outline. widgetBorderColor colours the widget rectangle. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Overrides the base implementation: text outline width. widgetBorderWidth sets the widget rectangle border. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`font`	Registered font face or alias and size, for example Regular;28. It is not a font file path. Registered font face or alias, optionally followed by ;size. A numeric size is scaled vertically with the screen. Register the face before using it. XML example, defaults and limitations	standard syntax: `setFont`
`fontScale`	Automatic label font adjustment: size;offset or width;offset (default offset -4). size;offset or width;offset. Offset is an integer; omitted offset is -4. An offset of 0 does not call the setter. XML example, defaults and limitations	standard syntax: `setFontScale`
`foregroundColor`	Text/foreground colour. A gradient value is supported only by the slider foreground path. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setForegroundColor`
`horizontalAlignment`	Text alignment inside its rectangle: left, center, right or block. Case-sensitive options: left, center, right, block. XML example, defaults and limitations	standard syntax: `setHAlign`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`scrollText`	Scrolling text configuration as comma-separated key=value pairs; direction, delays, repeat, stepSize and mode. Comma-separated key=value pairs. direction: left/right/top/bottom; stepDelay, startDelay, endDelay: milliseconds; stepSize: pixels; repeat: integer; mode: cached/bounce/bounceCached/roll. Omitted sub-options start at stepDelay=100, startDelay=0, endDelay=0, repeat=0, stepSize=2; omit mode for normal scrolling. XML example, defaults and limitations	standard syntax: `setScrollText`
`shadowColor`	Colour of the label text shadow. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setShadowColor`
`shadowOffset`	x,y offset of the text shadow; scaled with the screen. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `setShadowOffset`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tabWidth`	Tab-stop width for supporting text widgets; auto uses the automatic width. Non-negative integer tab-stop width, or auto for automatic sizing. XML example, defaults and limitations	standard syntax: `setTabWidth`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`text`	Static text, translated before setText. Python or a renderer may replace it later. XML text string; escape & as & and < as <. Translated and set initially; renderer/Python updates can replace it. XML example, defaults and limitations	standard syntax: `setText`
`textBorderColor`	Explicit colour of the outline around glyphs; different from a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setTextBorderColor`
`textBorderWidth`	Explicit glyph-outline thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setTextBorderWidth`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`underline`	Enable or disable underlined label text. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setUnderline`
`verticalAlignment`	Text alignment inside the widget: top, center/middle or bottom. Case-sensitive options: top, center, middle, bottom. XML example, defaults and limitations	standard syntax: `setVAlign`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`wrap`	Text overflow mode: wrap, noWrap or ellipsis; current parser also accepts numeric strings. Case-sensitive options: ellipsis, noWrap, wrap. XML example, defaults and limitations	standard syntax: `setWrap`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (72)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
void setBorderWidth(int width) override — eLabel
void setBorderColor(const gRGB& col) override — eLabel
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setText(const std::string& string) — eLabel
void setMarkedPos(int markedPos) — eLabel
void setFont(gFont* font) — eLabel
gFont* getFont() — eLabel
void setVAlign(int align) — eLabel
void setHAlign(int align) — eLabel
void setForegroundColor(const gRGB& col) — eLabel
void setShadowColor(const gRGB& col) — eLabel
void setShadowOffset(const ePoint& offset) — eLabel
void setTextBorderColor(const gRGB& col) — eLabel
void setTextBorderWidth(int width) — eLabel
void setWrap(int wrap) — eLabel
void setNoWrap(int nowrap) — eLabel
void setUnderline(bool underline) — eLabel
void setScrollText(int direction, long delay, long startDelay, long endDelay, int repeat, int stepSize, int mode) — eLabel
void clearForegroundColor() — eLabel
int getWrap() const — eLabel
int getNoWrap() const — eLabel
void setAlphatest(int alphatest) — eLabel
void setTabWidth(int width) — eLabel
gRGB getForegroundColor(int styleID = 0) — eLabel
eSize calculateSize() — eLabel
static eSize calculateTextSize(gFont* font, const std::string& string, eSize targetSize, bool nowrap = false) — eLabel
void setFontScale(int scaleType, int size) — eLabel

`eListbox`

List viewport and selection control. Row content may be string, configuration, service or MultiContent data. Row-template attributes and component-specific attributes are additional contracts.

lib/gui/elistbox.h, line 155 ↗

63 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (63)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorEven`	Solid colour for alternating even list rows; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColorRows`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`backgroundColorSelected`	Selected row background, as solid colour or a gradient specification. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColorSelected`
`backgroundPixmap`	Background image for a native target implementing setBackgroundPixmap; not universal to all widgets. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setBackgroundPixmap`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`enableWrapAround`	Allow list navigation to wrap from the final entry to the first and back. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWrapAround`
`entryFont`	Font for configuration entry labels on native targets supporting it. Registered font face or alias, optionally followed by ;size. A numeric size is scaled vertically with the screen. Register the face before using it. XML example, defaults and limitations	standard syntax: `setEntryFont`
`font`	Registered font face or alias and size, for example Regular;28. It is not a font file path. Registered font face or alias, optionally followed by ;size. A numeric size is scaled vertically with the screen. Register the face before using it. XML example, defaults and limitations	standard syntax: `setFont`
`fontScale`	Automatic label font adjustment: size;offset or width;offset (default offset -4). size;offset or width;offset. Offset is an integer; omitted offset is -4. An offset of 0 does not call the setter. XML example, defaults and limitations	standard syntax: `setFontScale`
`foregroundColor`	Text/foreground colour. A gradient value is supported only by the slider foreground path. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setForegroundColor`
`foregroundColorSelected`	Foreground/text colour for selected list entries. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setForegroundColorSelected`
`headerFont`	Font for configuration/list headers on supporting targets. Registered font face or alias, optionally followed by ;size. A numeric size is scaled vertically with the screen. Register the face before using it. XML example, defaults and limitations	standard syntax: `setHeaderFont`
`headerForegroundColor`	Foreground colour of configuration/list headers. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setHeaderColor`
`horizontalAlignment`	Text alignment inside its rectangle: left, center, right or block. Case-sensitive options: left, center, right, block. XML example, defaults and limitations	standard syntax: `setHAlign`
`itemAlignment`	Align list items within the available list rectangle; distinct from text alignment. Case-sensitive options: default, center, justify, leftTop, leftMiddle, leftBottom, rightTop, rightMiddle, rightBottom, centerTop, centerMiddle, centerBottom, justifyTop, justifyMiddle, justifyBottom, justifyLeft, justifyRight. XML example, defaults and limitations	standard syntax: `setItemAlignment`
`itemCornerRadius`	Rounded item background in its normal state. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setItemCornerRadius`
`itemCornerRadiusMarked`	Rounded background for a marked item. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setItemCornerRadiusMarked`
`itemCornerRadiusSelected`	Rounded background of the selected item. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setItemCornerRadiusSelected`
`itemGradient`	Background gradient for a normal list item. startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. XML example, defaults and limitations	standard syntax: `setItemGradient`
`itemGradientMarked`	Background gradient for a marked item. startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. XML example, defaults and limitations	standard syntax: `setItemGradientMarked`
`itemGradientSelected`	Background gradient for the selected list item. startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. XML example, defaults and limitations	standard syntax: `setItemGradientSelected`
`itemHeight`	Height of one list entry, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setItemHeight`
`itemSpacing`	Horizontal and vertical gap between list items; one value applies to both axes. One integer for both directions, or horizontal,vertical gap in design pixels. Both axes scale with the screen. XML example, defaults and limitations	standard syntax: `setItemSpacing`
`itemWidth`	Width of one list item, scaled horizontally. Integer design pixels, scaled horizontally with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setItemWidth`
`listOrientation`	List layout: vertical, horizontal or grid; not a slider direction. Case-sensitive options: vertical, horizontal, grid. XML example, defaults and limitations	standard syntax: `setOrientation`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`scrollbarBackgroundColor`	Solid colour behind the scrollbar handle. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setScrollbarBackgroundColor`
`scrollbarBackgroundGradient`	Gradient behind the scrollbar handle on supporting targets. startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. XML example, defaults and limitations	standard syntax: `setScrollbarBackgroundGradient`
`scrollbarBackgroundPixmap`	Image behind the scrollbar handle. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setScrollbarBackgroundPixmap`
`scrollbarBorderColor`	Scrollbar border colour. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setScrollbarBorderColor`
`scrollbarBorderWidth`	Scrollbar border thickness, scaled horizontally. Integer design pixels, scaled horizontally with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setScrollbarBorderWidth`
`scrollbarForegroundColor`	Scrollbar handle colour. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setScrollbarForegroundColor`
`scrollbarForegroundGradient`	Scrollbar handle gradient. startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. XML example, defaults and limitations	standard syntax: `setScrollbarForegroundGradient`
`scrollbarForegroundPixmap`	Scrollbar handle image. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setScrollbarForegroundPixmap`
`scrollbarLength`	Scrollbar length: numeric value, full or auto; interpretation is the target widget's. Non-negative integer length, full (0) or auto (-1). On eListbox this sizes the scrollbar track along the list: full uses the widget extent; auto follows the laid-out item extent and offsets. It does not directly set the handle length. XML example, defaults and limitations	standard syntax: `setScrollbarLength`
`scrollbarMode`	Visibility and side of the scrollbar; showOnDemand, showAlways, showNever and side-specific modes. Case-sensitive options: showOnDemand, showAlways, showNever, showLeftOnDemand, showLeftAlways, showTopOnDemand, showTopAlways, showOnDemandShrink. XML example, defaults and limitations	standard syntax: `setScrollbarMode`
`scrollbarOffset`	Integer distance/offset passed to the native scrollbar; this handler does not apply screen scaling. Integer gap between the list content and scrollbar in native pixels. This setter does not apply screen scaling. XML example, defaults and limitations	standard syntax: `setScrollbarOffset`
`scrollbarRadius`	Rounded scrollbar corners, optionally restricted to named edges. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setScrollbarRadius`
`scrollbarScroll`	Scrollbar movement granularity: byPage or byLine. Case-sensitive options: byPage, byLine. XML example, defaults and limitations	standard syntax: `setScrollbarScroll`
`scrollbarWidth`	Scrollbar thickness, scaled horizontally. Integer design pixels, scaled horizontally with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setScrollbarWidth`
`scrollText`	Scrolling text configuration as comma-separated key=value pairs; direction, delays, repeat, stepSize and mode. Comma-separated key=value pairs. direction: left/right/top/bottom; stepDelay, startDelay, endDelay: milliseconds; stepSize: pixels; repeat: integer; mode: cached/bounce/bounceCached/roll. Omitted sub-options start at stepDelay=100, startDelay=0, endDelay=0, repeat=0, stepSize=2; omit mode for normal scrolling. XML example, defaults and limitations	standard syntax: `setScrollText`
`selection`	Enable or disable drawing the list selection highlight. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setSelectionEnable`
`selectionPixmap`	Image used for the list selection background. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setSelectionPixmap`
`selectionZoom`	Selection enlargement as an integer percentage increment[,mode]: 25 means 1.25 times the normal size. The increment is capped at 500; see parseZoom for the mode. Non-negative integer percentage increment[,mode]. 25 means 125% of normal size; capped at 500. Modes: zoomContent, moveContent, ignoreContent. XML example, defaults and limitations	standard syntax: `setSelectionZoom`
`selectionZoomSize`	Explicit enlarged selection width,height[,mode]. width,height[,mode]. Modes: zoomContent, moveContent, ignoreContent. Literal dimensions scale with the screen. XML example, defaults and limitations	standard syntax: `setSelectionZoomSize`
`separatorLineColor`	Colour of entry separators in supporting lists. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setSeparatorColor`
`separatorLineSize`	Separator geometry: height, top,height or left,top,width,height; -1 has automatic/full-width meaning. height, top,height, or left,top,width,height. top=-1 centres the line; width=-1 uses the available width minus margins. XML example, defaults and limitations	standard syntax: `setSeparatorSize`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`spacingColor`	Colour of spacing in a native widget that supports setSpacingColor. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setSpacingColor`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`valueFont`	Font for configuration values on supporting targets. Registered font face or alias, optionally followed by ;size. A numeric size is scaled vertically with the screen. Register the face before using it. XML example, defaults and limitations	standard syntax: `setValueFont`
`verticalAlignment`	Text alignment inside the widget: top, center/middle or bottom. Case-sensitive options: top, center, middle, bottom. XML example, defaults and limitations	standard syntax: `setVAlign`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`wrap`	Text overflow mode: wrap, noWrap or ellipsis; current parser also accepts numeric strings. Case-sensitive options: ellipsis, noWrap, wrap. XML example, defaults and limitations	standard syntax: `setWrap`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (174)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
void invalidate(const gRegion &region = gRegion::invalidRegion()) override — eListbox
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
void setBackgroundColor(const gRGB &col) override — eListbox
void clearBackgroundColor() override — eListbox
void setBorderWidth(int width) override — eListbox
void setBorderColor(const gRGB &col) override — eListbox
void setWidgetBorderWidth(int width) override — eListbox
void setWidgetBorderColor(const gRGB &col) override — eListbox
virtual void setWidgetAlphaBlend(bool blend) — eWidget
void setPadding(const eRect &padding) override — eListbox
eRect getPadding() override — eListbox
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setItemAlignment(int align) — eListbox
void setScrollbarScroll(uint8_t scroll) — eListbox
void setScrollbarMode(uint8_t mode) — eListbox
void setWrapAround(bool state) — eListbox
void setLockFirstRow(bool lock) — eListbox
bool getLockFirstRow() const — eListbox
void setOrientation(uint8_t orientation) — eListbox
void setContent(iListboxContent *content) — eListbox
void allowNativeKeys(bool allow) — eListbox
void enableAutoNavigation(bool allow) — eListbox
int getCurrentIndex() const — eListbox
void moveSelection(int how) — eListbox
void moveSelectionTo(int index) — eListbox
void moveToEnd() — eListbox
bool atBegin() const — eListbox
bool atEnd() const — eListbox
void goTop() — eListbox
void goBottom() — eListbox
void goLineUp() — eListbox
void goLineDown() — eListbox
void goPageUp() — eListbox
void goPageDown() — eListbox
void goLeft() — eListbox
void goRight() — eListbox
void goPageLeft() — eListbox
void goPageRight() — eListbox
void goFirst() — eListbox
void goLast() — eListbox
void setItemHeight(int h) — eListbox
void setItemWidth(int w) — eListbox
void setSelectionEnable(int en) — eListbox
void setBackgroundColorSelected(const gRGB &col) — eListbox
void setForegroundColor(const gRGB &col) — eListbox
void setForegroundColorSelected(const gRGB &col) — eListbox
void setBackgroundColorRows(const gRGB &col) — eListbox
void setSpacingColor(const gRGB &col) — eListbox
void clearSpacingColor() — eListbox
void clearBackgroundColorSelected() — eListbox
void clearForegroundColor() — eListbox
void clearForegroundColorSelected() — eListbox
void setBackgroundPixmap(ePtr<gPixmap> &pm) — eListbox
void setSelectionPixmap(ePtr<gPixmap> &pm) — eListbox
void setSelectionBorderHidden() — eListbox
void setScrollbarForegroundPixmap(ePtr<gPixmap> &pm) — eListbox
void setScrollbarBackgroundPixmap(ePtr<gPixmap> &pm) — eListbox
void setScrollbarBorderWidth(int width) — eListbox
void setScrollbarWidth(int size) — eListbox
void setScrollbarHeight(int size) — eListbox
void setScrollbarOffset(int size) — eListbox
void setScrollbarLength(int size) — eListbox
void setFont(gFont *font) — eListbox
void setEntryFont(gFont *font) — eListbox
void setValueFont(gFont *font) — eListbox
void setHeaderFont(gFont *font) — eListbox
void setFontScale(int scaleType, int size) — eListbox
void setVAlign(int align) — eListbox
void setHAlign(int align) — eListbox
void setWrap(int wrap) — eListbox
void setUseVTIWorkaround(void) — eListbox
void setScrollbarBorderColor(const gRGB &col) — eListbox
void setScrollbarForegroundColor(gRGB &col) — eListbox
void setScrollbarBackgroundColor(gRGB &col) — eListbox
void setScrollbarForegroundGradient(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend) — eListbox
void setScrollbarBackgroundGradient(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend) — eListbox
void setScrollbarRadius(int radius, uint8_t edges) — eListbox
void setMaxRows(int rows) — eListbox
void setMaxColumns(int columns) — eListbox
void setItemSpacing(const ePoint &spacing, bool innerOnly = false) — eListbox
void setItemCornerRadius(int radius, uint8_t edges) — eListbox
void setItemCornerRadiusSelected(int radius, uint8_t edges) — eListbox
void setItemCornerRadiusMarked(int radius, uint8_t edges) — eListbox
void setItemCornerRadiusMarkedandSelected(int radius, uint8_t edges) — eListbox
void setItemGradient(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend) — eListbox
void setItemGradientSelected(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend) — eListbox
void setItemGradientMarked(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend) — eListbox
void setItemGradientMarkedandSelected(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend) — eListbox
void setSelectionZoom(float zoom, int zoomContentMode = 0) — eListbox
void setSelectionZoomSize(int width, int height, int zoomContentMode = 0) — eListbox
void setSeparatorColor(const gRGB &col) — eListbox
void setSeparatorSize(const eRect &size) — eListbox
void setHeaderColor(const gRGB &col) — eListbox
void setOverlay(ePtr<gPixmap> &pm) — eListbox
void setPageSize(int size) — eListbox
static void setDefaultScrollbarStyle(int width, int offset, int borderwidth, uint8_t scroll, uint8_t mode, bool enablewraparound) — eListbox
static void setDefaultPadding(const eRect &padding) — eListbox
static void setDefaultScrollbarRadius(int radius, uint8_t radiusEdges) — eListbox
static void setDefaultItemRadius(int radius, uint8_t radiusEdges) — eListbox
static void setDefaultItemRadiusSelected(int radius, uint8_t radiusEdges) — eListbox
static void setDefaultItemRadiusMarked(int radius, uint8_t radiusEdges) — eListbox
static void setDefaultItemRadiusMarkedAndSelected(int radius, uint8_t radiusEdges) — eListbox
static void setDefaultHorizontalAlignment(int alignment) — eListbox
static void setDefaultVerticalAlignment(int alignment) — eListbox
void setTopIndex(int idx) — eListbox
void setStartIndex(int index) — eListbox
int getStartIndex() const — eListbox
bool getWrapAround() const — eListbox
uint8_t getScrollbarScroll() const — eListbox
uint8_t getScrollbarMode() const — eListbox
int getScrollbarWidth() const — eListbox
int getScrollbarHeight() const — eListbox
int getScrollbarOffset() const — eListbox
int getScrollbarBorderWidth() const — eListbox
int getItemAlignment() const — eListbox
int getPageSize() const — eListbox
int getItemHeight() const — eListbox
int getItemWidth() const — eListbox
uint8_t getOrientation() const — eListbox
int getTopIndex() const — eListbox
bool getSelectionEnable() const — eListbox
gFont *getFont() const — eListbox
gFont *getEntryFont() const — eListbox
gFont *getValueFont() const — eListbox
gFont *getHeaderFont() const — eListbox
int getItemsPerPage() const — eListbox
int getCurrentPage() const — eListbox
int getPageCount() const — eListbox
int getMaxItemTextWidth() const — eListbox
void redrawItemByIndex(int index) — eListbox
int getScrollbarListOffset() const — eListbox
void setScrollText(int direction, long delay, long startDelay, long endDelay, int repeat, int stepSize, int mode) — eListbox
#ifndef SWIG struct eListboxStyle *getLocalStyle(void) — eListbox
void entryAdded(int index) — eListbox
void entryRemoved(int index) — eListbox
void entryChanged(int index) — eListbox
void entryReset(bool cursorHome = true) — eListbox
int getEntryTop() const — eListbox

`ePixmap`

Image widget: pixmap, scaling and alpha test/blending, plus base widget appearance. No font or text alignment attributes.

lib/gui/epixmap.h, line 7 ↗

18 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (18)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`alphaTest`	Pixmap transparency: off, on (alpha test), or blend (smooth alpha blending). Case-sensitive options: on, off, blend. XML example, defaults and limitations	standard syntax: `setAlphatest`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`pixmap`	Resolved image path passed to LoadPixmap; PNG transparency is commonly used. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setPixmap`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`scale`	Pixmap scaling flags, for example none, scale, keepAspect or centerScaled. Not screen resolution scaling. Case-sensitive options: none, 0, scale, 1, keepAspect, leftTop, leftCenter, leftMiddle, leftBottom, centerTop, middleTop, centerScaled, middleScaled, centerBottom, middleBottom, rightTop, rightCenter, rightMiddle, rightBottom, moveLeftTop, moveLeftCenter, moveLeftMiddle, moveLeftBottom, moveCenterTop, moveMiddleTop, moveCenter, moveMiddle, moveCenterBottom, moveMiddleBottom, moveRightTop, moveRightCenter, moveRightMiddle, moveRightBottom, off, on, aspect, center, width, height, stretch, fill. XML example, defaults and limitations	standard syntax: `setPixmapScale`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (58)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
virtual void setBorderColor(const gRGB& color) — eWidget
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setPixmap(gPixmap* pixmap) — ePixmap
void setPixmapFromFile(const char* filename, bool autoDetect = false) — ePixmap
void setAlphatest(int alphatest) — ePixmap
void setScale(int scale) — ePixmap
void setPixmapScale(int flags) — ePixmap
void setPixmapScaleFlags(int flags) — ePixmap
void setAniPixmapFromFile(const char* filename, bool autostart = false) — ePixmap
void startAnimation(bool once = false) — ePixmap
void stopAnimation() — ePixmap
eSize getPixmapSize() const — ePixmap

`ePositionGauge`

Playback position and seek/cut marker widget. pointer and seekPointer use filename:x,y syntax; the source/renderer supplies playback and cut-list values.

lib/gui/epositiongauge.h, line 13 ↗

18 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (18)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`foregroundColor`	Text/foreground colour. A gradient value is supported only by the slider foreground path. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setForegroundColor`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`pointer`	Pointer image and anchor offset for supporting widgets; see the source setter for the colon-separated path/coordinate syntax. imageFilename:x,y. x,y is the pointer anchor offset; the target must support pointer index 0. XML example, defaults and limitations	standard syntax: `setPointer`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`seekPointer`	Secondary seek pointer image and anchor offset, for widgets that support it. imageFilename:x,y. x,y is the pointer anchor offset; the target must support pointer index 1. XML example, defaults and limitations	standard syntax: `setPointer`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (57)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
virtual void setBorderColor(const gRGB& color) — eWidget
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
#ifndef SWIG protected: int event(int event, void *data=0, void *data2=0) — ePositionGauge
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setLength(const pts_t &len) — ePositionGauge
void setPosition(const pts_t &pos) — ePositionGauge
void setInColor(const gRGB &color) — ePositionGauge
void setPointer(int which, gPixmap *pixmap, const ePoint &center) — ePositionGauge
void setInOutList(SWIG_PYOBJECT(ePyObject) list) — ePositionGauge
void setForegroundColor(const gRGB &col) — ePositionGauge
void setCutMark(const pts_t &where, int what) — ePositionGauge
void enableSeekPointer(int enable) — ePositionGauge
void setSeekPosition(const pts_t &pos) — ePositionGauge

`eQRCode`

QR-code widget. text supplies the encoded payload; errorCorrection, quietZone and colour/spacing options determine the generated symbol.

lib/gui/eqrcode.h, line 9 ↗

19 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (19)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`errorCorrection`	QR code recovery level: low, medium, quartile or high. Case-sensitive options: low, medium, quartile, high. XML example, defaults and limitations	standard syntax: `setErrorCorrection`
`foregroundColor`	Text/foreground colour. A gradient value is supported only by the slider foreground path. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setForegroundColor`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`quietZone`	QR code quiet-zone size; does not add general-purpose label padding. Integer quiet-zone module count around a QR code. The parser uses 4 for an invalid integer; this is not ordinary pixel padding. XML example, defaults and limitations	standard syntax: `setQuietZone`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`text`	Static text, translated before setText. Python or a renderer may replace it later. XML text string; escape & as & and < as <. Translated and set initially; renderer/Python updates can replace it. XML example, defaults and limitations	standard syntax: `setText`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (54)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
void setBackgroundColor(const gRGB& color) override — eQRCode
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
virtual void setBorderColor(const gRGB& color) — eWidget
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setText(const std::string& text) — eQRCode
std::string getText() const — eQRCode
void setErrorCorrection(int level) — eQRCode
void setQuietZone(int modules) — eQRCode
void setForegroundColor(const gRGB& color) — eQRCode
bool isValid() const — eQRCode

`eRectangle`

Decorative rectangle. Uses the base widget background, gradient, corner and border attributes.

lib/gui/erectangle.h, line 6 ↗

15 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (15)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (48)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
virtual void setBorderColor(const gRGB& color) — eWidget
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget

`eSlider`

Progress or slider widget. Supports foreground/background images and gradients and the two-argument slider orientation parser. Several scrollbar names are compatibility mappings.

lib/gui/eslider.h, line 6 ↗

30 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (30)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`alphaTest`	Pixmap transparency: off, on (alpha test), or blend (smooth alpha blending). Case-sensitive options: on, off, blend. XML example, defaults and limitations	standard syntax: `setAlphatest`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`backgroundPixmap`	Background image for a native target implementing setBackgroundPixmap; not universal to all widgets. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setBackgroundPixmap`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`foregroundColor`	Text/foreground colour. A gradient value is supported only by the slider foreground path. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setForegroundColor` gradient: `setForegroundGradient`
`gradientMode`	Slider gradient behaviour: legacy or explicit. Check the receiver version before using this newer option. legacy or explicit. Controls how a slider interprets its gradient; use only with a slider implementing setGradientMode. XML example, defaults and limitations	standard syntax: `setGradientMode`
`orientation`	Slider direction: orHorizontal/orLeftToRight, orRightToLeft, orVertical/orTopToBottom, orBottomToTop. Case-sensitive options: orHorizontal, orLeftToRight, orRightToLeft, orVertical, orTopToBottom, orBottomToTop. XML example, defaults and limitations	standard syntax: `setOrientation`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`pixmap`	Resolved image path passed to LoadPixmap; PNG transparency is commonly used. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setPixmap`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`scale`	Pixmap scaling flags, for example none, scale, keepAspect or centerScaled. Not screen resolution scaling. Case-sensitive options: none, 0, scale, 1, keepAspect, leftTop, leftCenter, leftMiddle, leftBottom, centerTop, middleTop, centerScaled, middleScaled, centerBottom, middleBottom, rightTop, rightCenter, rightMiddle, rightBottom, moveLeftTop, moveLeftCenter, moveLeftMiddle, moveLeftBottom, moveCenterTop, moveMiddleTop, moveCenter, moveMiddle, moveCenterBottom, moveMiddleBottom, moveRightTop, moveRightCenter, moveRightMiddle, moveRightBottom, off, on, aspect, center, width, height, stretch, fill. XML example, defaults and limitations	standard syntax: `setPixmapScale`
`scrollbarBackgroundColor`	Solid colour behind the scrollbar handle. The implementation delegates to setBackgroundColor; this is a compatibility name for the slider background. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setScrollbarBackgroundColor`
`scrollbarBackgroundGradient`	Gradient behind the scrollbar handle on supporting targets. startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. XML example, defaults and limitations	standard syntax: `setScrollbarBackgroundGradient`
`scrollbarBackgroundPixmap`	Image behind the scrollbar handle. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setScrollbarBackgroundPixmap`
`scrollbarBorderColor`	Scrollbar border colour. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setScrollbarBorderColor`
`scrollbarBorderWidth`	Scrollbar border thickness, scaled horizontally. Integer design pixels, scaled horizontally with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setScrollbarBorderWidth`
`scrollbarForegroundColor`	Scrollbar handle colour. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setScrollbarForegroundColor`
`scrollbarForegroundGradient`	Scrollbar handle gradient. startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. XML example, defaults and limitations	standard syntax: `setScrollbarForegroundGradient`
`scrollbarForegroundPixmap`	Scrollbar handle image. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setScrollbarForegroundPixmap`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (70)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
void setBackgroundColor(const gRGB &color) override — eSlider
virtual void clearBackgroundColor() — eWidget
void setBorderWidth(int width) override — eSlider
void setBorderColor(const gRGB &color) override — eSlider
void setWidgetBorderWidth(int width) override — eSlider
void setWidgetBorderColor(const gRGB &color) override — eSlider
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend) — eSlider
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setValue(int val) — eSlider
void setStartEnd(int start, int end, bool pixel = false) — eSlider
void setRange(int min, int max) — eSlider
void setOrientation(uint8_t orientation, uint8_t swapped = 0) — eSlider
void setForegroundColor(const gRGB &color) — eSlider
void setPixmap(gPixmap *pixmap) — eSlider
void setBackgroundPixmap(gPixmap *pixmap) — eSlider
void setPixmapScale(int flags) — eSlider
void setAlphatest(int alphatest) — eSlider
void setIsScrollbar() — eSlider
void setGradientMode(bool explicitMode) — eSlider
static void setDefaultBorderWidth(int borderwidth) — eSlider
int getBorderWidth() — eSlider
void setScrollbarBorderWidth(int width) — eSlider
void setScrollbarBorderColor(const gRGB &color) — eSlider
void setScrollbarForegroundPixmap(gPixmap *pixmap) — eSlider
void setScrollbarBackgroundPixmap(gPixmap *pixmap) — eSlider
void setScrollbarForegroundColor(const gRGB &color) — eSlider
void setScrollbarBackgroundColor(const gRGB &color) — eSlider
void setForegroundGradient(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend, bool fullColor = false) — eSlider
void setScrollbarForegroundGradient(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend, bool fullColor = false) — eSlider
void setScrollbarBackgroundGradient(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend) — eSlider

`eStack`

Layout container whose children use align. Geometry and appearance are inherited from eWidget; it is not a text label or listbox.

lib/gui/estack.h, line 9 ↗

16 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (16)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`spacing`	Spacing setter for supporting native widgets; a panel also consumes spacing for its layout context. Integer spacing used by the native stack/layout; panel spacing is handled by the structural parser. XML example, defaults and limitations	standard syntax: `setSpacing`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (54)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
void show() override — eStack
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
virtual void setBorderColor(const gRGB& color) — eWidget
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
std::string dumpObject() const override — eStack
void setLayoutDirection(LayoutDirection dir) — eStack
LayoutDirection layoutDirection() const — eStack
void addChild(eWidget* child) — eStack
void removeChild(eWidget* child) — eStack
int getSpacing() const — eStack
void setSpacing(int spacing) — eStack

`eSubtitleWidget`

Native subtitle display surface. DVB/teletext subtitle styles are configured by the subtitle skin resources; they are not arbitrary label attributes on this widget.

lib/gui/esubtitle.h, line 43 ↗

16 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (16)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`pixmap`	Resolved image path passed to LoadPixmap; PNG transparency is commonly used. Image filename, resolved in the skin context before loading. Supply an existing PNG/SVG or another supported image; the sample path must be replaced with your asset. XML example, defaults and limitations	standard syntax: `setPixmap`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (53)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
virtual void setBorderColor(const gRGB& color) — eWidget
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setPage(const eDVBTeletextSubtitlePage &p) — eSubtitleWidget
void clearPage() — eSubtitleWidget
void setPixmap(ePtr<gPixmap> &pixmap, gRegion changed, eRect dest = eRect(0, 0, 720, 576)) — eSubtitleWidget
void destroy() — eSubtitleWidget
#endif static void setFontStyle(subfont_t face, gFont *font, int autoColor, const gRGB &col, const gRGB &borderCol, int borderWidth) — eSubtitleWidget

`eVideoWidget`

Native video plane wrapper derived from eLabel. Inherited label methods exist, but video placement/decoder behaviour is controlled by Pig or VideoWindow and the receiver driver.

lib/gui/evideo.h, line 6 ↗

31 current central XML attribute names. Inherits eLabel. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (31)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`alphaTest`	Pixmap transparency: off, on (alpha test), or blend (smooth alpha blending). For eLabel and its subclasses, both on and blend enable text blending: setAlphatest maps any positive mode to the same boolean. The three-way pixmap distinction does not apply here. Case-sensitive options: on, off, blend. XML example, defaults and limitations	standard syntax: `setAlphatest`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. Inherited eLabel override: text outline, not the video-plane border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Inherited eLabel override: text outline, not the video-plane border. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`font`	Registered font face or alias and size, for example Regular;28. It is not a font file path. Registered font face or alias, optionally followed by ;size. A numeric size is scaled vertically with the screen. Register the face before using it. XML example, defaults and limitations	standard syntax: `setFont`
`fontScale`	Automatic label font adjustment: size;offset or width;offset (default offset -4). size;offset or width;offset. Offset is an integer; omitted offset is -4. An offset of 0 does not call the setter. XML example, defaults and limitations	standard syntax: `setFontScale`
`foregroundColor`	Text/foreground colour. A gradient value is supported only by the slider foreground path. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setForegroundColor`
`horizontalAlignment`	Text alignment inside its rectangle: left, center, right or block. Case-sensitive options: left, center, right, block. XML example, defaults and limitations	standard syntax: `setHAlign`
`overScan`	Pass the overscan value to a native target implementing setOverscan; this is not global TV calibration. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setOverscan`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`scrollText`	Scrolling text configuration as comma-separated key=value pairs; direction, delays, repeat, stepSize and mode. Comma-separated key=value pairs. direction: left/right/top/bottom; stepDelay, startDelay, endDelay: milliseconds; stepSize: pixels; repeat: integer; mode: cached/bounce/bounceCached/roll. Omitted sub-options start at stepDelay=100, startDelay=0, endDelay=0, repeat=0, stepSize=2; omit mode for normal scrolling. XML example, defaults and limitations	standard syntax: `setScrollText`
`shadowColor`	Colour of the label text shadow. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setShadowColor`
`shadowOffset`	x,y offset of the text shadow; scaled with the screen. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `setShadowOffset`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tabWidth`	Tab-stop width for supporting text widgets; auto uses the automatic width. Non-negative integer tab-stop width, or auto for automatic sizing. XML example, defaults and limitations	standard syntax: `setTabWidth`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`text`	Static text, translated before setText. Python or a renderer may replace it later. XML text string; escape & as & and < as <. Translated and set initially; renderer/Python updates can replace it. XML example, defaults and limitations	standard syntax: `setText`
`textBorderColor`	Explicit colour of the outline around glyphs; different from a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setTextBorderColor`
`textBorderWidth`	Explicit glyph-outline thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setTextBorderWidth`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`underline`	Enable or disable underlined label text. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setUnderline`
`verticalAlignment`	Text alignment inside the widget: top, center/middle or bottom. Case-sensitive options: top, center, middle, bottom. XML example, defaults and limitations	standard syntax: `setVAlign`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`wrap`	Text overflow mode: wrap, noWrap or ellipsis; current parser also accepts numeric strings. Case-sensitive options: ellipsis, noWrap, wrap. XML example, defaults and limitations	standard syntax: `setWrap`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (78)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
void setBorderWidth(int width) override — eLabel
void setBorderColor(const gRGB& col) override — eLabel
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setText(const std::string& string) — eLabel
void setMarkedPos(int markedPos) — eLabel
void setFont(gFont* font) — eLabel
gFont* getFont() — eLabel
void setVAlign(int align) — eLabel
void setHAlign(int align) — eLabel
void setForegroundColor(const gRGB& col) — eLabel
void setShadowColor(const gRGB& col) — eLabel
void setShadowOffset(const ePoint& offset) — eLabel
void setTextBorderColor(const gRGB& col) — eLabel
void setTextBorderWidth(int width) — eLabel
void setWrap(int wrap) — eLabel
void setNoWrap(int nowrap) — eLabel
void setUnderline(bool underline) — eLabel
void setScrollText(int direction, long delay, long startDelay, long endDelay, int repeat, int stepSize, int mode) — eLabel
void clearForegroundColor() — eLabel
int getWrap() const — eLabel
int getNoWrap() const — eLabel
void setAlphatest(int alphatest) — eLabel
void setTabWidth(int width) — eLabel
gRGB getForegroundColor(int styleID = 0) — eLabel
eSize calculateSize() — eLabel
static eSize calculateTextSize(gFont* font, const std::string& string, eSize targetSize, bool nowrap = false) — eLabel
void setFontScale(int scaleType, int size) — eLabel
void setDecoder(int target) — eVideoWidget
void setOverscan(bool overscan) — eVideoWidget
void setFBSize(eSize size) — eVideoWidget
void setFullScreenPosition(eRect pos) — eVideoWidget
void restoreFullsize() — eVideoWidget
static void setFullsize(bool force = false, bool mainOnly = false) — eVideoWidget

`eWidget`

Base widget: geometry, background, borders, transparency and stacking. It does not implement text, pixmap or list content.

lib/gui/ewidget.h, line 15 ↗

15 current central XML attribute names. Inherits no other widget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (15)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (48)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
virtual eWidget* child() — eWidget
eWidget* getParent() — eWidget
virtual void show() — eWidget
void hide() — eWidget
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
virtual void setBackgroundColor(const gRGB& col) — eWidget
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
virtual void setBorderColor(const gRGB& color) — eWidget
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB& startcolor, const gRGB& midcolor, const gRGB& endcolor, uint8_t direction, bool alphablend) — eWidget
void setCornerRadius(int radius, uint8_t edges) — eWidget
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget

`eWindow`

Screen window. Adds title, window flags and animation mode to the base widget. Use these on the screen rather than on a Label renderer.

lib/gui/ewindow.h, line 9 ↗

18 current central XML attribute names. Inherits eWidget. Appearance also depends on the Python component and content.

Attributes, meaning and supported value variants (18)

XML attribute	Meaning / syntax	Native dispatch
`align`	Stack alignment passed to setAlign; this is an engine-facing value, not text alignment. The handler forwards the XML string unchanged to a native numeric/Boolean setter. No reliable general XML authoring syntax is established by this handler. XML example, defaults and limitations	standard syntax: `setAlign`
`alphaBlend`	Enable native widget background/border alpha blending where supported; useful for overlaying translucent rectangles. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setWidgetAlphaBlend`
`animationMode`	Control window show/hide animation; off disables both directions. Case-sensitive options: disable, off, offshow, offhide, onshow, onhide, disable_onshow, disable_onhide. XML example, defaults and limitations	standard syntax: `setAnimationMode`
`backgroundColor`	Solid #AARRGGBB/named colour, or gradient specification start[,middle],end,direction[,alphaBlend]. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. A gradient can also use startColour[,middleColour],endColour,horizontal\|vertical[,alphaBlend]. Use named colours or #AARRGGBB; the optional alphaBlend is Boolean. Only widgets with the gradient variant listed below accept it. XML example, defaults and limitations	solid colour: `setBackgroundColor` gradient: `setBackgroundGradient`
`backgroundColorOdd`	Solid base/odd-row list background; gradients are not accepted here. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBackgroundColor`
`borderColor`	Generic border setter. On eLabel this currently changes the text outline; use widgetBorderColor for a rectangle border. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setBorderColor`
`borderWidth`	Generic border width. On eLabel this currently changes glyph outlines; use widgetBorderWidth for the widget frame. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setBorderWidth`
`cornerRadius`	Corner radius, optionally followed by a semicolon and edge names, e.g. 24;topLeft,topRight. Integer radius, optionally ; followed by comma-separated edges: topLeft, topRight, top, bottomLeft, bottomRight, bottom, left, right. Omit edges for all corners. XML example, defaults and limitations	standard syntax: `setCornerRadius`
`flags`	Comma-separated eWindow flags, for example wfNoBorder; belongs on a screen/window. Comma-separated eWindow flag names, such as wfNoBorder. On template text, flags has a different meaning; see the underline recipe. XML example, defaults and limitations	standard syntax: `setFlag`
`padding`	One, two or four comma-separated inset values: left,top,right,bottom. Two values repeat as x,y,x,y. One integer for all sides; x,y repeats x,y,x,y; four integers are left,top,right,bottom. These values are passed through without screen scaling. XML example, defaults and limitations	standard syntax: `setPadding`
`position`	x,y relative to the current layout context; centre and arithmetic coordinates are supported. x,y coordinates in the design coordinate system. Literal numbers are scaled; parent-relative expressions such as center and percentages are context dependent. XML example, defaults and limitations	standard syntax: `csize`, `move`
`size`	width,height of the widget; does not set its text alignment or font size. width,height in the design coordinate system. Literal values are scaled with the screen. XML example, defaults and limitations	standard syntax: `resize`
`tag`	Integer widget identifier used by native stack/layout machinery. Integer native widget tag. This does not bind a Python component; use name for that. XML example, defaults and limitations	standard syntax: `setTag`
`title`	Window title; translated with the current interface locale before being applied. XML text string used as the screen title; translated before application. XML example, defaults and limitations	standard syntax: `setTitle`
`transparent`	Boolean: suppress the widget background. This is distinct from the transparency byte in a painted colour. Boolean: 1 / yes / true / on / enabled enables it; 0 / no / false / off disables it. Case-insensitive. Other unrecognised strings also evaluate false. XML example, defaults and limitations	standard syntax: `setTransparent`
`widgetBorderColor`	Explicit rectangular widget-frame colour, including on eLabel. A registered colour name or #AARRGGBB. AA is transparency: 00 opaque, FF transparent. Example: #00FFFFFF is opaque white. XML example, defaults and limitations	standard syntax: `setWidgetBorderColor`
`widgetBorderWidth`	Explicit rectangular widget-frame thickness, scaled vertically. Integer design pixels, scaled vertically with the screen. Use a non-negative value. XML example, defaults and limitations	standard syntax: `setWidgetBorderWidth`
`zPosition`	Integer painting layer among overlapping widgets; larger values are in front. Integer stacking order; higher values paint in front of lower values in the same parent. XML example, defaults and limitations	standard syntax: `setZPosition`

Public native methods, including inherited declarations (53)

void move(ePoint pos) — eWidget
void resize(eSize size) — eWidget
ePoint position() const — eWidget
eSize size() const — eWidget
eSize csize() const — eWidget
virtual void invalidate(const gRegion& region = gRegion::invalidRegion()) — eWidget
eWidget *child() — eWindow
eWidget* getParent() — eWidget
void show() — eWindow
void hide() — eWindow
void raise() — eWidget
void lower() — eWidget
void destruct() — eWidget
SWIG_VOID(int) getStyle(ePtr<eWindowStyle>& SWIG_NAMED_OUTPUT(style)) — eWidget
void setStyle(eWindowStyle* style) — eWidget
void setBackgroundColor(const gRGB &col) override — eWindow
virtual void clearBackgroundColor() — eWidget
virtual void setBorderWidth(int width) — eWidget
virtual void setBorderColor(const gRGB& color) — eWidget
virtual void setWidgetBorderWidth(int width) — eWidget
virtual void setWidgetBorderColor(const gRGB& color) — eWidget
virtual void setWidgetAlphaBlend(bool blend) — eWidget
virtual void setPadding(const eRect& padding) — eWidget
virtual eRect getPadding() — eWidget
void setZPosition(int z) — eWidget
void setTransparent(int transp) — eWidget
int isVisible() — eWidget
int isLowered() — eWidget
int isTransparent() — eWidget
void setModal(int m) — eWidget
int isModal() const — eWidget
ePoint getAbsolutePosition() — eWidget
int getTag() const — eWidget
void setTag(int tag) — eWidget
virtual int event(int event, void* data = 0, void* data2 = 0) — eWidget
void setFocus(eWidget* focus) — eWidget
void setPositionNotifyChild(int n) — eWidget
void notifyShowHide() — eWidget
void setBackgroundGradient(const gRGB &startcolor, const gRGB &midcolor, const gRGB &endcolor, uint8_t direction, bool alphablend) — eWindow
void setCornerRadius(int radius, uint8_t edges) — eWindow
uint8_t getCornerRadiusEdges() — eWidget
int getCornerRadius() — eWidget
bool isGradientSet() — eWidget
void setAlign(uint8_t a) — eWidget
uint8_t align() const — eWidget
void setStack(eWidget* stack) — eWidget
virtual std::string getClassName() const — eWidget
virtual std::string dumpObject() const — eWidget
void setTitle(const std::string &string) — eWindow
std::string getTitle() const — eWindow
void setFlag(int flags) — eWindow
void clearFlag(int flags) — eWindow
void setAnimationMode(int mode) — eWindow

Attributes that look similar but behave differently

Attribute	Distinction
`borderColor`, `borderWidth`	On `eLabel` and its subclasses these address the text outline. On other classes they use that class’s border implementation.
`widgetBorderColor`, `widgetBorderWidth`	Explicit widget border, including on a label.
`alphaTest`	Pixmap/text raster handling where supported; not the same as widget `alphaBlend`.
`transparent`	Controls widget background behaviour. It does not turn an opaque image file into an image with alpha.
`text`	Sets initial label content; a renderer can replace it from `source.text`.
`font`	Label or supported list font. A Canvas drawing command supplies its own font rather than using a native `font` XML attribute.
`position`, `size`	Geometry of this widget, not the row indexes or geometry inside a MultiContent template.

For visual comparisons, use the captured text examples, colour/layer examples, image examples and InfoBar progress examples. The tables describe API support; the examples show how selected values actually render.

Attributes per native widget

Find the widget behind the XML

How to read the tables

Widget catalogue

`eButton`

`eCanvas`

`eGauge`

`eInput`

`eLabel`

`eListbox`

`ePixmap`

`ePositionGauge`

`eQRCode`

`eRectangle`

`eSlider`

`eStack`

`eSubtitleWidget`

`eVideoWidget`

`eWidget`

`eWindow`

Attributes that look similar but behave differently