mlaga97
/
PySimpleGUI
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Release 4.29.0

This commit is contained in:
PySimpleGUI 2020-08-25 16:56:55 -04:00
parent b086edb26d
commit 154ea792ae
4 changed files with 154 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
PySimpleGUI.py
View File

@ -1,5 +1,5 @@
#!/usr/bin/python3 #!/usr/bin/python3
version = __version__ = "4.28.0.23 Unreleased 3-Aug-2020\nAdded a referesh to visiblity_changed (an existing function but blank), added Column.contents_changed which will update the scrollbar so corrently match the contents, separators expand only in 1 direction now, added SYBOOLS for arrows circle square, dark grey 8 theme, when closing window don't delete the tkroot variable and rows but instead set to None, dark grey 9 theme, replaced check for darkwin with try/except for wm_overrideredirect, fix for Column/window element justification, new vertical_alignment parm for Columns, vertical_alignment parm added to Frame, vertical_alignment added to pin func, vtop/vcenter/vbottom vertical alignment layout helper funcs, fixed statusbar expansion, added disabled button to theme previewer, grab anywhere stop motion was setting position to None and causing error. changed to event.x, expanded main to include popup tests, made vtop/vcenter/vbottom capable of taking an entire row as well as a single element, grab parameter for Text Element, added symbol left, added tclversion_detailed, all themes changed the progress bar definition that had a DEFAULT indicator because of bug it caused when swapping themes, added expand_x and expand_y to Columns, fix for Calendar Button, force focus when no-titlebar window, added Window.force_focus, do not close hidden master window, disable close on one_line_progress_meter - was causing next window to not work right when close with X, changed back toplevel to no parent" version = __version__ = "4.29.0 Released 25-Aug-2020"
port = 'PySimpleGUI' port = 'PySimpleGUI'
@ -31,7 +31,7 @@ port = 'PySimpleGUI'
""" """
Copyright 2018, 2019, 2020 PySimpleGUI.org Copyright 2018, 2019, 2020 PySimpleGUI.org
OK, let's get the bullshit out of the way OK, let's get the BS out of the way
This software is available for your use under a MODIFIED LGPL3+ license This software is available for your use under a MODIFIED LGPL3+ license

80
docs/call reference.md
View File

@ -1122,8 +1122,12 @@ Column(layout,
key=None, key=None,
k=None, k=None,
visible=True, visible=True,
justification="left", justification=None,
element_justification="left", element_justification=None,
vertical_alignment=None,
grab=None,
expand_x=None,
expand_y=None,
metadata=None) metadata=None)
``` ```
@ -1143,6 +1147,10 @@ Parameter Descriptions:
| bool | visible | set visibility state of the element | | bool | visible | set visibility state of the element |
| str | justification | set justification for the Column itself. Note entire row containing the Column will be affected | | str | justification | set justification for the Column itself. Note entire row containing the Column will be affected |
| str | element_justification | All elements inside the Column will have this justification 'left', 'right', 'center' are valid values | | str | element_justification | All elements inside the Column will have this justification 'left', 'right', 'center' are valid values |
| str | vertical_alignment | Place the column at the 'top', 'center', 'bottom' of the row (can also use t,c,r). Defaults to no setting (tkinter decides) |
| bool | grab | If True can grab this element and move the window around. Default is False |
| bool | expand_x | If True the column will automatically expand in the X direction to fill available space |
| bool | expand_y | If True the column will automatically expand in the Y direction to fill available space |
| Any | metadata | User metadata that can be set to ANYTHING | | Any | metadata | User metadata that can be set to ANYTHING |
### AddRow ### AddRow
@ -1708,6 +1716,7 @@ Frame(title,
right_click_menu=None, right_click_menu=None,
visible=True, visible=True,
element_justification="left", element_justification="left",
vertical_alignment=None,
metadata=None) metadata=None)
``` ```
@ -1731,6 +1740,7 @@ Parameter Descriptions:
| List[List[Union[List[str],str]]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | | List[List[Union[List[str],str]]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. |
| bool | visible | set visibility state of the element | | bool | visible | set visibility state of the element |
| str | element_justification | All elements inside the Frame will have this justification 'left', 'right', 'center' are valid values | | str | element_justification | All elements inside the Frame will have this justification 'left', 'right', 'center' are valid values |
| str | vertical_alignment | Place the column at the 'top', 'center', 'bottom' of the row (can also use t,c,r). Defaults to no setting (tkinter decides) |
| Any | metadata | User metadata that can be set to ANYTHING | | Any | metadata | User metadata that can be set to ANYTHING |
### AddRow ### AddRow
@ -6518,6 +6528,7 @@ StatusBar(text,
pad=None, pad=None,
key=None, key=None,
k=None, k=None,
right_click_menu=None,
tooltip=None, tooltip=None,
visible=True, visible=True,
metadata=None) metadata=None)
@ -6540,6 +6551,7 @@ Parameter Descriptions:
| (int, int) or ((int, int),(int,int)) or (int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | (int, int) or ((int, int),(int,int)) or (int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) |
| Union[str, int, tuple, object] | key | Used with window.FindElement and with return values to uniquely identify this element to uniquely identify this element | | Union[str, int, tuple, object] | key | Used with window.FindElement and with return values to uniquely identify this element to uniquely identify this element |
| Union[str, int, tuple, object] | k | Same as the Key. You can use either k or key. Which ever is set will be used. | | Union[str, int, tuple, object] | k | Same as the Key. You can use either k or key. Which ever is set will be used. |
| List[List[Union[List[str],str]]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. |
| str | tooltip | text, that will appear when mouse hovers over the element | | str | tooltip | text, that will appear when mouse hovers over the element |
| bool | visible | set visibility state of the element | | bool | visible | set visibility state of the element |
| Any | metadata | User metadata that can be set to ANYTHING | | Any | metadata | User metadata that can be set to ANYTHING |
@ -7887,6 +7899,7 @@ Text(text="",
key=None, key=None,
k=None, k=None,
right_click_menu=None, right_click_menu=None,
grab=None,
tooltip=None, tooltip=None,
visible=True, visible=True,
metadata=None) metadata=None)
@ -7911,6 +7924,7 @@ Parameter Descriptions:
| Union[str, int, tuple, object] | key | Used with window.FindElement and with return values to uniquely identify this element to uniquely identify this element | | Union[str, int, tuple, object] | key | Used with window.FindElement and with return values to uniquely identify this element to uniquely identify this element |
| Union[str, int, tuple, object] | k | Same as the Key. You can use either k or key. Which ever is set will be used. | | Union[str, int, tuple, object] | k | Same as the Key. You can use either k or key. Which ever is set will be used. |
| List[List[Union[List[str],str]]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | | List[List[Union[List[str],str]]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. |
| bool | grab | If True can grab this element and move the window around. Default is False |
| str | tooltip | text, that will appear when mouse hovers over the element | | str | tooltip | text, that will appear when mouse hovers over the element |
| bool | visible | set visibility state of the element | | bool | visible | set visibility state of the element |
| Any | metadata | User metadata that can be set to ANYTHING | | Any | metadata | User metadata that can be set to ANYTHING |
@ -9304,9 +9318,8 @@ UnHide()
### VisibilityChanged ### VisibilityChanged
Not used in tkinter, but supplied becuase it is used in Qt. Want to remain source code compatible so that if When making an element in a column or someplace that has a scrollbar, then you'll want to call this function
you are making this call in your PySimpleGUIQt code, you can switch to PySimpleGUI and it will not complain prior to the column's contents_changed() method.
about a missing method. Just know that in this version of PySimpleGUI, it does nothing
```python ```python
VisibilityChanged() VisibilityChanged()
@ -9629,6 +9642,14 @@ Returns the Element that currently has focus as reported by tkinter. If no eleme
|---|---|---| |---|---|---|
|<type>| **return** | An Element if one has been found with focus or None if no element found | |<type>| **return** | An Element if one has been found with focus or None if no element found |
### force_focus
Forces this window to take focus
```python
force_focus()
```
### get_screen_dimensions ### get_screen_dimensions
Get the screen dimensions. NOTE - you must have a window already open for this to work (blame tkinter not me) Get the screen dimensions. NOTE - you must have a window already open for this to work (blame tkinter not me)
@ -9908,9 +9929,8 @@ un_hide()
### visibility_changed ### visibility_changed
Not used in tkinter, but supplied becuase it is used in Qt. Want to remain source code compatible so that if When making an element in a column or someplace that has a scrollbar, then you'll want to call this function
you are making this call in your PySimpleGUIQt code, you can switch to PySimpleGUI and it will not complain prior to the column's contents_changed() method.
about a missing method. Just know that in this version of PySimpleGUI, it does nothing
```python ```python
visibility_changed() visibility_changed()
@ -9985,6 +10005,7 @@ CalendarButton(button_text,
bind_return_key=False, bind_return_key=False,
focus=False, focus=False,
pad=None, pad=None,
enable_events=None,
key=None, key=None,
k=None, k=None,
locale=None, locale=None,
@ -13965,15 +13986,54 @@ Parameter Descriptions:
| (Dict[Any:Any]) | values_dict | A dictionary with element keys as key and value is values parm for Update call | | (Dict[Any:Any]) | values_dict | A dictionary with element keys as key and value is values parm for Update call |
| None | **RETURN** | None | None | **RETURN** | None
## Element Visibility ## Layout Helper Funcs
Pin's an element provided into a layout so that when it's made invisible and visible again, it will Pin's an element provided into a layout so that when it's made invisible and visible again, it will
be in the correct place. Otherwise it will be placed at the end of its containing window/column. be in the correct place. Otherwise it will be placed at the end of its containing window/column.
``` ```
pin(elem) pin(elem, vertical_alignment=None)
``` ```
Align an element or a row of elements to the bottom of the row that contains it
```
vbottom(elem_or_row)
```
Parameter Descriptions:
|Type|Name|Meaning|
|--|--|--|
| Union[Element, List[Element], Tuple[Element]] | elem_or_row | the element or row of elements |
| Union[Column, List[Column]] | **RETURN** | A column element containing the provided element aligned to the bottom or list of elements (a row)
Align an element or a row of elements to the center of the row that contains it
```
vcenter(elem_or_row)
```
Parameter Descriptions:
|Type|Name|Meaning|
|--|--|--|
| Union[Element, List[Element], Tuple[Element]] | elem_or_row | the element or row of elements |
| Union[Column, List[Column]] | **RETURN** | A column element containing the provided element aligned to the center or list of elements (a row)
Align an element or a row of elements to the top of the row that contains it
```
vtop(elem_or_row)
```
Parameter Descriptions:
|Type|Name|Meaning|
|--|--|--|
| Union[Element, List[Element], Tuple[Element]] | elem_or_row | the element or row of elements |
| Union[Column, List[Column]] | **RETURN** | A column element containing the provided element aligned to the top or list of elements (a row)
## Configuration / Settings / Extensions ## Configuration / Settings / Extensions
Returns the dictionary of the global variables Returns the dictionary of the global variables

43
docs/index.md
View File

@ -3573,9 +3573,9 @@ Traceback (most recent call last):
main() main()
File "C:/Users/mike/.PyCharmCE2019.1/config/scratches/scratch_978 - key error example.py", line 17, in main File "C:/Users/mike/.PyCharmCE2019.1/config/scratches/scratch_978 - key error example.py", line 17, in main
window['-O U T'].update(values['-IN-']) window['-O U T'].update(values['-IN-'])
File "C:\Python\PycharmProjects\GooeyGUI\PySimpleGUI.py", line 8591, in __getitem__ File "C:\Python\PycharmProjects\PSG\PySimpleGUI.py", line 8591, in __getitem__
return self.FindElement(key) return self.FindElement(key)
File "C:\Python\PycharmProjects\GooeyGUI\PySimpleGUI.py", line 7709, in FindElement File "C:\Python\PycharmProjects\PSG\PySimpleGUI.py", line 7709, in FindElement
raise KeyError(key) raise KeyError(key)
KeyError: '-O U T' KeyError: '-O U T'
``` ```
@ -7690,6 +7690,45 @@ Element pinning for invisibility!
* spin arrow color automatically set to text color * spin arrow color automatically set to text color
* Bad element key popup - fix for displaying correct line info in some situations * Bad element key popup - fix for displaying correct line info in some situations
## 4.29.0 PySimpleGUI 25-Aug-2020
Custom titlebar capabilities (several new features required)
Better Alignment
Calendar button works again
* Window.visiblity_changed now refreshes the window
* Added Column.contents_changed which will update the scrollbar so corrently match the contents
* Separators expand only in 1 direction now
* Added 8 SYMBOLS:
SYMBOL_SQUARE = '█'
SYMBOL_CIRCLE = '⚫'
SYMBOL_CIRCLE_OUTLINE = '◯'
SYMBOL_UP = '▲'
SYMBOL_RIGHT = '►'
SYMBOL_LEFT = '◄'
SYMBOL_DOWN = '▼'
SYMBOL_X = '❎'
* New dark themes - dark grey 8, dark grey 9, dark green 9, dark purple 7
* When closing window no longer deletes the tkroot variable and rows but instead set to None
* Changd no-titlebar code to use try/except. Previously removed for Mac due to tk 8.6.10 errors calling wm_overrideredirect
* Fix for Column/window element justification
* New vertical_alignment parm for Column, Frame, pin
* New layout helper functions - vtop/vcenter/vbottom - Can pass an element or a row of elements
* Fixed statusbar expansion
* Added disabled button to theme previewer
* Fixed grab anywhere stop motion bug - was setting position to None and causing error changed to event.x
* Expanded main to include popup tests, theme tests, ability to hide tabs
* Grab parameter for Text Element, Column Element
* Added tclversion_detailed to get the detailed tkinter version
* All themes changed the progress bar definition that had a "DEFAULT" indicator. New constant DEFAULT_PROGRESS_BAR_COMPUTE indicates the other theme colors should be used to create the progess bar colors.
* Added expand_x and expand_y parameters to Columns
* Fix for Calendar Button. Still needs to be fixed for read_all_windows
* Force focus when no-titlebar window. Needed for Raspberry Pi
* Added Window.force_focus
* No longer closes the hidden master window. Closing it caused a memory leak within tkinter
* Disable close on one_line_progress_meter. There is a cancel button that will close the window
* Changed back toplevel to no parent - was causing problems with timeout=0 windows
### Upcoming ### Upcoming
There will always be overlapping work as the ports will never actually be "complete" as there's always something new that can be built. However there's a definition for the base functionality for PySimpleGUI. This is what is being strived for with the current ports that are underway. There will always be overlapping work as the ports will never actually be "complete" as there's always something new that can be built. However there's a definition for the base functionality for PySimpleGUI. This is what is being strived for with the current ports that are underway.

43
readme.md
View File

@ -3573,9 +3573,9 @@ Traceback (most recent call last):
main() main()
File "C:/Users/mike/.PyCharmCE2019.1/config/scratches/scratch_978 - key error example.py", line 17, in main File "C:/Users/mike/.PyCharmCE2019.1/config/scratches/scratch_978 - key error example.py", line 17, in main
window['-O U T'].update(values['-IN-']) window['-O U T'].update(values['-IN-'])
File "C:\Python\PycharmProjects\GooeyGUI\PySimpleGUI.py", line 8591, in __getitem__ File "C:\Python\PycharmProjects\PSG\PySimpleGUI.py", line 8591, in __getitem__
return self.FindElement(key) return self.FindElement(key)
File "C:\Python\PycharmProjects\GooeyGUI\PySimpleGUI.py", line 7709, in FindElement File "C:\Python\PycharmProjects\PSG\PySimpleGUI.py", line 7709, in FindElement
raise KeyError(key) raise KeyError(key)
KeyError: '-O U T' KeyError: '-O U T'
``` ```
@ -7690,6 +7690,45 @@ Element pinning for invisibility!
* spin arrow color automatically set to text color * spin arrow color automatically set to text color
* Bad element key popup - fix for displaying correct line info in some situations * Bad element key popup - fix for displaying correct line info in some situations
## 4.29.0 PySimpleGUI 25-Aug-2020
Custom titlebar capabilities (several new features required)
Better Alignment
Calendar button works again
* Window.visiblity_changed now refreshes the window
* Added Column.contents_changed which will update the scrollbar so corrently match the contents
* Separators expand only in 1 direction now
* Added 8 SYMBOLS:
SYMBOL_SQUARE = '█'
SYMBOL_CIRCLE = '⚫'
SYMBOL_CIRCLE_OUTLINE = '◯'
SYMBOL_UP = '▲'
SYMBOL_RIGHT = '►'
SYMBOL_LEFT = '◄'
SYMBOL_DOWN = '▼'
SYMBOL_X = '❎'
* New dark themes - dark grey 8, dark grey 9, dark green 9, dark purple 7
* When closing window no longer deletes the tkroot variable and rows but instead set to None
* Changd no-titlebar code to use try/except. Previously removed for Mac due to tk 8.6.10 errors calling wm_overrideredirect
* Fix for Column/window element justification
* New vertical_alignment parm for Column, Frame, pin
* New layout helper functions - vtop/vcenter/vbottom - Can pass an element or a row of elements
* Fixed statusbar expansion
* Added disabled button to theme previewer
* Fixed grab anywhere stop motion bug - was setting position to None and causing error changed to event.x
* Expanded main to include popup tests, theme tests, ability to hide tabs
* Grab parameter for Text Element, Column Element
* Added tclversion_detailed to get the detailed tkinter version
* All themes changed the progress bar definition that had a "DEFAULT" indicator. New constant DEFAULT_PROGRESS_BAR_COMPUTE indicates the other theme colors should be used to create the progess bar colors.
* Added expand_x and expand_y parameters to Columns
* Fix for Calendar Button. Still needs to be fixed for read_all_windows
* Force focus when no-titlebar window. Needed for Raspberry Pi
* Added Window.force_focus
* No longer closes the hidden master window. Closing it caused a memory leak within tkinter
* Disable close on one_line_progress_meter. There is a cancel button that will close the window
* Changed back toplevel to no parent - was causing problems with timeout=0 windows
### Upcoming ### Upcoming
There will always be overlapping work as the ports will never actually be "complete" as there's always something new that can be built. However there's a definition for the base functionality for PySimpleGUI. This is what is being strived for with the current ports that are underway. There will always be overlapping work as the ports will never actually be "complete" as there's always something new that can be built. However there's a definition for the base functionality for PySimpleGUI. This is what is being strived for with the current ports that are underway.