Window （窗口）(lv_win)

Overview（概述）

显示原文

The Window is container-like Widget built from a header with title and buttons and a content area.

Window（窗口）是一个类似容器的对象，由带有标头、按钮和内容区域构建而成。

Parts and Styles（部分和样式）

显示原文

The Window is built from other widgets so you can check their documentation for details:

Background: Base Widget
Header on the background: Base Widget
Title on the header: Label （标签）(lv_label)
Buttons on the header: Button（按钮） (lv_button)
Content area on the background: Base Widget

窗口控件是由其他控件构建的，因此可以查看它们的文档以获取详细信息：

背景：Base Widget
背景标头：Base Widget
标头上的标题：Label （标签）(lv_label)
标头上的按钮： Button（按钮） (lv_button)
背景内容区：Base Widget

Usage（用法）

Create a Window（创建一个窗口）

显示原文

lv_win_create(parent, header_height) creates a Window with an empty header.

lv_win_create(parent, header_height) 创建一个标头为空的窗口。

Title and buttons（标头和按钮）

显示原文

Any number of texts (but typically only one) can be added to the header with lv_win_add_title(win, "The title").

Control buttons can be added to the window's header with lv_win_add_button(win, icon, button_width). icon can be any image source, and button_width is the width of the button.

The title and the buttons will be added in the order the functions are called. So adding a button, a text and two other buttons will result in a button on the left, a title, and 2 buttons on the right. The width of the title is set to take all the remaining space on the header. In other words: it pushes to the right all the buttons that are added after the title.

可以使用 lv_win_add_title(win, "The title") 将任意数量的文本（但通常只有一个）添加到标头中。

可以使用 lv_win_add_button(win, icon, button_width) 将控制按钮添加到窗口的标头。 icon 可以是任何图像源， button_width 是按钮的宽度。

标头和按钮将按照调用函数的顺序添加。因此，添加一个按钮、一个文本和另外两个按钮将在左侧产生一个按钮，在右侧产生一个标头和两个按钮。标头的宽度设置为占据标头上的所有剩余空间。换句话说：它将标头后添加的所有按钮推到右侧。

Get 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.

lv_win_get_header(win) 返回一个指向标头的指针， lv_win_get_content(win) 返回一个指向可以在窗口添加内容的容器指针。