diff --git a/PySimpleGUI.py b/PySimpleGUI.py index d70c5189..d813dd17 100644 --- a/PySimpleGUI.py +++ b/PySimpleGUI.py @@ -1,6 +1,6 @@ #!/usr/bin/python3 -version = __version__ = "4.60.4.129 Unreleased" +version = __version__ = "4.60.4.130 Unreleased" _change_log = """ 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 4.60.4.129 button_color parm added to ButtonMenu.update + 4.60.4.130 + New coupon """ __version__ = version.split()[0] # For PEP 396 and PEP 345 @@ -25889,7 +25891,7 @@ def main(): elif event == 'Get Text': popup_scrolled('Returned:', popup_get_text('Enter some text', keep_on_top=True)) elif event.startswith('-UDEMY-'): - webbrowser.open_new_tab(r'https://www.udemy.com/course/pysimplegui/?couponCode=09B234B00A7E89CC8C1F') + webbrowser.open_new_tab(r'https://www.udemy.com/course/pysimplegui/?couponCode=266B9C51C90B3728782E') elif event.startswith('-SPONSOR-'): if webbrowser_available: webbrowser.open_new_tab(r'https://www.paypal.me/pythongui') @@ -25897,7 +25899,7 @@ def main(): if webbrowser_available: 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!", '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) elif event == 'Themes': @@ -26057,4 +26059,4 @@ if __name__ == '__main__': exit(0) main() exit(0) -#4265de03173912fae7b989bcbfe77953391799eda31755853031dca229d69f7abd97e9e733d21e864c5ec65a07a36a7e916b769ffdff252bc8449890b1a8f8ae3ab99f08edcfbc41b1f13edd1e0e7404096e7113d86147e21617293d0a5a93ed11f92f275bcbfaab8c533acf57d9c02eaaf5e7c59d89ac484fbd40800c395019a0797677115c85207bbef5faf7b964c3a6cb895c252645e3469c580f2673e9083920cf1a1028825f5f2823cd57bb59d5f34e19e483b9903678798fb6f9c48ec8e89708bb80dd73bd1b70795ef9e4b0d7487756483ef19af15d093d8edd95bb3f9cd251492844fc570b6c137c68f6e002dc8b2e63f731faff2e0d5dc51e4d9b37a628a4aa45ec4c8252b031cb753898bc93b649d3b74d7f99eae383c781753a210b384433fee50598d288c9ea7ea6fdfd71eff8aea5eb205a1dd10e5f9647c4ebfc1599d4294cfdc82ec2f33248b8983e272d223732c9f6a783113e39e89536f91e11b2d705ff56ef5bc1a92fe9ab854e86f7c74dfa2ad12229b2b13ee1da8d9c436b1aa7f2bf25c8ea139b65f63ad99cb177d8e265b0e8465606fdafaff7fb65f94800b35aeecf2346db592054855352e210b8ac082cc1e8fbaddac4adbcc25f6f083502b2d0cca72f63c39cf9053a52cee3c5c4b10b4e3010c28f0bd194fa6c3e24c2c0a764df105cba380ff95e3850c15707ed0f91a4b9ad4a64f5e96e37ee \ No newline at end of file +#3df9e3c9362e397b5c29836a44814920f2a5d73fc8450ce07fd59d3f7e26e40fd5103b04347218518c85da6621264cdd2039e906fc9a6c5b3f2adf710ec4b7d809f2c7fc69e2580ed9f81bf8ea427eea82e3581ddca3778e0aa9cd82825140166ad5313f06d40c2a4bfe4d77830f2499a8c18ca8877c7a00c363d30caf8307786b5e5a1836c4f75543a0792daa51c78ae50b699858d48e274a15db11fb9294490d147e9a84ee9037707800263e7b27629f7fcd57f4120cf5ee8d91791c8e14905dd9f9f5a2bf411c3111a5fd0015a68119c4c4c15ecc80cece8077aa93ea9b24c2de00b599ce6ba833dc32b3944f430eb6d06b87b710b971fd4cb00cb83def80cf29bb8b1f2926d06c5337336093c78ef3e80fa9b8434990c22883891e29d180f11738a30b46e713ffbe47cca9fb874cf08a3fae9d7b332dc5c4a4df1c892e6c140e0282d71259a723563c8adc1b4931fe94a0ab7e47aa007d7e6ec2b2d6e180c626cae5de82d9621731408a5fb9f742b0d66c64a01a6cc33b2f19cebb12b7027daa590e26bf81d7659bb5f716bec7588b6b136d0070b03351ef201766066dd90023685a75a6eefc0ed60307acbbae4e07e32c56d50b3b88be801cf37da229517c3d1aad042e4f208f9885de55a590ffd77a660852a9114863f7e60d68f72845fe9ce4f0656703a34e0c792fa8cbbb410a194d90e8c9f040e67c39f40d8a59d8 \ No newline at end of file diff --git a/docs/call reference.md b/docs/call reference.md index 5355d592..b2037bda 100644 --- a/docs/call reference.md +++ b/docs/call reference.md @@ -25,9 +25,9 @@ apply coupon for discount: - 09B234B00A7E89CC8C1F + 266B9C51C90B3728782E - @@ -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 | 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 | -| (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) | 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) | @@ -416,17 +416,17 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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. | -| (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 | -| bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data | -| str | image_filename | image filename if there is a button image. GIFs and PNGs only. | -| (str, 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 | -| bool | visible | control visibility of element | -| 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, int) | image_size | Size of the image in pixels (width, height) | +| str | text | sets button text | +| (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) | +| (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 | +| str | image_filename | image filename if there is a button image. GIFs and PNGs only. | +| (str, 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 | +| bool | visible | control visibility of element | +| 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, int) | image_size | Size of the image in pixels (width, height) | ### visible @@ -530,17 +530,17 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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. | -| (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 | -| bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data | -| str | image_filename | image filename if there is a button image. GIFs and PNGs only. | -| (str, 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 | -| bool | visible | control visibility of element | -| 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, int) | image_size | Size of the image in pixels (width, height) | +| str | text | sets button text | +| (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) | +| (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 | +| str | image_filename | image filename if there is a button image. GIFs and PNGs only. | +| (str, 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 | +| bool | visible | control visibility of element | +| 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, int) | image_size | Size of the image in pixels (width, height) | --------- @@ -851,20 +851,22 @@ update(menu_definition = None, image_size = (None, None), image_subsample = None, image_zoom = None, - button_text = None) + button_text = None, + button_color = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| List[List] | menu_definition | (New menu definition (in menu definition format) | -| bool | visible | control visibility of element | -| (str or bytes) | image_source | new image if image is to be changed. Can be a filename or a base64 encoded byte-string | -| (int, int) | image_size | Size of the image in pixels (width, height) | -| 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 | -| str | button_text | Text to be shown on the button | +| List[List] | menu_definition | (New menu definition (in menu definition format) | +| bool | visible | control visibility of element | +| (str or bytes) | image_source | new image if image is to be changed. Can be a filename or a base64 encoded byte-string | +| (int, int) | image_size | Size of the image in pixels (width, height) | +| 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 | +| 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 @@ -947,20 +949,22 @@ Update(menu_definition = None, image_size = (None, None), image_subsample = None, image_zoom = None, - button_text = None) + button_text = None, + button_color = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| List[List] | menu_definition | (New menu definition (in menu definition format) | -| bool | visible | control visibility of element | -| (str or bytes) | image_source | new image if image is to be changed. Can be a filename or a base64 encoded byte-string | -| (int, int) | image_size | Size of the image in pixels (width, height) | -| 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 | -| str | button_text | Text to be shown on the button | +| List[List] | menu_definition | (New menu definition (in menu definition format) | +| bool | visible | control visibility of element | +| (str or bytes) | image_source | new image if image is to be changed. Can be a filename or a base64 encoded byte-string | +| (int, int) | image_size | Size of the image in pixels (width, height) | +| 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 | +| 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| |--|--|--| | 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 | 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 | @@ -6297,8 +6301,8 @@ Parameter Descriptions: | 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 | 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 | do_not_clear | if False the element will be cleared any time the Window.Read call returns | +| 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 | | 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. | | 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 -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. @@ -6761,7 +6765,7 @@ Parameter Descriptions: ### 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. @@ -7509,7 +7513,7 @@ unhide_row() ### 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. @@ -7616,7 +7620,7 @@ Parameter Descriptions: ### 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. @@ -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 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) Versus the "old way" @@ -13354,16 +13358,21 @@ Rememeber that this call will return None if no match is found which may cause y checked for. ``` -find_element(key, silent_on_error = False) +find_element(key, + silent_on_error = False, + supress_guessing = None, + supress_raise = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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 | -| 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; +| 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 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 @@ -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 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) Versus the "old way" @@ -14039,16 +14048,21 @@ Rememeber that this call will return None if no match is found which may cause y checked for. ``` -Elem(key, silent_on_error = False) +Elem(key, + silent_on_error = False, + supress_guessing = None, + supress_raise = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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 | -| 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; +| 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 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 @@ -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 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) Versus the "old way" @@ -14077,16 +14091,21 @@ Rememeber that this call will return None if no match is found which may cause y checked for. ``` -Element(key, silent_on_error = False) +Element(key, + silent_on_error = False, + supress_guessing = None, + supress_raise = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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 | -| 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; +| 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 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 @@ -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 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) Versus the "old way" @@ -14158,16 +14177,21 @@ Rememeber that this call will return None if no match is found which may cause y checked for. ``` -Find(key, silent_on_error = False) +Find(key, + silent_on_error = False, + supress_guessing = None, + supress_raise = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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 | -| 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; +| 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 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 @@ -15360,7 +15384,7 @@ Parameter Descriptions: | (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 | | 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 | change_submits | If True, pressing Enter key submits window (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! | | 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 | 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. | @@ -17455,7 +17479,7 @@ popup_quick_message(args=*<1 or N object>, font = None, no_titlebar = True, grab_anywhere = False, - keep_on_top = None, + keep_on_top = True, location = (None, None), relative_location = (None, None), image = None, @@ -17748,7 +17772,7 @@ Parameter Descriptions: |--|--|--| | 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, 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 | 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. | @@ -18562,7 +18586,7 @@ PopupQuickMessage(args=*<1 or N object>, font = None, no_titlebar = True, grab_anywhere = False, - keep_on_top = None, + keep_on_top = True, location = (None, None), relative_location = (None, None), image = None, @@ -19248,14 +19272,17 @@ then a default filename will be used. 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: |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 @@ -19497,14 +19524,15 @@ then a default filename will be used. 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: |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. If you don't choose a path, one is provided for you that is OS specific diff --git a/docs/cookbook.md b/docs/cookbook.md index eaed67cb..2205af6e 100644 --- a/docs/cookbook.md +++ b/docs/cookbook.md @@ -25,9 +25,9 @@ apply coupon for discount: - 09B234B00A7E89CC8C1F + 266B9C51C90B3728782E - diff --git a/docs/index.md b/docs/index.md index 10995b3e..52331638 100644 --- a/docs/index.md +++ b/docs/index.md @@ -25,9 +25,9 @@ apply coupon for discount: - 09B234B00A7E89CC8C1F + 266B9C51C90B3728782E - @@ -1606,7 +1606,7 @@ Parameter Descriptions: |--|--|--| | 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, 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 | 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. | diff --git a/docs/readme.md b/docs/readme.md index a9acff6a..bb87045c 100644 --- a/docs/readme.md +++ b/docs/readme.md @@ -9,8 +9,8 @@ PySimpleGUI Udemy Course -
apply coupon for discount:
09B234B00A7E89CC8C1F
- click here to visit course page +
apply coupon for discount:
266B9C51C90B3728782E
+ click here to visit course page diff --git a/readme.md b/readme.md index a9acff6a..bb87045c 100644 --- a/readme.md +++ b/readme.md @@ -9,8 +9,8 @@ PySimpleGUI Udemy Course -
apply coupon for discount:
09B234B00A7E89CC8C1F
- click here to visit course page +
apply coupon for discount:
266B9C51C90B3728782E
+ click here to visit course page diff --git a/readme_creator/markdown input files/1_HEADER_top_part.md b/readme_creator/markdown input files/1_HEADER_top_part.md index 78f17c55..502b40f0 100644 --- a/readme_creator/markdown input files/1_HEADER_top_part.md +++ b/readme_creator/markdown input files/1_HEADER_top_part.md @@ -52,9 +52,9 @@ HOW DO I INSERT IMAGES ??? apply coupon for discount: - 09B234B00A7E89CC8C1F + 266B9C51C90B3728782E - diff --git a/readme_creator/markdown input files/5_call_reference.md b/readme_creator/markdown input files/5_call_reference.md index 8a452369..b32f61e2 100644 --- a/readme_creator/markdown input files/5_call_reference.md +++ b/readme_creator/markdown input files/5_call_reference.md @@ -25,9 +25,9 @@ apply coupon for discount: - 09B234B00A7E89CC8C1F + 266B9C51C90B3728782E - diff --git a/readme_creator/output/call reference.md b/readme_creator/output/call reference.md index 5355d592..b2037bda 100644 --- a/readme_creator/output/call reference.md +++ b/readme_creator/output/call reference.md @@ -25,9 +25,9 @@ apply coupon for discount: - 09B234B00A7E89CC8C1F + 266B9C51C90B3728782E - @@ -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 | 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 | -| (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) | 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) | @@ -416,17 +416,17 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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. | -| (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 | -| bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data | -| str | image_filename | image filename if there is a button image. GIFs and PNGs only. | -| (str, 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 | -| bool | visible | control visibility of element | -| 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, int) | image_size | Size of the image in pixels (width, height) | +| str | text | sets button text | +| (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) | +| (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 | +| str | image_filename | image filename if there is a button image. GIFs and PNGs only. | +| (str, 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 | +| bool | visible | control visibility of element | +| 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, int) | image_size | Size of the image in pixels (width, height) | ### visible @@ -530,17 +530,17 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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. | -| (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 | -| bytes or str | image_data | Raw or Base64 representation of the image to put on button. Choose either filename or data | -| str | image_filename | image filename if there is a button image. GIFs and PNGs only. | -| (str, 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 | -| bool | visible | control visibility of element | -| 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, int) | image_size | Size of the image in pixels (width, height) | +| str | text | sets button text | +| (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) | +| (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 | +| str | image_filename | image filename if there is a button image. GIFs and PNGs only. | +| (str, 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 | +| bool | visible | control visibility of element | +| 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, int) | image_size | Size of the image in pixels (width, height) | --------- @@ -851,20 +851,22 @@ update(menu_definition = None, image_size = (None, None), image_subsample = None, image_zoom = None, - button_text = None) + button_text = None, + button_color = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| List[List] | menu_definition | (New menu definition (in menu definition format) | -| bool | visible | control visibility of element | -| (str or bytes) | image_source | new image if image is to be changed. Can be a filename or a base64 encoded byte-string | -| (int, int) | image_size | Size of the image in pixels (width, height) | -| 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 | -| str | button_text | Text to be shown on the button | +| List[List] | menu_definition | (New menu definition (in menu definition format) | +| bool | visible | control visibility of element | +| (str or bytes) | image_source | new image if image is to be changed. Can be a filename or a base64 encoded byte-string | +| (int, int) | image_size | Size of the image in pixels (width, height) | +| 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 | +| 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 @@ -947,20 +949,22 @@ Update(menu_definition = None, image_size = (None, None), image_subsample = None, image_zoom = None, - button_text = None) + button_text = None, + button_color = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| List[List] | menu_definition | (New menu definition (in menu definition format) | -| bool | visible | control visibility of element | -| (str or bytes) | image_source | new image if image is to be changed. Can be a filename or a base64 encoded byte-string | -| (int, int) | image_size | Size of the image in pixels (width, height) | -| 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 | -| str | button_text | Text to be shown on the button | +| List[List] | menu_definition | (New menu definition (in menu definition format) | +| bool | visible | control visibility of element | +| (str or bytes) | image_source | new image if image is to be changed. Can be a filename or a base64 encoded byte-string | +| (int, int) | image_size | Size of the image in pixels (width, height) | +| 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 | +| 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| |--|--|--| | 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 | 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 | @@ -6297,8 +6301,8 @@ Parameter Descriptions: | 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 | 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 | do_not_clear | if False the element will be cleared any time the Window.Read call returns | +| 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 | | 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. | | 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 -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. @@ -6761,7 +6765,7 @@ Parameter Descriptions: ### 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. @@ -7509,7 +7513,7 @@ unhide_row() ### 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. @@ -7616,7 +7620,7 @@ Parameter Descriptions: ### 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. @@ -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 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) Versus the "old way" @@ -13354,16 +13358,21 @@ Rememeber that this call will return None if no match is found which may cause y checked for. ``` -find_element(key, silent_on_error = False) +find_element(key, + silent_on_error = False, + supress_guessing = None, + supress_raise = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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 | -| 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; +| 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 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 @@ -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 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) Versus the "old way" @@ -14039,16 +14048,21 @@ Rememeber that this call will return None if no match is found which may cause y checked for. ``` -Elem(key, silent_on_error = False) +Elem(key, + silent_on_error = False, + supress_guessing = None, + supress_raise = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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 | -| 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; +| 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 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 @@ -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 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) Versus the "old way" @@ -14077,16 +14091,21 @@ Rememeber that this call will return None if no match is found which may cause y checked for. ``` -Element(key, silent_on_error = False) +Element(key, + silent_on_error = False, + supress_guessing = None, + supress_raise = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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 | -| 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; +| 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 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 @@ -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 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) Versus the "old way" @@ -14158,16 +14177,21 @@ Rememeber that this call will return None if no match is found which may cause y checked for. ``` -Find(key, silent_on_error = False) +Find(key, + silent_on_error = False, + supress_guessing = None, + supress_raise = None) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| 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 | -| 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; +| 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 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 @@ -15360,7 +15384,7 @@ Parameter Descriptions: | (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 | | 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 | change_submits | If True, pressing Enter key submits window (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! | | 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 | 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. | @@ -17455,7 +17479,7 @@ popup_quick_message(args=*<1 or N object>, font = None, no_titlebar = True, grab_anywhere = False, - keep_on_top = None, + keep_on_top = True, location = (None, None), relative_location = (None, None), image = None, @@ -17748,7 +17772,7 @@ Parameter Descriptions: |--|--|--| | 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, 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 | 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. | @@ -18562,7 +18586,7 @@ PopupQuickMessage(args=*<1 or N object>, font = None, no_titlebar = True, grab_anywhere = False, - keep_on_top = None, + keep_on_top = True, location = (None, None), relative_location = (None, None), image = None, @@ -19248,14 +19272,17 @@ then a default filename will be used. 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: |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 @@ -19497,14 +19524,15 @@ then a default filename will be used. 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: |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. If you don't choose a path, one is provided for you that is OS specific diff --git a/readme_creator/output/index.md b/readme_creator/output/index.md index 10995b3e..52331638 100644 --- a/readme_creator/output/index.md +++ b/readme_creator/output/index.md @@ -25,9 +25,9 @@ apply coupon for discount: - 09B234B00A7E89CC8C1F + 266B9C51C90B3728782E - @@ -1606,7 +1606,7 @@ Parameter Descriptions: |--|--|--| | 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, 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 | 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. |