widget.messagebox
local messagebox = require "widget.messagebox"
BUTTONS_OK
(field) BUTTONS_OK: integer
BUTTONS_OK_CANCEL
(field) BUTTONS_OK_CANCEL: integer
BUTTONS_YES_NO
(field) BUTTONS_YES_NO: integer
BUTTONS_YES_NO_CANCEL
(field) BUTTONS_YES_NO_CANCEL: integer
ICON_ERROR
(field) ICON_ERROR: string
ICON_INFO
(field) ICON_INFO: string
ICON_WARNING
(field) ICON_WARNING: string
NEWLINE
(field) NEWLINE: integer
Indicates on a widget.styledtext that a new line follows.
__index
(field) __index: core.object
animations
(field) animations: widget.animation[]
background_color
(field) background_color: renderer.color
Array of bytes that represents a color used by the rendering functions.
border
(field) border: widget.border
Represents the border of a widget.
buttons
(field) buttons: widget.button[]
captured_widget
(field) captured_widget: widget
Widget that captured mouse events
child_active
(field) child_active: widget|nil
A base widget
childs
(field) childs: table<integer, widget>
clickable
(field) clickable: boolean
context
(field) context: 'application'|'session'
current_scale
(field) current_scale: number
cursor
(field) cursor: 'arrow'|'hand'|'ibeam'|'sizeh'|'sizev'
defer_draw
(field) defer_draw: boolean
draggable
(field) draggable: boolean
dragged
(field) dragged: boolean
explicit_update
(field) explicit_update: boolean
font
(field) font: string|renderer.font|widget.fontreference
Represents a reference to a font stored elsewhere.
force_events
(field) force_events: table
foreground_color
(field) foreground_color: renderer.color
Array of bytes that represents a color used by the rendering functions.
h_scrollbar
(field) h_scrollbar: widget.scrollbar
has_focus
(field) has_focus: boolean
hovered_scrollbar
(field) hovered_scrollbar: boolean
icon
(field) icon: widget.label
icon_huge_font
(field) icon_huge_font: renderer.font
input_text
(field) input_text: boolean
is_scrolling
(field) is_scrolling: boolean
label
(field) label: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>
message
(field) message: widget.label
mouse
(field) mouse: widget.position
Represents the position of a widget.
mouse_is_hovering
(field) mouse_is_hovering: boolean
mouse_is_pressed
(field) mouse_is_pressed: boolean
mouse_pressed_outside
(field) mouse_pressed_outside: boolean
name
(field) name: string
next_zindex
(field) next_zindex: integer
parent
(field) parent: widget|nil
A base widget
perform_update_size_position
(field) perform_update_size_position: boolean
position
(field) position: widget.position
Represents the position of a widget.
prev_height
(field) prev_height: number?
prev_size
(field) prev_size: widget.position
Represents the position of a widget.
prev_view
(field) prev_view: unknown
prev_width
(field) prev_width: number?
render_background
(field) render_background: boolean
scroll
(field) scroll: core.view.scroll
scrollable
(field) scrollable: boolean
set_focus
(field) set_focus: any
size
(field) size: widget.position
Modifying this property directly is not advised, use set_size() instead.
skip_scroll_ctrl
(field) skip_scroll_ctrl: boolean
By default is set to true to allow ctrl+wheel or cmd+wheel on mac to scale the interface, you can set it to false on your parent widget to allow manually intercepting ctrl+wheel.
super
(field) super: widget
A base widget
textview
(field) textview: widget
A base widget
title
(field) title: widget.label
tooltip
(field) tooltip: (string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>)?
tooltip_command
(field) tooltip_command: string?
type_name
(field) type_name: string
v_scrollbar
(field) v_scrollbar: widget.scrollbar
visible
(field) visible: boolean
zindex
(field) zindex: integer
alert
function widget.messagebox.alert(title: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, message: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, icon: `MessageBox.ICON_ERROR`|`MessageBox.ICON_INFO`|`MessageBox.ICON_WARNING`, icon_color?: renderer.color, on_close?: fun(self: widget.messagebox, button_id: integer, button: widget.button), buttons?: `MessageBox.BUTTONS_OK_CANCEL`|`MessageBox.BUTTONS_OK`|`MessageBox.BUTTONS_YES_NO_CANCEL`|`MessageBox.BUTTONS_YES_NO`)
Wrapper to easily show a message box.
icon:
-\> `MessageBox.ICON_ERROR`
| `MessageBox.ICON_INFO`
| `MessageBox.ICON_WARNING`
buttons:
-\> `MessageBox.BUTTONS_OK`
| `MessageBox.BUTTONS_OK_CANCEL`
| `MessageBox.BUTTONS_YES_NO`
| `MessageBox.BUTTONS_YES_NO_CANCEL`
error
function widget.messagebox.error(title: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, message: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, on_close?: fun(self: widget.messagebox, button_id: integer, button: widget.button), buttons?: `MessageBox.BUTTONS_OK_CANCEL`|`MessageBox.BUTTONS_OK`|`MessageBox.BUTTONS_YES_NO_CANCEL`|`MessageBox.BUTTONS_YES_NO`)
Wrapper to easily show an error message box.
buttons:
-\> `MessageBox.BUTTONS_OK`
| `MessageBox.BUTTONS_OK_CANCEL`
| `MessageBox.BUTTONS_YES_NO`
| `MessageBox.BUTTONS_YES_NO_CANCEL`
info
function widget.messagebox.info(title: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, message: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, on_close?: fun(self: widget.messagebox, button_id: integer, button: widget.button), buttons?: `MessageBox.BUTTONS_OK_CANCEL`|`MessageBox.BUTTONS_OK`|`MessageBox.BUTTONS_YES_NO_CANCEL`|`MessageBox.BUTTONS_YES_NO`)
Wrapper to easily show a info message box.
buttons:
-\> `MessageBox.BUTTONS_OK`
| `MessageBox.BUTTONS_OK_CANCEL`
| `MessageBox.BUTTONS_YES_NO`
| `MessageBox.BUTTONS_YES_NO_CANCEL`
override_rootview
function widget.override_rootview()
Called when initializing a floating widget to generate RootView overrides, this function will only override the events once.
warning
function widget.messagebox.warning(title: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, message: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, on_close?: fun(self: widget.messagebox, button_id: integer, button: widget.button), buttons?: `MessageBox.BUTTONS_OK_CANCEL`|`MessageBox.BUTTONS_OK`|`MessageBox.BUTTONS_YES_NO_CANCEL`|`MessageBox.BUTTONS_YES_NO`)
Wrapper to easily show a warning message box.
buttons:
-\> `MessageBox.BUTTONS_OK`
| `MessageBox.BUTTONS_OK_CANCEL`
| `MessageBox.BUTTONS_YES_NO`
| `MessageBox.BUTTONS_YES_NO_CANCEL`
__call
(method) core.object:__call(...any)
-> core.object
Metamethod to allow using the object call as a constructor.
__tostring
(method) widget:__tostring()
-> string
Useful for debugging.
activate
(method) widget:activate()
Emitted to input_text widgets when clicked.
add_button
(method) widget.messagebox:add_button(button_or_label: string|widget.button)
Adds a new button to the message box.
add_child
(method) widget:add_child(child: widget)
Add a child widget, automatically assign a zindex if non set and sorts them in reverse order for better events matching.
animate
(method) widget:animate(target?: table, properties: table<string, number>, options?: widget.animation.options)
Registers a new animation to be ran on the update cycle.
@param target
— If nil assumes properties belong to widget it self.
capture_mouse
(method) widget:capture_mouse(scrolling?: boolean)
All mouse events will be directly sent to the widget even if mouse moves outside the widget region.
@param scrolling
— Capture for scrolling
centered
(method) widget:centered()
Center the widget horizontally and vertically to the screen or parent widget.
clamp_scroll_position
(method) core.view:clamp_scroll_position()
deactivate
(method) widget:deactivate()
Emitted to input_text widgets on lost focus.
destroy
(method) widget:destroy()
If floating, remove the widget from the floating widgets list to allow proper garbage collection.
destroy_childs
(method) widget:destroy_childs()
Recursively destroy all childs from the widget.
drag
(method) widget:drag(x: number, y: number)
Used internally when dragging is activated.
draw
(method) widget.messagebox:draw()
-> boolean
We overwrite default draw function to draw the title background.
draw_background
(method) core.view:draw_background(color: renderer.color)
draw_border
(method) widget:draw_border(x?: number, y?: number, w?: number, h?: number)
Draw the widget configured border or custom one.
draw_scrollbar
(method) widget:draw_scrollbar()
draw_styled_text
(method) widget:draw_styled_text(text: table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, x: integer, y: integer, only_calc?: boolean, start_idx?: integer, end_idx?: integer)
-> width: integer
2. height: integer
Render or calculate the size of the specified range of elements in a styled text elemet.
draw_text_multiline
(method) widget:draw_text_multiline(font: string|renderer.font|widget.fontreference, text: string, x: integer, y: integer, color: renderer.color, only_calc: boolean)
-> resx: integer
2. resy: integer
3. width: integer
4. height: integer
Taken from the logview and modified it a tiny bit. TODO: something similar should be on pragtical core.
extend
(method) core.object:extend()
-> core.object
extends
(method) core.object:extends(T: any)
-> boolean
Check if the object inherits from the given type.
force_event
(method) widget:force_event(name: "mouse_released", force: boolean)
Toggle the forced interception of given event even if all the conditions for emitting it are not met.
Note: only "mouse_released" is implemented for the moment on floating views for use in the SelectBox, maybe a better system can be implemented on the future.
@param force
— If omitted is set to true by default
name:
| "mouse_released"
get_bottom
(method) widget:get_bottom()
-> number
Get the bottom y coordinate relative to parent
get_buttons_height
(method) widget.messagebox:get_buttons_height()
-> height: number
Get the height of biggest button.
get_buttons_width
(method) widget.messagebox:get_buttons_width()
-> width: number
Calculate the width of all buttons combined.
get_content_bounds
(method) core.view:get_content_bounds()
-> number
2. number
3. number
4. number
get_content_offset
(method) core.view:get_content_offset()
-> x: number
2. y: number
get_font
(method) widget:get_font(font?: string|renderer.font|widget.fontreference)
-> renderer.font
Get the real renderer.font associated with a widget.font.
get_h_scrollable_size
(method) widget:get_h_scrollable_size()
-> number
Calculates the x scrollable size taking into account the right most widget or the size of the widget it self if greater.
get_height
(method) widget:get_height()
-> number
Get height including borders.
get_name
(method) widget:get_name()
-> string
The name that is displayed on pragtical tabs.
get_position
(method) widget:get_position()
-> widget.position
Get the relative position in relation to parent
get_real_height
(method) widget:get_real_height()
-> number
Overall height of the widget accounting all visible child widgets.
get_real_width
(method) widget:get_real_width()
-> number
Overall width of the widget accounting all visible child widgets.
get_right
(method) widget:get_right()
-> number
Get the right x coordinate relative to parent
get_scrollable_size
(method) widget:get_scrollable_size()
-> number
Calculates the y scrollable size taking into account the bottom most widget or the size of the widget it self if greater.
get_size
(method) widget:get_size()
-> widget.position
get_width
(method) widget:get_width()
-> number
Get width including borders.
hide
(method) widget:hide()
Hide the widget.
hide_animated
(method) widget:hide_animated(lock_x?: boolean, lock_y?: boolean, options?: widget.animation.options)
Perform an animated hide.
@param lock_x
— Do not resize width while animating
@param lock_y
— Do not resize height while animating
is
(method) core.object:is(T: any)
-> boolean
Check if the object is strictly of the given type.
is_class_of
(method) core.object:is_class_of(T: any)
-> boolean
Check if the parameter is strictly of the object type.
is_extended_by
(method) core.object:is_extended_by(T: any)
-> boolean
Check if the parameter inherits from the object.
is_visible
(method) widget:is_visible()
-> boolean
Check if the widget is visible also recursing to the parent visibility.
mouse_on_top
(method) widget:mouse_on_top(x: number, y: number)
-> boolean
Check if the given mouse coordinate is hovering the widget
move_towards
(method) core.view:move_towards(t: any, k: any, dest: any, rate: any, name: any)
new
(method) widget.messagebox:new(parent: widget, title: string, message: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, icon: `MessageBox.ICON_ERROR`|`MessageBox.ICON_INFO`|`MessageBox.ICON_WARNING`, icon_color: renderer.color)
Constructor
icon:
-\> `MessageBox.ICON_ERROR`
| `MessageBox.ICON_INFO`
| `MessageBox.ICON_WARNING`
on_change
(method) widget:on_change(value: any)
Event emitted when the value of the widget changes. If applicable, child widgets should call this method when its value changes.
on_click
(method) widget:on_click(button: "left"|"right", x: number, y: number)
Click event emitted on a succesful on_mouse_pressed and on_mouse_released events combo.
button:
| "left"
| "right"
on_close
(method) widget.messagebox:on_close(button_id: integer, button: widget.button)
Called when the user clicks one of the buttons in the message box.
on_file_dropped
(method) widget:on_file_dropped(filename: string, x: number, y: number)
-> processed: boolean
Send file drop event to hovered child.
on_ime_text_editing
(method) core.view:on_ime_text_editing(text: any, start: any, length: any)
on_mouse_enter
(method) widget:on_mouse_enter(x: any, y: any, dx: any, dy: any)
Emitted once when the mouse hovers the widget.
on_mouse_leave
(method) widget:on_mouse_leave(x: any, y: any, dx: any, dy: any)
Emitted once when the mouse leaves the widget.
on_mouse_left
(method) widget:on_mouse_left()
on_mouse_moved
(method) widget:on_mouse_moved(x: number, y: number, dx: number, dy: number)
-> boolean
Besides the on_mouse_moved this event emits on_mouse_enter and on_mouse_leave for easy hover effects. Also, if the widget is scrollable and pressed this will drag it unless there is an active input_text child active.
on_mouse_pressed
(method) widget:on_mouse_pressed(button: "left"|"right", x: number, y: number, clicks: integer)
-> processed: boolean
Send mouse pressed events to hovered child or starts dragging if enabled.
button:
| "left"
| "right"
on_mouse_released
(method) widget:on_mouse_released(button: "left"|"right", x: number, y: number)
-> processed: boolean
Send mouse released events to hovered child, ends dragging if enabled and emits on click events if applicable.
button:
| "left"
| "right"
on_mouse_wheel
(method) widget:on_mouse_wheel(y: number, x: number)
-> boolean
on_scale_change
(method) widget.messagebox:on_scale_change(new_scale: number, prev_scale: number)
on_text_input
(method) widget:on_text_input(text: string)
-> processed: boolean
Redirects any text input to active child with the input_text flag.
on_touch_moved
(method) core.view:on_touch_moved(x: number, y: number, dx: number, dy: number, i: number)
release_mouse
(method) widget:release_mouse()
Undo capture_mouse()
remove_child
(method) widget:remove_child(child: widget)
Remove a child widget.
reposition_buttons
(method) widget.messagebox:reposition_buttons()
Position the buttons relative to the message.
run_animations
(method) widget:run_animations()
Runs all registered animations removing duplicated and finished ones.
schedule_update
(method) widget:schedule_update()
Schedule a core update and redraw. Since widgets try to not fire updates and draws to child widgets to reduce cpu consumption this function can be used when a re-update and re-draw is strictly needed.
scrollbar_dragging
(method) core.view:scrollbar_dragging()
-> boolean
scrollbar_hovering
(method) core.view:scrollbar_hovering()
-> boolean
scrollbar_overlaps_point
(method) core.view:scrollbar_overlaps_point(x: number, y: number)
-> boolean
set_border_width
(method) widget:set_border_width(width: integer)
Set the widget border size and appropriately re-set the widget size.
set_icon
(method) widget.messagebox:set_icon(icon: `MessageBox.ICON_ERROR`|`MessageBox.ICON_INFO`|`MessageBox.ICON_WARNING`, color?: renderer.color)
Change the message box icon.
icon:
-\> `MessageBox.ICON_ERROR`
| `MessageBox.ICON_INFO`
| `MessageBox.ICON_WARNING`
set_label
(method) widget:set_label(text: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>)
A text label for the widget, not all widgets support this.
set_message
(method) widget.messagebox:set_message(text: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>)
Change the message box message.
set_position
(method) widget:set_position(x?: integer, y?: integer)
Set the position of the widget and updates the child absolute coordinates
set_size
(method) widget:set_size(width?: integer, height?: integer)
set_target_size
(method) widget:set_target_size(axis: string|'x'|'y', value: number)
-> boolean
Called by pragtical node system to properly resize the widget.
axis:
| 'x'
| 'y'
set_title
(method) widget.messagebox:set_title(text: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>)
Change the message box title.
set_tooltip
(method) widget:set_tooltip(tooltip?: string|table<integer, string|integer|renderer.color|renderer.font|widget.fontreference>, command?: string)
Text displayed when the widget is hovered. If a command name is also given its associated binding will be displayed as part of the tooltip.
show
(method) widget.messagebox:show()
Calculate the MessageBox size, centers it relative to screen and shows it.
show_animated
(method) widget:show_animated(lock_x?: boolean, lock_y?: boolean, options?: widget.animation.options)
Perform an animated show.
@param lock_x
— Do not resize width while animating
@param lock_y
— Do not resize height while animating
supports_text_input
(method) core.view:supports_text_input()
-> boolean
swap_active_child
(method) widget:swap_active_child(child?: widget)
Replaces current active child with a new one and calls the activate/deactivate events of the child. This is especially used to send text input events to widgets with input_text support.
@param child
— If nil deactivates current child
toggle_background
(method) widget:toggle_background(enable?: boolean)
When set to false the background rendering is disabled.
toggle_visible
(method) widget:toggle_visible(animated?: boolean, lock_x?: boolean, lock_y?: boolean, options?: widget.animation.options)
Toggle visibility of widget.
try_close
(method) core.view:try_close(do_close: any)
update
(method) widget:update()
-> boolean
If visible execute the widget calculations and returns true.
update_if_scaled
(method) widget:update_if_scaled()
Explicitly call the widget update procedure when the scale change even if the widget is not visible.
update_position
(method) widget:update_position()
Called on the update function to be able to scroll the child widgets.
update_scrollbar
(method) core.view:update_scrollbar()
update_size_position
(method) widget.messagebox:update_size_position()