diff --git a/PySimpleGUI.py b/PySimpleGUI.py index f9c818e9..152d6891 100644 --- a/PySimpleGUI.py +++ b/PySimpleGUI.py @@ -1,6 +1,6 @@ #!/usr/bin/python3 -version = __version__ = "4.45.0.49 Unreleased\nAdded exception details if have a problem with the wm_overriderediect. docstring fix. Text element - autosize with size of None, None creates an expanding Label widget with size and width of None and wraplen=0 (truely autosizing it appears!), Addition of project information to the issue" +version = __version__ = "4.46.0 Released 10-Aug-2021" __version__ = version.split()[0] # For PEP 396 and PEP 345 @@ -71,8 +71,9 @@ port = 'PySimpleGUI' 3. If you use PySimpleGUI in your project/product, a notice of its use needs to be displayed in your readme file ----------------------------------------------------------------------------------------------------------------- - How about having FUN with this package?? Terrible note to begin this journey of actually having fun making - GUI based applications so I'll try to make it up to you. + The PySimpleGUI project goals are simple: + 1. Have fun + 2. You, the user, are successful The first bit of good news for you is that literally 100s of pages of documentation await you. 300 Demo Programs have been written as a "jump start" mechanism to get your running as quickly as possible. @@ -89,6 +90,21 @@ port = 'PySimpleGUI' The User Manual and the Cookbook are both designed to paint some nice looking GUIs on your screen within 5 minutes of you deciding to PySimpleGUI out. + A note from your sponsor.... + “Don’t aim at success. The more you aim at it and make it a target, the more you are going to miss it. + For success, like happiness, cannot be pursued; it must ensue, and it only does so as the unintended side effect of one’s personal dedication to a cause greater.” + — Viktor Frankl + + I first saw this quote in a truncated format: + "Happiness, cannot be pursued; it must ensue, and it only does so as the unintended side effect of one’s personal dedication to a cause greater." + + Everyone is different, but my experience with the PySimpleGUI project matches this theory. It's taken a lifetime of trying and "failing" and trying + to find happiness before I finally figured this truth-for-me out. If I do a long list of things, and live life in a kind & loving way, then the + result is happiness. It's a biproduct, not a directly produced thing. This should be taught in school. Or maybe it can't. + I hope you find happiness, but more importantly, or maybe first, I hope you find that bigger-than-you thing. For me it's always been programming. It seems to be + the giving back part, not just the calling, that makes the happiness fusion-reactor operate. + + "Thank you" has fueled this project. I'm incredibly grateful to have users that are in turn grateful. It's a feedback loop of gratitude. What a fantastic thing! """ # all of the tkinter involved imports @@ -6259,6 +6275,15 @@ class TabGroup(Element): return value def add_tab(self, tab_element): + """ + Add a new tab to an existing TabGroup + This call was written so that tabs can be added at runtime as your user performs operations. + Your Window should already be created and finalized. + + :param tab_element: A Tab Element that has a layout in it + :type tab_element: Tab + """ + self.add_row(tab_element) tab_element.TKFrame = tab_element.Widget = tk.Frame(self.TKNotebook) form = self.ParentForm diff --git a/docs/call reference.md b/docs/call reference.md index a4d55533..258c3942 100644 --- a/docs/call reference.md +++ b/docs/call reference.md @@ -53,6 +53,8 @@ Button(button_text = "", key = None, k = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -84,13 +86,15 @@ Parameter Descriptions: | (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) | | bool | use_ttk_buttons | True = use ttk buttons. False = do not use ttk buttons. None (Default) = use ttk buttons only if on a Mac and not with button images | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | If True the return key will cause this button to be pressed | | bool | focus | if True, initial focus will be put on this button | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | 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. | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -459,6 +463,8 @@ ButtonMenu(button_text, font = None, item_font = None, pad = None, + expand_x = False, + expand_y = False, key = None, k = None, tearoff = False, @@ -486,10 +492,11 @@ Parameter Descriptions: | str | background_color | color of the background | | str | text_color | element's text color. Can be in #RRGGBB format or a color name "black" | | str | disabled_text_color | color to use for text when item is disabled. Can be in #RRGGBB format or a color name "black" | -| str or Tuple[str, int] | font | specifies the font family, size, etc | -| str or Tuple[str, int] | item_font | specifies the font family, size, etc, for the menu items | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | +| str or Tuple[str, int] | item_font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike, for the menu items | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| 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 | +| bool | key | Used with window.find_element and with return values to uniquely identify this element to uniquely identify this element :param expand_x: If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | 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 | tearoff | Determines if menus should allow them to be torn off | | bool | visible | set visibility state of the element | @@ -789,6 +796,8 @@ Canvas(canvas = None, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, border_width = 0, metadata = None) @@ -807,6 +816,8 @@ Parameter Descriptions: | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | int | border_width | width of border around element in pixels. Not normally used with Canvas element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -1082,6 +1093,8 @@ Checkbox(text, pad = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -1095,7 +1108,7 @@ Parameter Descriptions: | (int, int) or (None, None) | size | (width, height) width = characters-wide, height = rows-high | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_text | if True will size the element to match the length of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | background_color | color of background | | str | text_color | color of the text | | str | checkbox_color | color of background of the box that has the check mark in it. The checkmark is the same color as the text | @@ -1107,6 +1120,8 @@ Parameter Descriptions: | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | str | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -1817,6 +1832,8 @@ Combo(values, key = None, k = None, pad = None, + expand_x = False, + expand_y = False, tooltip = None, readonly = False, font = None, @@ -1828,25 +1845,26 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| List[Any] or Tuple[Any] | values | values to choose. While displayed as text, the items returned are what the caller supplied, not text | -| Any | default_value | Choice to be displayed as initial value. Must match one of values variable contents | -| (int, int) or (None, None) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list | -| (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | -| bool | auto_size_text | True if element should be the same size as the contents | -| str | background_color | color of background | -| str | text_color | color of the text | -| bool | bind_return_key | If True, then the return key will cause a the Combo to generate an event | -| bool | change_submits | DEPRICATED DO NOT USE. Use `enable_events` instead | -| bool | enable_events | Turns on the element specific events. Combo event is when a choice is made | -| bool | disabled | set disable state for element | -| 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 | k | Same as the Key. You can use either k or key. Which ever is set will be used. | -| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str | tooltip | text that will appear when mouse hovers over this element | -| bool | readonly | make element readonly (user can't change). True means user cannot change | -| str or (str, int) | font | specifies the font family, size, etc | -| bool | visible | set visibility state of the element | -| Any | metadata | User metadata that can be set to ANYTHING | +| List[Any] or Tuple[Any] | values | values to choose. While displayed as text, the items returned are what the caller supplied, not text | +| Any | default_value | Choice to be displayed as initial value. Must match one of values variable contents | +| (int, int) or (None, None) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list | +| (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | +| bool | auto_size_text | True if element should be the same size as the contents | +| str | background_color | color of background | +| str | text_color | color of the text | +| bool | bind_return_key | If True, then the return key will cause a the Combo to generate an event | +| bool | change_submits | DEPRICATED DO NOT USE. Use `enable_events` instead | +| bool | enable_events | Turns on the element specific events. Combo event is when a choice is made | +| bool | disabled | set disable state for element | +| 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 | k | Same as the Key. You can use either k or key. Which ever is set will be used. | +| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool) :param tooltip: text that will appear when mouse hovers over this element | expand_y | If True the element will automatically expand in the Y direction to fill available space | +| bool | readonly | make element readonly (user can't change). True means user cannot change | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | +| bool | visible | set visibility state of the element | +| Any | metadata | User metadata that can be set to ANYTHING | ### bind @@ -2069,7 +2087,7 @@ Parameter Descriptions: | int | set_to_index | change selection to a particular choice starting with index = 0 | | bool | disabled | disable or enable state of the element | | bool | readonly | if True make element readonly (user cannot change any choices). Enables the element if either choice are made. | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | control visibility of element | | (int, int) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list | @@ -2155,7 +2173,7 @@ Parameter Descriptions: | int | set_to_index | change selection to a particular choice starting with index = 0 | | bool | disabled | disable or enable state of the element | | bool | readonly | if True make element readonly (user cannot change any choices). Enables the element if either choice are made. | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | control visibility of element | | (int, int) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list | @@ -2181,6 +2199,8 @@ Frame(title, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, element_justification = "left", vertical_alignment = None, @@ -2199,13 +2219,15 @@ Parameter Descriptions: | enum | relief | relief style. Values are same as other elements with reliefs. Choices include RELIEF_RAISED RELIEF_SUNKEN RELIEF_FLAT RELIEF_RIDGE RELIEF_GROOVE RELIEF_SOLID | | (int, int) | size | (width, height) DO NOT use this. Instead, place your layout in a Column element with the size set on the Column element. Set pad=(0,0) on your Column | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | int | border_width | width of border around element in pixels | | str or int or tuple or object | key | Value that uniquely identifies this element from all other elements. Used when Finding an element or in return values. Must be unique to the window | | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | str | element_justification | All elements inside the Frame will have this justification 'left', 'right', 'center' are valid values | | str | vertical_alignment | Place the column at the 'top', 'center', 'bottom' of the row (can also use t,c,r). Defaults to no setting (tkinter decides) | @@ -2553,6 +2575,8 @@ Graph(canvas_size, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, float_values = False, border_width = 0, @@ -2575,6 +2599,8 @@ Parameter Descriptions: | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element (Default = True) | | bool | float_values | If True x,y coordinates are returned as floats, not ints | | int | border_width | width of border around element in pixels. Not normally used for Graph Elements | @@ -2869,7 +2895,7 @@ Parameter Descriptions: | Any | text | text to display | | (int, int) or Tuple[float, float] | location | location to place first letter | | str | color | text color | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | float | angle | Angle 0 to 360 to draw the text. Zero represents horizontal text | | enum | text_location | "anchor" location for the text. Values start with TEXT_LOCATION_ | | int or None | **RETURN** | id returned from tkinter that you'll need if you want to manipulate the text @@ -3394,7 +3420,7 @@ Parameter Descriptions: | Any | text | text to display | | (int, int) or Tuple[float, float] | location | location to place first letter | | str | color | text color | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | float | angle | Angle 0 to 360 to draw the text. Zero represents horizontal text | | enum | text_location | "anchor" location for the text. Values start with TEXT_LOCATION_ | | int or None | **RETURN** | id returned from tkinter that you'll need if you want to manipulate the text @@ -3807,6 +3833,8 @@ Image(filename = None, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, enable_events = False, metadata = None) @@ -3826,6 +3854,8 @@ Parameter Descriptions: | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | bool | enable_events | Turns on the element specific events. For an Image element, the event is "image clicked" | | Any | metadata | User metadata that can be set to ANYTHING | @@ -4178,6 +4208,8 @@ Input(default_text = "", readonly = False, disabled_readonly_background_color = None, disabled_readonly_text_color = None, + expand_x = False, + expand_y = False, right_click_menu = None, visible = True, metadata = None) @@ -4195,7 +4227,7 @@ Parameter Descriptions: | str | justification | justification for data display. Valid choices - left, right, center | | str | background_color | color of background in one of the color formats | | str | text_color | color of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | tooltip | text, that will appear when mouse hovers over the element | | int | border_width | width of border around element in pixels | | bool | change_submits | * DEPRICATED DO NOT USE. Use `enable_events` instead | @@ -4209,6 +4241,8 @@ Parameter Descriptions: | bool | readonly | If True tkinter state set to 'readonly'. Use this in place of use_readonly_for_disable as another way of achieving readonly. Note cannot set BOTH readonly and disabled as tkinter only supplies a single flag | | str | disabled_readonly_background_color | If state is set to readonly or disabled, the color to use for the background | | str | disabled_readonly_text_color | If state is set to readonly or disabled, the color to use for the text | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | | bool | visible | set visibility state of the element (Default = True) | | Any | metadata | User metadata that can be set to ANYTHING | @@ -4558,6 +4592,8 @@ Listbox(values, k = None, pad = None, tooltip = None, + expand_x = False, + expand_y = False, right_click_menu = None, visible = True, metadata = None) @@ -4577,7 +4613,7 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | disabled | set disable state for element | | bool | auto_size_text | True if element should be the same size as the contents | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_scrollbar | Controls if a scrollbar should be shown. If True, no scrollbar will be shown | | str | background_color | color of background | | str | text_color | color of the text | @@ -4587,6 +4623,8 @@ Parameter Descriptions: | 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. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | str | tooltip | text, that will appear when mouse hovers over the element | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -5006,7 +5044,7 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | tearoff | if True, then can tear the menu off from the window ans use as a floating window. Very cool effect | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or int or tuple or object | key | Value that uniquely identifies this element from all other elements. Used when Finding an element or in return values. Must be unique to the window | | 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 | visible | set visibility state of the element | @@ -5383,13 +5421,13 @@ Parameter Descriptions: | bool | reroute_cprint | If True your cprint calls will output to this element. It's the same as you calling cprint_set_output_destination | | bool | echo_stdout_stderr | If True then output to stdout and stderr will be output to this element AND also to the normal console location | | bool | focus | if True initial focus will go to this element | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | str | tooltip | text, that will appear when mouse hovers over the element | | str | justification | text justification. left, right, center. Can use single characters l, r, c. | | bool | no_scrollbar | If False then a scrollbar will be shown (the default) | -| bool | expand_x | If True the Multiline will automatically expand in the X direction to fill available space | -| bool | expand_y | If True the Multiline will automatically expand in the Y direction to fill available space | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -5535,7 +5573,7 @@ Parameter Descriptions: | str | text_color | The color of the text | | str | background_color | The background color of the line | | str | justification | text justification. left, right, center. Can use single characters l, r, c. Sets only for this value, not entire element | -| str or (str, int) or (str, int, str) | font | specifies the font family, size, etc for the args being printed | +| str or (str, int) or (str, int, str) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the args being printed | | str or str, str | colors | Either a tuple or a string that has both the text and background colors. Or just the text color | | str | t | Color of the text | | str | b | The background color of the line | @@ -5709,7 +5747,7 @@ Parameter Descriptions: | str | value | new text to display | | bool | disabled | disable or enable state of the element | | bool | append | if True then new value will be added onto the end of the current value. if False then contents will be replaced. | -| str or (str, int) | font | specifies the font family, size, etc for the entire element | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the entire element | | str | text_color | color of the text | | str | background_color | color of background | | str | text_color_for_value | color of the new text being added (the value paramter) | @@ -5717,7 +5755,7 @@ Parameter Descriptions: | bool | visible | set visibility state of the element | | bool | autoscroll | if True then contents of element are scrolled down when new text is added to the end | | str | justification | text justification. left, right, center. Can use single characters l, r, c. Sets only for this value, not entire element | -| str or (str, int) | font_for_value | specifies the font family, size, etc for the value being updated | +| str or (str, int) | font_for_value | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the value being updated | ### visible @@ -5799,7 +5837,7 @@ Parameter Descriptions: | str | value | new text to display | | bool | disabled | disable or enable state of the element | | bool | append | if True then new value will be added onto the end of the current value. if False then contents will be replaced. | -| str or (str, int) | font | specifies the font family, size, etc for the entire element | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the entire element | | str | text_color | color of the text | | str | background_color | color of background | | str | text_color_for_value | color of the new text being added (the value paramter) | @@ -5807,7 +5845,7 @@ Parameter Descriptions: | bool | visible | set visibility state of the element | | bool | autoscroll | if True then contents of element are scrolled down when new text is added to the end | | str | justification | text justification. left, right, center. Can use single characters l, r, c. Sets only for this value, not entire element | -| str or (str, int) | font_for_value | specifies the font family, size, etc for the value being updated | +| str or (str, int) | font_for_value | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the value being updated | --------- @@ -5825,6 +5863,8 @@ OptionMenu(values, s = (None, None), disabled = False, auto_size_text = None, + expand_x = False, + expand_y = False, background_color = None, text_color = None, key = None, @@ -5845,6 +5885,8 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | disabled | control enabled / disabled | | bool | auto_size_text | True if size of Element should match the contents of the items | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | str | background_color | color of background | | str | text_color | color of the text | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element | @@ -6163,6 +6205,8 @@ Output(size = (None, None), key = None, k = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -6177,11 +6221,13 @@ Parameter Descriptions: | str | text_color | color of the text | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | bool | echo_stdout_stderr | If True then output to stdout will be output to this element AND also to the normal console location | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | tooltip | text, that will appear when mouse hovers over the 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. | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -6504,6 +6550,8 @@ Pane(pane_list, border_width = None, key = None, k = None, + expand_x = None, + expand_y = None, visible = True, metadata = None) ``` @@ -6524,6 +6572,8 @@ Parameter Descriptions: | int | border_width | width of border around element in pixels | | str or int or tuple or object | key | Value that uniquely identifies this element from all other elements. Used when Finding an element or in return values. Must be unique to the window | | 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 | expand_x | If True the column will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the column will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -6802,6 +6852,8 @@ ProgressBar(max_value, k = None, pad = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -6823,6 +6875,8 @@ Parameter Descriptions: | 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. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -7134,6 +7188,8 @@ Radio(text, change_submits = False, enable_events = False, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -7152,7 +7208,7 @@ Parameter Descriptions: | str | background_color | color of background | | str | text_color | color of the text | | str | circle_color | color of background of the circle that has the dot selection indicator in it | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | 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 | k | Same as the Key. You can use either k or key. Which ever is set will be used. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | @@ -7160,6 +7216,8 @@ Parameter Descriptions: | bool | change_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | enable_events | Turns on the element specific events. Radio Button events happen when an item is selected | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -7487,7 +7545,7 @@ Parameter Descriptions: The color will match the theme's background color. ``` -Sizegrip(background_color = None) +Sizegrip(background_color = None, key = None) ``` Parameter Descriptions: @@ -7723,6 +7781,8 @@ Slider(range = (None, None), key = None, k = None, pad = None, + expand_x = False, + expand_y = False, tooltip = None, visible = True, metadata = None) @@ -7745,13 +7805,15 @@ Parameter Descriptions: | bool | disabled | set disable state for element | | (int, int) | size | (w=characters-wide, h=rows-high) | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | background_color | color of slider's background | | str | text_color | color of the slider's text | | str | trough_color | color of the slider's trough | | str or int or tuple or object | key | Value that uniquely identifies this element from all other elements. Used when Finding an element or in return values. Must be unique to the window | | 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. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -8047,6 +8109,8 @@ Spin(values, pad = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -8064,7 +8128,7 @@ Parameter Descriptions: | (int, int) or (None, None) | size | (width, height) width = characters-wide, height = rows-high | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_text | if True will size the element to match the length of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | background_color | color of background | | str | text_color | color of the text | | str or int or tuple or object | key | Used with window.find_element and with return values to uniquely identify this element | @@ -8072,6 +8136,8 @@ Parameter Descriptions: | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | str | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -8398,6 +8464,8 @@ StatusBar(text, key = None, k = None, right_click_menu = None, + expand_x = False, + expand_y = False, tooltip = None, visible = True, metadata = None) @@ -8414,7 +8482,7 @@ Parameter Descriptions: | bool | click_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | enable_events | Turns on the element specific events. StatusBar events occur when the bar is clicked | | enum | relief | relief style. Values are same as progress meter relief values. Can be a constant or a string: `RELIEF_RAISED RELIEF_SUNKEN RELIEF_FLAT RELIEF_RIDGE RELIEF_GROOVE RELIEF_SOLID` | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | text_color | color of the text | | str | background_color | color of background | | str | justification | how string should be aligned within space provided by size. Valid choices = `left`, `right`, `center` | @@ -8422,6 +8490,8 @@ Parameter Descriptions: | 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. | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -8628,7 +8698,7 @@ Parameter Descriptions: | str | value | new text to show | | str | background_color | color of background | | str | text_color | color of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | set visibility state of the element | ### visible @@ -8694,7 +8764,7 @@ Parameter Descriptions: | str | value | new text to show | | str | background_color | color of background | | str | text_color | color of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | set visibility state of the element | --------- @@ -8717,6 +8787,8 @@ Tab(title, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, element_justification = "left", metadata = None) @@ -8730,7 +8802,7 @@ Parameter Descriptions: | List[List[Element]] | layout | The element layout that will be shown in the tab | | str | title_color | color of the tab text (note not currently working on tkinter) | | str | background_color | color of background of the entire layout | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | bool | disabled | If True button will be created disabled | | int | border_width | width of border around element in pixels | @@ -8738,6 +8810,8 @@ Parameter Descriptions: | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | str | element_justification | All elements inside the Tab will have this justification 'left', 'right', 'center' are valid values | | Any | metadata | User metadata that can be set to ANYTHING | @@ -9105,6 +9179,8 @@ TabGroup(layout, s = (None, None), tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -9120,7 +9196,7 @@ Parameter Descriptions: | str | selected_title_color | color of tab text when it is selected | | str | selected_background_color | color of tab when it is selected | | str | background_color | color of background area that tabs are located on | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | change_submits | * DEPRICATED DO NOT USE. Use `enable_events` instead | | bool | enable_events | If True then switching tabs will generate an Event | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | @@ -9132,9 +9208,27 @@ Parameter Descriptions: | (intorNone, intorNone) | 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 | | str | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | +### add_tab + +Add a new tab to an existing TabGroup +This call was written so that tabs can be added at runtime as your user performs operations. +Your Window should already be created and finalized. + +``` +add_tab(tab_element) +``` + +Parameter Descriptions: + +|Type|Name|Meaning| +|--|--|--| +| Tab | tab_element | A Tab Element that has a layout in it | + ### bind Used to add tkinter events to an Element. @@ -9470,6 +9564,8 @@ Table(values, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -9489,7 +9585,7 @@ Parameter Descriptions: | bool | display_row_numbers | if True, the first column of the table will be the row # | | int | num_rows | The number of rows of the table to display at a time | | int | row_height | height of a single row in pixels | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | justification | 'left', 'right', 'center' are valid choices | | str | text_color | color of the text | | str | background_color | color of background | @@ -9497,7 +9593,7 @@ Parameter Descriptions: | str or (str, str) | selected_row_colors | Sets the text color and background color for a selected row. Same format as button colors - tuple ('red', 'yellow') or string 'red on yellow'. Defaults to theme's button color | | str | header_text_color | sets the text color for the header | | str | header_background_color | sets the background color for the header | -| str or Tuple[str, int] | header_font | specifies the font family, size, etc | +| str or Tuple[str, int] | header_font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | List[Tuple[int, str] or Tuple[Int, str, str]] | row_colors | list of tuples of (row, background color) OR (row, foreground color, background color). Sets the colors of listed rows to the color(s) provided (note the optional foreground color) | | bool | vertical_scroll_only | if True only the vertical scrollbar will be visible | | bool | hide_vertical_scroll | if True vertical scrollbar will be hidden | @@ -9510,6 +9606,8 @@ Parameter Descriptions: | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -9835,6 +9933,8 @@ Text(text = "", key = None, k = None, right_click_menu = None, + expand_x = False, + expand_y = False, grab = None, tooltip = None, visible = True, @@ -9852,7 +9952,7 @@ Parameter Descriptions: | bool | click_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | enable_events | Turns on the element specific events. Text events happen when the text is clicked | | (str/enum) | relief | relief style around the text. Values are same as progress meter relief values. Should be a constant that is defined at starting with "RELIEF_" - `RELIEF_RAISED, RELIEF_SUNKEN, RELIEF_FLAT, RELIEF_RIDGE, RELIEF_GROOVE, RELIEF_SOLID` | -| (str or (str, int) or None) | font | specifies the font family, size, etc | +| (str or (str, int) or None) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | text_color | color of the text | | str | background_color | color of background | | int | border_width | number of pixels for the border (if using a relief) | @@ -9861,6 +9961,8 @@ Parameter Descriptions: | 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. | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | grab | If True can grab this element and move the window around. Default is False | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | visible | set visibility state of the element | @@ -10061,7 +10163,7 @@ Parameter Descriptions: | str | value | new text to show | | str | background_color | color of background | | str | text_color | color of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | set visibility state of the element | ### visible @@ -10137,7 +10239,7 @@ Parameter Descriptions: | str | value | new text to show | | str | background_color | color of background | | str | text_color | color of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | set visibility state of the element | --------- @@ -10222,6 +10324,8 @@ Tree(data = None, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -10242,14 +10346,14 @@ Parameter Descriptions: | bool | show_expanded | if True then the tree will be initially shown with all nodes completely expanded | | bool | change_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | enable_events | Turns on the element specific events. Tree events happen when row is clicked | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | justification | 'left', 'right', 'center' are valid choices | | str | text_color | color of the text | | str | background_color | color of background | | str or (str, str) | selected_row_colors | Sets the text color and background color for a selected row. Same format as button colors - tuple ('red', 'yellow') or string 'red on yellow'. Defaults to theme's button color | | str | header_text_color | sets the text color for the header | | str | header_background_color | sets the background color for the header | -| str or Tuple[str, int] | header_font | specifies the font family, size, etc | +| str or Tuple[str, int] | header_font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | int | num_rows | The number of rows of the table to display at a time | | int | row_height | height of a single row in pixels | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | @@ -10257,6 +10361,8 @@ Parameter Descriptions: | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[str] or str]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -10877,15 +10983,18 @@ User Settings ``` UserSettings(filename = None, path = None, - silent_on_error = False) + silent_on_error = False, + autosave = True) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| (str or None) | filename | The name of the file to use. Can be a full path and filename or just filename | -| (str or None) | path | The folder that the settings file will be stored in. Do not include the filename. | +| (str or None) | filename | The name of the file to use. Can be a full path and filename or just filename | +| (str or None) | path | The folder that the settings file will be stored in. Do not include the filename. | +| bool | silent_on_error | If True errors will not be reported | +| bool | autosave | If True the settings file is saved after every update | ### delete_entry @@ -11052,8 +11161,9 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| Any | key | Setting to be saved. Can be any valid dictionary key type | -| Any | value | Value to save as the setting's value. Can be anything | +| Any | key | Setting to be saved. Can be any valid dictionary key type | +| Any | value | Value to save as the setting's value. Can be anything | +| bool | autosave | If True then the value will be saved to the file | | (Any) | **RETURN** | value that key was set to ### set_default_value @@ -11173,7 +11283,7 @@ Parameter Descriptions: | (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) | | (int, int) | margins | (left/right, top/bottom) Amount of pixels to leave inside the window's frame around the edges before your elements are shown. | | (str, str) or str | button_color | Default button colors for all buttons in the window | -| str or Tuple[str, int] or None | font | specifies the font family, size, etc | +| str or Tuple[str, int] or None | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (str, str) | progress_bar_color | (bar color, background color) Sets the default colors for all progress bars in the window | | str | background_color | color of background | | int | border_depth | Default border depth (width) for all elements in the window | @@ -11631,6 +11741,23 @@ Restore a window to a non-maximized state. Does different things depending on p normal() ``` +### perform_long_operation + +Call your function that will take a long time to execute. When it's complete, send an event +specified by the end_key. + +``` +perform_long_operation(func, end_key) +``` + +Parameter Descriptions: + +|Type|Name|Meaning| +|--|--|--| +| Any | func | A lambda or a function name with no parms | +| Any | end_key | The key that will be generated when the function returns | +| threading.Thread | **RETURN** | The id of the thread + ### read THE biggest deal method in the Window class! This is how you get all of your data from your Window. @@ -12726,7 +12853,7 @@ Parameter Descriptions: | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | @@ -12770,7 +12897,7 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | @@ -12819,7 +12946,7 @@ Parameter Descriptions: | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | If True, then the return key will cause a the Listbox to generate an event | | bool | focus | Determines if initial focus should go to this element. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | @@ -12855,7 +12982,7 @@ Parameter Descriptions: | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | | focus | if focus should be set to this | @@ -12902,7 +13029,7 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | focus | if focus should be set to this | @@ -12940,7 +13067,7 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | @@ -12984,7 +13111,7 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | change_submits | If True, pressing Enter key submits window (Default = False) | | bool | enable_events | Turns on the element specific events.(Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | disabled | set disable state for element (Default = False) | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | | str or int or tuple or object | key | key for uniquely identify this element (for window.find_element) | @@ -13030,7 +13157,7 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | change_submits | If True, pressing Enter key submits window (Default = False) | | bool | enable_events | Turns on the element specific events.(Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | | str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | @@ -13076,7 +13203,7 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | change_submits | If True, pressing Enter key submits window (Default = False) | | bool | enable_events | Turns on the element specific events.(Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | | str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | @@ -13118,7 +13245,7 @@ Parameter Descriptions: | 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) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element | | 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 | k | Same as the Key. You can use either k or key. Which ever is set will be used. | @@ -13152,7 +13279,7 @@ Parameter Descriptions: | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | | focus | if focus should be set to this | @@ -13190,7 +13317,7 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | @@ -13228,7 +13355,7 @@ Parameter Descriptions: | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | | str or int or tuple or object | key | key for uniquely identify this element (for window.find_element) | @@ -13293,7 +13420,7 @@ Parameter Descriptions: | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | | str or int or tuple or object | key | key for uniquely identify this element (for window.find_element) | @@ -13330,7 +13457,7 @@ Parameter Descriptions: | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | | str or int or tuple or object | key | key for uniquely identify this element (for window.find_element) | @@ -13366,7 +13493,7 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | @@ -13411,7 +13538,7 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | focus | if focus should be set to this | @@ -13451,7 +13578,7 @@ Parameter Descriptions: | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | | str or int or tuple or object | key | key for uniquely identify this element (for window.find_element) | @@ -13497,7 +13624,7 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | change_submits | If True, pressing Enter key submits window (Default = False) | | bool | enable_events | Turns on the element specific events.(Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | | str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | @@ -13533,7 +13660,7 @@ Parameter Descriptions: | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | | str or int or tuple or object | key | key for uniquely identify this element (for window.find_element) | @@ -13569,7 +13696,7 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | @@ -13619,7 +13746,7 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | disabled | set disable state for element (Default = False) | | idk_yetReally | focus | if focus should be set to this | @@ -13666,7 +13793,7 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | disabled | set disable state for element (Default = False) | | idk_yetReally | focus | if focus should be set to this | @@ -13713,7 +13840,7 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | disabled | set disable state for element (Default = False) | | idk_yetReally | focus | if focus should be set to this | @@ -13759,7 +13886,7 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | disabled | set disable state for element (Default = False) | | idk_yetReally | focus | if focus should be set to this | @@ -13792,6 +13919,7 @@ easy_print(args=*<1 or N object>, grab_anywhere = False, keep_on_top = False, do_not_reroute_stdout = True, + echo_stdout = False, text_color = None, background_color = None, colors = None, @@ -13809,7 +13937,7 @@ Parameter Descriptions: | str | end | end character | | str | sep | separator character | | (int, int) | location | Location of upper left corner of the window | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | no_button | don't show button | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | @@ -13817,7 +13945,8 @@ Parameter Descriptions: | str | text_color | color of the text | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | -| bool | do_not_reroute_stdout | do not reroute stdout | +| bool | do_not_reroute_stdout | do not reroute stdout and stderr. If False, both stdout and stderr will reroute to here | +| bool | echo_stdout | If True stdout is sent to both the console and the debug window | | str or str, str | colors | Either a tuple or a string that has both the text and background colors | | str or str, str | c | Either a tuple or a string that has both the text and background colors | | bool | resizable | if True, the user can resize the debug window. Default is True | @@ -13850,6 +13979,7 @@ eprint(args=*<1 or N object>, grab_anywhere = False, keep_on_top = False, do_not_reroute_stdout = True, + echo_stdout = False, text_color = None, background_color = None, colors = None, @@ -13867,7 +13997,7 @@ Parameter Descriptions: | str | end | end character | | str | sep | separator character | | (int, int) | location | Location of upper left corner of the window | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | no_button | don't show button | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | @@ -13875,7 +14005,8 @@ Parameter Descriptions: | str | text_color | color of the text | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | -| bool | do_not_reroute_stdout | do not reroute stdout | +| bool | do_not_reroute_stdout | do not reroute stdout and stderr. If False, both stdout and stderr will reroute to here | +| bool | echo_stdout | If True stdout is sent to both the console and the debug window | | str or str, str | colors | Either a tuple or a string that has both the text and background colors | | str or str, str | c | Either a tuple or a string that has both the text and background colors | | bool | resizable | if True, the user can resize the debug window. Default is True | @@ -13902,6 +14033,7 @@ sgprint(args=*<1 or N object>, grab_anywhere = False, keep_on_top = False, do_not_reroute_stdout = True, + echo_stdout = False, text_color = None, background_color = None, colors = None, @@ -13919,7 +14051,7 @@ Parameter Descriptions: | str | end | end character | | str | sep | separator character | | (int, int) | location | Location of upper left corner of the window | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | no_button | don't show button | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | @@ -13927,7 +14059,8 @@ Parameter Descriptions: | str | text_color | color of the text | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | -| bool | do_not_reroute_stdout | do not reroute stdout | +| bool | do_not_reroute_stdout | do not reroute stdout and stderr. If False, both stdout and stderr will reroute to here | +| bool | echo_stdout | If True stdout is sent to both the console and the debug window | | str or str, str | colors | Either a tuple or a string that has both the text and background colors | | str or str, str | c | Either a tuple or a string that has both the text and background colors | | bool | resizable | if True, the user can resize the debug window. Default is True | @@ -13960,6 +14093,7 @@ EasyPrint(args=*<1 or N object>, grab_anywhere = False, keep_on_top = False, do_not_reroute_stdout = True, + echo_stdout = False, text_color = None, background_color = None, colors = None, @@ -13977,7 +14111,7 @@ Parameter Descriptions: | str | end | end character | | str | sep | separator character | | (int, int) | location | Location of upper left corner of the window | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | no_button | don't show button | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | @@ -13985,7 +14119,8 @@ Parameter Descriptions: | str | text_color | color of the text | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | -| bool | do_not_reroute_stdout | do not reroute stdout | +| bool | do_not_reroute_stdout | do not reroute stdout and stderr. If False, both stdout and stderr will reroute to here | +| bool | echo_stdout | If True stdout is sent to both the console and the debug window | | str or str, str | colors | Either a tuple or a string that has both the text and background colors | | str or str, str | c | Either a tuple or a string that has both the text and background colors | | bool | resizable | if True, the user can resize the debug window. Default is True | @@ -14018,6 +14153,7 @@ Print(args=*<1 or N object>, grab_anywhere = False, keep_on_top = False, do_not_reroute_stdout = True, + echo_stdout = False, text_color = None, background_color = None, colors = None, @@ -14035,7 +14171,7 @@ Parameter Descriptions: | str | end | end character | | str | sep | separator character | | (int, int) | location | Location of upper left corner of the window | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | no_button | don't show button | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | @@ -14043,7 +14179,8 @@ Parameter Descriptions: | str | text_color | color of the text | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | -| bool | do_not_reroute_stdout | do not reroute stdout | +| bool | do_not_reroute_stdout | do not reroute stdout and stderr. If False, both stdout and stderr will reroute to here | +| bool | echo_stdout | If True stdout is sent to both the console and the debug window | | str or str, str | colors | Either a tuple or a string that has both the text and background colors | | str or str, str | c | Either a tuple or a string that has both the text and background colors | | bool | resizable | if True, the user can resize the debug window. Default is True | @@ -14107,7 +14244,7 @@ Parameter Descriptions: |--|--|--| | Any | *args | stuff to output | | str | text_color | Color of the text | -| str or (str, int) or (str, int, str) | font | specifies the font family, size, etc for the value being updated | +| str or (str, int) or (str, int, str) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the value being updated | | str | background_color | The background color of the line | | str or str, str | colors | Either a tuple or a string that has both the text and background colors "text on background" or just the text color | | str | t | Color of the text | @@ -14149,7 +14286,8 @@ OneLineProgressMeter(title, border_width = None, grab_anywhere = False, no_titlebar = False, - keep_on_top = False) + keep_on_top = False, + no_button = False) ``` Parameter Descriptions: @@ -14169,6 +14307,7 @@ Parameter Descriptions: | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | no_titlebar | If True: no titlebar will be shown on the window | | bool | keep_on_top | If True the window will remain above all current windows | +| bool | no_button | If True: window will be created without a cancel button | | (bool) | **RETURN** | True if updated successfully. False if user closed the meter with the X or Cancel button Cancels and closes a previously created One Line Progress Meter window @@ -14197,7 +14336,8 @@ one_line_progress_meter(title, border_width = None, grab_anywhere = False, no_titlebar = False, - keep_on_top = False) + keep_on_top = False, + no_button = False) ``` Parameter Descriptions: @@ -14217,6 +14357,7 @@ Parameter Descriptions: | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | no_titlebar | If True: no titlebar will be shown on the window | | bool | keep_on_top | If True the window will remain above all current windows | +| bool | no_button | If True: window will be created without a cancel button | | (bool) | **RETURN** | True if updated successfully. False if user closed the meter with the X or Cancel button Cancels and closes a previously created One Line Progress Meter window @@ -14276,7 +14417,7 @@ Parameter Descriptions: | bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. | | str or bytes | icon | icon to display on the window. Same format as a Window call | | int | line_width | Width of lines in characters. Defaults to MESSAGE_BOX_LINE_WIDTH | -| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc | +| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True will not show the frame around the window and the titlebar across the top | | bool | grab_anywhere | If True can grab anywhere to move the window. If no_titlebar is True, grab_anywhere should likely be enabled too | | (int, int) | location | Location on screen to display the top left corner of window. Defaults to window centered on screen | @@ -14316,7 +14457,7 @@ Parameter Descriptions: | str | message | An optional message to be shown with the animation | | str | background_color | color of background | | str | text_color | color of the text | -| str or tuple | font | specifies the font family, size, etc | +| str or tuple | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True then the titlebar and window frame will not be shown | | bool | grab_anywhere | If True then you can move the window just clicking anywhere on window, hold and drag | | bool | keep_on_top | If True then Window will remain on top of all other windows currently shownn | @@ -14366,7 +14507,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14411,7 +14552,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14456,7 +14597,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14550,7 +14691,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14600,7 +14741,7 @@ Parameter Descriptions: | str | background_color | color of background | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14646,7 +14787,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the message text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True can click and drag anywhere in the window to move the window | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14711,7 +14852,7 @@ Parameter Descriptions: | bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. (Default = False) | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -14756,7 +14897,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | @@ -14802,7 +14943,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -14875,7 +15016,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14920,7 +15061,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14967,7 +15108,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15015,7 +15156,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -15066,7 +15207,7 @@ Parameter Descriptions: | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or bytes | image | Image to include at the top of the popup window | | bytes or str | icon | filename or base64 string to be used for the window's icon | | bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | @@ -15109,7 +15250,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15163,7 +15304,7 @@ Parameter Descriptions: | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or bytes | image | Image to include at the top of the popup window | | bytes or str | icon | filename or base64 string to be used for the window's icon | | bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | @@ -15213,7 +15354,7 @@ Parameter Descriptions: | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or bytes | image | Image to include at the top of the popup window | | bytes or str | icon | filename or base64 string to be used for the window's icon | | bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | @@ -15268,7 +15409,7 @@ Parameter Descriptions: | bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. | | str or bytes | icon | icon to display on the window. Same format as a Window call | | int | line_width | Width of lines in characters. Defaults to MESSAGE_BOX_LINE_WIDTH | -| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc | +| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True will not show the frame around the window and the titlebar across the top | | bool | grab_anywhere | If True can grab anywhere to move the window. If no_titlebar is True, grab_anywhere should likely be enabled too | | (int, int) | location | Location on screen to display the top left corner of window. Defaults to window centered on screen | @@ -15308,7 +15449,7 @@ Parameter Descriptions: | str | message | An optional message to be shown with the animation | | str | background_color | color of background | | str | text_color | color of the text | -| str or tuple | font | specifies the font family, size, etc | +| str or tuple | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True then the titlebar and window frame will not be shown | | bool | grab_anywhere | If True then you can move the window just clicking anywhere on window, hold and drag | | bool | keep_on_top | If True then Window will remain on top of all other windows currently shownn | @@ -15357,7 +15498,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | @@ -15403,7 +15544,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15448,7 +15589,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15493,7 +15634,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15548,7 +15689,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15598,7 +15739,7 @@ Parameter Descriptions: | str | background_color | color of background | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15644,7 +15785,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the message text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True can click and drag anywhere in the window to move the window | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15690,7 +15831,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | @@ -15732,7 +15873,7 @@ Parameter Descriptions: | bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. (Default = False) | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -15777,7 +15918,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | @@ -15822,7 +15963,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | @@ -15868,7 +16009,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -15912,7 +16053,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15957,7 +16098,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -16004,7 +16145,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -16052,7 +16193,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -16103,7 +16244,7 @@ Parameter Descriptions: | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or bytes | image | Image to include at the top of the popup window | | bytes or str | icon | filename or base64 string to be used for the window's icon | | bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | @@ -16148,7 +16289,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -16193,7 +16334,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -17140,7 +17281,7 @@ Parameter Descriptions: | (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) | | bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show | | bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | int | border_width | width of border around element | | int | slider_border_width | Width of the border around sliders | | str | slider_relief | Type of relief to use for sliders | @@ -17262,7 +17403,7 @@ Parameter Descriptions: | (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) | | bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show | | bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | int | border_width | width of border around element | | int | slider_border_width | Width of the border around sliders | | str | slider_relief | Type of relief to use for sliders | diff --git a/docs/index.md b/docs/index.md index 9cbba920..52c0a04f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1474,7 +1474,7 @@ Parameter Descriptions: | bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. | | str or bytes | icon | icon to display on the window. Same format as a Window call | | int | line_width | Width of lines in characters. Defaults to MESSAGE_BOX_LINE_WIDTH | -| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc | +| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True will not show the frame around the window and the titlebar across the top | | bool | grab_anywhere | If True can grab anywhere to move the window. If no_titlebar is True, grab_anywhere should likely be enabled too | | (int, int) | location | Location on screen to display the top left corner of window. Defaults to window centered on screen | @@ -1545,7 +1545,7 @@ Parameter Descriptions: | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or bytes | image | Image to include at the top of the popup window | | bytes or str | icon | filename or base64 string to be used for the window's icon | | bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | @@ -1610,7 +1610,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -1673,7 +1673,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the message text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True can click and drag anywhere in the window to move the window | | bool | keep_on_top | If True the window will remain above all current windows | @@ -1742,7 +1742,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -1815,7 +1815,7 @@ Parameter Descriptions: | str | background_color | color of background | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -1872,7 +1872,7 @@ Parameter Descriptions: | str | message | An optional message to be shown with the animation | | str | background_color | color of background | | str | text_color | color of the text | -| str or tuple | font | specifies the font family, size, etc | +| str or tuple | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True then the titlebar and window frame will not be shown | | bool | grab_anywhere | If True then you can move the window just clicking anywhere on window, hold and drag | | bool | keep_on_top | If True then Window will remain on top of all other windows currently shownn | @@ -1881,7 +1881,7 @@ Parameter Descriptions: | int | time_between_frames | Amount of time in milliseconds between each frame | | str | transparent_color | This color will be completely see-through in your window. Can even click through | | str | title | Title that will be shown on the window | -| str | icon | Same as Window icon parameter. Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | +| str or bytes | icon | Same as Window icon parameter. Can be either a filename or Base64 byte string. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | | bool | **RETURN** | True if the window updated OK. False if the window was closed ***To close animated popups***, call PopupAnimated with `image_source=None`. This will close all of the currently open PopupAnimated windows. @@ -1901,7 +1901,9 @@ one_line_progress_meter(title, size = (20, 20), border_width = None, grab_anywhere = False, - no_titlebar = False) + no_titlebar = False, + keep_on_top = False, + no_button = False) ``` Parameter Descriptions: @@ -1920,6 +1922,8 @@ Parameter Descriptions: | int | border_width | width of border around element | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | no_titlebar | If True: no titlebar will be shown on the window | +| bool | keep_on_top | If True the window will remain above all current windows | +| bool | no_button | If True: window will be created without a cancel button | | (bool) | **RETURN** | True if updated successfully. False if user closed the meter with the X or Cancel button Here's the one-line Progress Meter in action! @@ -3758,6 +3762,23 @@ To specify an underlined, Helvetica font with a size of 15 the values: ('Helvetica', 15, 'underline italics') 'Helvetica 15 underline italics' +**Font Style - Valid font styles include:** + +* italic +* roman +* bold +* normal +* underline +* overstrike + +An example with many styles is: + +```python +font='Courier 12 italic bold underline overstrike' +``` + +The same styles can be used with the tuple format for fonts. + #### Key See the section above that has full information about keys. @@ -8818,6 +8839,72 @@ Happy 1M installs and 3 year anniversary edition! * Fix for combo and input element readonly state not being recalled when updating disabled value * Moved *args to end in one_line_progress_meter +## 4.46.0 PySimpleGUI 10-Aug-2021 + +McRelease - Lots of Mac changes including new Mac patch control panel in global settings +expand_x, expand_y in the constructors +docstrings reformatted +Text Elements really autosize now + +Multiline.print & cprint + * Added autoscroll parameter - defaults to True (backward compatible) + * will now take a single color and use as text color +Text element - autosize with size of None, None creates an expanding Label widget with size and width of None and wraplen=0 (truely autosizing it appears!), +ButtonMenu + * use font for button as menu font if none is supplied + * fixed mutible problem - makes a copy of menu definition when making ButtonMenu + * made menu definition optional so can change only some other settings +Mac + * New window added to control the patches and feature disables. Access by calling main_mac_feature_control or through the global settings window from main() + * Disables grab anywhere if a titlebar is present + * Right click menu bound to Button2 which is the right button on a Mac (Button3 for all other systems) + * FINALLY found the no-titlebar problem - weird tkinter bug. Can't set alpha channel while making window if no titlebar on Mac (credit to Tanay for this find!!) + * Allowed Modal windows again + * Will not try to apply no titlebar patch if tkinter version >= 8.6.10 regardless of user settings + * Disable the alpha chan to zero if the no titlebar patch is set on the Mac. Will see the window move to center of screen for these windows. + * Added no-titlebar batch to toolore neetips +Fixed problem with titles on some Linux systems - set class_ for Toplevel windows +Menu defintion bug fix - when menu shortcut char in first pos and item is disabled !&Item +Sizegrip - fixed expansion problem +Added kill application button to error popup +one_line_progress_meter + * keep_on_top parameter added + * no_button parameter added so that no cancel button is shown +Deprication warning added to FindElement as first step of moving out of non-PEP8 world, +Added TabGroup.add_tab to add new tab to TabGroup at runtime +execute_py_file + * set cwd='.' if dir not found + * check for file exists +Right click menu + * added to Radio Checkbox Tabgroup Spin Slider + * Elements that don't have a right_click_menu parm now pick up the default from the Window + * Added a right click menu callback to cover portions of the window that don't have an element on them + * Changed Button binding for Mac to Button2 (the right button rather than middle on the other systems) + * Made right click menus based on button release (MUCH better) +docstrings + * Reformatted all docstrings to line up the desriptions for better readability + * Added type and rtype to docstrings that were missing any entries + * Updated all font entires in docstrings to include list as well as string +Added stderr to Debug print if rerouting stdout +expand_x and expand_y now in the constructor of all elements. No longer need to call Element.expand after finalizing window if using these. +Added Window.perform_long_operation to automatically run users functions as threads +Fixed Text.get() was returning not the latest value when set by another element +Set cursor color to the same as the text color for Input Combo Spin Multiline Output +Added echo_stdout to debug print so that stdout can be captured when run as a subprocess +Addition of autosave parameter for UserSettings +Test harness + Made progress meter shorter so that the test harness fit better on smaller screens (a constant battle) + Compacted Test Harness significantly so it's 690x670 +Added Sizegrip to Debug Window +New Grab Anywhere move code +Move all windows at the same timed if using grab_anywhere (experimental) (set Window._move_all_windows = True) +Table element - set the headers to stretch if expand_x is True +Element.set_size - if Graph element then also set the member variable CanvasSize +added exception details when making window with 0 alpha +Check for no color setting when setting the cursor color for inputs (must test for gray gray gray theme in the future regression tests) +Added exception details if have a problem with the wm_overriderediect +Addition of "project information" to the issue - your opportunity to share something about what you're making + ## Upcoming The future for PySimpleGUI looks bright! @@ -8889,7 +8976,7 @@ If you've helped, I sure hope that you feel like you've been properly thanked. In response to a number of email contacts from individuals and corporations that are using PySimpleGUI that wanted to financially support the project a "Support" Button was added to the GitHub site. This support button is connected with a PayPal account. If you wish to help support this currently freely supplied software and free technical support, then follow this link: www.paypal.me/psgui . -To be clear, this is not a solicitation for your money. No one is being directly asked to support / contribute. The project is self-funded and there are ongoing costs just to offer the software (URLs, ReadTheDocs, etc). If you're a corporate user and find that PySimpleGUI is helping you financially, that's awesome. If you want to help ensure PySimpleGUI has a future, you now have that option to help. It's likely that at some point the costs will become too high for the project to continue to be free, but until then we'll all enjoy the successes we're having. +The project is self-funded and there are ongoing costs just to offer the software (URLs, ReadTheDocs, etc). If you're a corporate user and find that PySimpleGUI is helping you financially, that's awesome. If you want to help ensure PySimpleGUI has a future, you now have that option to help. It's likely that at some point the costs will become too high for the project to continue to be free or perhaps continue at all, but until then we'll all enjoy the successes we're having. ## Legal diff --git a/readme_creator/markdown input files/2_readme.md b/readme_creator/markdown input files/2_readme.md index 960c9473..b2e15725 100644 --- a/readme_creator/markdown input files/2_readme.md +++ b/readme_creator/markdown input files/2_readme.md @@ -2190,6 +2190,24 @@ To specify an underlined, Helvetica font with a size of 15 the values: ('Helvetica', 15, 'underline italics') 'Helvetica 15 underline italics' +**Font Style - Valid font styles include:** + +* italic +* roman +* bold +* normal +* underline +* overstrike + +An example with many styles is: + +```python +font='Courier 12 italic bold underline overstrike' +``` + +The same styles can be used with the tuple format for fonts. + + #### Key See the section above that has full information about keys. diff --git a/readme_creator/markdown input files/4_Release_notes.md b/readme_creator/markdown input files/4_Release_notes.md index 76d95b9d..f9e563b9 100644 --- a/readme_creator/markdown input files/4_Release_notes.md +++ b/readme_creator/markdown input files/4_Release_notes.md @@ -2018,6 +2018,73 @@ Happy 1M installs and 3 year anniversary edition! * Moved *args to end in one_line_progress_meter +## 4.46.0 PySimpleGUI 10-Aug-2021 + +McRelease - Lots of Mac changes including new Mac patch control panel in global settings +expand_x, expand_y in the constructors +docstrings reformatted +Text Elements really autosize now + +Multiline.print & cprint + * Added autoscroll parameter - defaults to True (backward compatible) + * will now take a single color and use as text color +Text element - autosize with size of None, None creates an expanding Label widget with size and width of None and wraplen=0 (truely autosizing it appears!), +ButtonMenu + * use font for button as menu font if none is supplied + * fixed mutible problem - makes a copy of menu definition when making ButtonMenu + * made menu definition optional so can change only some other settings +Mac + * New window added to control the patches and feature disables. Access by calling main_mac_feature_control or through the global settings window from main() + * Disables grab anywhere if a titlebar is present + * Right click menu bound to Button2 which is the right button on a Mac (Button3 for all other systems) + * FINALLY found the no-titlebar problem - weird tkinter bug. Can't set alpha channel while making window if no titlebar on Mac (credit to Tanay for this find!!) + * Allowed Modal windows again + * Will not try to apply no titlebar patch if tkinter version >= 8.6.10 regardless of user settings + * Disable the alpha chan to zero if the no titlebar patch is set on the Mac. Will see the window move to center of screen for these windows. + * Added no-titlebar batch to toolore neetips +Fixed problem with titles on some Linux systems - set class_ for Toplevel windows +Menu defintion bug fix - when menu shortcut char in first pos and item is disabled !&Item +Sizegrip - fixed expansion problem +Added kill application button to error popup +one_line_progress_meter + * keep_on_top parameter added + * no_button parameter added so that no cancel button is shown +Deprication warning added to FindElement as first step of moving out of non-PEP8 world, +Added TabGroup.add_tab to add new tab to TabGroup at runtime +execute_py_file + * set cwd='.' if dir not found + * check for file exists +Right click menu + * added to Radio Checkbox Tabgroup Spin Slider + * Elements that don't have a right_click_menu parm now pick up the default from the Window + * Added a right click menu callback to cover portions of the window that don't have an element on them + * Changed Button binding for Mac to Button2 (the right button rather than middle on the other systems) + * Made right click menus based on button release (MUCH better) +docstrings + * Reformatted all docstrings to line up the desriptions for better readability + * Added type and rtype to docstrings that were missing any entries + * Updated all font entires in docstrings to include list as well as string +Added stderr to Debug print if rerouting stdout +expand_x and expand_y now in the constructor of all elements. No longer need to call Element.expand after finalizing window if using these. +Added Window.perform_long_operation to automatically run users functions as threads +Fixed Text.get() was returning not the latest value when set by another element +Set cursor color to the same as the text color for Input Combo Spin Multiline Output +Added echo_stdout to debug print so that stdout can be captured when run as a subprocess +Addition of autosave parameter for UserSettings +Test harness + Made progress meter shorter so that the test harness fit better on smaller screens (a constant battle) + Compacted Test Harness significantly so it's 690x670 +Added Sizegrip to Debug Window +New Grab Anywhere move code +Move all windows at the same timed if using grab_anywhere (experimental) (set Window._move_all_windows = True) +Table element - set the headers to stretch if expand_x is True +Element.set_size - if Graph element then also set the member variable CanvasSize +added exception details when making window with 0 alpha +Check for no color setting when setting the cursor color for inputs (must test for gray gray gray theme in the future regression tests) +Added exception details if have a problem with the wm_overriderediect +Addition of "project information" to the issue - your opportunity to share something about what you're making + + ## Upcoming The future for PySimpleGUI looks bright! @@ -2092,7 +2159,7 @@ If you've helped, I sure hope that you feel like you've been properly thanked. In response to a number of email contacts from individuals and corporations that are using PySimpleGUI that wanted to financially support the project a "Support" Button was added to the GitHub site. This support button is connected with a PayPal account. If you wish to help support this currently freely supplied software and free technical support, then follow this link: www.paypal.me/psgui . -To be clear, this is not a solicitation for your money. No one is being directly asked to support / contribute. The project is self-funded and there are ongoing costs just to offer the software (URLs, ReadTheDocs, etc). If you're a corporate user and find that PySimpleGUI is helping you financially, that's awesome. If you want to help ensure PySimpleGUI has a future, you now have that option to help. It's likely that at some point the costs will become too high for the project to continue to be free, but until then we'll all enjoy the successes we're having. +The project is self-funded and there are ongoing costs just to offer the software (URLs, ReadTheDocs, etc). If you're a corporate user and find that PySimpleGUI is helping you financially, that's awesome. If you want to help ensure PySimpleGUI has a future, you now have that option to help. It's likely that at some point the costs will become too high for the project to continue to be free or perhaps continue at all, but until then we'll all enjoy the successes we're having. ## Legal diff --git a/readme_creator/markdown input files/5_call_reference.md b/readme_creator/markdown input files/5_call_reference.md index 2efd4343..13d2c8cf 100644 --- a/readme_creator/markdown input files/5_call_reference.md +++ b/readme_creator/markdown input files/5_call_reference.md @@ -2040,6 +2040,9 @@ The following methods are here for backwards compatibility reference. You will +### add_tab + + ### bind @@ -2605,6 +2608,9 @@ The following methods are here for backwards compatibility reference. You will ### normal +### perform_long_operation + + ### read diff --git a/readme_creator/output/call reference.md b/readme_creator/output/call reference.md index 0bd8ca84..258c3942 100644 --- a/readme_creator/output/call reference.md +++ b/readme_creator/output/call reference.md @@ -53,6 +53,8 @@ Button(button_text = "", key = None, k = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -84,13 +86,15 @@ Parameter Descriptions: | (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) | | bool | use_ttk_buttons | True = use ttk buttons. False = do not use ttk buttons. None (Default) = use ttk buttons only if on a Mac and not with button images | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | If True the return key will cause this button to be pressed | | bool | focus | if True, initial focus will be put on this button | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str or int or tuple or object | key | Used with window.FindElement 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. | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -459,6 +463,8 @@ ButtonMenu(button_text, font = None, item_font = None, pad = None, + expand_x = False, + expand_y = False, key = None, k = None, tearoff = False, @@ -486,10 +492,11 @@ Parameter Descriptions: | str | background_color | color of the background | | str | text_color | element's text color. Can be in #RRGGBB format or a color name "black" | | str | disabled_text_color | color to use for text when item is disabled. Can be in #RRGGBB format or a color name "black" | -| str or Tuple[str, int] | font | specifies the font family, size, etc | -| str or Tuple[str, int] | item_font | specifies the font family, size, etc, for the menu items | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | +| str or Tuple[str, int] | item_font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike, for the menu items | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str or int or tuple or object | key | Used with window.FindElement and with return values to uniquely identify this element to uniquely identify this element | +| bool | key | Used with window.find_element and with return values to uniquely identify this element to uniquely identify this element :param expand_x: If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | 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 | tearoff | Determines if menus should allow them to be torn off | | bool | visible | set visibility state of the element | @@ -697,7 +704,7 @@ unhide_row() Changes some of the settings for the ButtonMenu Element. Must call `Window.Read` or `Window.Finalize` prior ``` -update(menu_definition, visible = None) +update(menu_definition = None, visible = None) ``` Parameter Descriptions: @@ -765,7 +772,7 @@ Parameter Descriptions: Changes some of the settings for the ButtonMenu Element. Must call `Window.Read` or `Window.Finalize` prior ``` -Update(menu_definition, visible = None) +Update(menu_definition = None, visible = None) ``` Parameter Descriptions: @@ -789,6 +796,8 @@ Canvas(canvas = None, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, border_width = 0, metadata = None) @@ -803,10 +812,12 @@ Parameter Descriptions: | (int,int) or (None, None) | size | (width in char, height in rows) size in pixels to make canvas | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element | -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | int | border_width | width of border around element in pixels. Not normally used with Canvas element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -1081,6 +1092,9 @@ Checkbox(text, k = None, pad = None, tooltip = None, + right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -1094,17 +1108,20 @@ Parameter Descriptions: | (int, int) or (None, None) | size | (width, height) width = characters-wide, height = rows-high | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_text | if True will size the element to match the length of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | background_color | color of background | | str | text_color | color of the text | | str | checkbox_color | color of background of the box that has the check mark in it. The checkmark is the same color as the text | | bool | change_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | enable_events | Turns on the element specific events. Checkbox events happen when an item changes | | bool | disabled | set disable state | -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | str | tooltip | text, that will appear when mouse hovers over the element | +| List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -1815,6 +1832,8 @@ Combo(values, key = None, k = None, pad = None, + expand_x = False, + expand_y = False, tooltip = None, readonly = False, font = None, @@ -1826,25 +1845,26 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| List[Any] or Tuple[Any] | values | values to choose. While displayed as text, the items returned are what the caller supplied, not text | -| Any | default_value | Choice to be displayed as initial value. Must match one of values variable contents | -| (int, int) or (None, None) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list | -| (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | -| bool | auto_size_text | True if element should be the same size as the contents | -| str | background_color | color of background | -| str | text_color | color of the text | -| bool | bind_return_key | If True, then the return key will cause a the Combo to generate an event | -| bool | change_submits | DEPRICATED DO NOT USE. Use `enable_events` instead | -| bool | enable_events | Turns on the element specific events. Combo event is when a choice is made | -| bool | disabled | set disable state for element | -| str or int or tuple or object | key | Used with window.FindElement and with return values 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. | -| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str | tooltip | text that will appear when mouse hovers over this element | -| bool | readonly | make element readonly (user can't change). True means user cannot change | -| str or (str, int) | font | specifies the font family, size, etc | -| bool | visible | set visibility state of the element | -| Any | metadata | User metadata that can be set to ANYTHING | +| List[Any] or Tuple[Any] | values | values to choose. While displayed as text, the items returned are what the caller supplied, not text | +| Any | default_value | Choice to be displayed as initial value. Must match one of values variable contents | +| (int, int) or (None, None) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list | +| (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | +| bool | auto_size_text | True if element should be the same size as the contents | +| str | background_color | color of background | +| str | text_color | color of the text | +| bool | bind_return_key | If True, then the return key will cause a the Combo to generate an event | +| bool | change_submits | DEPRICATED DO NOT USE. Use `enable_events` instead | +| bool | enable_events | Turns on the element specific events. Combo event is when a choice is made | +| bool | disabled | set disable state for element | +| 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 | k | Same as the Key. You can use either k or key. Which ever is set will be used. | +| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool) :param tooltip: text that will appear when mouse hovers over this element | expand_y | If True the element will automatically expand in the Y direction to fill available space | +| bool | readonly | make element readonly (user can't change). True means user cannot change | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | +| bool | visible | set visibility state of the element | +| Any | metadata | User metadata that can be set to ANYTHING | ### bind @@ -2067,7 +2087,7 @@ Parameter Descriptions: | int | set_to_index | change selection to a particular choice starting with index = 0 | | bool | disabled | disable or enable state of the element | | bool | readonly | if True make element readonly (user cannot change any choices). Enables the element if either choice are made. | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | control visibility of element | | (int, int) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list | @@ -2153,7 +2173,7 @@ Parameter Descriptions: | int | set_to_index | change selection to a particular choice starting with index = 0 | | bool | disabled | disable or enable state of the element | | bool | readonly | if True make element readonly (user cannot change any choices). Enables the element if either choice are made. | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | control visibility of element | | (int, int) | size | width, height. Width = characters-wide, height = NOTE it's the number of entries to show in the list | @@ -2179,6 +2199,8 @@ Frame(title, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, element_justification = "left", vertical_alignment = None, @@ -2195,15 +2217,17 @@ Parameter Descriptions: | str | background_color | background color of the Frame | | enum | title_location | location to place the text title. Choices include: TITLE_LOCATION_TOP TITLE_LOCATION_BOTTOM TITLE_LOCATION_LEFT TITLE_LOCATION_RIGHT TITLE_LOCATION_TOP_LEFT TITLE_LOCATION_TOP_RIGHT TITLE_LOCATION_BOTTOM_LEFT TITLE_LOCATION_BOTTOM_RIGHT | | enum | relief | relief style. Values are same as other elements with reliefs. Choices include RELIEF_RAISED RELIEF_SUNKEN RELIEF_FLAT RELIEF_RIDGE RELIEF_GROOVE RELIEF_SOLID | -| (int, int) | size | (width, height) (note this parameter may not always work) | +| (int, int) | size | (width, height) DO NOT use this. Instead, place your layout in a Column element with the size set on the Column element. Set pad=(0,0) on your Column | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | int | border_width | width of border around element in pixels | | str or int or tuple or object | key | Value that uniquely identifies this element from all other elements. Used when Finding an element or in return values. Must be unique to the window | | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | str | element_justification | All elements inside the Frame will have this justification 'left', 'right', 'center' are valid values | | str | vertical_alignment | Place the column at the 'top', 'center', 'bottom' of the row (can also use t,c,r). Defaults to no setting (tkinter decides) | @@ -2551,6 +2575,8 @@ Graph(canvas_size, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, float_values = False, border_width = 0, @@ -2573,6 +2599,8 @@ Parameter Descriptions: | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element (Default = True) | | bool | float_values | If True x,y coordinates are returned as floats, not ints | | int | border_width | width of border around element in pixels. Not normally used for Graph Elements | @@ -2867,7 +2895,7 @@ Parameter Descriptions: | Any | text | text to display | | (int, int) or Tuple[float, float] | location | location to place first letter | | str | color | text color | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | float | angle | Angle 0 to 360 to draw the text. Zero represents horizontal text | | enum | text_location | "anchor" location for the text. Values start with TEXT_LOCATION_ | | int or None | **RETURN** | id returned from tkinter that you'll need if you want to manipulate the text @@ -3392,7 +3420,7 @@ Parameter Descriptions: | Any | text | text to display | | (int, int) or Tuple[float, float] | location | location to place first letter | | str | color | text color | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | float | angle | Angle 0 to 360 to draw the text. Zero represents horizontal text | | enum | text_location | "anchor" location for the text. Values start with TEXT_LOCATION_ | | int or None | **RETURN** | id returned from tkinter that you'll need if you want to manipulate the text @@ -3805,6 +3833,8 @@ Image(filename = None, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, enable_events = False, metadata = None) @@ -3820,10 +3850,12 @@ Parameter Descriptions: | (int, int) | size | (width, height) size of image in pixels | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str or int or tuple or object | key | Used with window.FindElement 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | bool | enable_events | Turns on the element specific events. For an Image element, the event is "image clicked" | | Any | metadata | User metadata that can be set to ANYTHING | @@ -4176,6 +4208,8 @@ Input(default_text = "", readonly = False, disabled_readonly_background_color = None, disabled_readonly_text_color = None, + expand_x = False, + expand_y = False, right_click_menu = None, visible = True, metadata = None) @@ -4193,7 +4227,7 @@ Parameter Descriptions: | str | justification | justification for data display. Valid choices - left, right, center | | str | background_color | color of background in one of the color formats | | str | text_color | color of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | tooltip | text, that will appear when mouse hovers over the element | | int | border_width | width of border around element in pixels | | bool | change_submits | * DEPRICATED DO NOT USE. Use `enable_events` instead | @@ -4207,6 +4241,8 @@ Parameter Descriptions: | bool | readonly | If True tkinter state set to 'readonly'. Use this in place of use_readonly_for_disable as another way of achieving readonly. Note cannot set BOTH readonly and disabled as tkinter only supplies a single flag | | str | disabled_readonly_background_color | If state is set to readonly or disabled, the color to use for the background | | str | disabled_readonly_text_color | If state is set to readonly or disabled, the color to use for the text | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | | bool | visible | set visibility state of the element (Default = True) | | Any | metadata | User metadata that can be set to ANYTHING | @@ -4556,6 +4592,8 @@ Listbox(values, k = None, pad = None, tooltip = None, + expand_x = False, + expand_y = False, right_click_menu = None, visible = True, metadata = None) @@ -4575,16 +4613,18 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | disabled | set disable state for element | | bool | auto_size_text | True if element should be the same size as the contents | -| str or (str, int) | font | specifies the font family, size, etc | -| bool | font | specifies the font family, size, etc :param no_scrollbar: Controls if a scrollbar should be shown. If True, no scrollbar will be shown | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | +| bool | no_scrollbar | Controls if a scrollbar should be shown. If True, no scrollbar will be shown | | str | background_color | color of background | | str | text_color | color of the text | | str | highlight_background_color | color of the background when an item is selected. Defaults to normal text color (a reverse look) | | str | highlight_text_color | color of the text when an item is selected. Defaults to the normal background color (a rerverse look) | -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | str | tooltip | text, that will appear when mouse hovers over the element | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -5004,7 +5044,7 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | tearoff | if True, then can tear the menu off from the window ans use as a floating window. Very cool effect | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or int or tuple or object | key | Value that uniquely identifies this element from all other elements. Used when Finding an element or in return values. Must be unique to the window | | 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 | visible | set visibility state of the element | @@ -5372,7 +5412,7 @@ Parameter Descriptions: | 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 | -| str or int or tuple or object | key | Used with window.FindElement 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. | | bool | write_only | If True then no entry will be added to the values dictionary when the window is read | | bool | auto_refresh | If True then anytime the element is updated, the window will be refreshed so that the change is immediately displayed | @@ -5381,13 +5421,13 @@ Parameter Descriptions: | bool | reroute_cprint | If True your cprint calls will output to this element. It's the same as you calling cprint_set_output_destination | | bool | echo_stdout_stderr | If True then output to stdout and stderr will be output to this element AND also to the normal console location | | bool | focus | if True initial focus will go to this element | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | str | tooltip | text, that will appear when mouse hovers over the element | | str | justification | text justification. left, right, center. Can use single characters l, r, c. | | bool | no_scrollbar | If False then a scrollbar will be shown (the default) | -| bool | expand_x | If True the Multiline will automatically expand in the X direction to fill available space | -| bool | expand_y | If True the Multiline will automatically expand in the Y direction to fill available space | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -5519,7 +5559,8 @@ print(args=*<1 or N object>, colors = None, t = None, b = None, - c = None) + c = None, + autoscroll = True) ``` Parameter Descriptions: @@ -5532,11 +5573,12 @@ Parameter Descriptions: | str | text_color | The color of the text | | str | background_color | The background color of the line | | str | justification | text justification. left, right, center. Can use single characters l, r, c. Sets only for this value, not entire element | -| str or (str, int) or (str, int, str) | font | specifies the font family, size, etc for the args being printed | -| str or str, str | colors | Either a tuple or a string that has both the text and background colors | +| str or (str, int) or (str, int, str) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the args being printed | +| str or str, str | colors | Either a tuple or a string that has both the text and background colors. Or just the text color | | str | t | Color of the text | | str | b | The background color of the line | -| str or str, str | c | Either a tuple or a string that has both the text and background colors | +| str or str, str | c | Either a tuple or a string that has both the text and background colors or just tex color (same as the color parm) | +| bool | autoscroll | If True the contents of the element will automatically scroll as more data added to the end | ### reroute_stderr_to_here @@ -5705,7 +5747,7 @@ Parameter Descriptions: | str | value | new text to display | | bool | disabled | disable or enable state of the element | | bool | append | if True then new value will be added onto the end of the current value. if False then contents will be replaced. | -| str or (str, int) | font | specifies the font family, size, etc for the entire element | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the entire element | | str | text_color | color of the text | | str | background_color | color of background | | str | text_color_for_value | color of the new text being added (the value paramter) | @@ -5713,7 +5755,7 @@ Parameter Descriptions: | bool | visible | set visibility state of the element | | bool | autoscroll | if True then contents of element are scrolled down when new text is added to the end | | str | justification | text justification. left, right, center. Can use single characters l, r, c. Sets only for this value, not entire element | -| str or (str, int) | font_for_value | specifies the font family, size, etc for the value being updated | +| str or (str, int) | font_for_value | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the value being updated | ### visible @@ -5795,7 +5837,7 @@ Parameter Descriptions: | str | value | new text to display | | bool | disabled | disable or enable state of the element | | bool | append | if True then new value will be added onto the end of the current value. if False then contents will be replaced. | -| str or (str, int) | font | specifies the font family, size, etc for the entire element | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the entire element | | str | text_color | color of the text | | str | background_color | color of background | | str | text_color_for_value | color of the new text being added (the value paramter) | @@ -5803,7 +5845,7 @@ Parameter Descriptions: | bool | visible | set visibility state of the element | | bool | autoscroll | if True then contents of element are scrolled down when new text is added to the end | | str | justification | text justification. left, right, center. Can use single characters l, r, c. Sets only for this value, not entire element | -| str or (str, int) | font_for_value | specifies the font family, size, etc for the value being updated | +| str or (str, int) | font_for_value | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the value being updated | --------- @@ -5821,6 +5863,8 @@ OptionMenu(values, s = (None, None), disabled = False, auto_size_text = None, + expand_x = False, + expand_y = False, background_color = None, text_color = None, key = None, @@ -5841,9 +5885,11 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | disabled | control enabled / disabled | | bool | auto_size_text | True if size of Element should match the contents of the items | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | str | background_color | color of background | | str | text_color | color of the text | -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | str | tooltip | text that will appear when mouse hovers over this element | @@ -6159,6 +6205,8 @@ Output(size = (None, None), key = None, k = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -6173,11 +6221,13 @@ Parameter Descriptions: | str | text_color | color of the text | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | bool | echo_stdout_stderr | If True then output to stdout will be output to this element AND also to the normal console location | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or int or tuple or object | key | Used with window.FindElement 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. | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -6500,6 +6550,8 @@ Pane(pane_list, border_width = None, key = None, k = None, + expand_x = None, + expand_y = None, visible = True, metadata = None) ``` @@ -6520,6 +6572,8 @@ Parameter Descriptions: | int | border_width | width of border around element in pixels | | str or int or tuple or object | key | Value that uniquely identifies this element from all other elements. Used when Finding an element or in return values. Must be unique to the window | | 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 | expand_x | If True the column will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the column will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -6797,6 +6851,9 @@ ProgressBar(max_value, key = None, k = None, pad = None, + right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -6805,20 +6862,23 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| int | max_value | max value of progressbar | -| str | orientation | 'horizontal' or 'vertical' | -| (int, int) or (None, None) | size | Size of the bar. If horizontal (chars wide, pixels high), vert (pixels wide, rows high) | -| (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | -| bool | auto_size_text | Not sure why this is here | -| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Easy to remember which is which if you say "ON" between colors. "red" on "green". | -| str | style | Progress bar style defined as one of these 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' | -| int | border_width | The amount of pixels that go around the outside of the bar | -| str | relief | relief style. Values are same as progress meter relief values. Can be a constant or a string: `RELIEF_RAISED RELIEF_SUNKEN RELIEF_FLAT RELIEF_RIDGE RELIEF_GROOVE RELIEF_SOLID` (Default value = DEFAULT_PROGRESS_BAR_RELIEF) | -| str or int or tuple or object | key | Used with window.FindElement 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. | -| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| bool | visible | set visibility state of the element | -| Any | metadata | User metadata that can be set to ANYTHING | +| int | max_value | max value of progressbar | +| str | orientation | 'horizontal' or 'vertical' | +| (int, int) or (None, None) | size | Size of the bar. If horizontal (chars wide, pixels high), vert (pixels wide, rows high) | +| (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | +| bool | auto_size_text | Not sure why this is here | +| (str, str) or str | bar_color | The 2 colors that make up a progress bar. Easy to remember which is which if you say "ON" between colors. "red" on "green". | +| str | style | Progress bar style defined as one of these 'default', 'winnative', 'clam', 'alt', 'classic', 'vista', 'xpnative' | +| int | border_width | The amount of pixels that go around the outside of the bar | +| str | relief | relief style. Values are same as progress meter relief values. Can be a constant or a string: `RELIEF_RAISED RELIEF_SUNKEN RELIEF_FLAT RELIEF_RIDGE RELIEF_GROOVE RELIEF_SOLID` (Default value = DEFAULT_PROGRESS_BAR_RELIEF) | +| 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. | +| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | +| List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | +| bool | visible | set visibility state of the element | +| Any | metadata | User metadata that can be set to ANYTHING | ### bind @@ -7127,6 +7187,9 @@ Radio(text, tooltip = None, change_submits = False, enable_events = False, + right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -7145,13 +7208,16 @@ Parameter Descriptions: | str | background_color | color of background | | str | text_color | color of the text | | str | circle_color | color of background of the circle that has the dot selection indicator in it | -| str or (str, int) | font | specifies the font family, size, etc | -| str or int or tuple or object | key | Used with window.FindElement and with return values to uniquely identify this element | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | +| 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 | k | Same as the Key. You can use either k or key. Which ever is set will be used. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | change_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | enable_events | Turns on the element specific events. Radio Button events happen when an item is selected | +| List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -7479,7 +7545,7 @@ Parameter Descriptions: The color will match the theme's background color. ``` -Sizegrip(background_color = None) +Sizegrip(background_color = None, key = None) ``` Parameter Descriptions: @@ -7715,6 +7781,8 @@ Slider(range = (None, None), key = None, k = None, pad = None, + expand_x = False, + expand_y = False, tooltip = None, visible = True, metadata = None) @@ -7737,13 +7805,15 @@ Parameter Descriptions: | bool | disabled | set disable state for element | | (int, int) | size | (w=characters-wide, h=rows-high) | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | background_color | color of slider's background | | str | text_color | color of the slider's text | | str | trough_color | color of the slider's trough | | str or int or tuple or object | key | Value that uniquely identifies this element from all other elements. Used when Finding an element or in return values. Must be unique to the window | | 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. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -8038,6 +8108,9 @@ Spin(values, k = None, pad = None, tooltip = None, + right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -8055,13 +8128,16 @@ Parameter Descriptions: | (int, int) or (None, None) | size | (width, height) width = characters-wide, height = rows-high | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_text | if True will size the element to match the length of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | background_color | color of background | | str | text_color | color of the text | -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | str | tooltip | text, that will appear when mouse hovers over the element | +| List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -8388,6 +8464,8 @@ StatusBar(text, key = None, k = None, right_click_menu = None, + expand_x = False, + expand_y = False, tooltip = None, visible = True, metadata = None) @@ -8404,14 +8482,16 @@ Parameter Descriptions: | bool | click_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | enable_events | Turns on the element specific events. StatusBar events occur when the bar is clicked | | enum | relief | relief style. Values are same as progress meter relief values. Can be a constant or a string: `RELIEF_RAISED RELIEF_SUNKEN RELIEF_FLAT RELIEF_RIDGE RELIEF_GROOVE RELIEF_SOLID` | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | text_color | color of the text | | str | background_color | color of background | | str | justification | how string should be aligned within space provided by size. Valid choices = `left`, `right`, `center` | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str or int or tuple or object | key | Used with window.FindElement 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. | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -8618,7 +8698,7 @@ Parameter Descriptions: | str | value | new text to show | | str | background_color | color of background | | str | text_color | color of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | set visibility state of the element | ### visible @@ -8684,7 +8764,7 @@ Parameter Descriptions: | str | value | new text to show | | str | background_color | color of background | | str | text_color | color of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | set visibility state of the element | --------- @@ -8707,6 +8787,8 @@ Tab(title, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, element_justification = "left", metadata = None) @@ -8720,7 +8802,7 @@ Parameter Descriptions: | List[List[Element]] | layout | The element layout that will be shown in the tab | | str | title_color | color of the tab text (note not currently working on tkinter) | | str | background_color | color of background of the entire layout | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | | bool | disabled | If True button will be created disabled | | int | border_width | width of border around element in pixels | @@ -8728,6 +8810,8 @@ Parameter Descriptions: | 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | str | element_justification | All elements inside the Tab will have this justification 'left', 'right', 'center' are valid values | | Any | metadata | User metadata that can be set to ANYTHING | @@ -8847,6 +8931,7 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| | List[List[Element]] | rows | List[List[Element]] The list of rows | +| | **RETURN** | (Tab) used for chaining ### select @@ -9012,6 +9097,7 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| | List[List[Element]] | rows | List[List[Element]] The list of rows | +| | **RETURN** | (Tab) used for chaining ### Select @@ -9092,6 +9178,9 @@ TabGroup(layout, size = (None, None), s = (None, None), tooltip = None, + right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -9107,7 +9196,7 @@ Parameter Descriptions: | str | selected_title_color | color of tab text when it is selected | | str | selected_background_color | color of tab when it is selected | | str | background_color | color of background area that tabs are located on | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | change_submits | * DEPRICATED DO NOT USE. Use `enable_events` instead | | bool | enable_events | If True then switching tabs will generate an Event | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | @@ -9118,9 +9207,28 @@ Parameter Descriptions: | (intorNone, intorNone) | size | (width, height) w=pixels-wide, h=pixels-high. Either item in tuple can be None to indicate use the computed value and set only 1 direction | | (intorNone, intorNone) | 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 | | str | tooltip | text, that will appear when mouse hovers over the element | +| List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | +### add_tab + +Add a new tab to an existing TabGroup +This call was written so that tabs can be added at runtime as your user performs operations. +Your Window should already be created and finalized. + +``` +add_tab(tab_element) +``` + +Parameter Descriptions: + +|Type|Name|Meaning| +|--|--|--| +| Tab | tab_element | A Tab Element that has a layout in it | + ### bind Used to add tkinter events to an Element. @@ -9456,6 +9564,8 @@ Table(values, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -9475,7 +9585,7 @@ Parameter Descriptions: | bool | display_row_numbers | if True, the first column of the table will be the row # | | int | num_rows | The number of rows of the table to display at a time | | int | row_height | height of a single row in pixels | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | justification | 'left', 'right', 'center' are valid choices | | str | text_color | color of the text | | str | background_color | color of background | @@ -9483,7 +9593,7 @@ Parameter Descriptions: | str or (str, str) | selected_row_colors | Sets the text color and background color for a selected row. Same format as button colors - tuple ('red', 'yellow') or string 'red on yellow'. Defaults to theme's button color | | str | header_text_color | sets the text color for the header | | str | header_background_color | sets the background color for the header | -| str or Tuple[str, int] | header_font | specifies the font family, size, etc | +| str or Tuple[str, int] | header_font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | List[Tuple[int, str] or Tuple[Int, str, str]] | row_colors | list of tuples of (row, background color) OR (row, foreground color, background color). Sets the colors of listed rows to the color(s) provided (note the optional foreground color) | | bool | vertical_scroll_only | if True only the vertical scrollbar will be visible | | bool | hide_vertical_scroll | if True vertical scrollbar will be hidden | @@ -9492,10 +9602,12 @@ Parameter Descriptions: | bool | enable_events | Turns on the element specific events. Table events happen when row is clicked | | bool | bind_return_key | if True, pressing return key will cause event coming from Table, ALSO a left button double click will generate an event if this parameter is True | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str or int or tuple or object | key | Used with window.FindElement 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -9821,6 +9933,8 @@ Text(text = "", key = None, k = None, right_click_menu = None, + expand_x = False, + expand_y = False, grab = None, tooltip = None, visible = True, @@ -9838,15 +9952,17 @@ Parameter Descriptions: | bool | click_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | enable_events | Turns on the element specific events. Text events happen when the text is clicked | | (str/enum) | relief | relief style around the text. Values are same as progress meter relief values. Should be a constant that is defined at starting with "RELIEF_" - `RELIEF_RAISED, RELIEF_SUNKEN, RELIEF_FLAT, RELIEF_RIDGE, RELIEF_GROOVE, RELIEF_SOLID` | -| (str or (str, int) or None) | font | specifies the font family, size, etc | +| (str or (str, int) or None) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | text_color | color of the text | | str | background_color | color of background | | int | border_width | number of pixels for the border (if using a relief) | | str | justification | how string should be aligned within space provided by size. Valid choices = `left`, `right`, `center` | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str or int or tuple or object | key | Used with window.FindElement 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. | | List[List[ List[str] or str ]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | grab | If True can grab this element and move the window around. Default is False | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | visible | set visibility state of the element | @@ -10047,7 +10163,7 @@ Parameter Descriptions: | str | value | new text to show | | str | background_color | color of background | | str | text_color | color of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | set visibility state of the element | ### visible @@ -10123,7 +10239,7 @@ Parameter Descriptions: | str | value | new text to show | | str | background_color | color of background | | str | text_color | color of the text | -| str or (str, int) | font | specifies the font family, size, etc | +| str or (str, int) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | visible | set visibility state of the element | --------- @@ -10164,7 +10280,7 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| str or bytes or None | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | +| str or bytes or None | icon | Can be either a filename or Base64 byte string of a PNG. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | | str | title | The "title" to show in the titlebar | | str or None | text_color | Text color for titlebar | | str or None | background_color | Background color for titlebar | @@ -10208,6 +10324,8 @@ Tree(data = None, k = None, tooltip = None, right_click_menu = None, + expand_x = False, + expand_y = False, visible = True, metadata = None) ``` @@ -10228,21 +10346,23 @@ Parameter Descriptions: | bool | show_expanded | if True then the tree will be initially shown with all nodes completely expanded | | bool | change_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead | | bool | enable_events | Turns on the element specific events. Tree events happen when row is clicked | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | justification | 'left', 'right', 'center' are valid choices | | str | text_color | color of the text | | str | background_color | color of background | | str or (str, str) | selected_row_colors | Sets the text color and background color for a selected row. Same format as button colors - tuple ('red', 'yellow') or string 'red on yellow'. Defaults to theme's button color | | str | header_text_color | sets the text color for the header | | str | header_background_color | sets the background color for the header | -| str or Tuple[str, int] | header_font | specifies the font family, size, etc | +| str or Tuple[str, int] | header_font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | int | num_rows | The number of rows of the table to display at a time | | int | row_height | height of a single row in pixels | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element (left/right, top/bottom) or ((left, right), (top, bottom)) | -| str or int or tuple or object | key | Used with window.FindElement 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 | tooltip | text, that will appear when mouse hovers over the element | | List[List[str] or str]] | right_click_menu | A list of lists of Menu items to show when this element is right clicked. See user docs for exact format. | +| bool | expand_x | If True the element will automatically expand in the X direction to fill available space | +| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space | | bool | visible | set visibility state of the element | | Any | metadata | User metadata that can be set to ANYTHING | @@ -10863,15 +10983,18 @@ User Settings ``` UserSettings(filename = None, path = None, - silent_on_error = False) + silent_on_error = False, + autosave = True) ``` Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| (str or None) | filename | The name of the file to use. Can be a full path and filename or just filename | -| (str or None) | path | The folder that the settings file will be stored in. Do not include the filename. | +| (str or None) | filename | The name of the file to use. Can be a full path and filename or just filename | +| (str or None) | path | The folder that the settings file will be stored in. Do not include the filename. | +| bool | silent_on_error | If True errors will not be reported | +| bool | autosave | If True the settings file is saved after every update | ### delete_entry @@ -11038,8 +11161,9 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| Any | key | Setting to be saved. Can be any valid dictionary key type | -| Any | value | Value to save as the setting's value. Can be anything | +| Any | key | Setting to be saved. Can be any valid dictionary key type | +| Any | value | Value to save as the setting's value. Can be anything | +| bool | autosave | If True then the value will be saved to the file | | (Any) | **RETURN** | value that key was set to ### set_default_value @@ -11159,13 +11283,13 @@ Parameter Descriptions: | (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) | | (int, int) | margins | (left/right, top/bottom) Amount of pixels to leave inside the window's frame around the edges before your elements are shown. | | (str, str) or str | button_color | Default button colors for all buttons in the window | -| str or Tuple[str, int] or None | font | specifies the font family, size, etc | +| str or Tuple[str, int] or None | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (str, str) | progress_bar_color | (bar color, background color) Sets the default colors for all progress bars in the window | | str | background_color | color of background | | int | border_depth | Default border depth (width) for all elements in the window | | bool | auto_close | If True, the window will automatically close itself | | int | auto_close_duration | Number of seconds to wait before closing the window | -| (str or bytes) | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | +| (str or bytes) | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's | | bool | force_toplevel | If True will cause this window to skip the normal use of a hidden master window | | float | alpha_channel | Sets the opacity of the window. 0 = invisible 1 = completely visible. Values bewteen 0 & 1 will produce semi-transparent windows in SOME environments (The Raspberry Pi always has this value at 1 and cannot change. | | bool | return_keyboard_events | if True key presses on the keyboard will be returned as Events from Read calls | @@ -11183,8 +11307,7 @@ Parameter Descriptions: | str | right_click_menu_background_color | Background color for right click menus | | str | right_click_menu_text_color | Text color for right click menus | | str | right_click_menu_disabled_text_color | Text color for disabled right click menu items | -| (str, str) or str or Tuple(int, int) or (None, None) | right_click_menu_selected_colors | Text AND background colors for a selected item. Can be a Tuple OR a color string. simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. -Normally a tuple, but can be a simplified-dual-color-string "foreground on background". Can be a single color if want to set only the background. | +| (str, str) or str or Tuple(int, int) or (None, None) | right_click_menu_selected_colors | Text AND background colors for a selected item. Can be a Tuple OR a color string. simplified-button-color-string "foreground on background". Can be a single color if want to set only the background. Normally a tuple, but can be a simplified-dual-color-string "foreground on background". Can be a single color if want to set only the background. | | str or Tuple[str, int] | right_click_menu_font | Font for right click menus | | bool | right_click_menu_tearoff | If True then all right click menus can be torn off | | bool | finalize | If True then the Finalize method will be called. Use this rather than chaining .Finalize for cleaner code | @@ -11210,6 +11333,12 @@ Users, create a single layout (a list of lists) and pass as a parameter to Windo add_row(args=*<1 or N object>) ``` +Parameter Descriptions: + +|Type|Name|Meaning| +|--|--|--| +| | *args | List[Elements] | + ### add_rows Loops through a list of lists of elements and adds each row, list, to the layout. @@ -11408,16 +11537,21 @@ THIS METHOD IS NO LONGER NEEDED to be called by the user You can perform the same operation by writing this statement: element = window[key] -You can drop the entire "FindElement" function name and use [ ] instead. +You can drop the entire "find_element" function name and use [ ] instead. -Typically used in combination with a call to element's Update method (or any other element method!): -window[key].Update(new_value) +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!): +window[key].update(new_value) Versus the "old way" window.FindElement(key).Update(new_value) This call can be abbreviated to any of these: -FindElement == Element == Find +find_element = FindElement == Element == Find +With find_element being the PEP8 compliant call that should be used. + Rememeber that this call will return None if no match is found which may cause your code to crash if not checked for. @@ -11429,7 +11563,7 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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; @@ -11607,6 +11741,23 @@ Restore a window to a non-maximized state. Does different things depending on p normal() ``` +### perform_long_operation + +Call your function that will take a long time to execute. When it's complete, send an event +specified by the end_key. + +``` +perform_long_operation(func, end_key) +``` + +Parameter Descriptions: + +|Type|Name|Meaning| +|--|--|--| +| Any | func | A lambda or a function name with no parms | +| Any | end_key | The key that will be generated when the function returns | +| threading.Thread | **RETURN** | The id of the thread + ### read THE biggest deal method in the Window class! This is how you get all of your data from your Window. @@ -11717,8 +11868,8 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| str | icon | Filename or bytes object | -| str | pngbase64 | Base64 encoded image | +| str | icon | Filename or bytes object | +| bytes | pngbase64 | Base64 encoded image | ### set_min_size @@ -11832,6 +11983,12 @@ Users, create a single layout (a list of lists) and pass as a parameter to Windo AddRow(args=*<1 or N object>) ``` +Parameter Descriptions: + +|Type|Name|Meaning| +|--|--|--| +| | *args | List[Elements] | + ### AddRows Loops through a list of lists of elements and adds each row, list, to the layout. @@ -11923,16 +12080,21 @@ THIS METHOD IS NO LONGER NEEDED to be called by the user You can perform the same operation by writing this statement: element = window[key] -You can drop the entire "FindElement" function name and use [ ] instead. +You can drop the entire "find_element" function name and use [ ] instead. -Typically used in combination with a call to element's Update method (or any other element method!): -window[key].Update(new_value) +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!): +window[key].update(new_value) Versus the "old way" window.FindElement(key).Update(new_value) This call can be abbreviated to any of these: -FindElement == Element == Find +find_element = FindElement == Element == Find +With find_element being the PEP8 compliant call that should be used. + Rememeber that this call will return None if no match is found which may cause your code to crash if not checked for. @@ -11944,7 +12106,7 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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; @@ -11956,16 +12118,21 @@ THIS METHOD IS NO LONGER NEEDED to be called by the user You can perform the same operation by writing this statement: element = window[key] -You can drop the entire "FindElement" function name and use [ ] instead. +You can drop the entire "find_element" function name and use [ ] instead. -Typically used in combination with a call to element's Update method (or any other element method!): -window[key].Update(new_value) +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!): +window[key].update(new_value) Versus the "old way" window.FindElement(key).Update(new_value) This call can be abbreviated to any of these: -FindElement == Element == Find +find_element = FindElement == Element == Find +With find_element being the PEP8 compliant call that should be used. + Rememeber that this call will return None if no match is found which may cause your code to crash if not checked for. @@ -11977,7 +12144,7 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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; @@ -12032,16 +12199,21 @@ THIS METHOD IS NO LONGER NEEDED to be called by the user You can perform the same operation by writing this statement: element = window[key] -You can drop the entire "FindElement" function name and use [ ] instead. +You can drop the entire "find_element" function name and use [ ] instead. -Typically used in combination with a call to element's Update method (or any other element method!): -window[key].Update(new_value) +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!): +window[key].update(new_value) Versus the "old way" window.FindElement(key).Update(new_value) This call can be abbreviated to any of these: -FindElement == Element == Find +find_element = FindElement == Element == Find +With find_element being the PEP8 compliant call that should be used. + Rememeber that this call will return None if no match is found which may cause your code to crash if not checked for. @@ -12053,30 +12225,17 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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; ### FindElement -Find element object associated with the provided key. -THIS METHOD IS NO LONGER NEEDED to be called by the user +** Warning ** This call will eventually be depricated. ** -You can perform the same operation by writing this statement: -element = window[key] +It is suggested that you modify your code to use the recommended window[key] lookup or the PEP8 compliant window.find_element(key) -You can drop the entire "FindElement" function name and use [ ] instead. - -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" -window.FindElement(key).Update(new_value) - -This call can be abbreviated to any of these: -FindElement == Element == Find -Rememeber that this call will return None if no match is found which may cause your code to crash if not -checked for. +For now, you'll only see a message printed and the call will continue to funcation as before. ``` FindElement(key, silent_on_error = False) @@ -12086,7 +12245,7 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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; @@ -12304,8 +12463,8 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| str | icon | Filename or bytes object | -| str | pngbase64 | Base64 encoded image | +| str | icon | Filename or bytes object | +| bytes | pngbase64 | Base64 encoded image | ### SetTransparentColor @@ -12440,6 +12599,12 @@ Reads the context menu read(timeout = None) ``` +Parameter Descriptions: + +|Type|Name|Meaning| +|--|--|--| +| | timeout | Optional. Any value other than None indicates a non-blocking read | + ### show_message Shows a balloon above icon in system tray @@ -12526,6 +12691,12 @@ Reads the context menu Read(timeout = None) ``` +Parameter Descriptions: + +|Type|Name|Meaning| +|--|--|--| +| | timeout | Optional. Any value other than None indicates a non-blocking read | + ### ShowMessage Shows a balloon above icon in system tray @@ -12682,11 +12853,11 @@ Parameter Descriptions: | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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 | locale | defines the locale used to get day names | | str | format | formats result using this strftime format | @@ -12726,10 +12897,11 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | -| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | focus | if focus should be set to this :param pad: Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| | focus | if focus should be set to this | +| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -12774,11 +12946,11 @@ Parameter Descriptions: | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | If True, then the return key will cause a the Listbox to generate an event | | bool | focus | Determines if initial focus should go to this element. | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | User metadata that can be set to ANYTHING | | (Button) | **RETURN** | returns a button @@ -12810,11 +12982,12 @@ Parameter Descriptions: | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | -| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | focus | if focus should be set to this :param pad: Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| | focus | if focus should be set to this | +| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -12856,12 +13029,12 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -12894,10 +13067,11 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | -| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | focus | if focus should be set to this :param pad: Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| | focus | if focus should be set to this | +| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -12927,18 +13101,20 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| | str | button_text | text in the button (Default value = 'Browse') | -| Tuple[(str, str), ...] | target | key or (row,col) target for the button (Default value = (ThisRow, -1)) :param file_types: filter file types (Default value = (("ALL Files", "*.*"))) | -| str | initial_folder | starting path for folders and files :param tooltip: text, that will appear when mouse hovers over the element | +| str or (int, int) | target | key or (row,col) target for the button (Default value = (ThisRow, -1)) | +| Tuple[(str, str), ...] | file_types | filter file types (Default value = (("ALL Files", "*.*"))) | +| | initial_folder | starting path for folders and files | +| str | tooltip | text, that will appear when mouse hovers over the element | | (int, int) | size | (w,h) w=characters-wide, h=rows-high | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | | bool | change_submits | If True, pressing Enter key submits window (Default = False) | | bool | enable_events | Turns on the element specific events.(Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | disabled | set disable state for element (Default = False) | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -12969,7 +13145,8 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| | str | button_text | text in the button (Default value = 'Save As...') | -| Tuple[(str, str), ...] | target | key or (row,col) target for the button (Default value = (ThisRow, -1)) :param file_types: (Default value = (("ALL Files", "*.*"))) | +| str or (int, int) | target | key or (row,col) target for the button (Default value = (ThisRow, -1)) | +| Tuple[(str, str), ...] | file_types | (Default value = (("ALL Files", "*.*"))) | | str | default_extension | If no extension entered by user, add this to filename (only used in saveas dialogs) | | str | initial_folder | starting path for folders and files | | bool | disabled | set disable state for element (Default = False) | @@ -12980,9 +13157,9 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | change_submits | If True, pressing Enter key submits window (Default = False) | | bool | enable_events | Turns on the element specific events.(Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13015,7 +13192,8 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| | str | button_text | text in the button (Default value = 'Browse') | -| Tuple[(str, str), ...] | target | key or (row,col) target for the button (Default value = (ThisRow, -1)) :param file_types: (Default value = (("ALL Files", "*.*"))) | +| str or (int, int) | target | key or (row,col) target for the button (Default value = (ThisRow, -1)) | +| Tuple[(str, str), ...] | file_types | (Default value = (("ALL Files", "*.*"))) | | bool | disabled | set disable state for element (Default = False) | | str | initial_folder | starting path for folders and files | | str | tooltip | text, that will appear when mouse hovers over the element | @@ -13025,9 +13203,9 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | change_submits | If True, pressing Enter key submits window (Default = False) | | bool | enable_events | Turns on the element specific events.(Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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 | files_delimiter | String to place between files when multiple files are selected. Normally a ; | | Any | metadata | Anything you want to store along with this button | @@ -13057,18 +13235,19 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| | str | button_text | text in the button (Default value = 'Browse') | -| key or (row,col) | target | target for the button (Default value = (ThisRow, -1)) | +| str or (int, int) | target | target for the button (Default value = (ThisRow, -1)) | | str | initial_folder | starting path for folders and files | | str | tooltip | text, that will appear when mouse hovers over the element | | (int, int) | size | (w,h) w=characters-wide, h=rows-high | | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | -| bool | button_color | button color (foreground, background) :param disabled: set disable state for element (Default = False) | +| | 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) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element | -| str or int or tuple or object | key | Used with window.FindElement 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 | | 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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | The Button created @@ -13100,11 +13279,12 @@ Parameter Descriptions: | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str | tooltip | text, that will appear when mouse hovers over the element | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | -| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | focus | if focus should be set to this :param pad: Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| | focus | if focus should be set to this | +| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13137,10 +13317,11 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | -| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | focus | if focus should be set to this :param pad: Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| | focus | if focus should be set to this | +| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13174,10 +13355,10 @@ Parameter Descriptions: | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13239,10 +13420,10 @@ Parameter Descriptions: | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13276,10 +13457,10 @@ Parameter Descriptions: | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13312,10 +13493,11 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | -| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | focus | if focus should be set to this :param pad: Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| | focus | if focus should be set to this | +| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13356,12 +13538,12 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | int | border_width | width of border around element | | Any | metadata | Anything you want to store along with this button | @@ -13396,10 +13578,10 @@ Parameter Descriptions: | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13430,7 +13612,8 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| | str | button_text | text in the button (Default value = 'Save As...') | -| Tuple[(str, str), ...] | target | key or (row,col) target for the button (Default value = (ThisRow, -1)) :param file_types: (Default value = (("ALL Files", "*.*"))) | +| str or (int, int) | target | key or (row,col) target for the button (Default value = (ThisRow, -1)) | +| Tuple[(str, str), ...] | file_types | (Default value = (("ALL Files", "*.*"))) | | str | default_extension | If no extension entered by user, add this to filename (only used in saveas dialogs) | | str | initial_folder | starting path for folders and files | | bool | disabled | set disable state for element (Default = False) | @@ -13441,9 +13624,9 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | change_submits | If True, pressing Enter key submits window (Default = False) | | bool | enable_events | Turns on the element specific events.(Default = False) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13477,10 +13660,10 @@ Parameter Descriptions: | bool | disabled | set disable state for element (Default = False) | | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13513,10 +13696,11 @@ Parameter Descriptions: | (str, str) or str | button_color | button color (foreground, background) | | bool | disabled | set disable state for element (Default = False) | | str | tooltip | text, that will appear when mouse hovers over the element | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = True) If True, then the return key will cause a the Listbox to generate an event | -| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | focus | if focus should be set to this :param pad: Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| | focus | if focus should be set to this | +| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13562,12 +13746,12 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | disabled | set disable state for element (Default = False) | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | int | border_width | width of border around element | | Any | metadata | Anything you want to store along with this button | @@ -13609,12 +13793,12 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | disabled | set disable state for element (Default = False) | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | int | border_width | width of border around element | | Any | metadata | Anything you want to store along with this button | @@ -13656,12 +13840,12 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | disabled | set disable state for element (Default = False) | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13702,12 +13886,12 @@ Parameter Descriptions: | (int, int) or (None, None) | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used | | bool | auto_size_button | True if button size is determined by button text | | (str, str) or str | button_color | button color (foreground, background) | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | bind_return_key | (Default = False) If True, then the return key will cause a the Listbox to generate an event | | bool | disabled | set disable state for element (Default = False) | | idk_yetReally | focus | if focus should be set to this | | (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) | pad | Amount of padding to put around element in pixels (left/right, top/bottom) | -| str or int or tuple or object | key | key for uniquely identify this element (for window.FindElement) | +| str or int or tuple or object | key | key for uniquely identify this element (for window.find_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. | | Any | metadata | Anything you want to store along with this button | | (Button) | **RETURN** | returns a button @@ -13735,6 +13919,7 @@ easy_print(args=*<1 or N object>, grab_anywhere = False, keep_on_top = False, do_not_reroute_stdout = True, + echo_stdout = False, text_color = None, background_color = None, colors = None, @@ -13752,7 +13937,7 @@ Parameter Descriptions: | str | end | end character | | str | sep | separator character | | (int, int) | location | Location of upper left corner of the window | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | no_button | don't show button | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | @@ -13760,7 +13945,8 @@ Parameter Descriptions: | str | text_color | color of the text | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | -| bool | do_not_reroute_stdout | do not reroute stdout | +| bool | do_not_reroute_stdout | do not reroute stdout and stderr. If False, both stdout and stderr will reroute to here | +| bool | echo_stdout | If True stdout is sent to both the console and the debug window | | str or str, str | colors | Either a tuple or a string that has both the text and background colors | | str or str, str | c | Either a tuple or a string that has both the text and background colors | | bool | resizable | if True, the user can resize the debug window. Default is True | @@ -13793,6 +13979,7 @@ eprint(args=*<1 or N object>, grab_anywhere = False, keep_on_top = False, do_not_reroute_stdout = True, + echo_stdout = False, text_color = None, background_color = None, colors = None, @@ -13810,7 +13997,7 @@ Parameter Descriptions: | str | end | end character | | str | sep | separator character | | (int, int) | location | Location of upper left corner of the window | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | no_button | don't show button | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | @@ -13818,7 +14005,8 @@ Parameter Descriptions: | str | text_color | color of the text | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | -| bool | do_not_reroute_stdout | do not reroute stdout | +| bool | do_not_reroute_stdout | do not reroute stdout and stderr. If False, both stdout and stderr will reroute to here | +| bool | echo_stdout | If True stdout is sent to both the console and the debug window | | str or str, str | colors | Either a tuple or a string that has both the text and background colors | | str or str, str | c | Either a tuple or a string that has both the text and background colors | | bool | resizable | if True, the user can resize the debug window. Default is True | @@ -13845,6 +14033,7 @@ sgprint(args=*<1 or N object>, grab_anywhere = False, keep_on_top = False, do_not_reroute_stdout = True, + echo_stdout = False, text_color = None, background_color = None, colors = None, @@ -13862,7 +14051,7 @@ Parameter Descriptions: | str | end | end character | | str | sep | separator character | | (int, int) | location | Location of upper left corner of the window | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | no_button | don't show button | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | @@ -13870,7 +14059,8 @@ Parameter Descriptions: | str | text_color | color of the text | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | -| bool | do_not_reroute_stdout | do not reroute stdout | +| bool | do_not_reroute_stdout | do not reroute stdout and stderr. If False, both stdout and stderr will reroute to here | +| bool | echo_stdout | If True stdout is sent to both the console and the debug window | | str or str, str | colors | Either a tuple or a string that has both the text and background colors | | str or str, str | c | Either a tuple or a string that has both the text and background colors | | bool | resizable | if True, the user can resize the debug window. Default is True | @@ -13903,6 +14093,7 @@ EasyPrint(args=*<1 or N object>, grab_anywhere = False, keep_on_top = False, do_not_reroute_stdout = True, + echo_stdout = False, text_color = None, background_color = None, colors = None, @@ -13920,7 +14111,7 @@ Parameter Descriptions: | str | end | end character | | str | sep | separator character | | (int, int) | location | Location of upper left corner of the window | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | no_button | don't show button | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | @@ -13928,7 +14119,8 @@ Parameter Descriptions: | str | text_color | color of the text | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | -| bool | do_not_reroute_stdout | do not reroute stdout | +| bool | do_not_reroute_stdout | do not reroute stdout and stderr. If False, both stdout and stderr will reroute to here | +| bool | echo_stdout | If True stdout is sent to both the console and the debug window | | str or str, str | colors | Either a tuple or a string that has both the text and background colors | | str or str, str | c | Either a tuple or a string that has both the text and background colors | | bool | resizable | if True, the user can resize the debug window. Default is True | @@ -13961,6 +14153,7 @@ Print(args=*<1 or N object>, grab_anywhere = False, keep_on_top = False, do_not_reroute_stdout = True, + echo_stdout = False, text_color = None, background_color = None, colors = None, @@ -13978,7 +14171,7 @@ Parameter Descriptions: | str | end | end character | | str | sep | separator character | | (int, int) | location | Location of upper left corner of the window | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | no_button | don't show button | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | @@ -13986,7 +14179,8 @@ Parameter Descriptions: | str | text_color | color of the text | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | -| bool | do_not_reroute_stdout | do not reroute stdout | +| bool | do_not_reroute_stdout | do not reroute stdout and stderr. If False, both stdout and stderr will reroute to here | +| bool | echo_stdout | If True stdout is sent to both the console and the debug window | | str or str, str | colors | Either a tuple or a string that has both the text and background colors | | str or str, str | c | Either a tuple or a string that has both the text and background colors | | bool | resizable | if True, the user can resize the debug window. Default is True | @@ -14040,7 +14234,8 @@ cprint(args=*<1 or N object>, c = None, window = None, key = None, - justification = None) + justification = None, + autoscroll = True) ``` Parameter Descriptions: @@ -14049,17 +14244,18 @@ Parameter Descriptions: |--|--|--| | Any | *args | stuff to output | | str | text_color | Color of the text | -| str or (str, int) or (str, int, str) | font | specifies the font family, size, etc for the value being updated | +| str or (str, int) or (str, int, str) | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike for the value being updated | | str | background_color | The background color of the line | -| str or str, str | colors | Either a tuple or a string that has both the text and background colors | +| str or str, str | colors | Either a tuple or a string that has both the text and background colors "text on background" or just the text color | | str | t | Color of the text | | str | b | The background color of the line | -| str or str, str | c | Either a tuple or a string that has both the text and background colors | +| str or str, str | c | Either a tuple or a string. Same as the color parm | | str | end | end character | | str | sep | separator character | | Any | key | key of multiline to output to (if you want to override the one previously set) | -| str | window | Window containing the multiline to output to (if you want to override the one previously set) :param justification: text justification. left, right, center. Can use single characters l, r, c. Sets only for this value, not entire element | -| None | **RETURN** | None +| | window | Window containing the multiline to output to (if you want to override the one previously set) | +| str | justification | text justification. left, right, center. Can use single characters l, r, c. Sets only for this value, not entire element | +| bool | autoscroll | If True the contents of the element will automatically scroll as more data added to the end | Sets up the color print (cprint) output destination @@ -14089,7 +14285,9 @@ OneLineProgressMeter(title, size = (20, 20), border_width = None, grab_anywhere = False, - no_titlebar = False) + no_titlebar = False, + keep_on_top = False, + no_button = False) ``` Parameter Descriptions: @@ -14108,6 +14306,8 @@ Parameter Descriptions: | int | border_width | width of border around element | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | no_titlebar | If True: no titlebar will be shown on the window | +| bool | keep_on_top | If True the window will remain above all current windows | +| bool | no_button | If True: window will be created without a cancel button | | (bool) | **RETURN** | True if updated successfully. False if user closed the meter with the X or Cancel button Cancels and closes a previously created One Line Progress Meter window @@ -14135,7 +14335,9 @@ one_line_progress_meter(title, size = (20, 20), border_width = None, grab_anywhere = False, - no_titlebar = False) + no_titlebar = False, + keep_on_top = False, + no_button = False) ``` Parameter Descriptions: @@ -14154,6 +14356,8 @@ Parameter Descriptions: | int | border_width | width of border around element | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | no_titlebar | If True: no titlebar will be shown on the window | +| bool | keep_on_top | If True the window will remain above all current windows | +| bool | no_button | If True: window will be created without a cancel button | | (bool) | **RETURN** | True if updated successfully. False if user closed the meter with the X or Cancel button Cancels and closes a previously created One Line Progress Meter window @@ -14213,7 +14417,7 @@ Parameter Descriptions: | bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. | | str or bytes | icon | icon to display on the window. Same format as a Window call | | int | line_width | Width of lines in characters. Defaults to MESSAGE_BOX_LINE_WIDTH | -| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc | +| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True will not show the frame around the window and the titlebar across the top | | bool | grab_anywhere | If True can grab anywhere to move the window. If no_titlebar is True, grab_anywhere should likely be enabled too | | (int, int) | location | Location on screen to display the top left corner of window. Defaults to window centered on screen | @@ -14253,7 +14457,7 @@ Parameter Descriptions: | str | message | An optional message to be shown with the animation | | str | background_color | color of background | | str | text_color | color of the text | -| str or tuple | font | specifies the font family, size, etc | +| str or tuple | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True then the titlebar and window frame will not be shown | | bool | grab_anywhere | If True then you can move the window just clicking anywhere on window, hold and drag | | bool | keep_on_top | If True then Window will remain on top of all other windows currently shownn | @@ -14262,7 +14466,7 @@ Parameter Descriptions: | int | time_between_frames | Amount of time in milliseconds between each frame | | str | transparent_color | This color will be completely see-through in your window. Can even click through | | str | title | Title that will be shown on the window | -| str | icon | Same as Window icon parameter. Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | +| str or bytes | icon | Same as Window icon parameter. Can be either a filename or Base64 byte string. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | | bool | **RETURN** | True if the window updated OK. False if the window was closed Popup that closes itself after some time period @@ -14303,7 +14507,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14348,7 +14552,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14393,7 +14597,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14425,20 +14629,20 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| int | start_mon | The starting month | -| int or None | start_day | The starting day - optional. Set to None or 0 if no date to be chosen at start | -| int | start_year | The starting year | -| int | begin_at_sunday_plus | Determines the left-most day in the display. 0=sunday, 1=monday, etc | -| str | icon | Same as Window icon parameter. Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | -| (int, int) | location | (x,y) location on the screen to place the top left corner of your window. Default is to center on screen | -| str | title | Title that will be shown on the window | -| bool | close_when_chosen | If True, the window will close and function return when a day is clicked | -| str | locale | locale used to get the day names | -| bool | no_titlebar | If True no titlebar will be shown | -| bool | keep_on_top | If True the window will remain above all current windows | -| List[str] | month_names | optional list of month names to use (should be 12 items) | -| List[str] | day_abbreviations | optional list of abbreviations to display as the day of week | -| bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | +| int | start_mon | The starting month | +| int or None | start_day | The starting day - optional. Set to None or 0 if no date to be chosen at start | +| int | start_year | The starting year | +| int | begin_at_sunday_plus | Determines the left-most day in the display. 0=sunday, 1=monday, etc | +| (str or bytes) | icon | Same as Window icon parameter. Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | +| (int, int) | location | (x,y) location on the screen to place the top left corner of your window. Default is to center on screen | +| str | title | Title that will be shown on the window | +| bool | close_when_chosen | If True, the window will close and function return when a day is clicked | +| str | locale | locale used to get the day names | +| bool | no_titlebar | If True no titlebar will be shown | +| bool | keep_on_top | If True the window will remain above all current windows | +| List[str] | month_names | optional list of month names to use (should be 12 items) | +| List[str] | day_abbreviations | optional list of abbreviations to display as the day of week | +| bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | | None or (int, int, int) | **RETURN** | Tuple containing (month, day, year) of chosen date or None if was cancelled Display popup window with text entry field and browse button so that a file can be chosen by user. @@ -14487,7 +14691,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14537,7 +14741,7 @@ Parameter Descriptions: | str | background_color | color of background | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14583,7 +14787,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the message text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True can click and drag anywhere in the window to move the window | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14648,7 +14852,7 @@ Parameter Descriptions: | bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. (Default = False) | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -14693,7 +14897,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | @@ -14739,7 +14943,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -14812,7 +15016,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14857,7 +15061,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14904,7 +15108,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -14952,7 +15156,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -15003,7 +15207,7 @@ Parameter Descriptions: | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or bytes | image | Image to include at the top of the popup window | | bytes or str | icon | filename or base64 string to be used for the window's icon | | bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | @@ -15046,7 +15250,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15100,7 +15304,7 @@ Parameter Descriptions: | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or bytes | image | Image to include at the top of the popup window | | bytes or str | icon | filename or base64 string to be used for the window's icon | | bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | @@ -15150,7 +15354,7 @@ Parameter Descriptions: | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or bytes | image | Image to include at the top of the popup window | | bytes or str | icon | filename or base64 string to be used for the window's icon | | bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | @@ -15205,7 +15409,7 @@ Parameter Descriptions: | bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. | | str or bytes | icon | icon to display on the window. Same format as a Window call | | int | line_width | Width of lines in characters. Defaults to MESSAGE_BOX_LINE_WIDTH | -| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc | +| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True will not show the frame around the window and the titlebar across the top | | bool | grab_anywhere | If True can grab anywhere to move the window. If no_titlebar is True, grab_anywhere should likely be enabled too | | (int, int) | location | Location on screen to display the top left corner of window. Defaults to window centered on screen | @@ -15245,7 +15449,7 @@ Parameter Descriptions: | str | message | An optional message to be shown with the animation | | str | background_color | color of background | | str | text_color | color of the text | -| str or tuple | font | specifies the font family, size, etc | +| str or tuple | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True then the titlebar and window frame will not be shown | | bool | grab_anywhere | If True then you can move the window just clicking anywhere on window, hold and drag | | bool | keep_on_top | If True then Window will remain on top of all other windows currently shownn | @@ -15254,7 +15458,7 @@ Parameter Descriptions: | int | time_between_frames | Amount of time in milliseconds between each frame | | str | transparent_color | This color will be completely see-through in your window. Can even click through | | str | title | Title that will be shown on the window | -| str | icon | Same as Window icon parameter. Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | +| str or bytes | icon | Same as Window icon parameter. Can be either a filename or Base64 byte string. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | | bool | **RETURN** | True if the window updated OK. False if the window was closed Display a Popup without a titlebar. Enables grab anywhere so you can move it @@ -15294,7 +15498,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | @@ -15340,7 +15544,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15385,7 +15589,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15430,7 +15634,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15485,7 +15689,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15535,7 +15739,7 @@ Parameter Descriptions: | str | background_color | color of background | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15581,7 +15785,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the message text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True can click and drag anywhere in the window to move the window | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15627,7 +15831,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | @@ -15669,7 +15873,7 @@ Parameter Descriptions: | bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. (Default = False) | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -15714,7 +15918,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | @@ -15759,7 +15963,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | | (int, int) | location | Location of upper left corner of the window | @@ -15805,7 +16009,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -15849,7 +16053,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15894,7 +16098,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15941,7 +16145,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -15989,7 +16193,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -16040,7 +16244,7 @@ Parameter Descriptions: | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or bytes | image | Image to include at the top of the popup window | | bytes or str | icon | filename or base64 string to be used for the window's icon | | bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | @@ -16085,7 +16289,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -16130,7 +16334,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -17012,7 +17216,6 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| | bytes or str | icon | Either a Base64 byte string or a filename | -| None | **RETURN** | None ``` set_options(icon = None, @@ -17070,7 +17273,7 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| bytes or str | icon | filename or base64 string to be used for the window's icon | +| bytes or str | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's | | (str, str) or str | button_color | Color of the button (text, background) | | (int, int) | element_size | element size (width, height) in characters | | (int, int) | button_element_size | Size of button | @@ -17078,7 +17281,7 @@ Parameter Descriptions: | (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) | | bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show | | bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | int | border_width | width of border around element | | int | slider_border_width | Width of the border around sliders | | str | slider_relief | Type of relief to use for sliders | @@ -17135,7 +17338,6 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| | bytes or str | icon | Either a Base64 byte string or a filename | -| None | **RETURN** | None ``` SetOptions(icon = None, @@ -17193,7 +17395,7 @@ Parameter Descriptions: |Type|Name|Meaning| |--|--|--| -| bytes or str | icon | filename or base64 string to be used for the window's icon | +| bytes or str | icon | Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO. Most portable is to use a Base64 of a PNG file. This works universally across all OS's | | (str, str) or str | button_color | Color of the button (text, background) | | (int, int) | element_size | element size (width, height) in characters | | (int, int) | button_element_size | Size of button | @@ -17201,7 +17403,7 @@ Parameter Descriptions: | (int, int or (int, int),(int,int)) | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)) | | bool | auto_size_text | True if the Widget should be shrunk to exactly fit the number of chars to show | | bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | int | border_width | width of border around element | | int | slider_border_width | Width of the border around sliders | | str | slider_relief | Type of relief to use for sliders | diff --git a/readme_creator/output/index.md b/readme_creator/output/index.md index 9cbba920..52c0a04f 100644 --- a/readme_creator/output/index.md +++ b/readme_creator/output/index.md @@ -1474,7 +1474,7 @@ Parameter Descriptions: | bool | non_blocking | If True then will immediately return from the function without waiting for the user's input. | | str or bytes | icon | icon to display on the window. Same format as a Window call | | int | line_width | Width of lines in characters. Defaults to MESSAGE_BOX_LINE_WIDTH | -| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc | +| str or Tuple[font_name, size, modifiers] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True will not show the frame around the window and the titlebar across the top | | bool | grab_anywhere | If True can grab anywhere to move the window. If no_titlebar is True, grab_anywhere should likely be enabled too | | (int, int) | location | Location on screen to display the top left corner of window. Defaults to window centered on screen | @@ -1545,7 +1545,7 @@ Parameter Descriptions: | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True, than can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | str or bytes | image | Image to include at the top of the popup window | | bytes or str | icon | filename or base64 string to be used for the window's icon | | bool | modal | If True then makes the popup will behave like a Modal window... all other windows are non-operational until this one is closed. Default = True | @@ -1610,7 +1610,7 @@ Parameter Descriptions: | bool | non_blocking | if True the call will immediately return rather than waiting on user input | | bytes or str | icon | filename or base64 string to be used for the window's icon | | int | line_width | Width of lines in characters | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | (int, int) | location | Location of upper left corner of the window | @@ -1673,7 +1673,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the message text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True can click and drag anywhere in the window to move the window | | bool | keep_on_top | If True the window will remain above all current windows | @@ -1742,7 +1742,7 @@ Parameter Descriptions: | str | background_color | background color of the entire window | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -1815,7 +1815,7 @@ Parameter Descriptions: | str | background_color | color of background | | str | text_color | color of the text | | bytes or str | icon | filename or base64 string to be used for the window's icon | -| str or Tuple[str, int] | font | specifies the font family, size, etc | +| str or Tuple[str, int] | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True no titlebar will be shown | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | keep_on_top | If True the window will remain above all current windows | @@ -1872,7 +1872,7 @@ Parameter Descriptions: | str | message | An optional message to be shown with the animation | | str | background_color | color of background | | str | text_color | color of the text | -| str or tuple | font | specifies the font family, size, etc | +| str or tuple | font | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike | | bool | no_titlebar | If True then the titlebar and window frame will not be shown | | bool | grab_anywhere | If True then you can move the window just clicking anywhere on window, hold and drag | | bool | keep_on_top | If True then Window will remain on top of all other windows currently shownn | @@ -1881,7 +1881,7 @@ Parameter Descriptions: | int | time_between_frames | Amount of time in milliseconds between each frame | | str | transparent_color | This color will be completely see-through in your window. Can even click through | | str | title | Title that will be shown on the window | -| str | icon | Same as Window icon parameter. Can be either a filename or Base64 value. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | +| str or bytes | icon | Same as Window icon parameter. Can be either a filename or Base64 byte string. For Windows if filename, it MUST be ICO format. For Linux, must NOT be ICO | | bool | **RETURN** | True if the window updated OK. False if the window was closed ***To close animated popups***, call PopupAnimated with `image_source=None`. This will close all of the currently open PopupAnimated windows. @@ -1901,7 +1901,9 @@ one_line_progress_meter(title, size = (20, 20), border_width = None, grab_anywhere = False, - no_titlebar = False) + no_titlebar = False, + keep_on_top = False, + no_button = False) ``` Parameter Descriptions: @@ -1920,6 +1922,8 @@ Parameter Descriptions: | int | border_width | width of border around element | | bool | grab_anywhere | If True: can grab anywhere to move the window (Default = False) | | bool | no_titlebar | If True: no titlebar will be shown on the window | +| bool | keep_on_top | If True the window will remain above all current windows | +| bool | no_button | If True: window will be created without a cancel button | | (bool) | **RETURN** | True if updated successfully. False if user closed the meter with the X or Cancel button Here's the one-line Progress Meter in action! @@ -3758,6 +3762,23 @@ To specify an underlined, Helvetica font with a size of 15 the values: ('Helvetica', 15, 'underline italics') 'Helvetica 15 underline italics' +**Font Style - Valid font styles include:** + +* italic +* roman +* bold +* normal +* underline +* overstrike + +An example with many styles is: + +```python +font='Courier 12 italic bold underline overstrike' +``` + +The same styles can be used with the tuple format for fonts. + #### Key See the section above that has full information about keys. @@ -8818,6 +8839,72 @@ Happy 1M installs and 3 year anniversary edition! * Fix for combo and input element readonly state not being recalled when updating disabled value * Moved *args to end in one_line_progress_meter +## 4.46.0 PySimpleGUI 10-Aug-2021 + +McRelease - Lots of Mac changes including new Mac patch control panel in global settings +expand_x, expand_y in the constructors +docstrings reformatted +Text Elements really autosize now + +Multiline.print & cprint + * Added autoscroll parameter - defaults to True (backward compatible) + * will now take a single color and use as text color +Text element - autosize with size of None, None creates an expanding Label widget with size and width of None and wraplen=0 (truely autosizing it appears!), +ButtonMenu + * use font for button as menu font if none is supplied + * fixed mutible problem - makes a copy of menu definition when making ButtonMenu + * made menu definition optional so can change only some other settings +Mac + * New window added to control the patches and feature disables. Access by calling main_mac_feature_control or through the global settings window from main() + * Disables grab anywhere if a titlebar is present + * Right click menu bound to Button2 which is the right button on a Mac (Button3 for all other systems) + * FINALLY found the no-titlebar problem - weird tkinter bug. Can't set alpha channel while making window if no titlebar on Mac (credit to Tanay for this find!!) + * Allowed Modal windows again + * Will not try to apply no titlebar patch if tkinter version >= 8.6.10 regardless of user settings + * Disable the alpha chan to zero if the no titlebar patch is set on the Mac. Will see the window move to center of screen for these windows. + * Added no-titlebar batch to toolore neetips +Fixed problem with titles on some Linux systems - set class_ for Toplevel windows +Menu defintion bug fix - when menu shortcut char in first pos and item is disabled !&Item +Sizegrip - fixed expansion problem +Added kill application button to error popup +one_line_progress_meter + * keep_on_top parameter added + * no_button parameter added so that no cancel button is shown +Deprication warning added to FindElement as first step of moving out of non-PEP8 world, +Added TabGroup.add_tab to add new tab to TabGroup at runtime +execute_py_file + * set cwd='.' if dir not found + * check for file exists +Right click menu + * added to Radio Checkbox Tabgroup Spin Slider + * Elements that don't have a right_click_menu parm now pick up the default from the Window + * Added a right click menu callback to cover portions of the window that don't have an element on them + * Changed Button binding for Mac to Button2 (the right button rather than middle on the other systems) + * Made right click menus based on button release (MUCH better) +docstrings + * Reformatted all docstrings to line up the desriptions for better readability + * Added type and rtype to docstrings that were missing any entries + * Updated all font entires in docstrings to include list as well as string +Added stderr to Debug print if rerouting stdout +expand_x and expand_y now in the constructor of all elements. No longer need to call Element.expand after finalizing window if using these. +Added Window.perform_long_operation to automatically run users functions as threads +Fixed Text.get() was returning not the latest value when set by another element +Set cursor color to the same as the text color for Input Combo Spin Multiline Output +Added echo_stdout to debug print so that stdout can be captured when run as a subprocess +Addition of autosave parameter for UserSettings +Test harness + Made progress meter shorter so that the test harness fit better on smaller screens (a constant battle) + Compacted Test Harness significantly so it's 690x670 +Added Sizegrip to Debug Window +New Grab Anywhere move code +Move all windows at the same timed if using grab_anywhere (experimental) (set Window._move_all_windows = True) +Table element - set the headers to stretch if expand_x is True +Element.set_size - if Graph element then also set the member variable CanvasSize +added exception details when making window with 0 alpha +Check for no color setting when setting the cursor color for inputs (must test for gray gray gray theme in the future regression tests) +Added exception details if have a problem with the wm_overriderediect +Addition of "project information" to the issue - your opportunity to share something about what you're making + ## Upcoming The future for PySimpleGUI looks bright! @@ -8889,7 +8976,7 @@ If you've helped, I sure hope that you feel like you've been properly thanked. In response to a number of email contacts from individuals and corporations that are using PySimpleGUI that wanted to financially support the project a "Support" Button was added to the GitHub site. This support button is connected with a PayPal account. If you wish to help support this currently freely supplied software and free technical support, then follow this link: www.paypal.me/psgui . -To be clear, this is not a solicitation for your money. No one is being directly asked to support / contribute. The project is self-funded and there are ongoing costs just to offer the software (URLs, ReadTheDocs, etc). If you're a corporate user and find that PySimpleGUI is helping you financially, that's awesome. If you want to help ensure PySimpleGUI has a future, you now have that option to help. It's likely that at some point the costs will become too high for the project to continue to be free, but until then we'll all enjoy the successes we're having. +The project is self-funded and there are ongoing costs just to offer the software (URLs, ReadTheDocs, etc). If you're a corporate user and find that PySimpleGUI is helping you financially, that's awesome. If you want to help ensure PySimpleGUI has a future, you now have that option to help. It's likely that at some point the costs will become too high for the project to continue to be free or perhaps continue at all, but until then we'll all enjoy the successes we're having. ## Legal