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

Merge pull request #5416 from PySimpleGUI/Dev-latest 

Dev latest
This commit is contained in:
PySimpleGUI 2022-04-28 12:37:43 -04:00 committed by GitHub
parent e79d59ab79 b31266999b
commit 4aec09a8c5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 129 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

110
DemoPrograms/Demo_TTK_Scrollbars.py Normal file
View File

@ -0,0 +1,110 @@
import PySimpleGUI as sg
"""
Demo - TTK Scrollbars
Beginning in release 4.60.0 (May 2022), all scrollbars in the tkinter port use TTK Scrollbars
This feature impacts all elements that have scrollbars including:
Multiline
Output
Listbox
Table
Tree
Column
Not all elements in PySimpleGUI use TTK Widgets. Some of the Widgets are TK Widgets. Regardless of the
underlying widget, if it has a scrollbar that's visible normally (one of the above elements... unlike the Combo),
then it will use a TTK scrollbar.
There are many options available to you to set for these scrollbars.
TTK Theme
While the TTK Theme has been available for you to set, most users have likely not experimented much with this feature.
This may change with these new scrollbars because the TTK Theme will impact how the scrollbars look. Be aware that
the TTK Theme will also impact elements that use TTK Widgets.
You can see what tkinter widgets are used for all of the elements in the documenation located here:
https://pysimplegui.readthedocs.io/en/latest/#table-of-elements-in-tkinter-port
Hierarchy of settings
The scrollbar settings used for an element are picked up from one of these 4 locations. The priority order for
the settings is:
1. The Element's parms in the layout (you can change individual element's scrollbars)
2. Window parms
3. set_options parms
4. The Global Settings (changable by calling sg.main())
The TTK Theme follows a similar hierarchy. The order of priority to determine the theme is:
1. Window parm
2. set_options parm
3. The Global Settings
More detailed information is available in the documenation about these scrollbars. The docstrings also tell you about
each parm. The parm names are identical for the elements, the Window and the set_options call
sbar_trough_color:
Scrollbar color of the trough
sbar_background_color:
Scrollbar color of the background of the arrow buttons at the ends AND the color of the "thumb" (the thing you grab and slide). Switches to arrow color when mouse is over
sbar_arrow_color:
Scrollbar color of the arrow at the ends of the scrollbar (it looks like a button). Switches to background color when mouse is over
sbar_width:
Scrollbar width in pixels
sbar_arrow_width:
Scrollbar width of the arrow on the scrollbar. It will potentially impact the overall width of the scrollbar
sbar_frame_color:
Scrollbar Color of frame around scrollbar (available only on some ttk themes)
sbar_relief:
Scrollbar relief that will be used for the "thumb" of the scrollbar (the thing you grab that slides). Should be a constant that is defined at starting with "RELIEF_" - RELIEF_RAISED, RELIEF_SUNKEN, RELIEF_FLAT, RELIEF_RIDGE, RELIEF_GROOVE, RELIEF_SOLID
Note that some parms can impact others. For example, setting the relief to Ridge negates the frame color setting
This Demo shows 2 different windows to demonstrate the parms in the Window object and set_options.
Copyright 2022 PySimpleGUI
"""
# Our first window uses your global defaults with the Listbox element directly overriding the settings
layout = [[sg.T('Fun with TTK Scrollbars')],
[sg.Multiline('\n'.join([str(x) for x in range(50)]), size=(40,20), expand_x=True, expand_y=True),
sg.Listbox(list(range(40)), s=(10,15),
sbar_background_color='green', sbar_trough_color='red', sbar_relief='ridge', sbar_arrow_color='purple', sbar_frame_color='yellow',)],
[sg.Button('Exit'), sg.Sizegrip()]]
window = sg.Window('TTK Scrollbars 1', layout, resizable=True)
while True:
event, values = window.read()
print(event, values)
if event == sg.WIN_CLOSED or event == 'Exit':
break
window.close()
# Our second window uses both set_options and the Window object to change the scrollbars
sg.set_options(sbar_width=30, sbar_arrow_width=30)
layout = [[sg.T('Fun with TTK Scrollbars 2')],
[sg.Multiline('\n'.join([str(x) for x in range(50)]), size=(40,20), expand_x=True, expand_y=True),
sg.Listbox(list(range(40)), s=(10,15),
sbar_background_color='green', sbar_trough_color='red', sbar_arrow_color='purple', sbar_frame_color='yellow',)],
[sg.Button('Exit'), sg.Sizegrip()]]
window = sg.Window('TTK Scrollbars 2', layout, sbar_relief=sg.RELIEF_SOLID, resizable=True)
while True:
event, values = window.read()
print(event, values)
if event == sg.WIN_CLOSED or event == 'Exit':
break
window.close()

26
PySimpleGUI.py
View File

@ -1,6 +1,6 @@
#!/usr/bin/python3
version = __version__ = "4.59.0.32 Released 5-Apr-2022"
version = __version__ = "4.59.0.33 Released 5-Apr-2022"
_change_log = """
Changelog since 4.59.0 released to PyPI on 5-Apr-2022
@ -115,6 +115,13 @@ _change_log = """
already taking forever... (insert eyeroll emoji here)
Removed "Use TTK Scrollbars" checkbox in global settings... you're getting TTK scrollbars whether you like it or not ;-)
Prettied up the ttk settings tab in global settings
4.59.0.33
New Column element parameters - size_subsample_width & size_subsample_height
Gives much more control over the sizing of SCROLLABLE columns. Previously the size was set to 1/2 the required height and the full required width.
The defaults are backward compatible (size_subsample_width=1, size_subsample_height=2)
Setting both to 1 will make the Column fit the contents exactly.
One use is when you expect your Column to grow or shrink over time. Or maybe you didn't like the 1/2 size that PySimpleGUI has always used before.
Hoping this isn't too complex to understand!
"""
__version__ = version.split()[0] # For PEP 396 and PEP 345
@ -7849,7 +7856,7 @@ class Column(Element):
A container element that is used to create a layout within your window's layout
"""
def __init__(self, layout, background_color=None, size=(None, None), s=(None, None), pad=None, p=None, scrollable=False,
def __init__(self, layout, background_color=None, size=(None, None), s=(None, None), size_subsample_width=1, size_subsample_height=2, pad=None, p=None, scrollable=False,
vertical_scroll_only=False, right_click_menu=None, key=None, k=None, visible=True, justification=None, element_justification=None,
vertical_alignment=None, grab=None, expand_x=None, expand_y=None, metadata=None,
sbar_trough_color=None, sbar_background_color=None, sbar_arrow_color=None, sbar_width=None, sbar_arrow_width=None,
@ -7863,6 +7870,10 @@ class Column(Element):
:type size: (int | None, int | None)
:param s: Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used
:type s: (int | None, int | None)
:param size_subsample_width: Determines the size of a scrollable column width based on 1/size_subsample * required size. 1 = match the contents exactly, 2 = 1/2 contents size, 3 = 1/3. Can be a fraction to make larger than required.
:type size_subsample_width: (float)
:param size_subsample_height: Determines the size of a scrollable height based on 1/size_subsample * required size. 1 = match the contents exactly, 2 = 1/2 contents size, 3 = 1/3. Can be a fraction to make larger than required..
:type size_subsample_height: (float)
:param pad: Amount of padding to put around element in pixels (left/right, top/bottom) or ((left, right), (top, bottom)) or an int. If an int, then it's converted into a tuple (int, int)
:type pad: (int, int) or ((int, int),(int,int)) or (int,(int,int)) or ((int, int),int) | int
:param p: Same as pad parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, pad will be used
@ -7936,6 +7947,8 @@ class Column(Element):
self.Layout(layout)
sz = size if size != (None, None) else s
pad = pad if pad is not None else p
self.size_subsample_width = size_subsample_width
self.size_subsample_height = size_subsample_height
super().__init__(ELEM_TYPE_COLUMN, background_color=bg, size=sz, pad=pad, key=key, visible=visible, metadata=metadata,
sbar_trough_color=sbar_trough_color, sbar_background_color=sbar_background_color, sbar_arrow_color=sbar_arrow_color, sbar_width=sbar_width, sbar_arrow_width=sbar_arrow_width, sbar_frame_color=sbar_frame_color, sbar_relief=sbar_relief)
@ -14933,18 +14946,17 @@ def PackFormIntoFrame(form, containing_frame, toplevel_form):
PackFormIntoFrame(element, element.TKColFrame.TKFrame, toplevel_form)
element.TKColFrame.TKFrame.update()
if element.Size == (None, None): # if no size specified, use column width x column height/2
element.TKColFrame.canvas.config(width=element.TKColFrame.TKFrame.winfo_reqwidth(),
height=element.TKColFrame.TKFrame.winfo_reqheight() // 2)
element.TKColFrame.canvas.config(width=element.TKColFrame.TKFrame.winfo_reqwidth() // element.size_subsample_width,
height=element.TKColFrame.TKFrame.winfo_reqheight() // element.size_subsample_height)
else:
element.TKColFrame.canvas.config(width=element.TKColFrame.TKFrame.winfo_reqwidth(),
height=element.TKColFrame.TKFrame.winfo_reqheight() // 2)
element.TKColFrame.canvas.config(width=element.TKColFrame.TKFrame.winfo_reqwidth() // element.size_subsample_width,
height=element.TKColFrame.TKFrame.winfo_reqheight() // element.size_subsample_height)
if None not in (element.Size[0], element.Size[1]):
element.TKColFrame.canvas.config(width=element.Size[0], height=element.Size[1])
elif element.Size[1] is not None:
element.TKColFrame.canvas.config(height=element.Size[1])
elif element.Size[0] is not None:
element.TKColFrame.canvas.config(width=element.Size[0])
if not element.BackgroundColor in (None, COLOR_SYSTEM_DEFAULT):
element.TKColFrame.canvas.config(background=element.BackgroundColor)
element.TKColFrame.TKFrame.config(background=element.BackgroundColor, borderwidth=0, highlightthickness=0)