Release 4.58.0

readme_creator/output/call reference.md

@@ -157,15 +157,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -620,15 +623,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -1003,15 +1009,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -1339,15 +1348,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -1758,15 +1770,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -2197,15 +2212,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -2636,15 +2654,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -3074,15 +3095,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -4092,15 +4116,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -4411,15 +4438,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -4862,15 +4892,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -5304,15 +5337,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -5779,15 +5815,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -6223,15 +6262,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -6743,15 +6785,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -7139,15 +7184,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -7541,15 +7589,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -7902,15 +7953,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### expand
 
@@ -8337,15 +8391,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -8756,15 +8813,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### expand
 
@@ -9067,15 +9127,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -9448,15 +9511,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -9859,15 +9925,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -10253,15 +10322,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -10712,15 +10784,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -11070,9 +11145,12 @@ Table(values,
     header_text_color = None,
     header_background_color = None,
     header_font = None,
+    header_border_width = None,
+    header_relief = None,
     row_colors = None,
     vertical_scroll_only = True,
     hide_vertical_scroll = False,
+    border_width = None,
     size = (None, None),
     s = (None, None),
     change_submits = False,
@@ -11116,9 +11194,12 @@ Parameter Descriptions:
 |                                      str                                       |    header_text_color    | sets the text color for the header |
 |                                      str                                       | header_background_color | sets the background color for the header |
 |                       (str or (str, int[, str]) or None)                       |       header_font       | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
+|                                 (int or None)                                  |   header_border_width   | Border width for the header portion |
+|                                 (str or None)                                  |      header_relief      | Relief style for the header. Values are same as other elements that use relief. RELIEF_RAISED RELIEF_SUNKEN RELIEF_FLAT RELIEF_RIDGE RELIEF_GROOVE RELIEF_SOLID |
 |                 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 |
+|                                      int                                       |      border_width       | Border width/depth in pixels |
 |                                   (int, int)                                   |          size           | DO NOT USE! Use num_rows instead |
 |                                      bool                                      |     change_submits      | DO NOT USE. Only listed for backwards compat - Use enable_events instead |
 |                                      bool                                      |      enable_events      | Turns on the element specific events. Table events happen when row is clicked |
@@ -11142,15 +11223,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -11555,15 +11639,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### expand
 
@@ -11963,11 +12050,14 @@ Tree(data = None,
     font = None,
     justification = "right",
     text_color = None,
+    border_width = None,
     background_color = None,
     selected_row_colors = (None, None),
     header_text_color = None,
     header_background_color = None,
     header_font = None,
+    header_border_width = None,
+    header_relief = None,
     num_rows = None,
     row_height = None,
     pad = None,
@@ -12002,11 +12092,14 @@ Parameter Descriptions:
 |                       (str or (str, int[, str]) or None)                       |          font           | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
 |                                      str                                       |      justification      | 'left', 'right', 'center' are valid choices |
 |                                      str                                       |       text_color        | color of the text |
+|                                      int                                       |      border_width       | Border width/depth in pixels |
 |                                      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 (str, int[, str]) or None)                       |       header_font       | specifies the font family, size, etc. Tuple or Single string format 'name size styles'. Styles: italic * roman bold normal underline overstrike |
+|                                 (int or None)                                  |   header_border_width   | Border width for the header portion |
+|                                 (str or None)                                  |      header_relief      | Relief style for the header. Values are same as other elements that use relief. RELIEF_RAISED RELIEF_SUNKEN RELIEF_FLAT RELIEF_RIDGE RELIEF_GROOVE RELIEF_SOLID |
 |                                      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) or int |           pad           | Amount of padding to put around element in pixels (left/right, top/bottom) or ((left, right), (top, bottom)) or an int. If an int, then it's converted into a tuple (int, int) |
@@ -12040,15 +12133,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### block_focus
 
@@ -12480,15 +12576,18 @@ Used to add tkinter events to an Element.
 The tkinter specific data is in the Element's member variable user_bind_event
 
 ```
-bind(bind_string, key_modifier)
+bind(bind_string,
+    key_modifier,
+    propagate = True)
 ```
 
 Parameter Descriptions:
 
 |Type|Name|Meaning|
 |--|--|--|
-| str | bind_string  | The string tkinter expected in its bind function |
-| str | key_modifier | Additional data to be added to the element's key when event is returned |
+| str  | bind_string  | The string tkinter expected in its bind function |
+| str  | key_modifier | Additional data to be added to the element's key when event is returned |
+| bool |  propagate   | If True then tkinter will be told to propagate the event to the element |
 
 ### expand
 
@@ -12881,7 +12980,9 @@ Used to add tkinter events to a Window.
 The tkinter specific data is in the Window's member variable user_bind_event
 
 ```
-bind(bind_string, key)
+bind(bind_string,
+    key,
+    propagate = True)
 ```
 
 Parameter Descriptions:
@@ -12890,6 +12991,7 @@ Parameter Descriptions:
 |--|--|--|
 |            str             | bind_string | The string tkinter expected in its bind function |
 | str or int or tuple or object |     key     | The event that will be generated when the tkinter event occurs |
+|            bool            |  propagate  | If True then tkinter will be told to propagate the event |
 
 ### bring_to_front
 
@@ -19360,7 +19462,8 @@ set_options(icon = None,
     keep_on_top = None,
     dpi_awareness = None,
     scaling = None,
-    disable_modal_windows = None)
+    disable_modal_windows = None,
+    tooltip_offset = (None, None))
 ```
 
 Parameter Descriptions:
@@ -19421,6 +19524,7 @@ Parameter Descriptions:
 |                      bool                      |          dpi_awareness          | If True then will turn on DPI awareness (Windows only at the moment) |
 |                     float                      |             scaling             | Sets the default scaling for all windows including popups, etc. |
 |                      bool                      |      disable_modal_windows      | If True then all windows, including popups, will not be modal windows |
+|          ((None, None) or (int, int))          |         tooltip_offset          | Offset to use for tooltips as a tuple. These values will be added to the mouse location when the widget was entered. |
 | None | **RETURN** | None
 
 ### Non PEP8 versions
@@ -19492,7 +19596,8 @@ SetOptions(icon = None,
     keep_on_top = None,
     dpi_awareness = None,
     scaling = None,
-    disable_modal_windows = None)
+    disable_modal_windows = None,
+    tooltip_offset = (None, None))
 ```
 
 Parameter Descriptions:
@@ -19553,6 +19658,7 @@ Parameter Descriptions:
 |                      bool                      |          dpi_awareness          | If True then will turn on DPI awareness (Windows only at the moment) |
 |                     float                      |             scaling             | Sets the default scaling for all windows including popups, etc. |
 |                      bool                      |      disable_modal_windows      | If True then all windows, including popups, will not be modal windows |
+|          ((None, None) or (int, int))          |         tooltip_offset          | Offset to use for tooltips as a tuple. These values will be added to the mouse location when the widget was entered. |
 | None | **RETURN** | None
 
 ## Old Themes (Look and Feel) - Replaced by theme()

readme_creator/output/index.md

@@ -9879,6 +9879,55 @@ New Emojis for 2022... collect them all!
 - Fix for Listbox scrollbar not behaving correctly when making element invisible / visible
 - Docstring update for Window.perform_long_operation warns users that Thread are used and thus no PySimpleGUI calls are allowed. Also added description of exactly what happens when the user's function completes. 
 
+## 4.58.0 PySimpleGUI 3-Apr-2022
+
+A little of this and that release  
+More focus on focus  
+`bind` methods improved with `propagate` parm  
+Visibility losing settings fix
+
+- `execute_get_results` Added checking for timeout error to  instead of showing an error popup as it's not truly an error in this case
+- `Checkbox` Added cast to bool of default parm in case user passes in an incorrect type
+- `ButtonMenu.update` addition of button_text parameter. Enables changing text displayed on the ButtonMenu. Should have been an original feature.
+- Open GitHub Issue GUI Tabs use 2 lines now. Added tab asking where found PSG.
+- New symbols `SYMBOL_CHECKMARK_SMALL` & `SYMBOL_X_SMALL`
+- `ButtonMenu.Click` - Added click PEP8 alias `ButtonMenu.click`
+- Automatically add timeouts to user reads if a debugger window is opened. Debugger for multi-window applications still needs to be added
+- `Window.start_thread` a simple alias for `Window.perform_long_operation`.  It's clearer what's happening with this alias.
+- `bind_return_key` parm added to Spin element.  If element has focus and the return key is pressed, then an event is generated.
+- Event generation for disabled elements
+	- If an element is disabled, then don't generate events (fixed specifically for Input element). However, if a Browse button fills in a disabled element, then an event should still be generated
+	- Don't generate events if no files / folders selected using File or Folder Browse buttons. If cancel is clicked then no longer generates an event. 
+- Fix docstring for image in the Titlebar element. Incorrectly said an ICO file can be used. Must be PNG or GIF
+- Windows-specific code that enables the PySimpleGUI supplied icon to be shown rather than the python.exe logo
+- Removed all temporary Tk() window creation calls
+	- Instead create the hidden master root. 
+	- These were required for operations like getting the list of fonts from tkinter, the screensize, character width and height. This way one and only one Tk window will ever be creeated
+	- The reason for the change is that the Mac crashes if multiple Tk() objects are created, even if only 1 at a time is active.
+- `image_source` parm added to `Button`
+	- It can be either a filename or a base64 string. 
+	- This is like the Image elements parms
+- Graph element doc string improvement. Describes the mouse up event.
+- Improved support for focus
+	- `Element.get_next_focus` added. Returns the element that should get the focus after the indicated element
+	- `Element.get_previous_focus` added. Returns the element that should get the focus after the indicated element
+	- Better exception error reporting for the Element focus methods.  Uses popups with tracebacks now instead of prints
+- `Window.widget_to_element` returns the element that a tkinter widget is used to implement (it's a reverse lookup)
+- `Element.widget` added.  It's a PEP8 compliant property  that returns `Element.Widget`
+- `Element.key` added. It's a PEP8 compliant property that returns `Element.Key`
+- Simplified Radio, Checkbox, Slider creation. Moved the command parm outside the creation and instead made a config call.
+- Visibility fix
+	- Expand and other settings were being lost when element is made invisible and visible again.
+- `propagate` parameter to the bind methods.  Used to tell tkinter whether or not to propagate the event to the element / or window
+- `Canvas.update` method added so that a `Canvas` can be made visible/invisible
+- Removed the need for `tk.scrolledtext.ScrolledText` by adding a vertical scrollbar to a Text widget.  Getting ready for addition of ttk scrollbars!  
+- `tooltip_offset` parm added to `set_options` as a way to set tooltip location (a hack to get around an 8.6.12 bug)
+- `Table` and `Tree` elements new parameters
+	- `border_width` -  the border width for the element
+	- `header_border_width` - the width of the border for the header
+	- `header_relief` - the type of header relief to use
+- `Table` and `Tree` elements are now excluded from grab-anywhere so that headers can be resized without moving the window
+
 ## Code Condition
 
     Make it run