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

Newest Udemy code

This commit is contained in:
PySimpleGUI 2022-08-28 19:24:24 -04:00
parent e0e1ba855f
commit 30d4241a34
9 changed files with 327 additions and 312 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
PySimpleGUI.py
View File

@ -25461,16 +25461,15 @@ 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://www.udemy.com/course/pysimplegui/?couponCode=F006AC77434776717B42')
webbrowser.open_new_tab(r'https://www.udemy.com/course/pysimplegui/?couponCode=346BC463A0F8759BEF1B')
elif event.startswith('-SPONSOR-'):
if webbrowser_available:
webbrowser.open_new_tab(r'https://www.paypal.me/pythongui')
elif event == '-COFFEE-':
if webbrowser_available:
# 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!", 'F006AC77434776717B42',
popup_scrolled("Oh look! It's a Udemy discount coupon!", '346BC463A0F8759BEF1B',
'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':
@ -25631,4 +25630,4 @@ if __name__ == '__main__':
exit(0)
main()
exit(0)
#42663486b530def72b9a3742b6807f494b9497159f9888a99b3a9ebed9539c24386f7c749635a851014ba58e21cabdd7b7f9873a7abebab37c4fb4f6958af5af3ee06acada854d6251ea26f30af6dea7a78a60958267ab77221191cb8eae5b45cd1d2d353a5558268ede7d23486e6a53ec36a42ecd7a90a4ab85909634f56231eb63facb6c55dc260346d67d2a8528f8af08797e0a4c700a3d1fd0ceedb4d05fcd5f0e66d8f5e50b327833665622f9bb45224fd1fd0f427575a2973df3c95cee107a2f465bda05f8c2fd4a6be095e44bc21ca1fb6a3e69d5a7e877ccdb73a995d15bd40d882618dc95ea9d01c71bd212bd6444108be77087ef767f8560923026e14b450749e08a4723b8e516747db6e1f8097f5ccd11ba2cfe0503682d4eb5ac7c08d54dd9836159c1a3328fe5e670b288b50143ae8440ec447c79f1db25116b2e2a23bd04a79b18024bfd8fe7a297e0a168f374eb730dc9b61ff0fc76b366333eb27ec4bfbfd334367ba322f894618d15b9b9c75e278894bb3ad64eb0a0a900bdc33e040bc68289ac2e8e5c12867d50b7f7ecb32666206bfb39a4832f0dc8ad80ddb6f040d14d0e9157af77e95422a9439658075c117113c60e512ce4e06690cf23fb929de405cd5206d419bd1f0ebc661d9d6f61e62425965c5994755f6a13be328581acee16cb2ac01e01174ace8c4000572e89f77372c3e98e213104de29
#4137380fb91599297f120658a5ff702002e15a5d5dacec6a7cd7e697eb7e31336f7000251eec25ac7d31fb40ca32df7eb5346295dfa17ae97dbb0985ab68737a73ba71d875a37c3b100da05effddd6acdd3a80ac0b0084549432099c2b5772350b0abc7edda8443269190e8dfda5ce49447d696bc730a5aaba618ac9dc0d08fb07f771d413913b6e332127270b43d462890319188aea4f1236c07ababa7d11239e12eb12112f17cef3332f1dede4140e13583b3612da1440d9c042541d3a45e95e66bc47d958e731f95a7fe9c2401abe303108135a20e01c92af8363ae3e252314014d1e5647af77561c193908fd04cc8dda38389b4fad8a1443b5fa0c6dbda1930001749e47d078865dd1b7c44cf25c8b51c56078027e447e15a8ff284709eafa7b6bf45e911da32a52ab7e4be986dced86a8dd99cafc29b8797ce0a316d2f96f72b52468a723371a515337a28b9c047330ddc0bb9f1e3c52d25d1be1147f0a1c487ac384d784ec3eb12fec3d5751efb5f4139c75cac4f4628cab41cdf3c955cd10598a4de4aa99452bc7f4072c87c39cde9e5d8ef44bc7e0723d106db0d314bc903b60f9794f7ef37f31546038933bd2a762fc9c5913f7bcf7eb84f6c6acdee52651963281bf9bb9c6ebe3059c3ba10429e262816f2776b0a62990ff62281363356aaa6efccec90e17e5cf576d4dbda92722a2f3157ecf95487f122e5f8107

304
docs/call reference.md
View File

@ -2458,7 +2458,8 @@ update(value = None,
readonly = None,
font = None,
visible = None,
size = (None, None))
size = (None, None),
select = None)
```
Parameter Descriptions:
@ -2473,6 +2474,7 @@ Parameter Descriptions:
| (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 |
| bool | visible | control visibility of element |
| (int, int) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list |
| bool | select | if True, then the text will be selected, if False then selection will be cleared |
### visible
@ -2561,7 +2563,8 @@ Update(value = None,
readonly = None,
font = None,
visible = None,
size = (None, None))
size = (None, None),
select = None)
```
Parameter Descriptions:
@ -2576,6 +2579,7 @@ Parameter Descriptions:
| (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 |
| bool | visible | control visibility of element |
| (int, int) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list |
| bool | select | if True, then the text will be selected, if False then selection will be cleared |
---------
@ -7170,19 +7174,19 @@ Rather than use the `Output` element, it's recommended that you use the `Multili
You can control which Multiline Element receives your stdout output as well as use the color-print (`cprint`) with a Multiline.
** NOTE - It's recommended to use Multiline Element instead **
Output Element - a multi-lined text area to where stdout, stderr, cprint are rerouted.
Output Element - a multi-lined text area where stdout and stderr are re-routed to.
The Output Element is now based on the Multiline Element. When you make an Output Element, you're
creating a Multiline Element with some specific settings set:
auto_refresh = True
auto_scroll = True
reroute_stdout = True
reroute_stderr = True
reroute_cprint = True
write_only = True
The Multiline Element is the superior and recommended method for showing the output of stdout.
The Multiline Element has been added to significantly while the Output element has not.
If you choose to use a Multiline element to replace an Output element, be sure an turn on the write_only paramter in the Multline
Of course, Output Element continues to operate and be backwards compatible, but you're missing out on
features such as routing the cprint output to the element.
In Apr 2022, the Output Element was switched to be a subclass of the Multiline so that more code will be in common. Nowever
you will not get all of the parms unless you switch to the Multline Specifically
If you choose to use a Multiline element to replace an Output element, be sure an turn on the write_only paramter in the Multiline
so that an item is not included in the values dictionary on every window.read call
```
Output(size = (None, None),
@ -8022,7 +8026,7 @@ Parameter Descriptions:
| (int, int) or (None, None) | 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 |
| (int, int) or (None, None) | size_px | Size in pixels (length, width). Will be used in place of size parm if specified |
| bool | auto_size_text | Not sure why this is here |
| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Easy to remember which is which if you say "ON" between colors. "red" on "green". |
| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Either a tuple of 2 strings or a string. Tuple - (bar, background). A string with 1 color changes the background of the bar only. A string with 2 colors separated by "on" like "red on blue" specifies a red bar on a blue background. |
| str | style | Progress bar style defined as one of these 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' |
| int | border_width | The amount of pixels that go around the outside of the bar |
| str | relief | relief style. Values are same as progress meter relief values. Can be a constant or a string: `RELIEF_RAISED RELIEF_SUNKEN RELIEF_FLAT RELIEF_RIDGE RELIEF_GROOVE RELIEF_SOLID` (Default value = DEFAULT_PROGRESS_BAR_RELIEF) |
@ -16517,7 +16521,7 @@ Parameter Descriptions:
| Any | *args | stuff to output |
| str or int or tuple or object | key | Used to differentiate between mutliple meters. Used to cancel meter early. Now optional as there is a default value for single meters |
| str | orientation | 'horizontal' or 'vertical' ('h' or 'v' work) (Default value = 'vertical' / 'v') |
| Tuple(str, str) | bar_color | color of a bar line |
| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Either a tuple of 2 strings or a string. Tuple - (bar, background). A string with 1 color changes the background of the bar only. A string with 2 colors separated by "on" like "red on blue" specifies a red bar on a blue background. |
| (str, str) or str | button_color | button color (foreground, background) |
| (int, int) | size | (w,h) w=characters-wide, h=rows-high (Default value = DEFAULT_PROGRESS_BAR_SIZE) |
| int | border_width | width of border around element |
@ -16571,7 +16575,7 @@ Parameter Descriptions:
| Any | *args | stuff to output |
| str or int or tuple or object | key | Used to differentiate between mutliple meters. Used to cancel meter early. Now optional as there is a default value for single meters |
| str | orientation | 'horizontal' or 'vertical' ('h' or 'v' work) (Default value = 'vertical' / 'v') |
| Tuple(str, str) | bar_color | color of a bar line |
| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Either a tuple of 2 strings or a string. Tuple - (bar, background). A string with 1 color changes the background of the bar only. A string with 2 colors separated by "on" like "red on blue" specifies a red bar on a blue background. |
| (str, str) or str | button_color | button color (foreground, background) |
| (int, int) | size | (w,h) w=characters-wide, h=rows-high (Default value = DEFAULT_PROGRESS_BAR_SIZE) |
| int | border_width | width of border around element |
@ -19857,78 +19861,80 @@ set_options(icon = None,
sbar_frame_color = None,
sbar_relief = None,
alpha_channel = None,
hide_window_when_creating = None)
hide_window_when_creating = None,
use_button_shortcuts = 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) |
| 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 |
| 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 |
| float | alpha_channel | Default alpha channel to be used on all windows |
| bool | hide_window_when_creating | If True then alpha will be set to 0 while a window is made and moved to location indicated |
| bool | use_button_shortcuts | If True then Shortcut Char will be used with Buttons |
| None | **RETURN** | None
### Non PEP8 versions
@ -20011,78 +20017,80 @@ SetOptions(icon = None,
sbar_frame_color = None,
sbar_relief = None,
alpha_channel = None,
hide_window_when_creating = None)
hide_window_when_creating = None,
use_button_shortcuts = 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) |
| 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 |
| 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 |
| float | alpha_channel | Default alpha channel to be used on all windows |
| bool | hide_window_when_creating | If True then alpha will be set to 0 while a window is made and moved to location indicated |
| bool | use_button_shortcuts | If True then Shortcut Char will be used with Buttons |
| 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>
F006AC77434776717B42
346BC463A0F8759BEF1B
</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=F006AC77434776717B42','_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=346BC463A0F8759BEF1B','_blank');">
click here to visit course page
</button>
</div>

6
docs/index.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;">
apply coupon for discount:
</span>
F006AC77434776717B42
346BC463A0F8759BEF1B
</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=F006AC77434776717B42','_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=346BC463A0F8759BEF1B','_blank');">
click here to visit course page
</button>
</div>
@ -2075,7 +2075,7 @@ Parameter Descriptions:
| Any | *args | stuff to output |
| str or int or tuple or object | key | Used to differentiate between mutliple meters. Used to cancel meter early. Now optional as there is a default value for single meters |
| str | orientation | 'horizontal' or 'vertical' ('h' or 'v' work) (Default value = 'vertical' / 'v') |
| Tuple(str, str) | bar_color | color of a bar line |
| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Either a tuple of 2 strings or a string. Tuple - (bar, background). A string with 1 color changes the background of the bar only. A string with 2 colors separated by "on" like "red on blue" specifies a red bar on a blue background. |
| (str, str) or str | button_color | button color (foreground, background) |
| (int, int) | size | (w,h) w=characters-wide, h=rows-high (Default value = DEFAULT_PROGRESS_BAR_SIZE) |
| int | border_width | width of border around element |

2
docs/readme.md
View File

@ -10,7 +10,7 @@
</td>
<td>
<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>
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=346BC463A0F8759BEF1B">click here to visit course page</a>
</td>
</tr>
</table>

2
readme.md
View File

@ -10,7 +10,7 @@
</td>
<td>
<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>
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=346BC463A0F8759BEF1B">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>
F006AC77434776717B42
346BC463A0F8759BEF1B
</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=F006AC77434776717B42','_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=346BC463A0F8759BEF1B','_blank');">
click here to visit course page
</button>
</div>

304
readme_creator/output/call reference.md
View File

@ -2458,7 +2458,8 @@ update(value = None,
readonly = None,
font = None,
visible = None,
size = (None, None))
size = (None, None),
select = None)
```
Parameter Descriptions:
@ -2473,6 +2474,7 @@ Parameter Descriptions:
| (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 |
| bool | visible | control visibility of element |
| (int, int) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list |
| bool | select | if True, then the text will be selected, if False then selection will be cleared |
### visible
@ -2561,7 +2563,8 @@ Update(value = None,
readonly = None,
font = None,
visible = None,
size = (None, None))
size = (None, None),
select = None)
```
Parameter Descriptions:
@ -2576,6 +2579,7 @@ Parameter Descriptions:
| (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 |
| bool | visible | control visibility of element |
| (int, int) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list |
| bool | select | if True, then the text will be selected, if False then selection will be cleared |
---------
@ -7170,19 +7174,19 @@ Rather than use the `Output` element, it's recommended that you use the `Multili
You can control which Multiline Element receives your stdout output as well as use the color-print (`cprint`) with a Multiline.
** NOTE - It's recommended to use Multiline Element instead **
Output Element - a multi-lined text area to where stdout, stderr, cprint are rerouted.
Output Element - a multi-lined text area where stdout and stderr are re-routed to.
The Output Element is now based on the Multiline Element. When you make an Output Element, you're
creating a Multiline Element with some specific settings set:
auto_refresh = True
auto_scroll = True
reroute_stdout = True
reroute_stderr = True
reroute_cprint = True
write_only = True
The Multiline Element is the superior and recommended method for showing the output of stdout.
The Multiline Element has been added to significantly while the Output element has not.
If you choose to use a Multiline element to replace an Output element, be sure an turn on the write_only paramter in the Multline
Of course, Output Element continues to operate and be backwards compatible, but you're missing out on
features such as routing the cprint output to the element.
In Apr 2022, the Output Element was switched to be a subclass of the Multiline so that more code will be in common. Nowever
you will not get all of the parms unless you switch to the Multline Specifically
If you choose to use a Multiline element to replace an Output element, be sure an turn on the write_only paramter in the Multiline
so that an item is not included in the values dictionary on every window.read call
```
Output(size = (None, None),
@ -8022,7 +8026,7 @@ Parameter Descriptions:
| (int, int) or (None, None) | 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 |
| (int, int) or (None, None) | size_px | Size in pixels (length, width). Will be used in place of size parm if specified |
| bool | auto_size_text | Not sure why this is here |
| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Easy to remember which is which if you say "ON" between colors. "red" on "green". |
| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Either a tuple of 2 strings or a string. Tuple - (bar, background). A string with 1 color changes the background of the bar only. A string with 2 colors separated by "on" like "red on blue" specifies a red bar on a blue background. |
| str | style | Progress bar style defined as one of these 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' |
| int | border_width | The amount of pixels that go around the outside of the bar |
| str | relief | relief style. Values are same as progress meter relief values. Can be a constant or a string: `RELIEF_RAISED RELIEF_SUNKEN RELIEF_FLAT RELIEF_RIDGE RELIEF_GROOVE RELIEF_SOLID` (Default value = DEFAULT_PROGRESS_BAR_RELIEF) |
@ -16517,7 +16521,7 @@ Parameter Descriptions:
| Any | *args | stuff to output |
| str or int or tuple or object | key | Used to differentiate between mutliple meters. Used to cancel meter early. Now optional as there is a default value for single meters |
| str | orientation | 'horizontal' or 'vertical' ('h' or 'v' work) (Default value = 'vertical' / 'v') |
| Tuple(str, str) | bar_color | color of a bar line |
| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Either a tuple of 2 strings or a string. Tuple - (bar, background). A string with 1 color changes the background of the bar only. A string with 2 colors separated by "on" like "red on blue" specifies a red bar on a blue background. |
| (str, str) or str | button_color | button color (foreground, background) |
| (int, int) | size | (w,h) w=characters-wide, h=rows-high (Default value = DEFAULT_PROGRESS_BAR_SIZE) |
| int | border_width | width of border around element |
@ -16571,7 +16575,7 @@ Parameter Descriptions:
| Any | *args | stuff to output |
| str or int or tuple or object | key | Used to differentiate between mutliple meters. Used to cancel meter early. Now optional as there is a default value for single meters |
| str | orientation | 'horizontal' or 'vertical' ('h' or 'v' work) (Default value = 'vertical' / 'v') |
| Tuple(str, str) | bar_color | color of a bar line |
| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Either a tuple of 2 strings or a string. Tuple - (bar, background). A string with 1 color changes the background of the bar only. A string with 2 colors separated by "on" like "red on blue" specifies a red bar on a blue background. |
| (str, str) or str | button_color | button color (foreground, background) |
| (int, int) | size | (w,h) w=characters-wide, h=rows-high (Default value = DEFAULT_PROGRESS_BAR_SIZE) |
| int | border_width | width of border around element |
@ -19857,78 +19861,80 @@ set_options(icon = None,
sbar_frame_color = None,
sbar_relief = None,
alpha_channel = None,
hide_window_when_creating = None)
hide_window_when_creating = None,
use_button_shortcuts = 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) |
| 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 |
| 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 |
| float | alpha_channel | Default alpha channel to be used on all windows |
| bool | hide_window_when_creating | If True then alpha will be set to 0 while a window is made and moved to location indicated |
| bool | use_button_shortcuts | If True then Shortcut Char will be used with Buttons |
| None | **RETURN** | None
### Non PEP8 versions
@ -20011,78 +20017,80 @@ SetOptions(icon = None,
sbar_frame_color = None,
sbar_relief = None,
alpha_channel = None,
hide_window_when_creating = None)
hide_window_when_creating = None,
use_button_shortcuts = 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) |
| 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 |
| 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 |
| float | alpha_channel | Default alpha channel to be used on all windows |
| bool | hide_window_when_creating | If True then alpha will be set to 0 while a window is made and moved to location indicated |
| bool | use_button_shortcuts | If True then Shortcut Char will be used with Buttons |
| None | **RETURN** | None
## Old Themes (Look and Feel) - Replaced by theme()

6
readme_creator/output/index.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;">
apply coupon for discount:
</span>
F006AC77434776717B42
346BC463A0F8759BEF1B
</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=F006AC77434776717B42','_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=346BC463A0F8759BEF1B','_blank');">
click here to visit course page
</button>
</div>
@ -2075,7 +2075,7 @@ Parameter Descriptions:
| Any | *args | stuff to output |
| str or int or tuple or object | key | Used to differentiate between mutliple meters. Used to cancel meter early. Now optional as there is a default value for single meters |
| str | orientation | 'horizontal' or 'vertical' ('h' or 'v' work) (Default value = 'vertical' / 'v') |
| Tuple(str, str) | bar_color | color of a bar line |
| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Either a tuple of 2 strings or a string. Tuple - (bar, background). A string with 1 color changes the background of the bar only. A string with 2 colors separated by "on" like "red on blue" specifies a red bar on a blue background. |
| (str, str) or str | button_color | button color (foreground, background) |
| (int, int) | size | (w,h) w=characters-wide, h=rows-high (Default value = DEFAULT_PROGRESS_BAR_SIZE) |
| int | border_width | width of border around element |