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

Merge pull request #6116 from PySimpleGUI/Dev-latest 

New Udemy coupon
This commit is contained in:
PySimpleGUI 2022-12-23 03:12:28 -05:00 committed by GitHub
parent 05d9773737 e7a6465a08
commit de58236c7a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
10 changed files with 232 additions and 174 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
PySimpleGUI.py
View File

@ -1,6 +1,6 @@
#!/usr/bin/python3 #!/usr/bin/python3
version = __version__ = "4.60.4.129 Unreleased" version = __version__ = "4.60.4.130 Unreleased"
_change_log = """ _change_log = """
Changelog since 4.60.0 released to PyPI on 8-May-2022 Changelog since 4.60.0 released to PyPI on 8-May-2022
@ -325,6 +325,8 @@ _change_log = """
Cleaned up User Settings API code for porting Cleaned up User Settings API code for porting
4.60.4.129 4.60.4.129
button_color parm added to ButtonMenu.update button_color parm added to ButtonMenu.update
4.60.4.130
New coupon
""" """
__version__ = version.split()[0] # For PEP 396 and PEP 345 __version__ = version.split()[0] # For PEP 396 and PEP 345
@ -25889,7 +25891,7 @@ def main():
elif event == 'Get Text': elif event == 'Get Text':
popup_scrolled('Returned:', popup_get_text('Enter some text', keep_on_top=True)) popup_scrolled('Returned:', popup_get_text('Enter some text', keep_on_top=True))
elif event.startswith('-UDEMY-'): elif event.startswith('-UDEMY-'):
webbrowser.open_new_tab(r'https://www.udemy.com/course/pysimplegui/?couponCode=09B234B00A7E89CC8C1F') webbrowser.open_new_tab(r'https://www.udemy.com/course/pysimplegui/?couponCode=266B9C51C90B3728782E')
elif event.startswith('-SPONSOR-'): elif event.startswith('-SPONSOR-'):
if webbrowser_available: if webbrowser_available:
webbrowser.open_new_tab(r'https://www.paypal.me/pythongui') webbrowser.open_new_tab(r'https://www.paypal.me/pythongui')
@ -25897,7 +25899,7 @@ def main():
if webbrowser_available: if webbrowser_available:
webbrowser.open_new_tab(r'https://www.buymeacoffee.com/PySimpleGUI') webbrowser.open_new_tab(r'https://www.buymeacoffee.com/PySimpleGUI')
elif event in ('-EMOJI-HEARTS-', '-HEART-', '-PYTHON HEARTS-'): elif event in ('-EMOJI-HEARTS-', '-HEART-', '-PYTHON HEARTS-'):
popup_scrolled("Oh look! It's a Udemy discount coupon!", '09B234B00A7E89CC8C1F', popup_scrolled("Oh look! It's a Udemy discount coupon!", '266B9C51C90B3728782E',
'A personal message from Mike -- thank you so very much for supporting PySimpleGUI!', title='Udemy Coupon', image=EMOJI_BASE64_MIKE, keep_on_top=True) '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': elif event == 'Themes':
@ -26057,4 +26059,4 @@ if __name__ == '__main__':
exit(0) exit(0)
main() main()
exit(0) exit(0)
#4265de03173912fae7b989bcbfe77953391799eda31755853031dca229d69f7abd97e9e733d21e864c5ec65a07a36a7e916b769ffdff252bc8449890b1a8f8ae3ab99f08edcfbc41b1f13edd1e0e7404096e7113d86147e21617293d0a5a93ed11f92f275bcbfaab8c533acf57d9c02eaaf5e7c59d89ac484fbd40800c395019a0797677115c85207bbef5faf7b964c3a6cb895c252645e3469c580f2673e9083920cf1a1028825f5f2823cd57bb59d5f34e19e483b9903678798fb6f9c48ec8e89708bb80dd73bd1b70795ef9e4b0d7487756483ef19af15d093d8edd95bb3f9cd251492844fc570b6c137c68f6e002dc8b2e63f731faff2e0d5dc51e4d9b37a628a4aa45ec4c8252b031cb753898bc93b649d3b74d7f99eae383c781753a210b384433fee50598d288c9ea7ea6fdfd71eff8aea5eb205a1dd10e5f9647c4ebfc1599d4294cfdc82ec2f33248b8983e272d223732c9f6a783113e39e89536f91e11b2d705ff56ef5bc1a92fe9ab854e86f7c74dfa2ad12229b2b13ee1da8d9c436b1aa7f2bf25c8ea139b65f63ad99cb177d8e265b0e8465606fdafaff7fb65f94800b35aeecf2346db592054855352e210b8ac082cc1e8fbaddac4adbcc25f6f083502b2d0cca72f63c39cf9053a52cee3c5c4b10b4e3010c28f0bd194fa6c3e24c2c0a764df105cba380ff95e3850c15707ed0f91a4b9ad4a64f5e96e37ee #3df9e3c9362e397b5c29836a44814920f2a5d73fc8450ce07fd59d3f7e26e40fd5103b04347218518c85da6621264cdd2039e906fc9a6c5b3f2adf710ec4b7d809f2c7fc69e2580ed9f81bf8ea427eea82e3581ddca3778e0aa9cd82825140166ad5313f06d40c2a4bfe4d77830f2499a8c18ca8877c7a00c363d30caf8307786b5e5a1836c4f75543a0792daa51c78ae50b699858d48e274a15db11fb9294490d147e9a84ee9037707800263e7b27629f7fcd57f4120cf5ee8d91791c8e14905dd9f9f5a2bf411c3111a5fd0015a68119c4c4c15ecc80cece8077aa93ea9b24c2de00b599ce6ba833dc32b3944f430eb6d06b87b710b971fd4cb00cb83def80cf29bb8b1f2926d06c5337336093c78ef3e80fa9b8434990c22883891e29d180f11738a30b46e713ffbe47cca9fb874cf08a3fae9d7b332dc5c4a4df1c892e6c140e0282d71259a723563c8adc1b4931fe94a0ab7e47aa007d7e6ec2b2d6e180c626cae5de82d9621731408a5fb9f742b0d66c64a01a6cc33b2f19cebb12b7027daa590e26bf81d7659bb5f716bec7588b6b136d0070b03351ef201766066dd90023685a75a6eefc0ed60307acbbae4e07e32c56d50b3b88be801cf37da229517c3d1aad042e4f208f9885de55a590ffd77a660852a9114863f7e60d68f72845fe9ce4f0656703a34e0c792fa8cbbb410a194d90e8c9f040e67c39f40d8a59d8

94
docs/call reference.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;"> <span style="font-weight: normal;">
apply coupon for discount: apply coupon for discount:
</span> </span>
09B234B00A7E89CC8C1F 266B9C51C90B3728782E
</div> </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=09B234B00A7E89CC8C1F','_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=266B9C51C90B3728782E','_blank');">
click here to visit course page click here to visit course page
</button> </button>
</div> </div>
@ -120,7 +120,7 @@ Parameter Descriptions:
| (int or None, int or None) or (None, None) or int | size | (w, h) w=characters-wide, h=rows-high. If an int instead of a tuple is supplied, then height is auto-set to 1 | | (int or None, int or None) or (None, None) or int | size | (w, h) w=characters-wide, h=rows-high. If an int instead of a tuple is supplied, then height is auto-set to 1 |
| (int or None, int or None) or (None, None) or int | 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 or None, int or None) or (None, None) or int | 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 |
| bool | auto_size_button | if True the button size is sized to fit the text | | bool | auto_size_button | if True the button size is sized to fit the text |
| (str, str) or str or (int, int) or None | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. | | (str, str) or str | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. |
| (str, str) or str | disabled_button_color | colors to use when button is disabled (text, background). Use None for a color if don't want to change. Only ttk buttons support both text and background colors. tk buttons only support changing text color | | (str, str) or str | disabled_button_color | colors to use when button is disabled (text, background). Use None for a color if don't want to change. Only ttk buttons support both text and background colors. tk buttons only support changing text color |
| (str, str) | highlight_colors | colors to use when button has focus (has focus, does not have focus). None will use colors based on theme. Only used by Linux and only for non-TTK button | | (str, str) | highlight_colors | colors to use when button has focus (has focus, does not have focus). None will use colors based on theme. Only used by Linux and only for non-TTK button |
| (str, str) or str | mouseover_colors | Important difference between Linux & Windows! Linux - Colors when mouse moved over button. Windows - colors when button is pressed. The default is to switch the text and background colors (an inverse effect) | | (str, str) or str | mouseover_colors | Important difference between Linux & Windows! Linux - Colors when mouse moved over button. Windows - colors when button is pressed. The default is to switch the text and background colors (an inverse effect) |
@ -417,7 +417,7 @@ Parameter Descriptions:
|Type|Name|Meaning| |Type|Name|Meaning|
|--|--|--| |--|--|--|
| str | text | sets button text | | str | text | sets button text |
| (str, str) or str or (int, int) or None | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. | | (str, str) or str | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. |
| (bool or str) | disabled | True/False to enable/disable at the GUI level. Use BUTTON_DISABLED_MEANS_IGNORE to ignore clicks (won't change colors) | | (bool or str) | disabled | True/False to enable/disable at the GUI level. Use BUTTON_DISABLED_MEANS_IGNORE to ignore clicks (won't change colors) |
| (str or bytes) | image_source | Image to place on button. Use INSTEAD of the image_filename and image_data. Unifies these into 1 easier to use parm | | (str or bytes) | image_source | Image to place on button. Use INSTEAD of the image_filename and image_data. Unifies these into 1 easier to use parm |
| bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data | | bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data |
@ -531,7 +531,7 @@ Parameter Descriptions:
|Type|Name|Meaning| |Type|Name|Meaning|
|--|--|--| |--|--|--|
| str | text | sets button text | | str | text | sets button text |
| (str, str) or str or (int, int) or None | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. | | (str, str) or str | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. |
| (bool or str) | disabled | True/False to enable/disable at the GUI level. Use BUTTON_DISABLED_MEANS_IGNORE to ignore clicks (won't change colors) | | (bool or str) | disabled | True/False to enable/disable at the GUI level. Use BUTTON_DISABLED_MEANS_IGNORE to ignore clicks (won't change colors) |
| (str or bytes) | image_source | Image to place on button. Use INSTEAD of the image_filename and image_data. Unifies these into 1 easier to use parm | | (str or bytes) | image_source | Image to place on button. Use INSTEAD of the image_filename and image_data. Unifies these into 1 easier to use parm |
| bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data | | bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data |
@ -851,7 +851,8 @@ update(menu_definition = None,
image_size = (None, None), image_size = (None, None),
image_subsample = None, image_subsample = None,
image_zoom = None, image_zoom = None,
button_text = None) button_text = None,
button_color = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -865,6 +866,7 @@ Parameter Descriptions:
| int | image_subsample | amount to reduce the size of the image. Divides the size by this number. 2=1/2, 3=1/3, 4=1/4, etc | | int | image_subsample | amount to reduce the size of the image. Divides the size by this number. 2=1/2, 3=1/3, 4=1/4, etc |
| int | image_zoom | amount to increase the size of the image. 2=twice size, 3=3 times, etc | | int | image_zoom | amount to increase the size of the image. 2=twice size, 3=3 times, etc |
| str | button_text | Text to be shown on the button | | str | button_text | Text to be shown on the button |
| (str, str) or str | button_color | Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. |
### visible ### visible
@ -947,7 +949,8 @@ Update(menu_definition = None,
image_size = (None, None), image_size = (None, None),
image_subsample = None, image_subsample = None,
image_zoom = None, image_zoom = None,
button_text = None) button_text = None,
button_color = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -961,6 +964,7 @@ Parameter Descriptions:
| int | image_subsample | amount to reduce the size of the image. Divides the size by this number. 2=1/2, 3=1/3, 4=1/4, etc | | int | image_subsample | amount to reduce the size of the image. Divides the size by this number. 2=1/2, 3=1/3, 4=1/4, etc |
| int | image_zoom | amount to increase the size of the image. 2=twice size, 3=3 times, etc | | int | image_zoom | amount to increase the size of the image. 2=twice size, 3=3 times, etc |
| str | button_text | Text to be shown on the button | | str | button_text | Text to be shown on the button |
| (str, str) or str | button_color | Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. |
--------- ---------
@ -6286,7 +6290,7 @@ Parameter Descriptions:
|Type|Name|Meaning| |Type|Name|Meaning|
|--|--|--| |--|--|--|
| Any | default_text | Initial text to show | | Any | default_text | Initial text to show |
| bool | enter_submits | if True, the Window.Read call will return is enter key is pressed in this element | | bool | enter_submits | if True, the Window.read call will return is enter key is pressed in this element |
| bool | disabled | set disable state | | bool | disabled | set disable state |
| bool | autoscroll | If True the contents of the element will automatically scroll as more data added to the end | | bool | autoscroll | If True the contents of the element will automatically scroll as more data added to the end |
| int | border_width | width of border around element in pixels | | int | border_width | width of border around element in pixels |
@ -6297,8 +6301,8 @@ Parameter Descriptions:
| str | text_color | color of the text | | str | text_color | color of the text |
| bool | horizontal_scroll | Controls if a horizontal scrollbar should be shown. If True a horizontal scrollbar will be shown in addition to vertical | | bool | horizontal_scroll | Controls if a horizontal scrollbar should be shown. If True a horizontal scrollbar will be shown in addition to vertical |
| bool | change_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | change_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead |
| bool | enable_events | Turns on the element specific events. Spin events happen when an item changes | | bool | enable_events | If True then any key press that happens when the element has focus will generate an event. |
| bool | do_not_clear | if False the element will be cleared any time the Window.Read call returns | | bool | do_not_clear | if False the element will be cleared any time the Window.read call returns |
| str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element to uniquely identify this element | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element to uniquely identify this element |
| str or int or tuple or object | k | Same as the Key. You can use either k or key. Which ever is set will be used. | | str or int or tuple or object | k | Same as the Key. You can use either k or key. Which ever is set will be used. |
| bool | write_only | If True then no entry will be added to the values dictionary when the window is read | | bool | write_only | If True then no entry will be added to the values dictionary when the window is read |
@ -6654,7 +6658,7 @@ unhide_row()
### update ### update
Changes some of the settings for the Multiline Element. Must call `Window.Read` or `Window.Finalize` prior Changes some of the settings for the Multiline Element. Must call `Window.read` or set finalize=True when creating window.
Changes will not be visible in your window until you call window.read or window.refresh. Changes will not be visible in your window until you call window.read or window.refresh.
@ -6761,7 +6765,7 @@ Parameter Descriptions:
### Update ### Update
Changes some of the settings for the Multiline Element. Must call `Window.Read` or `Window.Finalize` prior Changes some of the settings for the Multiline Element. Must call `Window.read` or set finalize=True when creating window.
Changes will not be visible in your window until you call window.read or window.refresh. Changes will not be visible in your window until you call window.read or window.refresh.
@ -7509,7 +7513,7 @@ unhide_row()
### update ### update
Changes some of the settings for the Multiline Element. Must call `Window.Read` or `Window.Finalize` prior Changes some of the settings for the Multiline Element. Must call `Window.read` or set finalize=True when creating window.
Changes will not be visible in your window until you call window.read or window.refresh. Changes will not be visible in your window until you call window.read or window.refresh.
@ -7616,7 +7620,7 @@ Parameter Descriptions:
### Update ### Update
Changes some of the settings for the Multiline Element. Must call `Window.Read` or `Window.Finalize` prior Changes some of the settings for the Multiline Element. Must call `Window.read` or set finalize=True when creating window.
Changes will not be visible in your window until you call window.read or window.refresh. Changes will not be visible in your window until you call window.read or window.refresh.
@ -13340,7 +13344,7 @@ You can drop the entire "find_element" function name and use [ ] instead.
However, if you wish to perform a lookup without error checking, and don't have error popups turned However, if you wish to perform a lookup without error checking, and don't have error popups turned
off globally, you'll need to make this call so that you can disable error checks on this call. off globally, you'll need to make this call so that you can disable error checks on this call.
find_element is yypically used in combination with a call to element's Update method (or any other element method!): find_element is typically used in combination with a call to element's update method (or any other element method!):
window[key].update(new_value) window[key].update(new_value)
Versus the "old way" Versus the "old way"
@ -13354,7 +13358,10 @@ Rememeber that this call will return None if no match is found which may cause y
checked for. checked for.
``` ```
find_element(key, silent_on_error = False) find_element(key,
silent_on_error = False,
supress_guessing = None,
supress_raise = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -13363,7 +13370,9 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element |
| bool | silent_on_error | If True do not display popup nor print warning of key errors | | bool | silent_on_error | If True do not display popup nor print warning of key errors |
| Element or Error Element or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True; | (bool or None) | supress_guessing | Override for the global key guessing setting. |
| (bool or None) | supress_raise | Override for the global setting that determines if a key error should raise an exception |
| Element or ErrorElement or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True
### find_element_with_focus ### find_element_with_focus
@ -14025,7 +14034,7 @@ You can drop the entire "find_element" function name and use [ ] instead.
However, if you wish to perform a lookup without error checking, and don't have error popups turned However, if you wish to perform a lookup without error checking, and don't have error popups turned
off globally, you'll need to make this call so that you can disable error checks on this call. off globally, you'll need to make this call so that you can disable error checks on this call.
find_element is yypically used in combination with a call to element's Update method (or any other element method!): find_element is typically used in combination with a call to element's update method (or any other element method!):
window[key].update(new_value) window[key].update(new_value)
Versus the "old way" Versus the "old way"
@ -14039,7 +14048,10 @@ Rememeber that this call will return None if no match is found which may cause y
checked for. checked for.
``` ```
Elem(key, silent_on_error = False) Elem(key,
silent_on_error = False,
supress_guessing = None,
supress_raise = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -14048,7 +14060,9 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element |
| bool | silent_on_error | If True do not display popup nor print warning of key errors | | bool | silent_on_error | If True do not display popup nor print warning of key errors |
| Element or Error Element or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True; | (bool or None) | supress_guessing | Override for the global key guessing setting. |
| (bool or None) | supress_raise | Override for the global setting that determines if a key error should raise an exception |
| Element or ErrorElement or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True
### Element ### Element
@ -14063,7 +14077,7 @@ You can drop the entire "find_element" function name and use [ ] instead.
However, if you wish to perform a lookup without error checking, and don't have error popups turned However, if you wish to perform a lookup without error checking, and don't have error popups turned
off globally, you'll need to make this call so that you can disable error checks on this call. off globally, you'll need to make this call so that you can disable error checks on this call.
find_element is yypically used in combination with a call to element's Update method (or any other element method!): find_element is typically used in combination with a call to element's update method (or any other element method!):
window[key].update(new_value) window[key].update(new_value)
Versus the "old way" Versus the "old way"
@ -14077,7 +14091,10 @@ Rememeber that this call will return None if no match is found which may cause y
checked for. checked for.
``` ```
Element(key, silent_on_error = False) Element(key,
silent_on_error = False,
supress_guessing = None,
supress_raise = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -14086,7 +14103,9 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element |
| bool | silent_on_error | If True do not display popup nor print warning of key errors | | bool | silent_on_error | If True do not display popup nor print warning of key errors |
| Element or Error Element or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True; | (bool or None) | supress_guessing | Override for the global key guessing setting. |
| (bool or None) | supress_raise | Override for the global setting that determines if a key error should raise an exception |
| Element or ErrorElement or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True
### Enable ### Enable
@ -14144,7 +14163,7 @@ You can drop the entire "find_element" function name and use [ ] instead.
However, if you wish to perform a lookup without error checking, and don't have error popups turned However, if you wish to perform a lookup without error checking, and don't have error popups turned
off globally, you'll need to make this call so that you can disable error checks on this call. off globally, you'll need to make this call so that you can disable error checks on this call.
find_element is yypically used in combination with a call to element's Update method (or any other element method!): find_element is typically used in combination with a call to element's update method (or any other element method!):
window[key].update(new_value) window[key].update(new_value)
Versus the "old way" Versus the "old way"
@ -14158,7 +14177,10 @@ Rememeber that this call will return None if no match is found which may cause y
checked for. checked for.
``` ```
Find(key, silent_on_error = False) Find(key,
silent_on_error = False,
supress_guessing = None,
supress_raise = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -14167,7 +14189,9 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element |
| bool | silent_on_error | If True do not display popup nor print warning of key errors | | bool | silent_on_error | If True do not display popup nor print warning of key errors |
| Element or Error Element or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True; | (bool or None) | supress_guessing | Override for the global key guessing setting. |
| (bool or None) | supress_raise | Override for the global setting that determines if a key error should raise an exception |
| Element or ErrorElement or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True
### FindElement ### FindElement
@ -15360,7 +15384,7 @@ Parameter Descriptions:
| (int, int) | size | (w,h) w=characters-wide, h=rows-high | | (int, int) | size | (w,h) w=characters-wide, h=rows-high |
| (int, int) or (None, None) or int | 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) or int | 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 |
| bool | auto_size_button | True if button size is determined by button text | | bool | auto_size_button | True if button size is determined by button text |
| | button_color | button color (foreground, background) | | (str, str) or str | button_color | button color (foreground, background) |
| bool | disabled | set disable state for element (Default = False) | | bool | disabled | set disable state for element (Default = False) |
| bool | change_submits | If True, pressing Enter key submits window (Default = False) | | bool | change_submits | If True, pressing Enter key submits window (Default = False) |
| bool | enable_events | Turns on the element specific events.(Default = False) | | bool | enable_events | Turns on the element specific events.(Default = False) |
@ -16670,7 +16694,7 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| Any | *args | Variable number of your arguments. Load up the call with stuff to see! | | Any | *args | Variable number of your arguments. Load up the call with stuff to see! |
| str | title | Optional title for the window. If none provided, the first arg will be used instead. | | str | title | Optional title for the window. If none provided, the first arg will be used instead. |
| (str, str) or None | button_color | Color of the buttons shown (text color, button color) | | (str, str) or str | button_color | Color of the buttons shown (text color, button color) |
| str | background_color | Window's background color | | str | background_color | Window's background color |
| str | text_color | text color | | str | text_color | text color |
| int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. | | int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. |
@ -17455,7 +17479,7 @@ popup_quick_message(args=*<1 or N object>,
font = None, font = None,
no_titlebar = True, no_titlebar = True,
grab_anywhere = False, grab_anywhere = False,
keep_on_top = None, keep_on_top = True,
location = (None, None), location = (None, None),
relative_location = (None, None), relative_location = (None, None),
image = None, image = None,
@ -17748,7 +17772,7 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| Any | *args | Variable number of your arguments. Load up the call with stuff to see! | | Any | *args | Variable number of your arguments. Load up the call with stuff to see! |
| str | title | Optional title for the window. If none provided, the first arg will be used instead. | | str | title | Optional title for the window. If none provided, the first arg will be used instead. |
| (str, str) or None | button_color | Color of the buttons shown (text color, button color) | | (str, str) or str | button_color | Color of the buttons shown (text color, button color) |
| str | background_color | Window's background color | | str | background_color | Window's background color |
| str | text_color | text color | | str | text_color | text color |
| int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. | | int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. |
@ -18562,7 +18586,7 @@ PopupQuickMessage(args=*<1 or N object>,
font = None, font = None,
no_titlebar = True, no_titlebar = True,
grab_anywhere = False, grab_anywhere = False,
keep_on_top = None, keep_on_top = True,
location = (None, None), location = (None, None),
relative_location = (None, None), relative_location = (None, None),
image = None, image = None,
@ -19248,7 +19272,9 @@ then a default filename will be used.
After value has been deleted, the settings file is written to disk. After value has been deleted, the settings file is written to disk.
``` ```
delete_entry(key, section = None) delete_entry(key,
section = None,
silent_on_error = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -19256,6 +19282,7 @@ Parameter Descriptions:
|Type|Name|Meaning| |Type|Name|Meaning|
|--|--|--| |--|--|--|
| Any | key | Setting to be deleted. Can be any valid dictionary key type (i.e. must be hashable) | | Any | key | Setting to be deleted. Can be any valid dictionary key type (i.e. must be hashable) |
| bool | silent_on_error | Determines if error should be shown. This parameter overrides the silent on error setting for the object. |
### delete_file ### delete_file
@ -19497,7 +19524,7 @@ then a default filename will be used.
After value has been deleted, the settings file is written to disk. After value has been deleted, the settings file is written to disk.
``` ```
user_settings_delete_entry(key) user_settings_delete_entry(key, silent_on_error = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -19505,6 +19532,7 @@ Parameter Descriptions:
|Type|Name|Meaning| |Type|Name|Meaning|
|--|--|--| |--|--|--|
| Any | key | Setting to be saved. Can be any valid dictionary key type (hashable) | | Any | key | Setting to be saved. Can be any valid dictionary key type (hashable) |
| bool | silent_on_error | Determines if an error popup should be shown if an error occurs. Overrides the silent onf effort setting from initialization |
Deltes the filename and path for your settings file. Either paramter can be optional. Deltes the filename and path for your settings file. Either paramter can be optional.
If you don't choose a path, one is provided for you that is OS specific If you don't choose a path, one is provided for you that is OS specific

4
docs/cookbook.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;"> <span style="font-weight: normal;">
apply coupon for discount: apply coupon for discount:
</span> </span>
09B234B00A7E89CC8C1F 266B9C51C90B3728782E
</div> </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=09B234B00A7E89CC8C1F','_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=266B9C51C90B3728782E','_blank');">
click here to visit course page click here to visit course page
</button> </button>
</div> </div>

6
docs/index.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;"> <span style="font-weight: normal;">
apply coupon for discount: apply coupon for discount:
</span> </span>
09B234B00A7E89CC8C1F 266B9C51C90B3728782E
</div> </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=09B234B00A7E89CC8C1F','_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=266B9C51C90B3728782E','_blank');">
click here to visit course page click here to visit course page
</button> </button>
</div> </div>
@ -1606,7 +1606,7 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| Any | *args | Variable number of your arguments. Load up the call with stuff to see! | | Any | *args | Variable number of your arguments. Load up the call with stuff to see! |
| str | title | Optional title for the window. If none provided, the first arg will be used instead. | | str | title | Optional title for the window. If none provided, the first arg will be used instead. |
| (str, str) or None | button_color | Color of the buttons shown (text color, button color) | | (str, str) or str | button_color | Color of the buttons shown (text color, button color) |
| str | background_color | Window's background color | | str | background_color | Window's background color |
| str | text_color | text color | | str | text_color | text color |
| int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. | | int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. |

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"> <img src="https://www.dropbox.com/s/6wzf3ebmj97v4zs/PySimpleGUI-GitHub-Udemy-Course.png?raw=1" width=200 alt="PySimpleGUI Udemy Course">
</td> </td>
<td> <td>
<h5>apply coupon for discount:<br>09B234B00A7E89CC8C1F</h6> <h5>apply coupon for discount:<br>266B9C51C90B3728782E</h6>
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=09B234B00A7E89CC8C1F">click here to visit course page</a> <a href="https://www.udemy.com/course/pysimplegui/?couponCode=266B9C51C90B3728782E">click here to visit course page</a>
</td> </td>
</tr> </tr>
</table> </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"> <img src="https://www.dropbox.com/s/6wzf3ebmj97v4zs/PySimpleGUI-GitHub-Udemy-Course.png?raw=1" width=200 alt="PySimpleGUI Udemy Course">
</td> </td>
<td> <td>
<h5>apply coupon for discount:<br>09B234B00A7E89CC8C1F</h6> <h5>apply coupon for discount:<br>266B9C51C90B3728782E</h6>
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=09B234B00A7E89CC8C1F">click here to visit course page</a> <a href="https://www.udemy.com/course/pysimplegui/?couponCode=266B9C51C90B3728782E">click here to visit course page</a>
</td> </td>
</tr> </tr>
</table> </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;"> <span style="font-weight: normal;">
apply coupon for discount: apply coupon for discount:
</span> </span>
09B234B00A7E89CC8C1F 266B9C51C90B3728782E
</div> </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=09B234B00A7E89CC8C1F','_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=266B9C51C90B3728782E','_blank');">
click here to visit course page click here to visit course page
</button> </button>
</div> </div>

4
readme_creator/markdown input files/5_call_reference.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;"> <span style="font-weight: normal;">
apply coupon for discount: apply coupon for discount:
</span> </span>
09B234B00A7E89CC8C1F 266B9C51C90B3728782E
</div> </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=09B234B00A7E89CC8C1F','_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=266B9C51C90B3728782E','_blank');">
click here to visit course page click here to visit course page
</button> </button>
</div> </div>

94
readme_creator/output/call reference.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;"> <span style="font-weight: normal;">
apply coupon for discount: apply coupon for discount:
</span> </span>
09B234B00A7E89CC8C1F 266B9C51C90B3728782E
</div> </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=09B234B00A7E89CC8C1F','_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=266B9C51C90B3728782E','_blank');">
click here to visit course page click here to visit course page
</button> </button>
</div> </div>
@ -120,7 +120,7 @@ Parameter Descriptions:
| (int or None, int or None) or (None, None) or int | size | (w, h) w=characters-wide, h=rows-high. If an int instead of a tuple is supplied, then height is auto-set to 1 | | (int or None, int or None) or (None, None) or int | size | (w, h) w=characters-wide, h=rows-high. If an int instead of a tuple is supplied, then height is auto-set to 1 |
| (int or None, int or None) or (None, None) or int | 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 or None, int or None) or (None, None) or int | 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 |
| bool | auto_size_button | if True the button size is sized to fit the text | | bool | auto_size_button | if True the button size is sized to fit the text |
| (str, str) or str or (int, int) or None | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. | | (str, str) or str | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. |
| (str, str) or str | disabled_button_color | colors to use when button is disabled (text, background). Use None for a color if don't want to change. Only ttk buttons support both text and background colors. tk buttons only support changing text color | | (str, str) or str | disabled_button_color | colors to use when button is disabled (text, background). Use None for a color if don't want to change. Only ttk buttons support both text and background colors. tk buttons only support changing text color |
| (str, str) | highlight_colors | colors to use when button has focus (has focus, does not have focus). None will use colors based on theme. Only used by Linux and only for non-TTK button | | (str, str) | highlight_colors | colors to use when button has focus (has focus, does not have focus). None will use colors based on theme. Only used by Linux and only for non-TTK button |
| (str, str) or str | mouseover_colors | Important difference between Linux & Windows! Linux - Colors when mouse moved over button. Windows - colors when button is pressed. The default is to switch the text and background colors (an inverse effect) | | (str, str) or str | mouseover_colors | Important difference between Linux & Windows! Linux - Colors when mouse moved over button. Windows - colors when button is pressed. The default is to switch the text and background colors (an inverse effect) |
@ -417,7 +417,7 @@ Parameter Descriptions:
|Type|Name|Meaning| |Type|Name|Meaning|
|--|--|--| |--|--|--|
| str | text | sets button text | | str | text | sets button text |
| (str, str) or str or (int, int) or None | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. | | (str, str) or str | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. |
| (bool or str) | disabled | True/False to enable/disable at the GUI level. Use BUTTON_DISABLED_MEANS_IGNORE to ignore clicks (won't change colors) | | (bool or str) | disabled | True/False to enable/disable at the GUI level. Use BUTTON_DISABLED_MEANS_IGNORE to ignore clicks (won't change colors) |
| (str or bytes) | image_source | Image to place on button. Use INSTEAD of the image_filename and image_data. Unifies these into 1 easier to use parm | | (str or bytes) | image_source | Image to place on button. Use INSTEAD of the image_filename and image_data. Unifies these into 1 easier to use parm |
| bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data | | bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data |
@ -531,7 +531,7 @@ Parameter Descriptions:
|Type|Name|Meaning| |Type|Name|Meaning|
|--|--|--| |--|--|--|
| str | text | sets button text | | str | text | sets button text |
| (str, str) or str or (int, int) or None | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. | | (str, str) or str | button_color | Color of button. default is from theme or the window. Easy to remember which is which if you say "ON" between colors. "red" on "green". Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. |
| (bool or str) | disabled | True/False to enable/disable at the GUI level. Use BUTTON_DISABLED_MEANS_IGNORE to ignore clicks (won't change colors) | | (bool or str) | disabled | True/False to enable/disable at the GUI level. Use BUTTON_DISABLED_MEANS_IGNORE to ignore clicks (won't change colors) |
| (str or bytes) | image_source | Image to place on button. Use INSTEAD of the image_filename and image_data. Unifies these into 1 easier to use parm | | (str or bytes) | image_source | Image to place on button. Use INSTEAD of the image_filename and image_data. Unifies these into 1 easier to use parm |
| bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data | | bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data |
@ -851,7 +851,8 @@ update(menu_definition = None,
image_size = (None, None), image_size = (None, None),
image_subsample = None, image_subsample = None,
image_zoom = None, image_zoom = None,
button_text = None) button_text = None,
button_color = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -865,6 +866,7 @@ Parameter Descriptions:
| int | image_subsample | amount to reduce the size of the image. Divides the size by this number. 2=1/2, 3=1/3, 4=1/4, etc | | int | image_subsample | amount to reduce the size of the image. Divides the size by this number. 2=1/2, 3=1/3, 4=1/4, etc |
| int | image_zoom | amount to increase the size of the image. 2=twice size, 3=3 times, etc | | int | image_zoom | amount to increase the size of the image. 2=twice size, 3=3 times, etc |
| str | button_text | Text to be shown on the button | | str | button_text | Text to be shown on the button |
| (str, str) or str | button_color | Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. |
### visible ### visible
@ -947,7 +949,8 @@ Update(menu_definition = None,
image_size = (None, None), image_size = (None, None),
image_subsample = None, image_subsample = None,
image_zoom = None, image_zoom = None,
button_text = None) button_text = None,
button_color = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -961,6 +964,7 @@ Parameter Descriptions:
| int | image_subsample | amount to reduce the size of the image. Divides the size by this number. 2=1/2, 3=1/3, 4=1/4, etc | | int | image_subsample | amount to reduce the size of the image. Divides the size by this number. 2=1/2, 3=1/3, 4=1/4, etc |
| int | image_zoom | amount to increase the size of the image. 2=twice size, 3=3 times, etc | | int | image_zoom | amount to increase the size of the image. 2=twice size, 3=3 times, etc |
| str | button_text | Text to be shown on the button | | str | button_text | Text to be shown on the button |
| (str, str) or str | button_color | Normally a tuple, but can be a simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. |
--------- ---------
@ -6286,7 +6290,7 @@ Parameter Descriptions:
|Type|Name|Meaning| |Type|Name|Meaning|
|--|--|--| |--|--|--|
| Any | default_text | Initial text to show | | Any | default_text | Initial text to show |
| bool | enter_submits | if True, the Window.Read call will return is enter key is pressed in this element | | bool | enter_submits | if True, the Window.read call will return is enter key is pressed in this element |
| bool | disabled | set disable state | | bool | disabled | set disable state |
| bool | autoscroll | If True the contents of the element will automatically scroll as more data added to the end | | bool | autoscroll | If True the contents of the element will automatically scroll as more data added to the end |
| int | border_width | width of border around element in pixels | | int | border_width | width of border around element in pixels |
@ -6297,8 +6301,8 @@ Parameter Descriptions:
| str | text_color | color of the text | | str | text_color | color of the text |
| bool | horizontal_scroll | Controls if a horizontal scrollbar should be shown. If True a horizontal scrollbar will be shown in addition to vertical | | bool | horizontal_scroll | Controls if a horizontal scrollbar should be shown. If True a horizontal scrollbar will be shown in addition to vertical |
| bool | change_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | change_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead |
| bool | enable_events | Turns on the element specific events. Spin events happen when an item changes | | bool | enable_events | If True then any key press that happens when the element has focus will generate an event. |
| bool | do_not_clear | if False the element will be cleared any time the Window.Read call returns | | bool | do_not_clear | if False the element will be cleared any time the Window.read call returns |
| str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element to uniquely identify this element | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element to uniquely identify this element |
| str or int or tuple or object | k | Same as the Key. You can use either k or key. Which ever is set will be used. | | str or int or tuple or object | k | Same as the Key. You can use either k or key. Which ever is set will be used. |
| bool | write_only | If True then no entry will be added to the values dictionary when the window is read | | bool | write_only | If True then no entry will be added to the values dictionary when the window is read |
@ -6654,7 +6658,7 @@ unhide_row()
### update ### update
Changes some of the settings for the Multiline Element. Must call `Window.Read` or `Window.Finalize` prior Changes some of the settings for the Multiline Element. Must call `Window.read` or set finalize=True when creating window.
Changes will not be visible in your window until you call window.read or window.refresh. Changes will not be visible in your window until you call window.read or window.refresh.
@ -6761,7 +6765,7 @@ Parameter Descriptions:
### Update ### Update
Changes some of the settings for the Multiline Element. Must call `Window.Read` or `Window.Finalize` prior Changes some of the settings for the Multiline Element. Must call `Window.read` or set finalize=True when creating window.
Changes will not be visible in your window until you call window.read or window.refresh. Changes will not be visible in your window until you call window.read or window.refresh.
@ -7509,7 +7513,7 @@ unhide_row()
### update ### update
Changes some of the settings for the Multiline Element. Must call `Window.Read` or `Window.Finalize` prior Changes some of the settings for the Multiline Element. Must call `Window.read` or set finalize=True when creating window.
Changes will not be visible in your window until you call window.read or window.refresh. Changes will not be visible in your window until you call window.read or window.refresh.
@ -7616,7 +7620,7 @@ Parameter Descriptions:
### Update ### Update
Changes some of the settings for the Multiline Element. Must call `Window.Read` or `Window.Finalize` prior Changes some of the settings for the Multiline Element. Must call `Window.read` or set finalize=True when creating window.
Changes will not be visible in your window until you call window.read or window.refresh. Changes will not be visible in your window until you call window.read or window.refresh.
@ -13340,7 +13344,7 @@ You can drop the entire "find_element" function name and use [ ] instead.
However, if you wish to perform a lookup without error checking, and don't have error popups turned However, if you wish to perform a lookup without error checking, and don't have error popups turned
off globally, you'll need to make this call so that you can disable error checks on this call. off globally, you'll need to make this call so that you can disable error checks on this call.
find_element is yypically used in combination with a call to element's Update method (or any other element method!): find_element is typically used in combination with a call to element's update method (or any other element method!):
window[key].update(new_value) window[key].update(new_value)
Versus the "old way" Versus the "old way"
@ -13354,7 +13358,10 @@ Rememeber that this call will return None if no match is found which may cause y
checked for. checked for.
``` ```
find_element(key, silent_on_error = False) find_element(key,
silent_on_error = False,
supress_guessing = None,
supress_raise = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -13363,7 +13370,9 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element |
| bool | silent_on_error | If True do not display popup nor print warning of key errors | | bool | silent_on_error | If True do not display popup nor print warning of key errors |
| Element or Error Element or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True; | (bool or None) | supress_guessing | Override for the global key guessing setting. |
| (bool or None) | supress_raise | Override for the global setting that determines if a key error should raise an exception |
| Element or ErrorElement or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True
### find_element_with_focus ### find_element_with_focus
@ -14025,7 +14034,7 @@ You can drop the entire "find_element" function name and use [ ] instead.
However, if you wish to perform a lookup without error checking, and don't have error popups turned However, if you wish to perform a lookup without error checking, and don't have error popups turned
off globally, you'll need to make this call so that you can disable error checks on this call. off globally, you'll need to make this call so that you can disable error checks on this call.
find_element is yypically used in combination with a call to element's Update method (or any other element method!): find_element is typically used in combination with a call to element's update method (or any other element method!):
window[key].update(new_value) window[key].update(new_value)
Versus the "old way" Versus the "old way"
@ -14039,7 +14048,10 @@ Rememeber that this call will return None if no match is found which may cause y
checked for. checked for.
``` ```
Elem(key, silent_on_error = False) Elem(key,
silent_on_error = False,
supress_guessing = None,
supress_raise = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -14048,7 +14060,9 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element |
| bool | silent_on_error | If True do not display popup nor print warning of key errors | | bool | silent_on_error | If True do not display popup nor print warning of key errors |
| Element or Error Element or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True; | (bool or None) | supress_guessing | Override for the global key guessing setting. |
| (bool or None) | supress_raise | Override for the global setting that determines if a key error should raise an exception |
| Element or ErrorElement or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True
### Element ### Element
@ -14063,7 +14077,7 @@ You can drop the entire "find_element" function name and use [ ] instead.
However, if you wish to perform a lookup without error checking, and don't have error popups turned However, if you wish to perform a lookup without error checking, and don't have error popups turned
off globally, you'll need to make this call so that you can disable error checks on this call. off globally, you'll need to make this call so that you can disable error checks on this call.
find_element is yypically used in combination with a call to element's Update method (or any other element method!): find_element is typically used in combination with a call to element's update method (or any other element method!):
window[key].update(new_value) window[key].update(new_value)
Versus the "old way" Versus the "old way"
@ -14077,7 +14091,10 @@ Rememeber that this call will return None if no match is found which may cause y
checked for. checked for.
``` ```
Element(key, silent_on_error = False) Element(key,
silent_on_error = False,
supress_guessing = None,
supress_raise = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -14086,7 +14103,9 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element |
| bool | silent_on_error | If True do not display popup nor print warning of key errors | | bool | silent_on_error | If True do not display popup nor print warning of key errors |
| Element or Error Element or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True; | (bool or None) | supress_guessing | Override for the global key guessing setting. |
| (bool or None) | supress_raise | Override for the global setting that determines if a key error should raise an exception |
| Element or ErrorElement or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True
### Enable ### Enable
@ -14144,7 +14163,7 @@ You can drop the entire "find_element" function name and use [ ] instead.
However, if you wish to perform a lookup without error checking, and don't have error popups turned However, if you wish to perform a lookup without error checking, and don't have error popups turned
off globally, you'll need to make this call so that you can disable error checks on this call. off globally, you'll need to make this call so that you can disable error checks on this call.
find_element is yypically used in combination with a call to element's Update method (or any other element method!): find_element is typically used in combination with a call to element's update method (or any other element method!):
window[key].update(new_value) window[key].update(new_value)
Versus the "old way" Versus the "old way"
@ -14158,7 +14177,10 @@ Rememeber that this call will return None if no match is found which may cause y
checked for. checked for.
``` ```
Find(key, silent_on_error = False) Find(key,
silent_on_error = False,
supress_guessing = None,
supress_raise = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -14167,7 +14189,9 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element |
| bool | silent_on_error | If True do not display popup nor print warning of key errors | | bool | silent_on_error | If True do not display popup nor print warning of key errors |
| Element or Error Element or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True; | (bool or None) | supress_guessing | Override for the global key guessing setting. |
| (bool or None) | supress_raise | Override for the global setting that determines if a key error should raise an exception |
| Element or ErrorElement or None | **RETURN** | Return value can be: the Element that matches the supplied key if found; an Error Element if silent_on_error is False; None if silent_on_error True
### FindElement ### FindElement
@ -15360,7 +15384,7 @@ Parameter Descriptions:
| (int, int) | size | (w,h) w=characters-wide, h=rows-high | | (int, int) | size | (w,h) w=characters-wide, h=rows-high |
| (int, int) or (None, None) or int | 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) or int | 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 |
| bool | auto_size_button | True if button size is determined by button text | | bool | auto_size_button | True if button size is determined by button text |
| | button_color | button color (foreground, background) | | (str, str) or str | button_color | button color (foreground, background) |
| bool | disabled | set disable state for element (Default = False) | | bool | disabled | set disable state for element (Default = False) |
| bool | change_submits | If True, pressing Enter key submits window (Default = False) | | bool | change_submits | If True, pressing Enter key submits window (Default = False) |
| bool | enable_events | Turns on the element specific events.(Default = False) | | bool | enable_events | Turns on the element specific events.(Default = False) |
@ -16670,7 +16694,7 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| Any | *args | Variable number of your arguments. Load up the call with stuff to see! | | Any | *args | Variable number of your arguments. Load up the call with stuff to see! |
| str | title | Optional title for the window. If none provided, the first arg will be used instead. | | str | title | Optional title for the window. If none provided, the first arg will be used instead. |
| (str, str) or None | button_color | Color of the buttons shown (text color, button color) | | (str, str) or str | button_color | Color of the buttons shown (text color, button color) |
| str | background_color | Window's background color | | str | background_color | Window's background color |
| str | text_color | text color | | str | text_color | text color |
| int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. | | int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. |
@ -17455,7 +17479,7 @@ popup_quick_message(args=*<1 or N object>,
font = None, font = None,
no_titlebar = True, no_titlebar = True,
grab_anywhere = False, grab_anywhere = False,
keep_on_top = None, keep_on_top = True,
location = (None, None), location = (None, None),
relative_location = (None, None), relative_location = (None, None),
image = None, image = None,
@ -17748,7 +17772,7 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| Any | *args | Variable number of your arguments. Load up the call with stuff to see! | | Any | *args | Variable number of your arguments. Load up the call with stuff to see! |
| str | title | Optional title for the window. If none provided, the first arg will be used instead. | | str | title | Optional title for the window. If none provided, the first arg will be used instead. |
| (str, str) or None | button_color | Color of the buttons shown (text color, button color) | | (str, str) or str | button_color | Color of the buttons shown (text color, button color) |
| str | background_color | Window's background color | | str | background_color | Window's background color |
| str | text_color | text color | | str | text_color | text color |
| int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. | | int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. |
@ -18562,7 +18586,7 @@ PopupQuickMessage(args=*<1 or N object>,
font = None, font = None,
no_titlebar = True, no_titlebar = True,
grab_anywhere = False, grab_anywhere = False,
keep_on_top = None, keep_on_top = True,
location = (None, None), location = (None, None),
relative_location = (None, None), relative_location = (None, None),
image = None, image = None,
@ -19248,7 +19272,9 @@ then a default filename will be used.
After value has been deleted, the settings file is written to disk. After value has been deleted, the settings file is written to disk.
``` ```
delete_entry(key, section = None) delete_entry(key,
section = None,
silent_on_error = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -19256,6 +19282,7 @@ Parameter Descriptions:
|Type|Name|Meaning| |Type|Name|Meaning|
|--|--|--| |--|--|--|
| Any | key | Setting to be deleted. Can be any valid dictionary key type (i.e. must be hashable) | | Any | key | Setting to be deleted. Can be any valid dictionary key type (i.e. must be hashable) |
| bool | silent_on_error | Determines if error should be shown. This parameter overrides the silent on error setting for the object. |
### delete_file ### delete_file
@ -19497,7 +19524,7 @@ then a default filename will be used.
After value has been deleted, the settings file is written to disk. After value has been deleted, the settings file is written to disk.
``` ```
user_settings_delete_entry(key) user_settings_delete_entry(key, silent_on_error = None)
``` ```
Parameter Descriptions: Parameter Descriptions:
@ -19505,6 +19532,7 @@ Parameter Descriptions:
|Type|Name|Meaning| |Type|Name|Meaning|
|--|--|--| |--|--|--|
| Any | key | Setting to be saved. Can be any valid dictionary key type (hashable) | | Any | key | Setting to be saved. Can be any valid dictionary key type (hashable) |
| bool | silent_on_error | Determines if an error popup should be shown if an error occurs. Overrides the silent onf effort setting from initialization |
Deltes the filename and path for your settings file. Either paramter can be optional. Deltes the filename and path for your settings file. Either paramter can be optional.
If you don't choose a path, one is provided for you that is OS specific If you don't choose a path, one is provided for you that is OS specific

6
readme_creator/output/index.md
View File

@ -25,9 +25,9 @@
<span style="font-weight: normal;"> <span style="font-weight: normal;">
apply coupon for discount: apply coupon for discount:
</span> </span>
09B234B00A7E89CC8C1F 266B9C51C90B3728782E
</div> </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=09B234B00A7E89CC8C1F','_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=266B9C51C90B3728782E','_blank');">
click here to visit course page click here to visit course page
</button> </button>
</div> </div>
@ -1606,7 +1606,7 @@ Parameter Descriptions:
|--|--|--| |--|--|--|
| Any | *args | Variable number of your arguments. Load up the call with stuff to see! | | Any | *args | Variable number of your arguments. Load up the call with stuff to see! |
| str | title | Optional title for the window. If none provided, the first arg will be used instead. | | str | title | Optional title for the window. If none provided, the first arg will be used instead. |
| (str, str) or None | button_color | Color of the buttons shown (text color, button color) | | (str, str) or str | button_color | Color of the buttons shown (text color, button color) |
| str | background_color | Window's background color | | str | background_color | Window's background color |
| str | text_color | text color | | str | text_color | text color |
| int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. | | int | button_type | NOT USER SET! Determines which pre-defined buttons will be shown (Default value = POPUP_BUTTONS_OK). There are many Popup functions and they call Popup, changing this parameter to get the desired effect. |