### Maintenance page
* Add add tab color for mobile view
* Add spellcheck off / autocorect off in input
* Add disconnect button when authenticate enabled
* Add Invalid user or password message when authentication failed
### Board support
* Add ESP32 S2 support
* Add ESP32 S3 support
* Add ESP32 C3 support
### ESP commands
* Add command 701 to control GCODE streaming
* Remove command 901 as duplicate
* Update command 420 to add more details
* Use text as default output
* All json on all commands for formated output
### Core
* Add benchmak function to check transfer speed (for test only-not production)
* Merge code for ESP3DLib support
* Add better printer display support (M117 / Serial TFT)
* Use ESP32 analogWrite instead of emulated one
### Modules
* Display
* Refactor code
* Remove SPI ILI 9341 / 9488 support as not suitable
* Add ST7789 support (135x240 / 240x240)
* Filesystem
* Bug fixes due to esp core updates
* Better SD sharing mecanism
* Better global FS management
* FTP
* Add SD sharing support
* Better global FS management
* GCODE Host
* Add basic support for macro files
* Add ESP command support
* Use not blocking method to stream commands / handle response
* Notifications
* Add IFTTT notification service
* Add WebUI notification
* Add ESP3D display notification
* WebDav
* Add SD sharing support
* Add bug fix from https://github.com/d-a-v/ESPWebDAV
* Better global FS management
* Websocket
* Add function to handle zombies connections
* WiFi
* Fix connection to AP sometime fail
* Fix low signal not diplayed in ESP420 even connected
* Add AP Setup mode
### Libraries
* Update SDFat-2.0.6 to 2.1.2
* Update ESP32SSDP 1.1.1 to 1.2.0
* Update TFT_eSPI-1.4.11 to 2.4.61
* Update arduinoWebSockets-2.3.5 to 2.3.6
* Update esp8266-oled-ssd1306-4.0.0 to 4.3.0
* Remove lvgl support
### Tools
* Add I2C scanner script
* Add python script to simulate/stress printer serial communication
### PlatformIO
* Use latest 4.4.0 Espressif32 release (ESP32-arduino core 2.0.3)
* Add fix for Flash more than 4MB
* Add Esp32 S2/S3/C3 env
* Add ESP32-ST7789 / esp32-TTGO_T_Display env
2.4 KiB
.. include:: /header.rst
:github_url: |github_link_base|/widgets/extra/msgbox.md
Message box (lv_msgbox)
Overview
The Message boxes act as pop-ups. They are built from a background container, a title, an optional close button, a text and optional buttons.
The text will be broken into multiple lines automatically and the height will be set automatically to include the text and the buttons.
The message box can be modal (blocking clicks on the rest of the screen) or not modal.
Parts and Styles
The message box is built from other widgets, so you can check these widgets' documentation for details.
- Background: lv_obj
- Close button: lv_btn
- Title and text: lv_label
- Buttons: lv_btnmatrix
Usage
Create a message box
lv_msgbox_create(parent, title, txt, btn_txts[], add_close_btn) creates a message box.
If parent is NULL the message box will be modal. title and txt are strings for the title and the text.
btn_txts[] is an array with the buttons' text. E.g. const char * btn_txts[] = {"Ok", "Cancel", NULL}.
add_colse_btn can be true or false to add/don't add a close button.
Get the parts
The building blocks of the message box can be obtained using the following functions:
lv_obj_t * lv_msgbox_get_title(lv_obj_t * mbox);
lv_obj_t * lv_msgbox_get_close_btn(lv_obj_t * mbox);
lv_obj_t * lv_msgbox_get_text(lv_obj_t * mbox);
lv_obj_t * lv_msgbox_get_btns(lv_obj_t * mbox);
Close the message box
lv_msgbox_close(msgbox) closes (deletes) the message box.
Events
LV_EVENT_VALUE_CHANGEDis sent by the buttons if one of them is clicked.LV_OBJ_FLAG_EVENT_BUBBLEis enabled on the buttons so you can add events to the message box itself. In the event handler,lv_event_get_target(e)will return the button matrix andlv_event_get_current_target(e)will return the message box.lv_msgbox_get_active_btn(msgbox)andlv_msgbox_get_active_btn_text(msgbox)can be used to get the index and text of the clicked button.
Learn more about Events.
Keys
Keys have effect on the close button and button matrix. You can add them manually to a group if required.
Learn more about Keys.
Example
.. include:: ../../../examples/widgets/msgbox/index.rst
API
.. doxygenfile:: lv_msgbox.h
:project: lvgl