Popup scrolled
popup_scrolled
Show a scrolled Popup window containing the user's text that was supplied. Use with as many items to print as you want, just like a print statement.
popup_scrolled(
args = *<1 or N objects>,
title = None,
button_color = None,
background_color = None,
text_color = None,
yes_no = False,
no_buttons = False,
button_justification = "l",
auto_close = False,
auto_close_duration = None,
size = (None, None),
location = (None, None),
relative_location = (None, None),
non_blocking = False,
no_titlebar = False,
grab_anywhere = False,
keep_on_top = None,
font = None,
image = None,
icon = None,
modal = True,
no_sizegrip = False
)
Parameter Descriptions
Name | Type | Default | Description |
---|---|---|---|
*args | Any | Variable number of items to display | |
auto_close | bool | False | if True window will close itself |
auto_close_duration | int or float | None | Older versions only accept int. Time in seconds until window will close |
background_color | str | None | color of background |
button_color | (str, str) or str | None | button color (foreground, background) |
button_justification | str | l | How buttons should be arranged. l, c, r for Left, Center or Right justified |
font | (str or (str, int[, str]) or None) | None | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
grab_anywhere | bool | False | If True, than can grab anywhere to move the window (Default = False) |
icon | bytes or str | None | filename or base64 string to be used for the window's icon |
image | str or bytes | None | Image to include at the top of the popup window |
keep_on_top | bool | None | If True the window will remain above all current windows |
location | (int, int) | (None, None) | Location on the screen to place the upper left corner of the window |
modal | bool | True | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True |
no_buttons | bool | False | If True, no buttons will be shown. User will have to close using the "X" |
no_sizegrip | bool | False | If True no Sizegrip will be shown when there is no titlebar. It's only shown if there is no titlebar |
no_titlebar | bool | False | If True no titlebar will be shown |
non_blocking | bool | False | if True the call will immediately return rather than waiting on user input |
relative_location | (int, int) | (None, None) | (x,y) location relative to the default location of the window, in pixels. Normally the window centers. This location is relative to the location the window would be created. Note they can be negative. |
size | (int, int) | (None, None) | (w,h) w=characters-wide, h=rows-high |
text_color | str | None | color of the text |
title | str | None | Title to display in the window. |
yes_no | bool | False | If True, displays Yes and No buttons instead of Ok |
RETURN | str or None or TIMEOUT_KEY | Returns text of the button that was pressed. None will be returned if user closed window with X |
sprint
This method is an alias for popup_scrolled