Jump Start added

This commit is contained in:
MikeTheWatchGuy 2019-09-08 11:06:56 -04:00
parent 385c2020f0
commit 2e27926e97
2 changed files with 196 additions and 10 deletions

View File

@ -16,11 +16,11 @@
![Python Version](https://img.shields.io/badge/Python-2.7_3.x-yellow.svg)
![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_3.x_Version-4.3.2-red.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_3.x_Version-4.4.1-red.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_2.7_Version-2.2.0-blue.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_2.7_Version-2.4.1-blue.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUIQt_Version-0.26.0-orange.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUIQt_Version-0.28.0-orange.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUIWx_version-0.11.0-orange.svg?longCache=true&style=for-the-badge)
@ -31,7 +31,44 @@
## Python GUI For Humans - Transforms tkinter, Qt, Remi, WxPython into portable people-friendly Pythonic interfaces
#### July-2019 Note - This readme is being generated from the PySimpleGUI.py file located on GitHub. As a result, some of the calls or parameters may not match the PySimpleGUI that you pip installed.
---
# Jump-Start
## Install
```
pip install pysimplegui
or
pip3 install pysimplegui
```
### This Code
```python
import PySimpleGUI as sg
# All the stuff inside your window.
layout = [ [sg.Text('Some text on Row 1')],
[sg.Text('Enter something on Row 2'), sg.InputText()],
[sg.Button('Ok'), sg.Button('Cancel')] ]
# Create the Window
window = sg.Window('Window Title', layout)
# Event Loop to process "events" and get the "values" of the inputs
while True:
event, values = window.read()
if event in (None, 'Cancel'): # if user closes window or clicks cancel
break
window.close()
```
### Makes This Window
![image](https://user-images.githubusercontent.com/13696193/61077153-cdfc0b00-a3eb-11e9-9e93-d6ec2ffb442a.png)
### Any Questions?
---
#### Looking for a GUI package? Are you....
@ -72,6 +109,8 @@
* 170+ Demo Programs teach you how to integrate with many popular packages like OpenCV, Matplotlib, PyGame, etc.
* 200 pages of documentation, a Cookbook, built-in help using docstrings, in short it's heavily documented
#### July-2019 Note - This readme is being generated from the PySimpleGUI.py file located on GitHub. As a result, some of the calls or parameters may not match the PySimpleGUI that you pip installed.
## GUI Development does not have to be difficult nor painful. It can be FUN
#### What users are saying about PySimpleGUI
@ -5371,6 +5410,8 @@ Parameter Descriptions:
#### TKCanvas
#### property: TKCanvas
### Checkbox Element
Checkbox Element - Displays a checkbox and text next to it
@ -6201,6 +6242,8 @@ Parameter Descriptions:
#### TKCanvas
#### property: TKCanvas
#### Update
Changes some of the settings for the Graph Element. Must call `Window.Read` or `Window.Finalize` prior
@ -6893,6 +6936,8 @@ Parameter Descriptions:
#### TKOut
#### property: TKOut
#### Update
Changes some of the settings for the Output Element. Must call `Window.Read` or `Window.Finalize` prior
@ -8128,7 +8173,7 @@ Parameter Descriptions:
|---|---|
|tooltip_text|(str) the text to show in tooltip.|
### Window Element
### Window
Represents a single Window
@ -8242,6 +8287,14 @@ Parameter Descriptions:
#### AlphaChannel
#### property: AlphaChannel
A property that changes the current alpha channel value (internal value)
|Name|Meaning|
|---|---|
| **return** | (float) the current alpha channel setting according to self, not read directly from tkinter |
#### BringToFront
Brings this window to the top of all other windows (perhaps may not be brought before a window made to "stay
@ -8744,6 +8797,14 @@ Parameter Descriptions:
#### Size
#### property: Size
Return the current size of the window in pixels
|Name|Meaning|
|---|---|
| **return** | Tuple[(int), (int)] the (width, height) of the window |
#### UnHide
Used to bring back a window that was previously hidden using the Hide method
@ -11219,6 +11280,38 @@ Let's hope it doesn't all blow up in our faces!
* Added Window.visibility_changed to match the PySimpleGUIQt call
* Fixed Debugger so that popout window shows any newly added locals
## 4.4 PySimpleGUI Release 5-Sep-2019
* window() - "Calling" your Window object will perform a Read call
* InputText - move cursor to end following Update
* Shortcuts - trying to get a manageable and stable set of Normal, Short, Super-short
* DD - DropDown (Combo)
* LB, LBox - Listbox
* R, Rad - Radio
* ML, MLine - Multiline
* BMenu - ButtonMenu
* PBar, Prog - ProgressBar
* Col - Column
* Listbox - new method GetIndexes returns currently selected items as a list of indexes
* Output - new method Get returns the contents of the output element
* Button - For Macs don't don't allow setting button color. Previously only warned
* ButtonMenu - new Click method will click the button just like a normal Button's Click method
* Column scrolling finally works correctly with mousewheel. Shift+Mouse Scroll will scroll horizontally
* Table - Get method is a dummy version a Get because Qt port got a real Get method
* Table - Will add numerical column headers if Column Headsing is set to None when creating Table Element
* Table - FIXED the columns crazily resizing themselves bug!!
* Table - Can resize individual columns now
* Tree - was not returning Keys but instead the string representation of the key
* SetIcon will set to default base64 icon if there's an error loading icon
* Fix for duplicate key error. Was attempting to add a "unique key counter" onto end of keys if duplicate, but needed to turn into string first
* Columns
* No longer expand nor fill
* Sizing works for both scrolled and normal
* Setting focus - fixed bug when have tabs, columns, frames that have elements that can get the focus. Setting focus on top-level window
* InputText elements will now cause rows to expand due to X direction expansion
* Frame - Trying to set the size but doesn't seem to be setting it correctly
* Tabs will now expand & fill now (I hope this is OK!!!)
### Upcoming
Make suggestions people! Future release features

103
readme.md
View File

@ -16,11 +16,11 @@
![Python Version](https://img.shields.io/badge/Python-2.7_3.x-yellow.svg)
![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_3.x_Version-4.3.2-red.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_3.x_Version-4.4.1-red.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_2.7_Version-2.2.0-blue.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUI_For_Python_2.7_Version-2.4.1-blue.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUIQt_Version-0.26.0-orange.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUIQt_Version-0.28.0-orange.svg?longCache=true&style=for-the-badge)
![Python Version](https://img.shields.io/badge/PySimpleGUIWx_version-0.11.0-orange.svg?longCache=true&style=for-the-badge)
@ -31,7 +31,44 @@
## Python GUI For Humans - Transforms tkinter, Qt, Remi, WxPython into portable people-friendly Pythonic interfaces
#### July-2019 Note - This readme is being generated from the PySimpleGUI.py file located on GitHub. As a result, some of the calls or parameters may not match the PySimpleGUI that you pip installed.
---
# Jump-Start
## Install
```
pip install pysimplegui
or
pip3 install pysimplegui
```
### This Code
```python
import PySimpleGUI as sg
# All the stuff inside your window.
layout = [ [sg.Text('Some text on Row 1')],
[sg.Text('Enter something on Row 2'), sg.InputText()],
[sg.Button('Ok'), sg.Button('Cancel')] ]
# Create the Window
window = sg.Window('Window Title', layout)
# Event Loop to process "events" and get the "values" of the inputs
while True:
event, values = window.read()
if event in (None, 'Cancel'): # if user closes window or clicks cancel
break
window.close()
```
### Makes This Window
![image](https://user-images.githubusercontent.com/13696193/61077153-cdfc0b00-a3eb-11e9-9e93-d6ec2ffb442a.png)
### Any Questions?
---
#### Looking for a GUI package? Are you....
@ -72,6 +109,8 @@
* 170+ Demo Programs teach you how to integrate with many popular packages like OpenCV, Matplotlib, PyGame, etc.
* 200 pages of documentation, a Cookbook, built-in help using docstrings, in short it's heavily documented
#### July-2019 Note - This readme is being generated from the PySimpleGUI.py file located on GitHub. As a result, some of the calls or parameters may not match the PySimpleGUI that you pip installed.
## GUI Development does not have to be difficult nor painful. It can be FUN
#### What users are saying about PySimpleGUI
@ -5371,6 +5410,8 @@ Parameter Descriptions:
#### TKCanvas
#### property: TKCanvas
### Checkbox Element
Checkbox Element - Displays a checkbox and text next to it
@ -6201,6 +6242,8 @@ Parameter Descriptions:
#### TKCanvas
#### property: TKCanvas
#### Update
Changes some of the settings for the Graph Element. Must call `Window.Read` or `Window.Finalize` prior
@ -6893,6 +6936,8 @@ Parameter Descriptions:
#### TKOut
#### property: TKOut
#### Update
Changes some of the settings for the Output Element. Must call `Window.Read` or `Window.Finalize` prior
@ -8128,7 +8173,7 @@ Parameter Descriptions:
|---|---|
|tooltip_text|(str) the text to show in tooltip.|
### Window Element
### Window
Represents a single Window
@ -8242,6 +8287,14 @@ Parameter Descriptions:
#### AlphaChannel
#### property: AlphaChannel
A property that changes the current alpha channel value (internal value)
|Name|Meaning|
|---|---|
| **return** | (float) the current alpha channel setting according to self, not read directly from tkinter |
#### BringToFront
Brings this window to the top of all other windows (perhaps may not be brought before a window made to "stay
@ -8744,6 +8797,14 @@ Parameter Descriptions:
#### Size
#### property: Size
Return the current size of the window in pixels
|Name|Meaning|
|---|---|
| **return** | Tuple[(int), (int)] the (width, height) of the window |
#### UnHide
Used to bring back a window that was previously hidden using the Hide method
@ -11219,6 +11280,38 @@ Let's hope it doesn't all blow up in our faces!
* Added Window.visibility_changed to match the PySimpleGUIQt call
* Fixed Debugger so that popout window shows any newly added locals
## 4.4 PySimpleGUI Release 5-Sep-2019
* window() - "Calling" your Window object will perform a Read call
* InputText - move cursor to end following Update
* Shortcuts - trying to get a manageable and stable set of Normal, Short, Super-short
* DD - DropDown (Combo)
* LB, LBox - Listbox
* R, Rad - Radio
* ML, MLine - Multiline
* BMenu - ButtonMenu
* PBar, Prog - ProgressBar
* Col - Column
* Listbox - new method GetIndexes returns currently selected items as a list of indexes
* Output - new method Get returns the contents of the output element
* Button - For Macs don't don't allow setting button color. Previously only warned
* ButtonMenu - new Click method will click the button just like a normal Button's Click method
* Column scrolling finally works correctly with mousewheel. Shift+Mouse Scroll will scroll horizontally
* Table - Get method is a dummy version a Get because Qt port got a real Get method
* Table - Will add numerical column headers if Column Headsing is set to None when creating Table Element
* Table - FIXED the columns crazily resizing themselves bug!!
* Table - Can resize individual columns now
* Tree - was not returning Keys but instead the string representation of the key
* SetIcon will set to default base64 icon if there's an error loading icon
* Fix for duplicate key error. Was attempting to add a "unique key counter" onto end of keys if duplicate, but needed to turn into string first
* Columns
* No longer expand nor fill
* Sizing works for both scrolled and normal
* Setting focus - fixed bug when have tabs, columns, frames that have elements that can get the focus. Setting focus on top-level window
* InputText elements will now cause rows to expand due to X direction expansion
* Frame - Trying to set the size but doesn't seem to be setting it correctly
* Tabs will now expand & fill now (I hope this is OK!!!)
### Upcoming
Make suggestions people! Future release features