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

Merge pull request #5711 from PySimpleGUI/Dev-latest 

Dev latest
This commit is contained in:
PySimpleGUI 2022-07-22 15:23:24 -04:00 committed by GitHub
parent 6438e573df f405e9488c
commit a837c27ddd
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
9 changed files with 339 additions and 311 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

102
PySimpleGUI.py
View File

@ -1,6 +1,6 @@
#!/usr/bin/python3
version = __version__ = "4.60.1.60 Unreleased"
version = __version__ = "4.60.1.61 Unreleased"
_change_log = """
Changelog since 4.60.0 released to PyPI on 8-May-2022
@ -151,6 +151,9 @@ _change_log = """
Also applied similar fix for Tab element's focus color
4.60.1.60
Addition of set_option parameter hide_window_when_creating. If set to False then window will not be hidden while creating and moving
4.60.1.61
Changed the documentation location to PySimpleGUI.org (updated some comments as well as the SDK Reference Window's links)
New coupon code. Make the Udemy button in the test harness now include the coupon code automatically
"""
@ -224,13 +227,26 @@ port = 'PySimpleGUI'
In addition to the normal publishing requirements of LGPL3+, these also apply:
1. These and all comments are to remain in the source code
2. The "Official" version of PySimpleGUI and the associated documentation lives on two (and **only** two) places:
1. GitHub - (http://www.PySimpleGUI.com) currently pointing at:
https://github.com/PySimpleGUI/PySimpleGUI
2. PyPI - pip install PySimpleGUI is the customary way of obtaining the latest release
THE official documentation location is:
Read the Docs (via http://www.PySimpleGUI.org). Currently is pointed at:
https://pysimplegui.readthedocs.io/en/latest/
1. GitHub - (http://www.PySimpleGUI.com) currently pointing at:
https://github.com/PySimpleGUI/PySimpleGUI
2. PyPI - pip install PySimpleGUI is the customary way of obtaining the latest release
THE official documentation location is:
https://www.PySimpleGUI.org - Main documentation
There are also a lot of subdomains... many of which you can guess..
https://SDK.PySimpleGUI.org - The SDK Reference tab
https://Calls.PySimpleGUI.org - The SDK Reference tab
https://Cookbook.PySimpleGUI.org - The Cookbook tab
https://eCookbook.PySimpleGUI.org - The eCookbook located on Trinket
https://Anncouncements.PySimpleGUI.org - The Announcements Issue on GitHub
https://Install.PySimpleGUI.org - The "How to install" section of the docs
https://Upgrading.PySimpleGUI.org - The "How to upgrade" section of the docs
https://Udemy.PySimpleGUI.org - The Udemy course
https://GitHub.PySimpleGUI.org - The PySimpleGUI GitHub (also the located at PySimpleGUI.com)
https://Issues.PySimpleGUI.org - Open a new issue on GitHub
https://Bugs.PySimpleGUI.org - Open a new issue on GitHub
etc.....
If you've obtained this software in any other way, then those listed here, then SUPPORT WILL NOT BE PROVIDED.
3. If you use PySimpleGUI in your project/product, a notice of its use needs to be displayed in your readme file as per the license agreement
@ -245,7 +261,7 @@ port = 'PySimpleGUI'
If you're thinking of filing an Issue or posting a problem, Upgrade your software first
There are constantly something new and interesting coming out of this project so stay current if you can
The FASTEST WAY to learn PySimpleGUI is to begin to play with it, and to read the documentation.
The FASTEST WAY to learn PySimpleGUI is to begin to use it in conjunction with the materials provided by the project.
http://www.PySimpleGUI.org
http://Calls.PySimpleGUI.org
http://Cookbook.PySimpleGUI.org
@ -24776,37 +24792,37 @@ def main_sdk_help():
"""
online_help_links = {
'Button': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#button-element',
'ButtonMenu': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#buttonmenu-element',
'Canvas': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#canvas-element',
'Checkbox': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#checkbox-element',
'Column': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#column-element',
'Combo': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#combo-element',
'Frame': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#frame-element',
'Graph': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#graph-element',
'HorizontalSeparator': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#horizontalseparator-element',
'Image': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#image-element',
'Input': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#input-element',
'Listbox': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#listbox-element',
'Menu': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#menu-element',
'MenubarCustom': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#menubarcustom-element',
'Multiline': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#multiline-element',
'OptionMenu': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#optionmenu-element',
'Output': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#output-element',
'Pane': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#pane-element',
'ProgressBar': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#progressbar-element',
'Radio': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#radio-element',
'Slider': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#slider-element',
'Spin': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#spin-element',
'StatusBar': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#statusbar-element',
'Tab': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#tab-element',
'TabGroup': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#tabgroup-element',
'Table': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#table-element',
'Text': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#text-element',
'Titlebar': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#titlebar-element',
'Tree': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#tree-element',
'VerticalSeparator': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#verticalseparator-element',
'Window': r'https://pysimplegui.readthedocs.io/en/latest/call%20reference/#window',
'Button': r'https://PySimpleGUI.org/en/latest/call%20reference/#button-element',
'ButtonMenu': r'https://PySimpleGUI.org/en/latest/call%20reference/#buttonmenu-element',
'Canvas': r'https://PySimpleGUI.org/en/latest/call%20reference/#canvas-element',
'Checkbox': r'https://PySimpleGUI.org/en/latest/call%20reference/#checkbox-element',
'Column': r'https://PySimpleGUI.org/en/latest/call%20reference/#column-element',
'Combo': r'https://PySimpleGUI.org/en/latest/call%20reference/#combo-element',
'Frame': r'https://PySimpleGUI.org/en/latest/call%20reference/#frame-element',
'Graph': r'https://PySimpleGUI.org/en/latest/call%20reference/#graph-element',
'HorizontalSeparator': r'https://PySimpleGUI.org/en/latest/call%20reference/#horizontalseparator-element',
'Image': r'https://PySimpleGUI.org/en/latest/call%20reference/#image-element',
'Input': r'https://PySimpleGUI.org/en/latest/call%20reference/#input-element',
'Listbox': r'https://PySimpleGUI.org/en/latest/call%20reference/#listbox-element',
'Menu': r'https://PySimpleGUI.org/en/latest/call%20reference/#menu-element',
'MenubarCustom': r'https://PySimpleGUI.org/en/latest/call%20reference/#menubarcustom-element',
'Multiline': r'https://PySimpleGUI.org/en/latest/call%20reference/#multiline-element',
'OptionMenu': r'https://PySimpleGUI.org/en/latest/call%20reference/#optionmenu-element',
'Output': r'https://PySimpleGUI.org/en/latest/call%20reference/#output-element',
'Pane': r'https://PySimpleGUI.org/en/latest/call%20reference/#pane-element',
'ProgressBar': r'https://PySimpleGUI.org/en/latest/call%20reference/#progressbar-element',
'Radio': r'https://PySimpleGUI.org/en/latest/call%20reference/#radio-element',
'Slider': r'https://PySimpleGUI.org/en/latest/call%20reference/#slider-element',
'Spin': r'https://PySimpleGUI.org/en/latest/call%20reference/#spin-element',
'StatusBar': r'https://PySimpleGUI.org/en/latest/call%20reference/#statusbar-element',
'Tab': r'https://PySimpleGUI.org/en/latest/call%20reference/#tab-element',
'TabGroup': r'https://PySimpleGUI.org/en/latest/call%20reference/#tabgroup-element',
'Table': r'https://PySimpleGUI.org/en/latest/call%20reference/#table-element',
'Text': r'https://PySimpleGUI.org/en/latest/call%20reference/#text-element',
'Titlebar': r'https://PySimpleGUI.org/en/latest/call%20reference/#titlebar-element',
'Tree': r'https://PySimpleGUI.org/en/latest/call%20reference/#tree-element',
'VerticalSeparator': r'https://PySimpleGUI.org/en/latest/call%20reference/#verticalseparator-element',
'Window': r'https://PySimpleGUI.org/en/latest/call%20reference/#window',
}
NOT_AN_ELEMENT = 'Not An Element'
@ -25246,7 +25262,7 @@ def main():
elif event == 'Get Text':
popup_scrolled('Returned:', popup_get_text('Enter some text', keep_on_top=True))
elif event.startswith('-UDEMY-'):
webbrowser.open_new_tab(r'https://udemy.com/PySimpleGUI')
webbrowser.open_new_tab(r'https://www.udemy.com/course/pysimplegui/?couponCode=F006AC77434776717B42')
elif event.startswith('-SPONSOR-'):
if webbrowser_available:
webbrowser.open_new_tab(r'https://www.paypal.me/pythongui')
@ -25255,7 +25271,7 @@ def main():
# webbrowser.open_new_tab(r'https://udemy.com/PySimpleGUI')
webbrowser.open_new_tab(r'https://www.buymeacoffee.com/PySimpleGUI')
elif event in ('-EMOJI-HEARTS-', '-HEART-', '-PYTHON HEARTS-'):
popup_scrolled("Oh look! It's a Udemy discount coupon!", 'D11B305A347585E7A915',
popup_scrolled("Oh look! It's a Udemy discount coupon!", 'F006AC77434776717B42',
'A personal message from Mike -- thank you so very much for supporting PySimpleGUI!', title='Udemy Coupon', image=EMOJI_BASE64_MIKE, keep_on_top=True)
elif event == 'Themes':
@ -25412,4 +25428,4 @@ if __name__ == '__main__':
exit(0)
main()
exit(0)
#58ea5183ca79b8f5c06d39a6767647bc90503b97f3440920f0f73bd13c61cf1119d3149b8c9f08dc7bfa4f04779b7f29581180b8d6b24f115838b1d2ecb2042aeba20b3722a1406b77f701e0b5f2f12e9e2365e0700356918a3e271d85f9501479785fc3f858553c787406d06b80b197106d6439f8f2516800a500dc0024aed92998c8b10fae87c4ee935dfcae6d9a9fa8abc2957ce8bc7ce875510a18674a251c0f2ca00d53de99c0fe32e90a8d9ac50494ea6ff84cd03951ed69402dec1e5554760444c87e1c0f97d12f954ec6b60a269d0b21c17b36d432b3771b83e72be99e95addb256eca43f9e6fe681672ea33747c738492f0fb666077e37dd15a7890cc5d2b8b830ef11d6d6f76a7a5611b4d7dd2e0cc00d60319d794d3201669500524ad6245cfab7c5fa5610f0144f58899fe20cc76644f5f3c2e24badd54148aa33dc9f13407c02c617098bec4012a460f99314c5186ebeb35f68849f656be5f148acb2133367144df77c34ff182704b61297d9efcaa5ab67065a515e4d8b1454b4d5da9b32074a81001d7b6aa5c482a2fcb7215ea4bcabfb5135e3bfdee1b7466d97fd2521d229ea2379251dd64d46f8f45696639d3917fdc4c3eabb78d7a94df46c6df2232efc43a25c6aaaefa7a308945c5acdf2452ab7169083e303875c78c676540c9ac27a44be4d070aa7b2c1410d744cefb620c88548eb152598a8beac8
#68a54aeb138ba611cf9ca53347b1a7ef07af5cdb74e99c8a7652f464e1998797c6467a225850596d7edb0b63441a9effb96f5d9b376224e1b9d9d1b866576481e520e93bf7ea1d72846773da8a7695554a96cedc400b3b695df2c34659fe843fe6e7a661685786970b0a162aa8e8a3ba3bb14cd23a62f056ccda985de35d5827b595ffef9cbe3029edcd20f34f258791e28f287f7c2a4c9689da3198ac3dc95ddc4ada459225ae69e8dfbd202cd0d5fd517366f5cf37fa6a659765f333d6e1a3e80db1a5156dc088b742c63fa4f39da0154e8d2f69de460c4d54958df71416b624ac752d5f4f985bbaf36bd1db21d57c019aade66c5f8d3d3de8ea477766f105dffbf8d812fc56a8b64460831601956dbaa6126d6e505c826c17929fb73ff7e84bfd88d1cddd60079a983fec8ddae81ed42926fd3440b8cb6fd557fcf7750cf4b4ee6ddf31e9fe766f74af7c6b5db70075a8ff121d50f696fe84552f303103a4191dd8c9cb65559a673c05ca95c4300ba858c2a33a6067f9c0b2da44f51f81efd3d51bd2d60386f1f8e7196dedc9054b751ec354ade30604f50cbea77f467b9bc7d11e482a41f72e1cc8c7c3d385ccea604f4c3b110d8fa7d4ca732971a875e483ecf42927f2be67f66bc564cc26b326d9c3507309cfba106694b018dad513a51e7ae44d7158d5c552898b3bd3c1096b6d0139ec524a0b5202efbced81d3b586

262
docs/call reference.md
View File

@ -19856,76 +19856,79 @@ set_options(icon = None,
sbar_arrow_width = None,
sbar_frame_color = None,
sbar_relief = None,
alpha_channel = None)
alpha_channel = None,
hide_window_when_creating = None)
```
Parameter Descriptions:
|Type|Name|Meaning|
|--|--|--|
| bytes or str | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's |
| (str, str) or str | button_color | Color of the button (text, background) |
| (int, int) | element_size | element size (width, height) in characters |
| (int, int) | button_element_size | Size of button |
| (int, int) | margins | (left/right, top/bottom) tkinter margins around outsize. Amount of pixels to leave inside the window's frame around the edges before your elements are shown. |
| (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) |
| bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show |
| bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. |
| (str or (str, int[, str]) or None) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
| int | border_width | width of border around element |
| int | slider_border_width | Width of the border around sliders |
| str | slider_relief | Type of relief to use for sliders |
| ??? | slider_orientation | ??? |
| ??? | autoclose_time | ??? |
| ??? | message_box_line_width | ??? |
| ??? | progress_meter_border_depth | ??? |
| ??? | progress_meter_style | You can no longer set a progress bar style. All ttk styles must be the same for the window |
| ??? | progress_meter_relief | |
| ??? | progress_meter_color | ??? |
| ??? | progress_meter_size | ??? |
| 'left' or 'right' or 'center' | text_justification | Default text justification for all Text Elements in window |
| str | background_color | color of background |
| str | element_background_color | element background color |
| str | text_element_background_color | text element background color |
| str | input_elements_background_color | Default color to use for the background of input elements |
| str | input_text_color | Default color to use for the text for Input elements |
| str | scrollbar_color | Default color to use for the slider trough |
| str | text_color | color of the text |
| str | element_text_color | Default color to use for Text elements |
| (int, int) | debug_win_size | window size |
| (int, int) or None | window_location | Default location to place windows. Not setting will center windows on the display |
| ??? | error_button_color | (Default = (None)) |
| int | tooltip_time | time in milliseconds to wait before showing a tooltip. Default is 400ms |
| str or Tuple[str, int] or Tuple[str, int, str] | tooltip_font | font to use for all tooltips |
| bool | use_ttk_buttons | if True will cause all buttons to be ttk buttons |
| str | ttk_theme | Theme to use with ttk widgets. Choices (on Windows) include - 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' |
| bool | suppress_error_popups | If True then error popups will not be shown if generated internally to PySimpleGUI |
| bool | suppress_raise_key_errors | If True then key errors won't be raised (you'll still get popup error) |
| bool | suppress_key_guessing | If True then key errors won't try and find closest matches for you |
| bool | warn_button_key_duplicates | If True then duplicate Button Keys generate warnings (not recommended as they're expected) |
| bool | enable_treeview_869_patch | If True, then will use the treeview color patch for tk 8.6.9 |
| bool | enable_mac_notitlebar_patch | If True then Windows with no titlebar use an alternative technique when tkinter version < 8.6.10 |
| bool | use_custom_titlebar | If True then a custom titlebar is used instead of the normal system titlebar |
| str or None | titlebar_background_color | If custom titlebar indicated by use_custom_titlebar, then use this as background color |
| str or None | titlebar_text_color | If custom titlebar indicated by use_custom_titlebar, then use this as text color |
| (str or (str, int[, str]) or None) or None | titlebar_font | If custom titlebar indicated by use_custom_titlebar, then use this as title font |
| bytes or str | titlebar_icon | If custom titlebar indicated by use_custom_titlebar, then use this as the icon (file or base64 bytes) |
| str | user_settings_path | default path for user_settings API calls. Expanded with os.path.expanduser so can contain ~ to represent user |
| str | pysimplegui_settings_path | default path for the global PySimpleGUI user_settings |
| str | pysimplegui_settings_filename | default filename for the global PySimpleGUI user_settings |
| bool | keep_on_top | If True then all windows will automatically be set to keep_on_top=True |
| bool | dpi_awareness | If True then will turn on DPI awareness (Windows only at the moment) |
| float | scaling | Sets the default scaling for all windows including popups, etc. |
| bool | disable_modal_windows | If True then all windows, including popups, will not be modal windows (unless they've been set to FORCED using another option) |
| bool | force_modal_windows | If True then all windows will be modal (the disable option will be ignored... all windows will be forced to be modal) |
| ((None, None) or (int, int)) | tooltip_offset | Offset to use for tooltips as a tuple. These values will be added to the mouse location when the widget was entered. |
| str | sbar_trough_color | Scrollbar color of the trough |
| str | 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 |
| str | 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 |
| int | sbar_width | Scrollbar width in pixels |
| int | sbar_arrow_width | Scrollbar width of the arrow on the scrollbar. It will potentially impact the overall width of the scrollbar |
| str | sbar_frame_color | Scrollbar Color of frame around scrollbar (available only on some ttk themes) |
| type sbar_relief: (str) | 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 :param alpha_channel Default alpha channel to be used on all windows |
| bytes or str | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's |
| (str, str) or str | button_color | Color of the button (text, background) |
| (int, int) | element_size | element size (width, height) in characters |
| (int, int) | button_element_size | Size of button |
| (int, int) | margins | (left/right, top/bottom) tkinter margins around outsize. Amount of pixels to leave inside the window's frame around the edges before your elements are shown. |
| (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) |
| bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show |
| bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. |
| (str or (str, int[, str]) or None) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
| int | border_width | width of border around element |
| int | slider_border_width | Width of the border around sliders |
| str | slider_relief | Type of relief to use for sliders |
| ??? | slider_orientation | ??? |
| ??? | autoclose_time | ??? |
| ??? | message_box_line_width | ??? |
| ??? | progress_meter_border_depth | ??? |
| ??? | progress_meter_style | You can no longer set a progress bar style. All ttk styles must be the same for the window |
| ??? | progress_meter_relief | |
| ??? | progress_meter_color | ??? |
| ??? | progress_meter_size | ??? |
| 'left' or 'right' or 'center' | text_justification | Default text justification for all Text Elements in window |
| str | background_color | color of background |
| str | element_background_color | element background color |
| str | text_element_background_color | text element background color |
| str | input_elements_background_color | Default color to use for the background of input elements |
| str | input_text_color | Default color to use for the text for Input elements |
| str | scrollbar_color | Default color to use for the slider trough |
| str | text_color | color of the text |
| str | element_text_color | Default color to use for Text elements |
| (int, int) | debug_win_size | window size |
| (int, int) or None | window_location | Default location to place windows. Not setting will center windows on the display |
| ??? | error_button_color | (Default = (None)) |
| int | tooltip_time | time in milliseconds to wait before showing a tooltip. Default is 400ms |
| str or Tuple[str, int] or Tuple[str, int, str] | tooltip_font | font to use for all tooltips |
| bool | use_ttk_buttons | if True will cause all buttons to be ttk buttons |
| str | ttk_theme | Theme to use with ttk widgets. Choices (on Windows) include - 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' |
| bool | suppress_error_popups | If True then error popups will not be shown if generated internally to PySimpleGUI |
| bool | suppress_raise_key_errors | If True then key errors won't be raised (you'll still get popup error) |
| bool | suppress_key_guessing | If True then key errors won't try and find closest matches for you |
| bool | warn_button_key_duplicates | If True then duplicate Button Keys generate warnings (not recommended as they're expected) |
| bool | enable_treeview_869_patch | If True, then will use the treeview color patch for tk 8.6.9 |
| bool | enable_mac_notitlebar_patch | If True then Windows with no titlebar use an alternative technique when tkinter version < 8.6.10 |
| bool | use_custom_titlebar | If True then a custom titlebar is used instead of the normal system titlebar |
| str or None | titlebar_background_color | If custom titlebar indicated by use_custom_titlebar, then use this as background color |
| str or None | titlebar_text_color | If custom titlebar indicated by use_custom_titlebar, then use this as text color |
| (str or (str, int[, str]) or None) or None | titlebar_font | If custom titlebar indicated by use_custom_titlebar, then use this as title font |
| bytes or str | titlebar_icon | If custom titlebar indicated by use_custom_titlebar, then use this as the icon (file or base64 bytes) |
| str | user_settings_path | default path for user_settings API calls. Expanded with os.path.expanduser so can contain ~ to represent user |
| str | pysimplegui_settings_path | default path for the global PySimpleGUI user_settings |
| str | pysimplegui_settings_filename | default filename for the global PySimpleGUI user_settings |
| bool | keep_on_top | If True then all windows will automatically be set to keep_on_top=True |
| bool | dpi_awareness | If True then will turn on DPI awareness (Windows only at the moment) |
| float | scaling | Sets the default scaling for all windows including popups, etc. |
| bool | disable_modal_windows | If True then all windows, including popups, will not be modal windows (unless they've been set to FORCED using another option) |
| bool | force_modal_windows | If True then all windows will be modal (the disable option will be ignored... all windows will be forced to be modal) |
| ((None, None) or (int, int)) | tooltip_offset | Offset to use for tooltips as a tuple. These values will be added to the mouse location when the widget was entered. |
| str | sbar_trough_color | Scrollbar color of the trough |
| str | 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 |
| str | 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 |
| int | sbar_width | Scrollbar width in pixels |
| int | sbar_arrow_width | Scrollbar width of the arrow on the scrollbar. It will potentially impact the overall width of the scrollbar |
| str | sbar_frame_color | Scrollbar Color of frame around scrollbar (available only on some ttk themes) |
| str | 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 |
| return: None | alpha_channel Default alpha channel to be used on all windows
| type alpha_channel (float) :param hide_window_when_creating If True then alpha will be set to 0 while a window is made and moved to location indicated |
| None | **RETURN** | None
### Non PEP8 versions
@ -20007,76 +20010,79 @@ SetOptions(icon = None,
sbar_arrow_width = None,
sbar_frame_color = None,
sbar_relief = None,
alpha_channel = None)
alpha_channel = None,
hide_window_when_creating = None)
```
Parameter Descriptions:
|Type|Name|Meaning|
|--|--|--|
| bytes or str | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's |
| (str, str) or str | button_color | Color of the button (text, background) |
| (int, int) | element_size | element size (width, height) in characters |
| (int, int) | button_element_size | Size of button |
| (int, int) | margins | (left/right, top/bottom) tkinter margins around outsize. Amount of pixels to leave inside the window's frame around the edges before your elements are shown. |
| (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) |
| bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show |
| bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. |
| (str or (str, int[, str]) or None) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
| int | border_width | width of border around element |
| int | slider_border_width | Width of the border around sliders |
| str | slider_relief | Type of relief to use for sliders |
| ??? | slider_orientation | ??? |
| ??? | autoclose_time | ??? |
| ??? | message_box_line_width | ??? |
| ??? | progress_meter_border_depth | ??? |
| ??? | progress_meter_style | You can no longer set a progress bar style. All ttk styles must be the same for the window |
| ??? | progress_meter_relief | |
| ??? | progress_meter_color | ??? |
| ??? | progress_meter_size | ??? |
| 'left' or 'right' or 'center' | text_justification | Default text justification for all Text Elements in window |
| str | background_color | color of background |
| str | element_background_color | element background color |
| str | text_element_background_color | text element background color |
| str | input_elements_background_color | Default color to use for the background of input elements |
| str | input_text_color | Default color to use for the text for Input elements |
| str | scrollbar_color | Default color to use for the slider trough |
| str | text_color | color of the text |
| str | element_text_color | Default color to use for Text elements |
| (int, int) | debug_win_size | window size |
| (int, int) or None | window_location | Default location to place windows. Not setting will center windows on the display |
| ??? | error_button_color | (Default = (None)) |
| int | tooltip_time | time in milliseconds to wait before showing a tooltip. Default is 400ms |
| str or Tuple[str, int] or Tuple[str, int, str] | tooltip_font | font to use for all tooltips |
| bool | use_ttk_buttons | if True will cause all buttons to be ttk buttons |
| str | ttk_theme | Theme to use with ttk widgets. Choices (on Windows) include - 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' |
| bool | suppress_error_popups | If True then error popups will not be shown if generated internally to PySimpleGUI |
| bool | suppress_raise_key_errors | If True then key errors won't be raised (you'll still get popup error) |
| bool | suppress_key_guessing | If True then key errors won't try and find closest matches for you |
| bool | warn_button_key_duplicates | If True then duplicate Button Keys generate warnings (not recommended as they're expected) |
| bool | enable_treeview_869_patch | If True, then will use the treeview color patch for tk 8.6.9 |
| bool | enable_mac_notitlebar_patch | If True then Windows with no titlebar use an alternative technique when tkinter version < 8.6.10 |
| bool | use_custom_titlebar | If True then a custom titlebar is used instead of the normal system titlebar |
| str or None | titlebar_background_color | If custom titlebar indicated by use_custom_titlebar, then use this as background color |
| str or None | titlebar_text_color | If custom titlebar indicated by use_custom_titlebar, then use this as text color |
| (str or (str, int[, str]) or None) or None | titlebar_font | If custom titlebar indicated by use_custom_titlebar, then use this as title font |
| bytes or str | titlebar_icon | If custom titlebar indicated by use_custom_titlebar, then use this as the icon (file or base64 bytes) |
| str | user_settings_path | default path for user_settings API calls. Expanded with os.path.expanduser so can contain ~ to represent user |
| str | pysimplegui_settings_path | default path for the global PySimpleGUI user_settings |
| str | pysimplegui_settings_filename | default filename for the global PySimpleGUI user_settings |
| bool | keep_on_top | If True then all windows will automatically be set to keep_on_top=True |
| bool | dpi_awareness | If True then will turn on DPI awareness (Windows only at the moment) |
| float | scaling | Sets the default scaling for all windows including popups, etc. |
| bool | disable_modal_windows | If True then all windows, including popups, will not be modal windows (unless they've been set to FORCED using another option) |
| bool | force_modal_windows | If True then all windows will be modal (the disable option will be ignored... all windows will be forced to be modal) |
| ((None, None) or (int, int)) | tooltip_offset | Offset to use for tooltips as a tuple. These values will be added to the mouse location when the widget was entered. |
| str | sbar_trough_color | Scrollbar color of the trough |
| str | 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 |
| str | 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 |
| int | sbar_width | Scrollbar width in pixels |
| int | sbar_arrow_width | Scrollbar width of the arrow on the scrollbar. It will potentially impact the overall width of the scrollbar |
| str | sbar_frame_color | Scrollbar Color of frame around scrollbar (available only on some ttk themes) |
| type sbar_relief: (str) | 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 :param alpha_channel Default alpha channel to be used on all windows |
| bytes or str | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's |
| (str, str) or str | button_color | Color of the button (text, background) |
| (int, int) | element_size | element size (width, height) in characters |
| (int, int) | button_element_size | Size of button |
| (int, int) | margins | (left/right, top/bottom) tkinter margins around outsize. Amount of pixels to leave inside the window's frame around the edges before your elements are shown. |
| (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) |
| bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show |
| bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. |
| (str or (str, int[, str]) or None) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
| int | border_width | width of border around element |
| int | slider_border_width | Width of the border around sliders |
| str | slider_relief | Type of relief to use for sliders |
| ??? | slider_orientation | ??? |
| ??? | autoclose_time | ??? |
| ??? | message_box_line_width | ??? |
| ??? | progress_meter_border_depth | ??? |
| ??? | progress_meter_style | You can no longer set a progress bar style. All ttk styles must be the same for the window |
| ??? | progress_meter_relief | |
| ??? | progress_meter_color | ??? |
| ??? | progress_meter_size | ??? |
| 'left' or 'right' or 'center' | text_justification | Default text justification for all Text Elements in window |
| str | background_color | color of background |
| str | element_background_color | element background color |
| str | text_element_background_color | text element background color |
| str | input_elements_background_color | Default color to use for the background of input elements |
| str | input_text_color | Default color to use for the text for Input elements |
| str | scrollbar_color | Default color to use for the slider trough |
| str | text_color | color of the text |
| str | element_text_color | Default color to use for Text elements |
| (int, int) | debug_win_size | window size |
| (int, int) or None | window_location | Default location to place windows. Not setting will center windows on the display |
| ??? | error_button_color | (Default = (None)) |
| int | tooltip_time | time in milliseconds to wait before showing a tooltip. Default is 400ms |
| str or Tuple[str, int] or Tuple[str, int, str] | tooltip_font | font to use for all tooltips |
| bool | use_ttk_buttons | if True will cause all buttons to be ttk buttons |
| str | ttk_theme | Theme to use with ttk widgets. Choices (on Windows) include - 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' |
| bool | suppress_error_popups | If True then error popups will not be shown if generated internally to PySimpleGUI |
| bool | suppress_raise_key_errors | If True then key errors won't be raised (you'll still get popup error) |
| bool | suppress_key_guessing | If True then key errors won't try and find closest matches for you |
| bool | warn_button_key_duplicates | If True then duplicate Button Keys generate warnings (not recommended as they're expected) |
| bool | enable_treeview_869_patch | If True, then will use the treeview color patch for tk 8.6.9 |
| bool | enable_mac_notitlebar_patch | If True then Windows with no titlebar use an alternative technique when tkinter version < 8.6.10 |
| bool | use_custom_titlebar | If True then a custom titlebar is used instead of the normal system titlebar |
| str or None | titlebar_background_color | If custom titlebar indicated by use_custom_titlebar, then use this as background color |
| str or None | titlebar_text_color | If custom titlebar indicated by use_custom_titlebar, then use this as text color |
| (str or (str, int[, str]) or None) or None | titlebar_font | If custom titlebar indicated by use_custom_titlebar, then use this as title font |
| bytes or str | titlebar_icon | If custom titlebar indicated by use_custom_titlebar, then use this as the icon (file or base64 bytes) |
| str | user_settings_path | default path for user_settings API calls. Expanded with os.path.expanduser so can contain ~ to represent user |
| str | pysimplegui_settings_path | default path for the global PySimpleGUI user_settings |
| str | pysimplegui_settings_filename | default filename for the global PySimpleGUI user_settings |
| bool | keep_on_top | If True then all windows will automatically be set to keep_on_top=True |
| bool | dpi_awareness | If True then will turn on DPI awareness (Windows only at the moment) |
| float | scaling | Sets the default scaling for all windows including popups, etc. |
| bool | disable_modal_windows | If True then all windows, including popups, will not be modal windows (unless they've been set to FORCED using another option) |
| bool | force_modal_windows | If True then all windows will be modal (the disable option will be ignored... all windows will be forced to be modal) |
| ((None, None) or (int, int)) | tooltip_offset | Offset to use for tooltips as a tuple. These values will be added to the mouse location when the widget was entered. |
| str | sbar_trough_color | Scrollbar color of the trough |
| str | 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 |
| str | 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 |
| int | sbar_width | Scrollbar width in pixels |
| int | sbar_arrow_width | Scrollbar width of the arrow on the scrollbar. It will potentially impact the overall width of the scrollbar |
| str | sbar_frame_color | Scrollbar Color of frame around scrollbar (available only on some ttk themes) |
| str | 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 |
| return: None | alpha_channel Default alpha channel to be used on all windows
| type alpha_channel (float) :param hide_window_when_creating If True then alpha will be set to 0 while a window is made and moved to location indicated |
| None | **RETURN** | None
## Old Themes (Look and Feel) - Replaced by theme()

4
docs/cookbook.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;">
apply coupon for discount:
</span>
D11B305A347585E7A915
F006AC77434776717B42
</div>
<button style="margin: 0 auto; display: block; width: 200px; height: 70px; border-radius: 14px; border: none; padding: 10px; font-size: 18px; background-color: #357296; color: white; cursor: pointer;" onclick="window.open('https://www.udemy.com/course/pysimplegui/?couponCode=D11B305A347585E7A915','_blank');">
<button style="margin: 0 auto; display: block; width: 200px; height: 70px; border-radius: 14px; border: none; padding: 10px; font-size: 18px; background-color: #357296; color: white; cursor: pointer;" onclick="window.open('https://www.udemy.com/course/pysimplegui/?couponCode=F006AC77434776717B42','_blank');">
click here to visit course page
</button>
</div>

4
docs/index.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;">
apply coupon for discount:
</span>
D11B305A347585E7A915
F006AC77434776717B42
</div>
<button style="margin: 0 auto; display: block; width: 200px; height: 70px; border-radius: 14px; border: none; padding: 10px; font-size: 18px; background-color: #357296; color: white; cursor: pointer;" onclick="window.open('https://www.udemy.com/course/pysimplegui/?couponCode=D11B305A347585E7A915','_blank');">
<button style="margin: 0 auto; display: block; width: 200px; height: 70px; border-radius: 14px; border: none; padding: 10px; font-size: 18px; background-color: #357296; color: white; cursor: pointer;" onclick="window.open('https://www.udemy.com/course/pysimplegui/?couponCode=F006AC77434776717B42','_blank');">
click here to visit course page
</button>
</div>

4
docs/readme.md
View File

@ -9,8 +9,8 @@
<img src="https://www.dropbox.com/s/6wzf3ebmj97v4zs/PySimpleGUI-GitHub-Udemy-Course.png?raw=1" width=200 alt="PySimpleGUI Udemy Course">
</td>
<td>
<h5>apply coupon for discount:<br>D11B305A347585E7A915</h6>
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=D11B305A347585E7A915">click here to visit course page</a>
<h5>apply coupon for discount:<br>F006AC77434776717B42</h6>
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=F006AC77434776717B42">click here to visit course page</a>
</td>
</tr>
</table>

4
readme.md
View File

@ -9,8 +9,8 @@
<img src="https://www.dropbox.com/s/6wzf3ebmj97v4zs/PySimpleGUI-GitHub-Udemy-Course.png?raw=1" width=200 alt="PySimpleGUI Udemy Course">
</td>
<td>
<h5>apply coupon for discount:<br>D11B305A347585E7A915</h6>
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=D11B305A347585E7A915">click here to visit course page</a>
<h5>apply coupon for discount:<br>F006AC77434776717B42</h6>
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=F006AC77434776717B42">click here to visit course page</a>
</td>
</tr>
</table>

4
readme_creator/markdown input files/1_HEADER_top_part.md
View File

@ -52,9 +52,9 @@ HOW DO I INSERT IMAGES ???
<span style="font-weight: normal;">
apply coupon for discount:
</span>
D11B305A347585E7A915
F006AC77434776717B42
</div>
<button style="margin: 0 auto; display: block; width: 200px; height: 70px; border-radius: 14px; border: none; padding: 10px; font-size: 18px; background-color: #357296; color: white; cursor: pointer;" onclick="window.open('https://www.udemy.com/course/pysimplegui/?couponCode=D11B305A347585E7A915','_blank');">
<button style="margin: 0 auto; display: block; width: 200px; height: 70px; border-radius: 14px; border: none; padding: 10px; font-size: 18px; background-color: #357296; color: white; cursor: pointer;" onclick="window.open('https://www.udemy.com/course/pysimplegui/?couponCode=F006AC77434776717B42','_blank');">
click here to visit course page
</button>
</div>

262
readme_creator/output/call reference.md
View File

@ -19856,76 +19856,79 @@ set_options(icon = None,
sbar_arrow_width = None,
sbar_frame_color = None,
sbar_relief = None,
alpha_channel = None)
alpha_channel = None,
hide_window_when_creating = None)
```
Parameter Descriptions:
|Type|Name|Meaning|
|--|--|--|
| bytes or str | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's |
| (str, str) or str | button_color | Color of the button (text, background) |
| (int, int) | element_size | element size (width, height) in characters |
| (int, int) | button_element_size | Size of button |
| (int, int) | margins | (left/right, top/bottom) tkinter margins around outsize. Amount of pixels to leave inside the window's frame around the edges before your elements are shown. |
| (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) |
| bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show |
| bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. |
| (str or (str, int[, str]) or None) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
| int | border_width | width of border around element |
| int | slider_border_width | Width of the border around sliders |
| str | slider_relief | Type of relief to use for sliders |
| ??? | slider_orientation | ??? |
| ??? | autoclose_time | ??? |
| ??? | message_box_line_width | ??? |
| ??? | progress_meter_border_depth | ??? |
| ??? | progress_meter_style | You can no longer set a progress bar style. All ttk styles must be the same for the window |
| ??? | progress_meter_relief | |
| ??? | progress_meter_color | ??? |
| ??? | progress_meter_size | ??? |
| 'left' or 'right' or 'center' | text_justification | Default text justification for all Text Elements in window |
| str | background_color | color of background |
| str | element_background_color | element background color |
| str | text_element_background_color | text element background color |
| str | input_elements_background_color | Default color to use for the background of input elements |
| str | input_text_color | Default color to use for the text for Input elements |
| str | scrollbar_color | Default color to use for the slider trough |
| str | text_color | color of the text |
| str | element_text_color | Default color to use for Text elements |
| (int, int) | debug_win_size | window size |
| (int, int) or None | window_location | Default location to place windows. Not setting will center windows on the display |
| ??? | error_button_color | (Default = (None)) |
| int | tooltip_time | time in milliseconds to wait before showing a tooltip. Default is 400ms |
| str or Tuple[str, int] or Tuple[str, int, str] | tooltip_font | font to use for all tooltips |
| bool | use_ttk_buttons | if True will cause all buttons to be ttk buttons |
| str | ttk_theme | Theme to use with ttk widgets. Choices (on Windows) include - 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' |
| bool | suppress_error_popups | If True then error popups will not be shown if generated internally to PySimpleGUI |
| bool | suppress_raise_key_errors | If True then key errors won't be raised (you'll still get popup error) |
| bool | suppress_key_guessing | If True then key errors won't try and find closest matches for you |
| bool | warn_button_key_duplicates | If True then duplicate Button Keys generate warnings (not recommended as they're expected) |
| bool | enable_treeview_869_patch | If True, then will use the treeview color patch for tk 8.6.9 |
| bool | enable_mac_notitlebar_patch | If True then Windows with no titlebar use an alternative technique when tkinter version < 8.6.10 |
| bool | use_custom_titlebar | If True then a custom titlebar is used instead of the normal system titlebar |
| str or None | titlebar_background_color | If custom titlebar indicated by use_custom_titlebar, then use this as background color |
| str or None | titlebar_text_color | If custom titlebar indicated by use_custom_titlebar, then use this as text color |
| (str or (str, int[, str]) or None) or None | titlebar_font | If custom titlebar indicated by use_custom_titlebar, then use this as title font |
| bytes or str | titlebar_icon | If custom titlebar indicated by use_custom_titlebar, then use this as the icon (file or base64 bytes) |
| str | user_settings_path | default path for user_settings API calls. Expanded with os.path.expanduser so can contain ~ to represent user |
| str | pysimplegui_settings_path | default path for the global PySimpleGUI user_settings |
| str | pysimplegui_settings_filename | default filename for the global PySimpleGUI user_settings |
| bool | keep_on_top | If True then all windows will automatically be set to keep_on_top=True |
| bool | dpi_awareness | If True then will turn on DPI awareness (Windows only at the moment) |
| float | scaling | Sets the default scaling for all windows including popups, etc. |
| bool | disable_modal_windows | If True then all windows, including popups, will not be modal windows (unless they've been set to FORCED using another option) |
| bool | force_modal_windows | If True then all windows will be modal (the disable option will be ignored... all windows will be forced to be modal) |
| ((None, None) or (int, int)) | tooltip_offset | Offset to use for tooltips as a tuple. These values will be added to the mouse location when the widget was entered. |
| str | sbar_trough_color | Scrollbar color of the trough |
| str | 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 |
| str | 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 |
| int | sbar_width | Scrollbar width in pixels |
| int | sbar_arrow_width | Scrollbar width of the arrow on the scrollbar. It will potentially impact the overall width of the scrollbar |
| str | sbar_frame_color | Scrollbar Color of frame around scrollbar (available only on some ttk themes) |
| type sbar_relief: (str) | 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 :param alpha_channel Default alpha channel to be used on all windows |
| bytes or str | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's |
| (str, str) or str | button_color | Color of the button (text, background) |
| (int, int) | element_size | element size (width, height) in characters |
| (int, int) | button_element_size | Size of button |
| (int, int) | margins | (left/right, top/bottom) tkinter margins around outsize. Amount of pixels to leave inside the window's frame around the edges before your elements are shown. |
| (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) |
| bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show |
| bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. |
| (str or (str, int[, str]) or None) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
| int | border_width | width of border around element |
| int | slider_border_width | Width of the border around sliders |
| str | slider_relief | Type of relief to use for sliders |
| ??? | slider_orientation | ??? |
| ??? | autoclose_time | ??? |
| ??? | message_box_line_width | ??? |
| ??? | progress_meter_border_depth | ??? |
| ??? | progress_meter_style | You can no longer set a progress bar style. All ttk styles must be the same for the window |
| ??? | progress_meter_relief | |
| ??? | progress_meter_color | ??? |
| ??? | progress_meter_size | ??? |
| 'left' or 'right' or 'center' | text_justification | Default text justification for all Text Elements in window |
| str | background_color | color of background |
| str | element_background_color | element background color |
| str | text_element_background_color | text element background color |
| str | input_elements_background_color | Default color to use for the background of input elements |
| str | input_text_color | Default color to use for the text for Input elements |
| str | scrollbar_color | Default color to use for the slider trough |
| str | text_color | color of the text |
| str | element_text_color | Default color to use for Text elements |
| (int, int) | debug_win_size | window size |
| (int, int) or None | window_location | Default location to place windows. Not setting will center windows on the display |
| ??? | error_button_color | (Default = (None)) |
| int | tooltip_time | time in milliseconds to wait before showing a tooltip. Default is 400ms |
| str or Tuple[str, int] or Tuple[str, int, str] | tooltip_font | font to use for all tooltips |
| bool | use_ttk_buttons | if True will cause all buttons to be ttk buttons |
| str | ttk_theme | Theme to use with ttk widgets. Choices (on Windows) include - 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' |
| bool | suppress_error_popups | If True then error popups will not be shown if generated internally to PySimpleGUI |
| bool | suppress_raise_key_errors | If True then key errors won't be raised (you'll still get popup error) |
| bool | suppress_key_guessing | If True then key errors won't try and find closest matches for you |
| bool | warn_button_key_duplicates | If True then duplicate Button Keys generate warnings (not recommended as they're expected) |
| bool | enable_treeview_869_patch | If True, then will use the treeview color patch for tk 8.6.9 |
| bool | enable_mac_notitlebar_patch | If True then Windows with no titlebar use an alternative technique when tkinter version < 8.6.10 |
| bool | use_custom_titlebar | If True then a custom titlebar is used instead of the normal system titlebar |
| str or None | titlebar_background_color | If custom titlebar indicated by use_custom_titlebar, then use this as background color |
| str or None | titlebar_text_color | If custom titlebar indicated by use_custom_titlebar, then use this as text color |
| (str or (str, int[, str]) or None) or None | titlebar_font | If custom titlebar indicated by use_custom_titlebar, then use this as title font |
| bytes or str | titlebar_icon | If custom titlebar indicated by use_custom_titlebar, then use this as the icon (file or base64 bytes) |
| str | user_settings_path | default path for user_settings API calls. Expanded with os.path.expanduser so can contain ~ to represent user |
| str | pysimplegui_settings_path | default path for the global PySimpleGUI user_settings |
| str | pysimplegui_settings_filename | default filename for the global PySimpleGUI user_settings |
| bool | keep_on_top | If True then all windows will automatically be set to keep_on_top=True |
| bool | dpi_awareness | If True then will turn on DPI awareness (Windows only at the moment) |
| float | scaling | Sets the default scaling for all windows including popups, etc. |
| bool | disable_modal_windows | If True then all windows, including popups, will not be modal windows (unless they've been set to FORCED using another option) |
| bool | force_modal_windows | If True then all windows will be modal (the disable option will be ignored... all windows will be forced to be modal) |
| ((None, None) or (int, int)) | tooltip_offset | Offset to use for tooltips as a tuple. These values will be added to the mouse location when the widget was entered. |
| str | sbar_trough_color | Scrollbar color of the trough |
| str | 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 |
| str | 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 |
| int | sbar_width | Scrollbar width in pixels |
| int | sbar_arrow_width | Scrollbar width of the arrow on the scrollbar. It will potentially impact the overall width of the scrollbar |
| str | sbar_frame_color | Scrollbar Color of frame around scrollbar (available only on some ttk themes) |
| str | 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 |
| return: None | alpha_channel Default alpha channel to be used on all windows
| type alpha_channel (float) :param hide_window_when_creating If True then alpha will be set to 0 while a window is made and moved to location indicated |
| None | **RETURN** | None
### Non PEP8 versions
@ -20007,76 +20010,79 @@ SetOptions(icon = None,
sbar_arrow_width = None,
sbar_frame_color = None,
sbar_relief = None,
alpha_channel = None)
alpha_channel = None,
hide_window_when_creating = None)
```
Parameter Descriptions:
|Type|Name|Meaning|
|--|--|--|
| bytes or str | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's |
| (str, str) or str | button_color | Color of the button (text, background) |
| (int, int) | element_size | element size (width, height) in characters |
| (int, int) | button_element_size | Size of button |
| (int, int) | margins | (left/right, top/bottom) tkinter margins around outsize. Amount of pixels to leave inside the window's frame around the edges before your elements are shown. |
| (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) |
| bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show |
| bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. |
| (str or (str, int[, str]) or None) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
| int | border_width | width of border around element |
| int | slider_border_width | Width of the border around sliders |
| str | slider_relief | Type of relief to use for sliders |
| ??? | slider_orientation | ??? |
| ??? | autoclose_time | ??? |
| ??? | message_box_line_width | ??? |
| ??? | progress_meter_border_depth | ??? |
| ??? | progress_meter_style | You can no longer set a progress bar style. All ttk styles must be the same for the window |
| ??? | progress_meter_relief | |
| ??? | progress_meter_color | ??? |
| ??? | progress_meter_size | ??? |
| 'left' or 'right' or 'center' | text_justification | Default text justification for all Text Elements in window |
| str | background_color | color of background |
| str | element_background_color | element background color |
| str | text_element_background_color | text element background color |
| str | input_elements_background_color | Default color to use for the background of input elements |
| str | input_text_color | Default color to use for the text for Input elements |
| str | scrollbar_color | Default color to use for the slider trough |
| str | text_color | color of the text |
| str | element_text_color | Default color to use for Text elements |
| (int, int) | debug_win_size | window size |
| (int, int) or None | window_location | Default location to place windows. Not setting will center windows on the display |
| ??? | error_button_color | (Default = (None)) |
| int | tooltip_time | time in milliseconds to wait before showing a tooltip. Default is 400ms |
| str or Tuple[str, int] or Tuple[str, int, str] | tooltip_font | font to use for all tooltips |
| bool | use_ttk_buttons | if True will cause all buttons to be ttk buttons |
| str | ttk_theme | Theme to use with ttk widgets. Choices (on Windows) include - 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' |
| bool | suppress_error_popups | If True then error popups will not be shown if generated internally to PySimpleGUI |
| bool | suppress_raise_key_errors | If True then key errors won't be raised (you'll still get popup error) |
| bool | suppress_key_guessing | If True then key errors won't try and find closest matches for you |
| bool | warn_button_key_duplicates | If True then duplicate Button Keys generate warnings (not recommended as they're expected) |
| bool | enable_treeview_869_patch | If True, then will use the treeview color patch for tk 8.6.9 |
| bool | enable_mac_notitlebar_patch | If True then Windows with no titlebar use an alternative technique when tkinter version < 8.6.10 |
| bool | use_custom_titlebar | If True then a custom titlebar is used instead of the normal system titlebar |
| str or None | titlebar_background_color | If custom titlebar indicated by use_custom_titlebar, then use this as background color |
| str or None | titlebar_text_color | If custom titlebar indicated by use_custom_titlebar, then use this as text color |
| (str or (str, int[, str]) or None) or None | titlebar_font | If custom titlebar indicated by use_custom_titlebar, then use this as title font |
| bytes or str | titlebar_icon | If custom titlebar indicated by use_custom_titlebar, then use this as the icon (file or base64 bytes) |
| str | user_settings_path | default path for user_settings API calls. Expanded with os.path.expanduser so can contain ~ to represent user |
| str | pysimplegui_settings_path | default path for the global PySimpleGUI user_settings |
| str | pysimplegui_settings_filename | default filename for the global PySimpleGUI user_settings |
| bool | keep_on_top | If True then all windows will automatically be set to keep_on_top=True |
| bool | dpi_awareness | If True then will turn on DPI awareness (Windows only at the moment) |
| float | scaling | Sets the default scaling for all windows including popups, etc. |
| bool | disable_modal_windows | If True then all windows, including popups, will not be modal windows (unless they've been set to FORCED using another option) |
| bool | force_modal_windows | If True then all windows will be modal (the disable option will be ignored... all windows will be forced to be modal) |
| ((None, None) or (int, int)) | tooltip_offset | Offset to use for tooltips as a tuple. These values will be added to the mouse location when the widget was entered. |
| str | sbar_trough_color | Scrollbar color of the trough |
| str | 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 |
| str | 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 |
| int | sbar_width | Scrollbar width in pixels |
| int | sbar_arrow_width | Scrollbar width of the arrow on the scrollbar. It will potentially impact the overall width of the scrollbar |
| str | sbar_frame_color | Scrollbar Color of frame around scrollbar (available only on some ttk themes) |
| type sbar_relief: (str) | 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 :param alpha_channel Default alpha channel to be used on all windows |
| bytes or str | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's |
| (str, str) or str | button_color | Color of the button (text, background) |
| (int, int) | element_size | element size (width, height) in characters |
| (int, int) | button_element_size | Size of button |
| (int, int) | margins | (left/right, top/bottom) tkinter margins around outsize. Amount of pixels to leave inside the window's frame around the edges before your elements are shown. |
| (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) |
| bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show |
| bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. |
| (str or (str, int[, str]) or None) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
| int | border_width | width of border around element |
| int | slider_border_width | Width of the border around sliders |
| str | slider_relief | Type of relief to use for sliders |
| ??? | slider_orientation | ??? |
| ??? | autoclose_time | ??? |
| ??? | message_box_line_width | ??? |
| ??? | progress_meter_border_depth | ??? |
| ??? | progress_meter_style | You can no longer set a progress bar style. All ttk styles must be the same for the window |
| ??? | progress_meter_relief | |
| ??? | progress_meter_color | ??? |
| ??? | progress_meter_size | ??? |
| 'left' or 'right' or 'center' | text_justification | Default text justification for all Text Elements in window |
| str | background_color | color of background |
| str | element_background_color | element background color |
| str | text_element_background_color | text element background color |
| str | input_elements_background_color | Default color to use for the background of input elements |
| str | input_text_color | Default color to use for the text for Input elements |
| str | scrollbar_color | Default color to use for the slider trough |
| str | text_color | color of the text |
| str | element_text_color | Default color to use for Text elements |
| (int, int) | debug_win_size | window size |
| (int, int) or None | window_location | Default location to place windows. Not setting will center windows on the display |
| ??? | error_button_color | (Default = (None)) |
| int | tooltip_time | time in milliseconds to wait before showing a tooltip. Default is 400ms |
| str or Tuple[str, int] or Tuple[str, int, str] | tooltip_font | font to use for all tooltips |
| bool | use_ttk_buttons | if True will cause all buttons to be ttk buttons |
| str | ttk_theme | Theme to use with ttk widgets. Choices (on Windows) include - 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' |
| bool | suppress_error_popups | If True then error popups will not be shown if generated internally to PySimpleGUI |
| bool | suppress_raise_key_errors | If True then key errors won't be raised (you'll still get popup error) |
| bool | suppress_key_guessing | If True then key errors won't try and find closest matches for you |
| bool | warn_button_key_duplicates | If True then duplicate Button Keys generate warnings (not recommended as they're expected) |
| bool | enable_treeview_869_patch | If True, then will use the treeview color patch for tk 8.6.9 |
| bool | enable_mac_notitlebar_patch | If True then Windows with no titlebar use an alternative technique when tkinter version < 8.6.10 |
| bool | use_custom_titlebar | If True then a custom titlebar is used instead of the normal system titlebar |
| str or None | titlebar_background_color | If custom titlebar indicated by use_custom_titlebar, then use this as background color |
| str or None | titlebar_text_color | If custom titlebar indicated by use_custom_titlebar, then use this as text color |
| (str or (str, int[, str]) or None) or None | titlebar_font | If custom titlebar indicated by use_custom_titlebar, then use this as title font |
| bytes or str | titlebar_icon | If custom titlebar indicated by use_custom_titlebar, then use this as the icon (file or base64 bytes) |
| str | user_settings_path | default path for user_settings API calls. Expanded with os.path.expanduser so can contain ~ to represent user |
| str | pysimplegui_settings_path | default path for the global PySimpleGUI user_settings |
| str | pysimplegui_settings_filename | default filename for the global PySimpleGUI user_settings |
| bool | keep_on_top | If True then all windows will automatically be set to keep_on_top=True |
| bool | dpi_awareness | If True then will turn on DPI awareness (Windows only at the moment) |
| float | scaling | Sets the default scaling for all windows including popups, etc. |
| bool | disable_modal_windows | If True then all windows, including popups, will not be modal windows (unless they've been set to FORCED using another option) |
| bool | force_modal_windows | If True then all windows will be modal (the disable option will be ignored... all windows will be forced to be modal) |
| ((None, None) or (int, int)) | tooltip_offset | Offset to use for tooltips as a tuple. These values will be added to the mouse location when the widget was entered. |
| str | sbar_trough_color | Scrollbar color of the trough |
| str | 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 |
| str | 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 |
| int | sbar_width | Scrollbar width in pixels |
| int | sbar_arrow_width | Scrollbar width of the arrow on the scrollbar. It will potentially impact the overall width of the scrollbar |
| str | sbar_frame_color | Scrollbar Color of frame around scrollbar (available only on some ttk themes) |
| str | 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 |
| return: None | alpha_channel Default alpha channel to be used on all windows
| type alpha_channel (float) :param hide_window_when_creating If True then alpha will be set to 0 while a window is made and moved to location indicated |
| None | **RETURN** | None
## Old Themes (Look and Feel) - Replaced by theme()

4
readme_creator/output/index.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;">
apply coupon for discount:
</span>
D11B305A347585E7A915
F006AC77434776717B42
</div>
<button style="margin: 0 auto; display: block; width: 200px; height: 70px; border-radius: 14px; border: none; padding: 10px; font-size: 18px; background-color: #357296; color: white; cursor: pointer;" onclick="window.open('https://www.udemy.com/course/pysimplegui/?couponCode=D11B305A347585E7A915','_blank');">
<button style="margin: 0 auto; display: block; width: 200px; height: 70px; border-radius: 14px; border: none; padding: 10px; font-size: 18px; background-color: #357296; color: white; cursor: pointer;" onclick="window.open('https://www.udemy.com/course/pysimplegui/?couponCode=F006AC77434776717B42','_blank');">
click here to visit course page
</button>
</div>