Release 4.43.0
This commit is contained in:
parent
b8dd1f0c00
commit
d3cb3f74c2
|
@ -23,7 +23,7 @@ port = 'PySimpleGUI'
|
|||
|
||||
|
||||
"""
|
||||
Copyright 2018, 2019, 2020, 2021 PySimpleGUI
|
||||
Copyright 2018, 2019, 2020, 2021 PySimpleGUI(tm)
|
||||
|
||||
Before getting into the details, let's talk about the high level goals of the PySimpleGUI project.
|
||||
|
||||
|
|
File diff suppressed because it is too large
Load Diff
202
docs/index.md
202
docs/index.md
|
@ -1464,20 +1464,20 @@ Parameter Descriptions:
|
|||
|--|--|--|
|
||||
| Any | *args | Variable number of your arguments. Load up the call with stuff to see! |
|
||||
| str | title | Optional title for the window. If none provided, the first arg will be used instead. |
|
||||
| Tuple[str, str] or None | button_color | Color of the buttons shown (text color, button color) |
|
||||
| (str, str) or None | button_color | Color of the buttons shown (text color, button color) |
|
||||
| str | background_color | Window's background color |
|
||||
| str | text_color | text color |
|
||||
| int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. |
|
||||
| bool | auto_close | If True the window will automatically close |
|
||||
| int | auto_close_duration | time in seconds to keep window open before closing it automatically |
|
||||
| Tuple[str, str] or str | custom_text | A string or pair of strings that contain the text to display on the buttons |
|
||||
| (str, str) or str | custom_text | A string or pair of strings that contain the text to display on the buttons |
|
||||
| bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. |
|
||||
| str or bytes | icon | icon to display on the window. Same format as a Window call |
|
||||
| int | line_width | Width of lines in characters. Defaults to MESSAGE_BOX_LINE_WIDTH |
|
||||
| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc |
|
||||
| bool | no_titlebar | If True will not show the frame around the window and the titlebar across the top |
|
||||
| bool | grab_anywhere | If True can grab anywhere to move the window. If no_titlebar is True, grab_anywhere should likely be enabled too |
|
||||
| Tuple[int, int] | location | Location on screen to display the top left corner of window. Defaults to window centered on screen |
|
||||
| (int, int) | location | Location on screen to display the top left corner of window. Defaults to window centered on screen |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| bool | any_key_closes | If True then will turn on return_keyboard_events for the window which will cause window to close as soon as any key is pressed. Normally the return key only will close the window. Default is false. |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
|
@ -1523,31 +1523,33 @@ popup_scrolled(args=*<1 or N object>,
|
|||
font = None,
|
||||
image = None,
|
||||
icon = None,
|
||||
modal = True)
|
||||
modal = True,
|
||||
no_sizegrip = False)
|
||||
```
|
||||
|
||||
Parameter Descriptions:
|
||||
|
||||
|Type|Name|Meaning|
|
||||
|--|--|--|
|
||||
| Any | *args | Variable number of items to display |
|
||||
| str | title | Title to display in the window. |
|
||||
| Tuple[str, str] or str | button_color | button color (foreground, background) |
|
||||
| bool | yes_no | If True, displays Yes and No buttons instead of Ok |
|
||||
| bool | auto_close | if True window will close itself |
|
||||
| int or float | auto_close_duration | Older versions only accept int. Time in seconds until window will close |
|
||||
| (int, int) | size | (w,h) w=characters-wide, h=rows-high |
|
||||
| Tuple[int, int] | location | Location on the screen to place the upper left corner of the window |
|
||||
| bool | non_blocking | if True the call will immediately return rather than waiting on user input |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| Any | *args | Variable number of items to display |
|
||||
| str | title | Title to display in the window. |
|
||||
| (str, str) or str | button_color | button color (foreground, background) |
|
||||
| bool | yes_no | If True, displays Yes and No buttons instead of Ok |
|
||||
| bool | auto_close | if True window will close itself |
|
||||
| int or float | auto_close_duration | Older versions only accept int. Time in seconds until window will close |
|
||||
| (int, int) | size | (w,h) w=characters-wide, h=rows-high |
|
||||
| (int, int) | location | Location on the screen to place the upper left corner of the window |
|
||||
| bool | non_blocking | if True the call will immediately return rather than waiting on user input |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| str or Tuple[str, int] | font | specifies the font family, size, etc |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| bool | modal | 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 |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| bool | modal | 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 |
|
||||
| bool | no_sizegrip | If True no Sizegrip will be shown when there is no titlebar. It's only shown if there is no titlebar |
|
||||
| str or None or TIMEOUT_KEY | **RETURN** | Returns text of the button that was pressed. None will be returned if user closed window with X
|
||||
|
||||
Typical usage:
|
||||
|
@ -1597,23 +1599,23 @@ Parameter Descriptions:
|
|||
|
||||
|Type|Name|Meaning|
|
||||
|--|--|--|
|
||||
| Any | *args | Variable number of items to display |
|
||||
| str | title | Title to display in the window. |
|
||||
| int | button_type | Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). |
|
||||
| Tuple[str, str] or str | button_color | button color (foreground, background) |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bool | auto_close | if True window will close itself |
|
||||
| int or float | auto_close_duration | Older versions only accept int. Time in seconds until window will close |
|
||||
| bool | non_blocking | if True the call will immediately return rather than waiting on user input |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| int | line_width | Width of lines in characters |
|
||||
| Any | *args | Variable number of items to display |
|
||||
| str | title | Title to display in the window. |
|
||||
| int | button_type | Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). |
|
||||
| (str, str) or str | button_color | button color (foreground, background) |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bool | auto_close | if True window will close itself |
|
||||
| int or float | auto_close_duration | Older versions only accept int. Time in seconds until window will close |
|
||||
| bool | non_blocking | if True the call will immediately return rather than waiting on user input |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| int | line_width | Width of lines in characters |
|
||||
| str or Tuple[str, int] | font | specifies the font family, size, etc |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| Tuple[int, int] | location | Location of upper left corner of the window |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = False |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| (int, int) | location | Location of upper left corner of the window |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = False |
|
||||
| str or None | **RETURN** | Reason for popup closing
|
||||
|
||||
The `popup` call `popup_no_wait` or `popup_non_blocking` will create a popup window and then immediately return control back to you. You can turn other popup calls into non-blocking popups if they have a `non_blocking` parameter. Setting `non_blocking` to True will cause the function to return immediately rather than waiting for the window to be closed.
|
||||
|
@ -1662,22 +1664,22 @@ Parameter Descriptions:
|
|||
|
||||
|Type|Name|Meaning|
|
||||
|--|--|--|
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_text | default value to put into input area |
|
||||
| str | password_char | character to be shown instead of actually typed characters |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| Tuple[str, str] or str | button_color | Color of the button (text, background) |
|
||||
| str | background_color | background color of the entire window |
|
||||
| str | text_color | color of the message text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_text | default value to put into input area |
|
||||
| str | password_char | character to be shown instead of actually typed characters |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| (str, str) or str | button_color | Color of the button (text, background) |
|
||||
| str | background_color | background color of the entire window |
|
||||
| str | text_color | color of the message text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str or Tuple[str, int] | font | specifies the font family, size, etc |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True can click and drag anywhere in the window to move the window |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| Tuple[int, int] | location | (x,y) Location on screen to display the upper left corner of window |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | 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 |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True can click and drag anywhere in the window to move the window |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| (int, int) | location | (x,y) Location on screen to display the upper left corner of window |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | 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 |
|
||||
| str or None | **RETURN** | Text entered or None if window was closed or cancel button clicked
|
||||
|
||||
```python
|
||||
|
@ -1725,28 +1727,28 @@ Parameter Descriptions:
|
|||
|
||||
|Type|Name|Meaning|
|
||||
|--|--|--|
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_path | path to display to user as starting point (filled into the input field) |
|
||||
| str | default_extension | If no extension entered by user, add this to filename (only used in saveas dialogs) |
|
||||
| bool | save_as | if True, the "save as" dialog is shown which will verify before overwriting |
|
||||
| bool | multiple_files | if True, then allows multiple files to be selected that are returned with ';' between each filename |
|
||||
| Tuple[Tuple[str,str]] | file_types | List of extensions to show using wildcards. All files (the default) = (("ALL Files", "*.*"),) |
|
||||
| bool | no_window | if True, no PySimpleGUI window will be shown. Instead just the tkinter dialog is shown |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| Tuple[str, str] or str | button_color | Color of the button (text, background) |
|
||||
| str | background_color | background color of the entire window |
|
||||
| str | text_color | color of the text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_path | path to display to user as starting point (filled into the input field) |
|
||||
| str | default_extension | If no extension entered by user, add this to filename (only used in saveas dialogs) |
|
||||
| bool | save_as | if True, the "save as" dialog is shown which will verify before overwriting |
|
||||
| bool | multiple_files | if True, then allows multiple files to be selected that are returned with ';' between each filename |
|
||||
| Tuple[Tuple[str,str]] | file_types | List of extensions to show using wildcards. All files (the default) = (("ALL Files", "*.*"),) |
|
||||
| bool | no_window | if True, no PySimpleGUI window will be shown. Instead just the tkinter dialog is shown |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| (str, str) or str | button_color | Color of the button (text, background) |
|
||||
| str | background_color | background color of the entire window |
|
||||
| str | text_color | color of the text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str or Tuple[str, int] | font | specifies the font family, size, etc |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| Tuple[int, int] | location | Location of upper left corner of the window |
|
||||
| str | initial_folder | location in filesystem to begin browsing |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| str | files_delimiter | String to place between files when multiple files are selected. Normally a ; |
|
||||
| bool | modal | 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 |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| (int, int) | location | Location of upper left corner of the window |
|
||||
| str | initial_folder | location in filesystem to begin browsing |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| str | files_delimiter | String to place between files when multiple files are selected. Normally a ; |
|
||||
| bool | modal | 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 |
|
||||
| str or None | **RETURN** | string representing the file(s) chosen, None if cancelled or window closed with X
|
||||
|
||||
If configured as an Open File Popup then (save_as is not True) the dialog box will look like this.
|
||||
|
@ -1798,23 +1800,23 @@ Parameter Descriptions:
|
|||
|
||||
|Type|Name|Meaning|
|
||||
|--|--|--|
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_path | path to display to user as starting point (filled into the input field) |
|
||||
| bool | no_window | if True, no PySimpleGUI window will be shown. Instead just the tkinter dialog is shown |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| Tuple[str, str] or str | button_color | button color (foreground, background) |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_path | path to display to user as starting point (filled into the input field) |
|
||||
| bool | no_window | if True, no PySimpleGUI window will be shown. Instead just the tkinter dialog is shown |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| (str, str) or str | button_color | button color (foreground, background) |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str or Tuple[str, int] | font | specifies the font family, size, etc |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| Tuple[int, int] | location | Location of upper left corner of the window |
|
||||
| str | initial_folder | location in filesystem to begin browsing |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | 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 |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| (int, int) | location | Location of upper left corner of the window |
|
||||
| str | initial_folder | location in filesystem to begin browsing |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | 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 |
|
||||
| str or None | **RETURN** | string representing the path chosen, None if cancelled or window closed with X
|
||||
|
||||
This is a typical call
|
||||
|
@ -1905,7 +1907,7 @@ Parameter Descriptions:
|
|||
| Any | *args | stuff to output |
|
||||
| str | orientation | 'horizontal' or 'vertical' ('h' or 'v' work) (Default value = 'vertical' / 'v') |
|
||||
| Tuple(str, str) | bar_color | color of a bar line |
|
||||
| Tuple[str, str] or str | button_color | button color (foreground, background) |
|
||||
| (str, str) or str | button_color | button color (foreground, background) |
|
||||
| (int, int) | size | (w,h) w=characters-wide, h=rows-high (Default value = DEFAULT_PROGRESS_BAR_SIZE) |
|
||||
| int | border_width | width of border around element |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
|
@ -8734,6 +8736,26 @@ Grab Anywhere feature improved
|
|||
* Combo element new bind_return_key parameter - if set, when return key is pressed and element is focused, then event will be generated. Works like the Listbox's bind_return_key
|
||||
* Fix for changing the title of a Tab using
|
||||
|
||||
## 4.43.0 PySimpleGUI 23-May-2021
|
||||
|
||||
Happy User Appreciate Day!
|
||||
Multiline expand_x, expand_y parms
|
||||
Window.ding() - because FUN is the #1 goal
|
||||
|
||||
* Added 2 new parms to Multiline Element
|
||||
* expand_x - if True, then the element will expand in the X direction
|
||||
* expand_y - if True, then the element will expand in the Y direction
|
||||
* replaces the need to perform: window['-MULTILINE KEY-'].expand(True, True, True)
|
||||
* Defaults to FALSE to be backward compatible
|
||||
* popup_scrolled
|
||||
* changed to be resizable by default and expands the multline too
|
||||
* if no_titlebar is set, then a Sizegrip will be added, unless no_sizerip parm = True
|
||||
* easy_print(sg.Print)
|
||||
* changed to be resizable by default and exands the multiline too
|
||||
* if no_titlebar is set, then a Sizegrip will be added
|
||||
* Window.ding() added - get your user's attention when errors happen or just for FUN
|
||||
* Added Element.grab_anywhere_include - includes an element in grab_anywhere in case you have something like a Multiline element that you can to move the window using that element
|
||||
|
||||
## Upcoming
|
||||
|
||||
The future for PySimpleGUI looks bright!
|
||||
|
|
|
@ -1941,6 +1941,29 @@ Grab Anywhere feature improved
|
|||
* Fix for changing the title of a Tab using
|
||||
|
||||
|
||||
## 4.43.0 PySimpleGUI 23-May-2021
|
||||
|
||||
Happy User Appreciate Day!
|
||||
Multiline expand_x, expand_y parms
|
||||
Window.ding() - because FUN is the #1 goal
|
||||
|
||||
* Added 2 new parms to Multiline Element
|
||||
* expand_x - if True, then the element will expand in the X direction
|
||||
* expand_y - if True, then the element will expand in the Y direction
|
||||
* replaces the need to perform: window['-MULTILINE KEY-'].expand(True, True, True)
|
||||
* Defaults to FALSE to be backward compatible
|
||||
* popup_scrolled
|
||||
* changed to be resizable by default and expands the multline too
|
||||
* if no_titlebar is set, then a Sizegrip will be added, unless no_sizerip parm = True
|
||||
* easy_print(sg.Print)
|
||||
* changed to be resizable by default and exands the multiline too
|
||||
* if no_titlebar is set, then a Sizegrip will be added
|
||||
* Window.ding() added - get your user's attention when errors happen or just for FUN
|
||||
* Added Element.grab_anywhere_include - includes an element in grab_anywhere in case you have something like a Multiline element that you can to move the window using that element
|
||||
|
||||
|
||||
|
||||
|
||||
## Upcoming
|
||||
|
||||
The future for PySimpleGUI looks bright!
|
||||
|
|
|
@ -44,6 +44,9 @@ Here are all of the Elements, the Window & SystemTray classes, and all functions
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Button.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Button.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Button.hide_row+> -->
|
||||
|
||||
|
@ -120,6 +123,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+ButtonMenu.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+ButtonMenu.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+ButtonMenu.hide_row+> -->
|
||||
|
||||
|
@ -194,6 +200,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Canvas.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Canvas.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Canvas.hide_row+> -->
|
||||
|
||||
|
@ -264,6 +273,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Checkbox.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Checkbox.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Checkbox.hide_row+> -->
|
||||
|
||||
|
@ -341,6 +353,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Column.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Column.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Column.hide_row+> -->
|
||||
|
||||
|
@ -426,6 +441,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Combo.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Combo.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Combo.hide_row+> -->
|
||||
|
||||
|
@ -501,6 +519,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Frame.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Frame.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Frame.hide_row+> -->
|
||||
|
||||
|
@ -626,6 +647,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Graph.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Graph.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Graph.hide_row+> -->
|
||||
|
||||
|
@ -764,6 +788,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+HorizontalSeparator.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+HorizontalSeparator.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+HorizontalSeparator.hide_row+> -->
|
||||
|
||||
|
@ -827,6 +854,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Image.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Image.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Image.hide_row+> -->
|
||||
|
||||
|
@ -908,6 +938,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Input.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Input.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Input.hide_row+> -->
|
||||
|
||||
|
@ -992,6 +1025,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Listbox.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Listbox.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Listbox.hide_row+> -->
|
||||
|
||||
|
@ -1075,6 +1111,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Menu.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Menu.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Menu.hide_row+> -->
|
||||
|
||||
|
@ -1158,6 +1197,9 @@ See the Column element to get a list of method calls available. The function re
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Multiline.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Multiline.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Multiline.hide_row+> -->
|
||||
|
||||
|
@ -1249,6 +1291,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+OptionMenu.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+OptionMenu.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+OptionMenu.hide_row+> -->
|
||||
|
||||
|
@ -1322,6 +1367,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Output.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Output.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Output.hide_row+> -->
|
||||
|
||||
|
@ -1404,6 +1452,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Pane.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Pane.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Pane.hide_row+> -->
|
||||
|
||||
|
@ -1472,6 +1523,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+ProgressBar.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+ProgressBar.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+ProgressBar.hide_row+> -->
|
||||
|
||||
|
@ -1551,6 +1605,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Radio.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Radio.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Radio.hide_row+> -->
|
||||
|
||||
|
@ -1627,6 +1684,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Sizegrip.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Sizegrip.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Sizegrip.hide_row+> -->
|
||||
|
||||
|
@ -1683,6 +1743,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Slider.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Slider.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Slider.hide_row+> -->
|
||||
|
||||
|
@ -1755,6 +1818,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Spin.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Spin.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Spin.hide_row+> -->
|
||||
|
||||
|
@ -1826,6 +1892,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+StatusBar.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+StatusBar.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+StatusBar.hide_row+> -->
|
||||
|
||||
|
@ -1898,6 +1967,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Tab.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Tab.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Tab.hide_row+> -->
|
||||
|
||||
|
@ -1989,6 +2061,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+TabGroup.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+TabGroup.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+TabGroup.hide_row+> -->
|
||||
|
||||
|
@ -2065,6 +2140,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Table.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Table.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Table.hide_row+> -->
|
||||
|
||||
|
@ -2136,6 +2214,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Text.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Text.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Text.hide_row+> -->
|
||||
|
||||
|
@ -2221,6 +2302,9 @@ See the Column element to get a list of method calls available. The function re
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+Tree.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+Tree.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+Tree.hide_row+> -->
|
||||
|
||||
|
@ -2308,6 +2392,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### grab_anywhere_exclude
|
||||
<!-- <+VerticalSeparator.grab_anywhere_exclude+> -->
|
||||
|
||||
### grab_anywhere_include
|
||||
<!-- <+VerticalSeparator.grab_anywhere_include+> -->
|
||||
|
||||
### hide_row
|
||||
<!-- <+VerticalSeparator.hide_row+> -->
|
||||
|
||||
|
@ -2427,6 +2514,9 @@ The following methods are here for backwards compatibility reference. You will
|
|||
### current_location
|
||||
<!-- <+Window.current_location+> -->
|
||||
|
||||
### ding
|
||||
<!-- <+Window.ding+> -->
|
||||
|
||||
### disable
|
||||
<!-- <+Window.disable+> -->
|
||||
|
||||
|
|
File diff suppressed because it is too large
Load Diff
|
@ -1464,20 +1464,20 @@ Parameter Descriptions:
|
|||
|--|--|--|
|
||||
| Any | *args | Variable number of your arguments. Load up the call with stuff to see! |
|
||||
| str | title | Optional title for the window. If none provided, the first arg will be used instead. |
|
||||
| Tuple[str, str] or None | button_color | Color of the buttons shown (text color, button color) |
|
||||
| (str, str) or None | button_color | Color of the buttons shown (text color, button color) |
|
||||
| str | background_color | Window's background color |
|
||||
| str | text_color | text color |
|
||||
| int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. |
|
||||
| bool | auto_close | If True the window will automatically close |
|
||||
| int | auto_close_duration | time in seconds to keep window open before closing it automatically |
|
||||
| Tuple[str, str] or str | custom_text | A string or pair of strings that contain the text to display on the buttons |
|
||||
| (str, str) or str | custom_text | A string or pair of strings that contain the text to display on the buttons |
|
||||
| bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. |
|
||||
| str or bytes | icon | icon to display on the window. Same format as a Window call |
|
||||
| int | line_width | Width of lines in characters. Defaults to MESSAGE_BOX_LINE_WIDTH |
|
||||
| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc |
|
||||
| bool | no_titlebar | If True will not show the frame around the window and the titlebar across the top |
|
||||
| bool | grab_anywhere | If True can grab anywhere to move the window. If no_titlebar is True, grab_anywhere should likely be enabled too |
|
||||
| Tuple[int, int] | location | Location on screen to display the top left corner of window. Defaults to window centered on screen |
|
||||
| (int, int) | location | Location on screen to display the top left corner of window. Defaults to window centered on screen |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| bool | any_key_closes | If True then will turn on return_keyboard_events for the window which will cause window to close as soon as any key is pressed. Normally the return key only will close the window. Default is false. |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
|
@ -1523,31 +1523,33 @@ popup_scrolled(args=*<1 or N object>,
|
|||
font = None,
|
||||
image = None,
|
||||
icon = None,
|
||||
modal = True)
|
||||
modal = True,
|
||||
no_sizegrip = False)
|
||||
```
|
||||
|
||||
Parameter Descriptions:
|
||||
|
||||
|Type|Name|Meaning|
|
||||
|--|--|--|
|
||||
| Any | *args | Variable number of items to display |
|
||||
| str | title | Title to display in the window. |
|
||||
| Tuple[str, str] or str | button_color | button color (foreground, background) |
|
||||
| bool | yes_no | If True, displays Yes and No buttons instead of Ok |
|
||||
| bool | auto_close | if True window will close itself |
|
||||
| int or float | auto_close_duration | Older versions only accept int. Time in seconds until window will close |
|
||||
| (int, int) | size | (w,h) w=characters-wide, h=rows-high |
|
||||
| Tuple[int, int] | location | Location on the screen to place the upper left corner of the window |
|
||||
| bool | non_blocking | if True the call will immediately return rather than waiting on user input |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| Any | *args | Variable number of items to display |
|
||||
| str | title | Title to display in the window. |
|
||||
| (str, str) or str | button_color | button color (foreground, background) |
|
||||
| bool | yes_no | If True, displays Yes and No buttons instead of Ok |
|
||||
| bool | auto_close | if True window will close itself |
|
||||
| int or float | auto_close_duration | Older versions only accept int. Time in seconds until window will close |
|
||||
| (int, int) | size | (w,h) w=characters-wide, h=rows-high |
|
||||
| (int, int) | location | Location on the screen to place the upper left corner of the window |
|
||||
| bool | non_blocking | if True the call will immediately return rather than waiting on user input |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| str or Tuple[str, int] | font | specifies the font family, size, etc |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| bool | modal | 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 |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| bool | modal | 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 |
|
||||
| bool | no_sizegrip | If True no Sizegrip will be shown when there is no titlebar. It's only shown if there is no titlebar |
|
||||
| str or None or TIMEOUT_KEY | **RETURN** | Returns text of the button that was pressed. None will be returned if user closed window with X
|
||||
|
||||
Typical usage:
|
||||
|
@ -1597,23 +1599,23 @@ Parameter Descriptions:
|
|||
|
||||
|Type|Name|Meaning|
|
||||
|--|--|--|
|
||||
| Any | *args | Variable number of items to display |
|
||||
| str | title | Title to display in the window. |
|
||||
| int | button_type | Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). |
|
||||
| Tuple[str, str] or str | button_color | button color (foreground, background) |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bool | auto_close | if True window will close itself |
|
||||
| int or float | auto_close_duration | Older versions only accept int. Time in seconds until window will close |
|
||||
| bool | non_blocking | if True the call will immediately return rather than waiting on user input |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| int | line_width | Width of lines in characters |
|
||||
| Any | *args | Variable number of items to display |
|
||||
| str | title | Title to display in the window. |
|
||||
| int | button_type | Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). |
|
||||
| (str, str) or str | button_color | button color (foreground, background) |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bool | auto_close | if True window will close itself |
|
||||
| int or float | auto_close_duration | Older versions only accept int. Time in seconds until window will close |
|
||||
| bool | non_blocking | if True the call will immediately return rather than waiting on user input |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| int | line_width | Width of lines in characters |
|
||||
| str or Tuple[str, int] | font | specifies the font family, size, etc |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| Tuple[int, int] | location | Location of upper left corner of the window |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = False |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| (int, int) | location | Location of upper left corner of the window |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = False |
|
||||
| str or None | **RETURN** | Reason for popup closing
|
||||
|
||||
The `popup` call `popup_no_wait` or `popup_non_blocking` will create a popup window and then immediately return control back to you. You can turn other popup calls into non-blocking popups if they have a `non_blocking` parameter. Setting `non_blocking` to True will cause the function to return immediately rather than waiting for the window to be closed.
|
||||
|
@ -1662,22 +1664,22 @@ Parameter Descriptions:
|
|||
|
||||
|Type|Name|Meaning|
|
||||
|--|--|--|
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_text | default value to put into input area |
|
||||
| str | password_char | character to be shown instead of actually typed characters |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| Tuple[str, str] or str | button_color | Color of the button (text, background) |
|
||||
| str | background_color | background color of the entire window |
|
||||
| str | text_color | color of the message text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_text | default value to put into input area |
|
||||
| str | password_char | character to be shown instead of actually typed characters |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| (str, str) or str | button_color | Color of the button (text, background) |
|
||||
| str | background_color | background color of the entire window |
|
||||
| str | text_color | color of the message text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str or Tuple[str, int] | font | specifies the font family, size, etc |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True can click and drag anywhere in the window to move the window |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| Tuple[int, int] | location | (x,y) Location on screen to display the upper left corner of window |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | 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 |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True can click and drag anywhere in the window to move the window |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| (int, int) | location | (x,y) Location on screen to display the upper left corner of window |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | 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 |
|
||||
| str or None | **RETURN** | Text entered or None if window was closed or cancel button clicked
|
||||
|
||||
```python
|
||||
|
@ -1725,28 +1727,28 @@ Parameter Descriptions:
|
|||
|
||||
|Type|Name|Meaning|
|
||||
|--|--|--|
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_path | path to display to user as starting point (filled into the input field) |
|
||||
| str | default_extension | If no extension entered by user, add this to filename (only used in saveas dialogs) |
|
||||
| bool | save_as | if True, the "save as" dialog is shown which will verify before overwriting |
|
||||
| bool | multiple_files | if True, then allows multiple files to be selected that are returned with ';' between each filename |
|
||||
| Tuple[Tuple[str,str]] | file_types | List of extensions to show using wildcards. All files (the default) = (("ALL Files", "*.*"),) |
|
||||
| bool | no_window | if True, no PySimpleGUI window will be shown. Instead just the tkinter dialog is shown |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| Tuple[str, str] or str | button_color | Color of the button (text, background) |
|
||||
| str | background_color | background color of the entire window |
|
||||
| str | text_color | color of the text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_path | path to display to user as starting point (filled into the input field) |
|
||||
| str | default_extension | If no extension entered by user, add this to filename (only used in saveas dialogs) |
|
||||
| bool | save_as | if True, the "save as" dialog is shown which will verify before overwriting |
|
||||
| bool | multiple_files | if True, then allows multiple files to be selected that are returned with ';' between each filename |
|
||||
| Tuple[Tuple[str,str]] | file_types | List of extensions to show using wildcards. All files (the default) = (("ALL Files", "*.*"),) |
|
||||
| bool | no_window | if True, no PySimpleGUI window will be shown. Instead just the tkinter dialog is shown |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| (str, str) or str | button_color | Color of the button (text, background) |
|
||||
| str | background_color | background color of the entire window |
|
||||
| str | text_color | color of the text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str or Tuple[str, int] | font | specifies the font family, size, etc |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| Tuple[int, int] | location | Location of upper left corner of the window |
|
||||
| str | initial_folder | location in filesystem to begin browsing |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| str | files_delimiter | String to place between files when multiple files are selected. Normally a ; |
|
||||
| bool | modal | 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 |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| (int, int) | location | Location of upper left corner of the window |
|
||||
| str | initial_folder | location in filesystem to begin browsing |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| str | files_delimiter | String to place between files when multiple files are selected. Normally a ; |
|
||||
| bool | modal | 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 |
|
||||
| str or None | **RETURN** | string representing the file(s) chosen, None if cancelled or window closed with X
|
||||
|
||||
If configured as an Open File Popup then (save_as is not True) the dialog box will look like this.
|
||||
|
@ -1798,23 +1800,23 @@ Parameter Descriptions:
|
|||
|
||||
|Type|Name|Meaning|
|
||||
|--|--|--|
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_path | path to display to user as starting point (filled into the input field) |
|
||||
| bool | no_window | if True, no PySimpleGUI window will be shown. Instead just the tkinter dialog is shown |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| Tuple[str, str] or str | button_color | button color (foreground, background) |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str | message | message displayed to user |
|
||||
| str | title | Window title |
|
||||
| str | default_path | path to display to user as starting point (filled into the input field) |
|
||||
| bool | no_window | if True, no PySimpleGUI window will be shown. Instead just the tkinter dialog is shown |
|
||||
| (int, int) | size | (width, height) of the InputText Element |
|
||||
| (str, str) or str | button_color | button color (foreground, background) |
|
||||
| str | background_color | color of background |
|
||||
| str | text_color | color of the text |
|
||||
| bytes or str | icon | filename or base64 string to be used for the window's icon |
|
||||
| str or Tuple[str, int] | font | specifies the font family, size, etc |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| Tuple[int, int] | location | Location of upper left corner of the window |
|
||||
| str | initial_folder | location in filesystem to begin browsing |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | 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 |
|
||||
| bool | no_titlebar | If True no titlebar will be shown |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
| bool | keep_on_top | If True the window will remain above all current windows |
|
||||
| (int, int) | location | Location of upper left corner of the window |
|
||||
| str | initial_folder | location in filesystem to begin browsing |
|
||||
| str or bytes | image | Image to include at the top of the popup window |
|
||||
| bool | modal | 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 |
|
||||
| str or None | **RETURN** | string representing the path chosen, None if cancelled or window closed with X
|
||||
|
||||
This is a typical call
|
||||
|
@ -1905,7 +1907,7 @@ Parameter Descriptions:
|
|||
| Any | *args | stuff to output |
|
||||
| str | orientation | 'horizontal' or 'vertical' ('h' or 'v' work) (Default value = 'vertical' / 'v') |
|
||||
| Tuple(str, str) | bar_color | color of a bar line |
|
||||
| Tuple[str, str] or str | button_color | button color (foreground, background) |
|
||||
| (str, str) or str | button_color | button color (foreground, background) |
|
||||
| (int, int) | size | (w,h) w=characters-wide, h=rows-high (Default value = DEFAULT_PROGRESS_BAR_SIZE) |
|
||||
| int | border_width | width of border around element |
|
||||
| bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) |
|
||||
|
@ -8734,6 +8736,26 @@ Grab Anywhere feature improved
|
|||
* Combo element new bind_return_key parameter - if set, when return key is pressed and element is focused, then event will be generated. Works like the Listbox's bind_return_key
|
||||
* Fix for changing the title of a Tab using
|
||||
|
||||
## 4.43.0 PySimpleGUI 23-May-2021
|
||||
|
||||
Happy User Appreciate Day!
|
||||
Multiline expand_x, expand_y parms
|
||||
Window.ding() - because FUN is the #1 goal
|
||||
|
||||
* Added 2 new parms to Multiline Element
|
||||
* expand_x - if True, then the element will expand in the X direction
|
||||
* expand_y - if True, then the element will expand in the Y direction
|
||||
* replaces the need to perform: window['-MULTILINE KEY-'].expand(True, True, True)
|
||||
* Defaults to FALSE to be backward compatible
|
||||
* popup_scrolled
|
||||
* changed to be resizable by default and expands the multline too
|
||||
* if no_titlebar is set, then a Sizegrip will be added, unless no_sizerip parm = True
|
||||
* easy_print(sg.Print)
|
||||
* changed to be resizable by default and exands the multiline too
|
||||
* if no_titlebar is set, then a Sizegrip will be added
|
||||
* Window.ding() added - get your user's attention when errors happen or just for FUN
|
||||
* Added Element.grab_anywhere_include - includes an element in grab_anywhere in case you have something like a Multiline element that you can to move the window using that element
|
||||
|
||||
## Upcoming
|
||||
|
||||
The future for PySimpleGUI looks bright!
|
||||
|
|
Loading…
Reference in New Issue