You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/call reference.md
+20-6Lines changed: 20 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1747,7 +1747,7 @@ Parameter Descriptions:
1747
1747
| float | size_subsample_height | Determines the size of a scrollable height based on 1/size_subsample * required size. 1 = match the contents exactly, 2 = 1/2 contents size, 3 = 1/3. Can be a fraction to make larger than required.. |
1748
1748
| (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) |
1749
1749
| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) or int | p | Same as pad parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, pad will be used |
1750
-
| bool | scrollable | if True then scrollbars will be added to the column |
1750
+
| bool | scrollable | if True then scrollbars will be added to the column. If you update the contents of a scrollable column, be sure and call Column.contents_changed also |
1751
1751
| bool | vertical_scroll_only | if Truen then no horizontal scrollbar will be shown |
1752
1752
| 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. |
1753
1753
| 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 |
@@ -5163,7 +5163,8 @@ update(value = None,
5163
5163
background_color = None,
5164
5164
move_cursor_to = "end",
5165
5165
password_char = None,
5166
-
paste = None)
5166
+
paste = None,
5167
+
readonly = None)
5167
5168
```
5168
5169
5169
5170
Parameter Descriptions:
@@ -5179,6 +5180,7 @@ Parameter Descriptions:
5179
5180
| int or str | move_cursor_to | Moves the cursor to a particular offset. Defaults to 'end' |
5180
5181
| str | password_char | Password character if this is a password field |
5181
5182
| bool | paste | If True "Pastes" the value into the element rather than replacing the entire element. If anything is selected it is replaced. The text is inserted at the current cursor location. |
5183
+
| bool | readonly | if True make element readonly (user cannot change any choices). Enables the element if either choice are made. |
5182
5184
5183
5185
### visible
5184
5186
@@ -5263,7 +5265,8 @@ Update(value = None,
5263
5265
background_color = None,
5264
5266
move_cursor_to = "end",
5265
5267
password_char = None,
5266
-
paste = None)
5268
+
paste = None,
5269
+
readonly = None)
5267
5270
```
5268
5271
5269
5272
Parameter Descriptions:
@@ -5279,6 +5282,7 @@ Parameter Descriptions:
5279
5282
| int or str | move_cursor_to | Moves the cursor to a particular offset. Defaults to 'end' |
5280
5283
| str | password_char | Password character if this is a password field |
5281
5284
| bool | paste | If True "Pastes" the value into the element rather than replacing the entire element. If anything is selected it is replaced. The text is inserted at the current cursor location. |
5285
+
| bool | readonly | if True make element readonly (user cannot change any choices). Enables the element if either choice are made. |
| str | tooltip | text, that will appear when mouse hovers over the element |
6289
6294
| str | justification | text justification. left, right, center. Can use single characters l, r, c. |
6290
6295
| bool | no_scrollbar | If False then a vertical scrollbar will be shown (the default) |
6296
+
| bool | wrap_lines | If True, the lines will be wrapped automatically. Other parms affect this setting, but this one will override them all. Default is it does nothing and uses previous settings for wrapping. |
6291
6297
| str | sbar_trough_color | Scrollbar color of the trough |
6292
6298
| str | sbar_background_color | Scrollbar color of the background of the arrow buttons at the ends AND the color of the "thumb" (the thing you grab and slide). Switches to arrow color when mouse is over |
6293
6299
| str | sbar_arrow_color | Scrollbar color of the arrow at the ends of the scrollbar (it looks like a button). Switches to background color when mouse is over |
@@ -7206,6 +7212,8 @@ Output(size = (None, None),
7206
7212
expand_y = False,
7207
7213
visible = True,
7208
7214
metadata = None,
7215
+
wrap_lines = None,
7216
+
horizontal_scroll = None,
7209
7217
sbar_trough_color = None,
7210
7218
sbar_background_color = None,
7211
7219
sbar_arrow_color = None,
@@ -7235,6 +7243,8 @@ Parameter Descriptions:
7235
7243
| bool | expand_y | If True the element will automatically expand in the Y direction to fill available space |
7236
7244
| bool | visible | set visibility state of the element |
7237
7245
| Any | metadata | User metadata that can be set to ANYTHING |
7246
+
| bool | wrap_lines | If True, the lines will be wrapped automatically. Other parms affect this setting, but this one will override them all. Default is it does nothing and uses previous settings for wrapping. |
7247
+
| bool | horizontal_scroll | Controls if a horizontal scrollbar should be shown. If True, then line wrapping will be off by default |
7238
7248
| str | sbar_trough_color | Scrollbar color of the trough |
7239
7249
| str | sbar_background_color | Scrollbar color of the background of the arrow buttons at the ends AND the color of the "thumb" (the thing you grab and slide). Switches to arrow color when mouse is over |
7240
7250
| str | sbar_arrow_color | Scrollbar color of the arrow at the ends of the scrollbar (it looks like a button). Switches to background color when mouse is over |
@@ -9559,6 +9569,7 @@ Spin(values,
9559
9569
k = None,
9560
9570
pad = None,
9561
9571
p = None,
9572
+
wrap = None,
9562
9573
tooltip = None,
9563
9574
right_click_menu = None,
9564
9575
expand_x = False,
@@ -9576,7 +9587,7 @@ Parameter Descriptions:
9576
9587
| bool | disabled | set disable state |
9577
9588
| bool | change_submits | DO NOT USE. Only listed for backwards compat - Use enable_events instead |
9578
9589
| bool | enable_events | Turns on the element specific events. Spin events happen when an item changes |
9579
-
| bool | readonly | Turns on the element specific events. Spin events happen when an item changes |
9590
+
| bool | readonly | If True, then users cannot type in values. Only values from the values list are allowed. |
9580
9591
| (int, int) or (None, None) or int | size | (w, h) w=characters-wide, h=rows-high. If an int instead of a tuple is supplied, then height is auto-set to 1 |
9581
9592
| (int, int) or (None, None) or int | s | Same as size parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, size will be used |
9582
9593
| bool | auto_size_text | if True will size the element to match the length of the text |
@@ -9588,6 +9599,7 @@ Parameter Descriptions:
9588
9599
| 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. |
9589
9600
| (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) |
9590
9601
| (int, int or (int, int),(int,int) or int,(int,int)) or ((int, int),int) or int | p | Same as pad parameter. It's an alias. If EITHER of them are set, then the one that's set will be used. If BOTH are set, pad will be used |
9602
+
| bool | wrap | Determines if the values should "Wrap". Default is False. If True, when reaching last value, will continue back to the first value. |
9591
9603
| str | tooltip | text, that will appear when mouse hovers over the element |
9592
9604
| 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. |
9593
9605
| bool | expand_x | If True the element will automatically expand in the X direction to fill available space |
@@ -13014,7 +13026,7 @@ Parameter Descriptions:
13014
13026
| bool | auto_size_text | True if Elements in Window should be sized to exactly fir the length of text |
13015
13027
| bool | auto_size_buttons | True if Buttons in this Window should be sized to exactly fit the text on this. |
13016
13028
| (int, int) | relative_location | (x,y) location relative to the default location of the window, in pixels. Normally the window centers. This location is relative to the location the window would be created. Note they can be negative. |
13017
-
| (int, int) | location | (x,y) location, in pixels, to locate the upper left corner of the window on the screen. Default is to center on screen. |
13029
+
| (int, int or None, None) or None | location | (x,y) location, in pixels, to locate the upper left corner of the window on the screen. Default is to center on screen. None will not set any location meaning the OS will decide |
13018
13030
| (int, int) | size | (width, height) size in pixels for this window. Normally the window is autosized to fit contents, not set to an absolute size by the user. Try not to set this value. You risk, the contents being cut off, etc. Let the layout determine the window size instead |
13019
13031
| (int, int or (int, int),(int,int)) or int | element_padding | Default amount of padding to put around elements in window (left/right, top/bottom) or ((left, right), (top, bottom)), or an int. If an int, then it's converted into a tuple (int, int) |
13020
13032
| (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. |
@@ -14716,7 +14728,9 @@ Parameter Descriptions:
14716
14728
Returns a human-readable string of version numbers for:
14717
14729
14718
14730
Python version
14719
-
PySimpleGUI Port (tkinter in this case)
14731
+
Platform (Win, Mac, Linux)
14732
+
Platform version (tuple with information from the platform module)
<h5>apply coupon for discount:<br>4FD91A459D56B1029FF8</h6>
13
-
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=4FD91A459D56B1029FF8">click here to visit course page</a>
12
+
<h5>apply coupon for discount:<br>8D57E54186ADB10C4180</h6>
13
+
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=8D57E54186ADB10C4180">click here to visit course page</a>
<h5>apply coupon for discount:<br>4FD91A459D56B1029FF8</h6>
13
-
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=4FD91A459D56B1029FF8">click here to visit course page</a>
12
+
<h5>apply coupon for discount:<br>8D57E54186ADB10C4180</h6>
13
+
<a href="https://www.udemy.com/course/pysimplegui/?couponCode=8D57E54186ADB10C4180">click here to visit course page</a>
0 commit comments