# Recipes

These are examples of how you can use `guizero` to create user interfaces. Don't be restricted to these ideas, check out Using guizero and the widgets.

## Hello World

Create a guizero app and display some text.

    from guizero import App, Text
    app = App()
    text = Text(app, text="hello world")
    app.display()

## Get some text

Get some data from the user using a `TextBox`.

    from guizero import App, TextBox

    app = App()
    name = TextBox(app, text="Enter your name")

    app.display()

## Push a button

Use a `PushButton` to display a message when the button is pressed.

    from guizero import App, TextBox, PushButton, Text

    def update_text():
        label.value = name.value

    app = App()
    label = Text(app, text="What's your name?")
    name = TextBox(app)
    button = PushButton(app, command=update_text)

    app.display()

## Display an image

Use a `Picture` object to display an image.

    from guizero import App, Picture
    app = App()
    pic = Picture(app, image="myimage.gif")
    app.display()

## Button with an image

Create a picture `PushButton` with an image like this:

    from guizero import App, PushButton
    def do_nothing():
        print("A picture button was pressed")

    app = App()
    button = PushButton(app, image="button.gif", command=do_nothing)
    app.display()

> The image `button.gif` should be stored in the folder as your program. Alternatively you can provide the path to your image.

## Toggle 2 buttons

Have 2 buttons, start and stop with them changing the `enabled` state of each other.

    from guizero import App, PushButton

    def start():
        start_button.disable()
        stop_button.enable()

    def stop():
        start_button.enable()
        stop_button.disable()

    app = App()
    start_button = PushButton(app, command=start, text="start")
    stop_button = PushButton(app, command=stop, text="stop", enabled=False)
    app.display()

## Change your apps appearance

Your app doesn't have to use the standard colors and text, let your user pick the background and text color from 2 combo's.

    from guizero import App, Combo, Text

    def update_bg():
        app.bg = bg_combo.value

    def update_text():
        app.text_color = text_combo.value

    colors = ["black", "white", "red", "green", "blue"]

    app = App()
    app.bg = "black"
    app.text_color = "white"

    title1 = Text(app, text="Background color")
    bg_combo = Combo(app, options=colors, selected=app.bg, command=update_bg)

    title2 = Text(app, text="Text color")
    text_combo = Combo(app, options=colors, selected=app.text_color, command=update_text)

    app.display()

## Scale an image

Display an image on the screen with 2 sliders, 1 for height and 1 for width.

    from guizero import App, Slider, Picture

    def resize():
        picture.width = width.value
        picture.height = height.value

    app = App(layout="grid")

    picture = Picture(app, image="image.gif", grid=[0,1])

    width = Slider(app, command=resize, grid=[0,0], start=1, end=picture.width)
    width.width = picture.width
    width.value = picture.width

    height = Slider(app, command=resize, horizontal=False, grid=[1,1], start=1, end=picture.height)
    height.height = picture.height
    height.value = picture.height

    app.display()

## Double click a widget

To be able to react when a user double click's you will need to use events.

    from guizero import App, Text

    def double_click():
        double_click_me.value = "Thanks"

    app = App()

    double_click_me = Text(app, text="Double click me")
    double_click_me.when_double_clicked = double_click

    app.display()

## Update your app using a timer

You can use `repeat` to periodically update your application. For example, a timer which updates every 1 second (1000 ms).

    from guizero import App, Text

    # Update the counter
    def counter():
        text.value = int(text.value) + 1

    app = App("Hello world")
    text = Text(app, text="1")

    # Schedule call to counter() every 1000ms
    text.repeat(1000, counter)

    app.display()

## Ask before closing the app

You can use a `yesno` box to check whether someone really wants to exit your app. If they click yes, the app is closed, if not, nothing happens and they can continue with what they were doing.

    from guizero import App, Text

    # Ask the user if they really want to close the window
    def do_this_when_closed():
        if app.yesno("Close", "Do you want to quit?"):
            app.destroy()

    app = App()

    title = Text(app, text="blank app")

    # When the user tries to close the window, run the function do_this_when_closed()
    app.when_closed = do_this_when_closed

    app.display()