Window (lv_win)

A header (like a title bar) with a title and buttons, plus a content area below.

Overview

The Window widget is built from a header (like a title bar) with a title and optional buttons, plus a content area below.

Create a Window

lv_win_create(parent) creates a Window that is initially composed of the following Widget structure:

• Background (a base widget, the main window container), is set up to be a Flex-Flow container that flows its contained Widgets vertically (LV_FLEX_FLOW_COLUMN).
• Header (like a title bar) is initially empty, and is a Flex-Flow container set up to flow its contained Widgets horizontally (LV_FLEX_FLOW_ROW), left to right. The Header occupies the full width of the Background (its parent) and the top approximately 1/2 inch (according to LV_DPI_DEF).
• Content Area (a base widget) occupies the full width of the Background (its parent) the remainder of the available Background area below the Header. It is not itself a Flex-Flow container, but you can make it so if you wish. See Flex for details.

Title and buttons

Add buttons and labels to the header with the two helpers below. Items are placed left to right in the order they are added; either function can be called any number of times.

• lv_win_add_title(win, "The title") adds a label to the header. Its long mode is LV_LABEL_LONG_MODE_DOTS (text that is too wide ends with ...) and its flex_grow is 1, so it takes the remaining space and pushes any later buttons to the right end. If you add more than one title, the labels share the free space equally — change flex_grow to weight them differently. See Flex for details.
• lv_win_add_button(win, icon, button_width) adds a button of the given width that fills the header height. If icon is not NULL, it is used as an image centered on the button — any valid image source works, e.g. LV_SYMBOL_CLOSE for an x. The returned pointer lets you attach event callbacks.

Getting the parts

lv_win_get_header(win) returns a pointer to the header, lv_win_get_content(win) returns a pointer to the content container to which the content of the window can be added.