# lv_msgbox.h (/api/widgets/msgbox/lv_msgbox_h) Functions [#functions] lv_msgbox_get_header [#lv_msgbox_get_header] Get the header widget ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_get_header(lv_obj_t *obj) ``` Parameters | Name | Type | Description | | ----- | ------------------------------------------------ | ------------------------ | | `obj` | | pointer to a message box | **Returns:** — the header, or NULL if not exists lv_msgbox_get_footer [#lv_msgbox_get_footer] Get the footer widget ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_get_footer(lv_obj_t *obj) ``` Parameters | Name | Type | Description | | ----- | ------------------------------------------------ | ------------------------ | | `obj` | | pointer to a message box | **Returns:** — the footer, or NULL if not exists lv_msgbox_get_content [#lv_msgbox_get_content] Get the content widget ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_get_content(lv_obj_t *obj) ``` Parameters | Name | Type | Description | | ----- | ------------------------------------------------ | ------------------------ | | `obj` | | pointer to a message box | **Returns:** — the content lv_msgbox_get_title [#lv_msgbox_get_title] Get the title label ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_get_title(lv_obj_t *obj) ``` Parameters | Name | Type | Description | | ----- | ------------------------------------------------ | ------------------------ | | `obj` | | pointer to a message box | **Returns:** — the title, or NULL if it does not exist lv_msgbox_create [#lv_msgbox_create] Create an empty message box ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_create(lv_obj_t *parent) ``` Parameters | Name | Type | Description | | -------- | ------------------------------------------------ | ------------------------------------------- | | `parent` | | the parent or NULL to create a modal msgbox | **Returns:** — the created message box lv_msgbox_add_title [#lv_msgbox_add_title] Add title to the message box. It also creates a header for the title. ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_add_title(lv_obj_t *obj, const char *title) ``` Parameters | Name | Type | Description | | ------- | ------------------------------------------------ | ------------------------ | | `obj` | | pointer to a message box | | `title` | `const char *` | the text of the tile | **Returns:** — the created title label lv_msgbox_add_header_button [#lv_msgbox_add_header_button] Add a button to the header of to the message box. It also creates a header. ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_add_header_button(lv_obj_t *obj, const void *icon) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------ | ------------------------ | | `obj` | | pointer to a message box | | `icon` | `const void *` | the icon of the button | **Returns:** — the created button lv_msgbox_add_text [#lv_msgbox_add_text] Add a text to the content area of message box. Multiple texts will be created below each other. ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_add_text(lv_obj_t *obj, const char *text) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------ | ------------------------ | | `obj` | | pointer to a message box | | `text` | `const char *` | text to add | **Returns:** — the created label lv_msgbox_add_text_fmt [#lv_msgbox_add_text_fmt] Add a formatted text to the content area of message box. Multiple texts will be created below each other. ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_add_text_fmt(lv_obj_t *obj, const char *fmt,...) ``` Parameters | Name | Type | Description | | ----- | ------------------------------------------------ | --------------------------- | | `obj` | | pointer to a message box | | `fmt` | `const char *` | `printf`-like format string | | `...` | | | **Returns:** — the created label lv_msgbox_add_footer_button [#lv_msgbox_add_footer_button] Add a button to the footer of to the message box. It also creates a footer. ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_add_footer_button(lv_obj_t *obj, const char *text) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------ | ------------------------ | | `obj` | | pointer to a message box | | `text` | `const char *` | the text of the button | **Returns:** — the created button lv_msgbox_add_close_button [#lv_msgbox_add_close_button] Add a close button to the message box. It also creates a header. ```c title=" " lineNumbers=1 lv_obj_t * lv_msgbox_add_close_button(lv_obj_t *obj) ``` Parameters | Name | Type | Description | | ----- | ------------------------------------------------ | ------------------------ | | `obj` | | pointer to a message box | **Returns:** — the created close button lv_msgbox_close [#lv_msgbox_close] Close a message box ```c title=" " lineNumbers=1 void lv_msgbox_close(lv_obj_t *mbox) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------ | ------------------------ | | `mbox` | | pointer to a message box | lv_msgbox_close_async [#lv_msgbox_close_async] Close a message box in the next call of the message box ```c title=" " lineNumbers=1 void lv_msgbox_close_async(lv_obj_t *mbox) ``` Parameters | Name | Type | Description | | ------ | ------------------------------------------------ | ------------------------ | | `mbox` | | pointer to a message box | Variables [#variables] lv_msgbox_class [#lv_msgbox_class] ```c title=" " lineNumbers=1 const lv_obj_class_t lv_msgbox_class ``` lv_msgbox_header_class [#lv_msgbox_header_class] ```c title=" " lineNumbers=1 const lv_obj_class_t lv_msgbox_header_class ``` lv_msgbox_content_class [#lv_msgbox_content_class] ```c title=" " lineNumbers=1 const lv_obj_class_t lv_msgbox_content_class ``` lv_msgbox_footer_class [#lv_msgbox_footer_class] ```c title=" " lineNumbers=1 const lv_obj_class_t lv_msgbox_footer_class ``` lv_msgbox_header_button_class [#lv_msgbox_header_button_class] ```c title=" " lineNumbers=1 const lv_obj_class_t lv_msgbox_header_button_class ``` lv_msgbox_footer_button_class [#lv_msgbox_footer_button_class] ```c title=" " lineNumbers=1 const lv_obj_class_t lv_msgbox_footer_button_class ``` lv_msgbox_backdrop_class [#lv_msgbox_backdrop_class] ```c title=" " lineNumbers=1 const lv_obj_class_t lv_msgbox_backdrop_class ``` Dependencies [#dependencies]