Style properties（样式属性）

Size and position（大小和位置）

Properties related to size, position, alignment and layout of the objects.

width（宽度）

Sets the width of object. Pixel, percentage and LV_SIZE_CONTENT values can be used. Percentage values are relative to the width of the parent's content area.

Default Widget dependent
Inherited No
Layout Yes
Ext. draw No

min_width（最小宽度）

Sets a minimal width. Pixel and percentage values can be used. Percentage values are relative to the width of the parent's content area.

Default 0
Inherited No
Layout Yes
Ext. draw No

max_width（最大宽度）

Sets a maximal width. Pixel and percentage values can be used. Percentage values are relative to the width of the parent's content area.

Default LV_COORD_MAX
Inherited No
Layout Yes
Ext. draw No

height（高度）

Sets the height of object. Pixel, percentage and LV_SIZE_CONTENT can be used. Percentage values are relative to the height of the parent's content area.

Default Widget dependent
Inherited No
Layout Yes
Ext. draw No

min_height（最低高度）

Sets a minimal height. Pixel and percentage values can be used. Percentage values are relative to the width of the parent's content area.

Default 0
Inherited No
Layout Yes
Ext. draw No

max_height（最大高度）

Sets a maximal height. Pixel and percentage values can be used. Percentage values are relative to the height of the parent's content area.

Default LV_COORD_MAX
Inherited No
Layout Yes
Ext. draw No

length（长度）

Its meaning depends on the type of the widget. For example in case of lv_scale it means the length of the ticks.

Default 0
Inherited No
Layout No
Ext. draw Yes

x

Set the X coordinate of the object considering the set align. Pixel and percentage values can be used. Percentage values are relative to the width of the parent's content area.

Default 0
Inherited No
Layout Yes
Ext. draw No

y

Set the Y coordinate of the object considering the set align. Pixel and percentage values can be used. Percentage values are relative to the height of the parent's content area.

Default 0
Inherited No
Layout Yes
Ext. draw No

align（排列）

Set the alignment which tells from which point of the parent the X and Y coordinates should be interpreted. The possible values are: LV_ALIGN_DEFAULT, LV_ALIGN_TOP_LEFT/MID/RIGHT, LV_ALIGN_BOTTOM_LEFT/MID/RIGHT, LV_ALIGN_LEFT/RIGHT_MID, LV_ALIGN_CENTER. LV_ALIGN_DEFAULT means LV_ALIGN_TOP_LEFT with LTR base direction and LV_ALIGN_TOP_RIGHT with RTL base direction.

Default `LV_ALIGN_DEFAULT`
Inherited No
Layout Yes
Ext. draw No

transform_width（改变宽度）

Make the object wider on both sides with this value. Pixel and percentage (with lv_pct(x)) values can be used. Percentage values are relative to the object's width.

Default 0
Inherited No
Layout No
Ext. draw Yes

transform_height（改变高度）

Make the object higher on both sides with this value. Pixel and percentage (with lv_pct(x)) values can be used. Percentage values are relative to the object's height.

Default 0
Inherited No
Layout No
Ext. draw Yes

translate_x（改变x）

Move the object with this value in X direction. Applied after layouts, aligns and other positioning. Pixel and percentage (with lv_pct(x)) values can be used. Percentage values are relative to the object's width.

Default 0
Inherited No
Layout Yes
Ext. draw No

translate_y（改变y）

Move the object with this value in Y direction. Applied after layouts, aligns and other positioning. Pixel and percentage (with lv_pct(x)) values can be used. Percentage values are relative to the object's height.

Default 0
Inherited No
Layout Yes
Ext. draw No

transform_scale_x（改变x比例）

Zoom an objects horizontally. The value 256 (or LV_SCALE_NONE) means normal size, 128 half size, 512 double size, and so on

Default 0
Inherited No
Layout Yes
Ext. draw Yes

transform_scale_y（改变y比例）

Zoom an objects vertically. The value 256 (or LV_SCALE_NONE) means normal size, 128 half size, 512 double size, and so on

Default 0
Inherited No
Layout Yes
Ext. draw Yes

transform_rotation（改变旋转）

Rotate an objects. The value is interpreted in 0.1 degree units. E.g. 450 means 45 deg.

Default 0
Inherited No
Layout Yes
Ext. draw Yes

transform_pivot_x（改变x中心点）

Set the pivot point's X coordinate for transformations. Relative to the object's top left corner'

Default 0
Inherited No
Layout No
Ext. draw No

transform_pivot_y（改变y中心点）

Set the pivot point's Y coordinate for transformations. Relative to the object's top left corner'

Default 0
Inherited No
Layout No
Ext. draw No

transform_skew_x

Skew an object horizontally. The value is interpreted in 0.1 degree units. E.g. 450 means 45 deg.

Default 0
Inherited No
Layout Yes
Ext. draw Yes

transform_skew_y

Skew an object vertically. The value is interpreted in 0.1 degree units. E.g. 450 means 45 deg.

Default 0
Inherited No
Layout Yes
Ext. draw Yes

Padding

Properties to describe spacing between the parent's sides and the children and among the children. Very similar to the padding properties in HTML.

pad_top

Sets the padding on the top. It makes the content area smaller in this direction.

Default 0
Inherited No
Layout Yes
Ext. draw No

pad_bottom

Sets the padding on the bottom. It makes the content area smaller in this direction.

Default 0
Inherited No
Layout Yes
Ext. draw No

pad_left

Sets the padding on the left. It makes the content area smaller in this direction.

Default 0
Inherited No
Layout Yes
Ext. draw No

pad_right

Sets the padding on the right. It makes the content area smaller in this direction.

Default 0
Inherited No
Layout Yes
Ext. draw No

pad_row

Sets the padding between the rows. Used by the layouts.

Default 0
Inherited No
Layout Yes
Ext. draw No

pad_column

Sets the padding between the columns. Used by the layouts.

Default 0
Inherited No
Layout Yes
Ext. draw No

Margin

Properties to describe spacing around an object. Very similar to the margin properties in HTML.

margin_top

Sets the margin on the top. The object will keep this space from its siblings in layouts.

Default 0
Inherited No
Layout Yes
Ext. draw No

margin_bottom

Sets the margin on the bottom. The object will keep this space from its siblings in layouts.

Default 0
Inherited No
Layout Yes
Ext. draw No

margin_left

Sets the margin on the left. The object will keep this space from its siblings in layouts.

Default 0
Inherited No
Layout Yes
Ext. draw No

margin_right

Sets the margin on the right. The object will keep this space from its siblings in layouts.

Default 0
Inherited No
Layout Yes
Ext. draw No

Background

Properties to describe the background color and image of the objects.

bg_color

Set the background color of the object.

Default `0xffffff`
Inherited No
Layout No
Ext. draw No

bg_opa

Set the opacity of the background. Value 0, LV_OPA_0 or LV_OPA_TRANSP means fully transparent, 255, LV_OPA_100 or LV_OPA_COVER means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.

Default `LV_OPA_TRANSP`
Inherited No
Layout No
Ext. draw No

bg_grad_color

Set the gradient color of the background. Used only if grad_dir is not LV_GRAD_DIR_NONE

Default `0x000000`
Inherited No
Layout No
Ext. draw No

bg_grad_dir

Set the direction of the gradient of the background. The possible values are LV_GRAD_DIR_NONE/HOR/VER.

Default `LV_GRAD_DIR_NONE`
Inherited No
Layout No
Ext. draw No

bg_main_stop

Set the point from which the background color should start for gradients. 0 means to top/left side, 255 the bottom/right side, 128 the center, and so on

Default 0
Inherited No
Layout No
Ext. draw No

bg_grad_stop

Set the point from which the background's gradient color should start. 0 means to top/left side, 255 the bottom/right side, 128 the center, and so on

Default 255
Inherited No
Layout No
Ext. draw No

bg_main_opa

Set the opacity of the first gradient color

Default 255
Inherited No
Layout No
Ext. draw No

bg_grad_opa

Set the opacity of the second gradient color

Default 255
Inherited No
Layout No
Ext. draw No

bg_grad

Set the gradient definition. The pointed instance must exist while the object is alive. NULL to disable. It wraps BG_GRAD_COLOR, BG_GRAD_DIR, BG_MAIN_STOP and BG_GRAD_STOP into one descriptor and allows creating gradients with more colors too. If it's set other gradient related properties will be ignored'

Default `NULL`
Inherited No
Layout No
Ext. draw No

bg_image_src

Set a background image. Can be a pointer to lv_image_dsc_t, a path to a file or an LV_SYMBOL_...

Default `NULL`
Inherited No
Layout No
Ext. draw Yes

bg_image_opa

Set the opacity of the background image. Value 0, LV_OPA_0 or LV_OPA_TRANSP means fully transparent, 255, LV_OPA_100 or LV_OPA_COVER means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.

Default `LV_OPA_COVER`
Inherited No
Layout No
Ext. draw No

bg_image_recolor

Set a color to mix to the background image.

Default `0x000000`
Inherited No
Layout No
Ext. draw No

bg_image_recolor_opa

Set the intensity of background image recoloring. Value 0, LV_OPA_0 or LV_OPA_TRANSP means no mixing, 255, LV_OPA_100 or LV_OPA_COVER means full recoloring, other values or LV_OPA_10, LV_OPA_20, etc are interpreted proportionally.

Default `LV_OPA_TRANSP`
Inherited No
Layout No
Ext. draw No

bg_image_tiled

If enabled the background image will be tiled. The possible values are true or false.

Default 0
Inherited No
Layout No
Ext. draw No

Border

Properties to describe the borders

border_color

Set the color of the border

Default `0x000000`
Inherited No
Layout No
Ext. draw No

border_opa

Set the opacity of the border. Value 0, LV_OPA_0 or LV_OPA_TRANSP means fully transparent, 255, LV_OPA_100 or LV_OPA_COVER means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.

Default `LV_OPA_COVER`
Inherited No
Layout No
Ext. draw No

border_width

Set the width of the border. Only pixel values can be used.

Default 0
Inherited No
Layout Yes
Ext. draw No

border_side

Set only which side(s) the border should be drawn. The possible values are LV_BORDER_SIDE_NONE/TOP/BOTTOM/LEFT/RIGHT/INTERNAL. OR-ed values can be used as well, e.g. LV_BORDER_SIDE_TOP | LV_BORDER_SIDE_LEFT.

Default `LV_BORDER_SIDE_NONE`
Inherited No
Layout No
Ext. draw No

border_post

Sets whether the border should be drawn before or after the children are drawn. true: after children, false: before children

Default 0
Inherited No
Layout No
Ext. draw No

Outline

Properties to describe the outline. It's like a border but drawn outside of the rectangles.

outline_width

Set the width of the outline in pixels.

Default 0
Inherited No
Layout No
Ext. draw Yes

outline_color

Set the color of the outline.

Default `0x000000`
Inherited No
Layout No
Ext. draw No

outline_opa

Set the opacity of the outline. Value 0, LV_OPA_0 or LV_OPA_TRANSP means fully transparent, 255, LV_OPA_100 or LV_OPA_COVER means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.

Default `LV_OPA_COVER`
Inherited No
Layout No
Ext. draw Yes

outline_pad

Set the padding of the outline, i.e. the gap between object and the outline.

Default 0
Inherited No
Layout No
Ext. draw Yes

Shadow

Properties to describe the shadow drawn under the rectangles.

shadow_width

Set the width of the shadow in pixels. The value should be >= 0.

Default 0
Inherited No
Layout No
Ext. draw Yes

shadow_offset_x

Set an offset on the shadow in pixels in X direction.

Default 0
Inherited No
Layout No
Ext. draw Yes

shadow_offset_y

Set an offset on the shadow in pixels in Y direction.

Default 0
Inherited No
Layout No
Ext. draw Yes

shadow_spread

Make the shadow calculation to use a larger or smaller rectangle as base. The value can be in pixel to make the area larger/smaller

Default 0
Inherited No
Layout No
Ext. draw Yes

shadow_color

Set the color of the shadow

Default `0x000000`
Inherited No
Layout No
Ext. draw No

shadow_opa

Set the opacity of the shadow. Value 0, LV_OPA_0 or LV_OPA_TRANSP means fully transparent, 255, LV_OPA_100 or LV_OPA_COVER means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.

Default `LV_OPA_COVER`
Inherited No
Layout No
Ext. draw Yes

Image

Properties to describe the images

image_opa

Set the opacity of an image. Value 0, LV_OPA_0 or LV_OPA_TRANSP means fully transparent, 255, LV_OPA_100 or LV_OPA_COVER means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.

Default `LV_OPA_COVER`
Inherited No
Layout No
Ext. draw No

image_recolor

Set color to mixt to the image.

Default `0x000000`
Inherited No
Layout No
Ext. draw No

image_recolor_opa

Set the intensity of the color mixing. Value 0, LV_OPA_0 or LV_OPA_TRANSP means fully transparent, 255, LV_OPA_100 or LV_OPA_COVER means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.

Default 0
Inherited No
Layout No
Ext. draw No

Line

Properties to describe line-like objects

line_width

Set the width of the lines in pixel.

Default 0
Inherited No
Layout No
Ext. draw Yes

line_dash_width

Set the width of dashes in pixel. Note that dash works only on horizontal and vertical lines

Default 0
Inherited No
Layout No
Ext. draw No

line_dash_gap

Set the gap between dashes in pixel. Note that dash works only on horizontal and vertical lines

Default 0
Inherited No
Layout No
Ext. draw No

line_rounded

Make the end points of the lines rounded. true: rounded, false: perpendicular line ending

Default 0
Inherited No
Layout No
Ext. draw No

line_color

Set the color of the lines.

Default `0x000000`
Inherited No
Layout No
Ext. draw No

line_opa

Set the opacity of the lines.

Default `LV_OPA_COVER`
Inherited No
Layout No
Ext. draw No

Arc

TODO

arc_width

Set the width (thickness) of the arcs in pixel.

Default 0
Inherited No
Layout No
Ext. draw Yes

arc_rounded

Make the end points of the arcs rounded. true: rounded, false: perpendicular line ending

Default 0
Inherited No
Layout No
Ext. draw No

arc_color

Set the color of the arc.

Default `0x000000`
Inherited No
Layout No
Ext. draw No

arc_opa

Set the opacity of the arcs.

Default `LV_OPA_COVER`
Inherited No
Layout No
Ext. draw No

arc_image_src

Set an image from which the arc will be masked out. It's useful to display complex effects on the arcs. Can be a pointer to lv_image_dsc_t or a path to a file

Default `NULL`
Inherited No
Layout No
Ext. draw No

Text

Properties to describe the properties of text. All these properties are inherited.

text_color

Sets the color of the text.

Default `0x000000`
Inherited Yes
Layout No
Ext. draw No

text_opa

Set the opacity of the text. Value 0, LV_OPA_0 or LV_OPA_TRANSP means fully transparent, 255, LV_OPA_100 or LV_OPA_COVER means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.

Default `LV_OPA_COVER`
Inherited Yes
Layout No
Ext. draw No

text_font

Set the font of the text (a pointer lv_font_t *).

Default `LV_FONT_DEFAULT`
Inherited Yes
Layout Yes
Ext. draw No

text_letter_space

Set the letter space in pixels

Default 0
Inherited Yes
Layout Yes
Ext. draw No

text_line_space

Set the line space in pixels.

Default 0
Inherited Yes
Layout Yes
Ext. draw No

text_decor

Set decoration for the text. The possible values are LV_TEXT_DECOR_NONE/UNDERLINE/STRIKETHROUGH. OR-ed values can be used as well.

Default `LV_TEXT_DECOR_NONE`
Inherited Yes
Layout No
Ext. draw No

text_align

Set how to align the lines of the text. Note that it doesn't align the object itself, only the lines inside the object. The possible values are LV_TEXT_ALIGN_LEFT/CENTER/RIGHT/AUTO. LV_TEXT_ALIGN_AUTO detect the text base direction and uses left or right alignment accordingly

Default `LV_TEXT_ALIGN_AUTO`
Inherited Yes
Layout Yes
Ext. draw No

Miscellaneous

Mixed properties for various purposes.

radius

Set the radius on every corner. The value is interpreted in pixel (>= 0) or LV_RADIUS_CIRCLE for max. radius

Default 0
Inherited No
Layout No
Ext. draw No

clip_corner

Enable to clip the overflowed content on the rounded corner. Can be true or false.

Default 0
Inherited No
Layout No
Ext. draw No

opa

Scale down all opacity values of the object by this factor. Value 0, LV_OPA_0 or LV_OPA_TRANSP means fully transparent, 255, LV_OPA_100 or LV_OPA_COVER means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.

Default `LV_OPA_COVER`
Inherited Yes
Layout No
Ext. draw No

opa_layered

First draw the object on the layer, then scale down layer opacity factor. Value 0, LV_OPA_0 or LV_OPA_TRANSP means fully transparent, 255, LV_OPA_100 or LV_OPA_COVER means fully covering, other values or LV_OPA_10, LV_OPA_20, etc means semi transparency.

Default `LV_OPA_COVER`
Inherited Yes
Layout No
Ext. draw No

color_filter_dsc

Mix a color to all colors of the object.

Default `NULL`
Inherited No
Layout No
Ext. draw No

color_filter_opa

The intensity of mixing of color filter.

Default `LV_OPA_TRANSP`
Inherited No
Layout No
Ext. draw No

anim

The animation template for the object's animation. Should be a pointer to lv_anim_t. The animation parameters are widget specific, e.g. animation time could be the E.g. blink time of the cursor on the text area or scroll time of a roller. See the widgets' documentation to learn more.

Default `NULL`
Inherited No
Layout No
Ext. draw No

anim_duration

The animation duration in milliseconds. Its meaning is widget specific. E.g. blink time of the cursor on the text area or scroll time of a roller. See the widgets' documentation to learn more.

Default 0
Inherited No
Layout No
Ext. draw No

transition

An initialized lv_style_transition_dsc_t to describe a transition.

Default `NULL`
Inherited No
Layout No
Ext. draw No

blend_mode

Describes how to blend the colors to the background. The possible values are LV_BLEND_MODE_NORMAL/ADDITIVE/SUBTRACTIVE/MULTIPLY

Default `LV_BLEND_MODE_NORMAL`
Inherited No
Layout No
Ext. draw No

layout

Set the layout if the object. The children will be repositioned and resized according to the policies set for the layout. For the possible values see the documentation of the layouts.

Default 0
Inherited No
Layout Yes
Ext. draw No

base_dir

Set the base direction of the object. The possible values are LV_BIDI_DIR_LTR/RTL/AUTO.

Default `LV_BASE_DIR_AUTO`
Inherited Yes
Layout Yes
Ext. draw No

bitmap_mask_src

If set a layer will be created for the widget and the layer will be masked with this A8 bitmap mask.

Default `NULL`
Inherited No
Layout No
Ext. draw No

rotary_sensitivity

Adjust the sensitivity for rotary encoders in 1/256 unit. It means, 128: slow down the rotary to half, 512: speeds up to double, 256: no change

Default `256`
Inherited Yes
Layout No
Ext. draw No

Flex

Flex layout properties.

flex_flow

Defines in which direct the flex layout should arrange the children

Default `LV_FLEX_FLOW_NONE`
Inherited No
Layout Yes
Ext. draw No

flex_main_place

Defines how to align the children in the direction of flex flow

Default `LV_FLEX_ALIGN_NONE`
Inherited No
Layout Yes
Ext. draw No

flex_cross_place

Defines how to align the children perpendicular to the direction of flex flow

Default `LV_FLEX_ALIGN_NONE`
Inherited No
Layout Yes
Ext. draw No

flex_track_place

Defines how to align the tracks of the flow

Default `LV_FLEX_ALIGN_NONE`
Inherited No
Layout Yes
Ext. draw No

flex_grow

Defines how mayn space to take proprtionally the free space of the object's trach

Default `LV_FLEX_ALIGN_ROW`
Inherited No
Layout Yes
Ext. draw No

Grid

Grid layout properties.

grid_column_dsc_array

An array to describe the columns of the grid. Should be LV_GRID_TEMPLATE_LAST terminated

Default `NULL`
Inherited No
Layout Yes
Ext. draw No

grid_column_align

Defines how to distribute the columns

Default `LV_GRID_ALIGN_START`
Inherited No
Layout Yes
Ext. draw No

grid_row_dsc_array

An array to describe the rows of the grid. Should be LV_GRID_TEMPLATE_LAST terminated

Default `NULL`
Inherited No
Layout Yes
Ext. draw No

grid_row_align

Defines how to distribute the rows.

Default `LV_GRID_ALIGN_START`
Inherited No
Layout Yes
Ext. draw No

grid_cell_column_pos

Set the column in which the object should be placed

Default `LV_GRID_ALIGN_START`
Inherited No
Layout Yes
Ext. draw No

grid_cell_x_align

Set how to align the object horizontally.

Default `LV_GRID_ALIGN_START`
Inherited No
Layout Yes
Ext. draw No

grid_cell_column_span

Set how many columns the object should span. Needs to be >= 1

Default `LV_GRID_ALIGN_START`
Inherited No
Layout Yes
Ext. draw No

grid_cell_row_pos

Set the row in which the object should be placed

Default `LV_GRID_ALIGN_START`
Inherited No
Layout Yes
Ext. draw No

grid_cell_y_align

Set how to align the object vertically.

Default `LV_GRID_ALIGN_START`
Inherited No
Layout Yes
Ext. draw No

grid_cell_row_span

Set how many rows the object should span. Needs to be >= 1

Default `LV_GRID_ALIGN_START`
Inherited No
Layout Yes
Ext. draw No