窗口 (Window)
::: hljs-center
:::
## 示例代码
```lua
win = lvgl.win_create(lvgl.scr_act(), nil)
lvgl.win_set_title(win, "Window title")
-- close_btn = lvgl.win_add_btn_right(win, "\xef\x80\x8d")
-- --lvgl.obj_set_event_cb(close_btn, lvgl.win_close_event_cb)
-- lvgl.win_add_btn_right(win, "\xef\x80\x93")
txt = lvgl.label_create(win, nil)
lvgl.label_set_text(txt, "This is the content of the window\n\n")
lvgl.win_set_drag(win, true)
```
## 创建函数
## API
|
### lvgl.win_create
|调用|lvgl.win_create(par, copy)|
|-|-|
|功能|创建一个窗口对象|
|返回|指向创建的窗口的指针|
|参数||
|par|指向对象的指针, 它将是新键对象的父对象|
|copy|指向窗口对象的指针, 如果不为 nil, 则将从其复制新对象|
### lvgl.win_clean
|调用|lvgl.win_clean(win)|
|-|-|
|功能|清除窗口内所有子控件|
|参数||
|win|指向窗口对象的指针|
### lvgl.win_add_btn_right
|调用|lvgl.win_add_btn_right(win, path)|
|-|-|
|功能|在窗口右侧标题栏添加一个按钮|
|参数||
|win|指向窗口对象的指针|
|path|图片的资源路径|
### lvgl.win_add_btn_left
|调用|lvgl.win_add_btn_left(win, path)|
|-|-|
|功能|在窗口左侧标题栏添加一个按钮|
|参数||
|win|指向窗口对象的指针|
|path|图片的资源路径|
### lvgl.win_close_event_cb
|调用|lvgl.win_close_event_cb(win, event)|
|-|-|
|功能|窗口关闭回调函数|
|参数||
|win|指向窗口对象的指针|
|event|事件类型|
### lvgl.win_set_title
|调用|lvgl.win_set_title(win, txt)|
|-|-|
|功能|设置窗口文字|
|参数||
|win|指向窗口对象的指针|
|txt|需要设置的窗口文字|
### lvgl.win_set_header_height
|调用|lvgl.win_set_header_height(win, h)|
|-|-|
|功能|设置窗口标题栏高度|
|参数||
|win|指向窗口对象的指针|
|h|窗口标题栏高度|
### lvgl.win_set_btn_width
|调用|lvgl.win_set_btn_width(win, w)|
|-|-|
|功能|设置窗口按钮宽度|
|参数||
|win|指向窗口对象的指针|
|w|窗口按钮宽度|
### lvgl.win_set_content_size
|调用|lvgl.win_set_content_size(win, w, h)|
|-|-|
|功能|设置内容尺寸|
|参数||
|win|指向窗口对象的指针|
|w|内容宽度|
|h|内容高度|
### lvgl.win_set_layout
|调用|lvgl.win_set_layout(win, layout)|
|-|-|
|功能|设置窗口布局|
|参数||
|win|指向窗口对象的指针|
|layout|窗口布局，参数是容器布局类型|
### lvgl.win_set_scrollbar_mode
|调用|lvgl.win_set_scrollbar_mode(win, mode)|
|-|-|
|功能|设置窗口滚动条模式|
|参数||
|win|指向窗口对象的指针|
|mode|滚动条模式|
### lvgl.win_set_anim_time
|调用|lvgl.win_set_anim_time(win, time)|
|-|-|
|功能|设置动画时间|
|参数||
|win|指向窗口对象的指针|
|time|窗口的动画时间|
### lvgl.win_get_drag
|调用|lvgl.win_get_drag(win, en)|
|-|-|
|功能|设置窗口是否可以拖动|
|参数||
|win|指向窗口对象的指针|
|en|true 可以拖动，false 不可以拖动|
### lvgl.win_focus
|调用|lvgl.win_focus(win, obj, anim)|
|-|-|
|功能|设置窗口焦点对象|
|参数||
|win|指向窗口对象的指针|
|obj|窗口的焦点对象|
|anim|lvgl.ANIM_ON 启用动画。lvgl.ANIM_OFF 不启用动画|
### lvgl.win_scroll_hor
|调用|lvgl.win_scroll_hor(win, hor)|
|-|-|
|功能|设置窗口水平滚动|
|参数||
|win|指向窗口对象的指针|
|hor|窗口水平滚动数值|
### lvgl.win_scroll_ver
|调用|lvgl.win_scroll_ver(win, ver)|
|-|-|
|功能|设置窗口垂直滚动|
|参数||
|win|指向窗口对象的指针|
|hor|窗口垂直滚动数值|
|
[参考链接(C语言)](https://docs.lvgl.io/7.11/widgets/win.html)