Skip to content
Peter JOHN Matecsa edited this page Apr 9, 2022 · 4 revisions

Overview

The design interface is composed of the following sections: Captura de pantalla_2022-04-09_12-37-45-pygubu001 Xubuntu 20.04 screen-shot of pygubu-designer v0.25

Widgets Panel

This section shows the tkinter widgets available to use. It has two main branches, tk (older) and ttk (newer).

Container widgets

These are the only widgets permitted as root elements of the Widget Tree. You need to add one of these to continue adding widgets as children of the container widget.

Control & Display widgets

These are the basic widgets included in tkinter.

Pygubu Helpers

These are combinations of standard widgets that implement popular UI design patterns.

Pygubu Widgets

These are custom widgets used to build the pygubu main window and are available to use.

Widgets Tree

Shows the widgets included in the project as a tree hierarchy.

Adding a widget

To add a widget to the tree, select the widget that will be the new widget's parent and click the icon of the new widget on the Widgets Panel.

To add a new top-level container, make sure that no item is selected in the tree, and click on the container icon.

The columns displayed on the tree are the following:

Widget Id: the unique widget identifier.

Class: the widget class name.

R: The widget's positional row number in its parent container.

C: The widget's positional column number in its parent container.

Atop the tree, use the filter to search for a specific widget identifier or class name.

Moving a widget

Select the item you want to move and use the options from the menu "Edit > Widget Tree." The row and column numbers take precedence when your application runs with the grid layout.

Widget Properties Editor

Use this to alter the properties of the currently selected widget in the Widgets Tree.

It has three sections:

General: display properties

Layout: layout manager choice and position with the parental container

Bindings: if possible, a call back function

Preview Panel

See a preview of all top-level widgets in the Widgets Tree.

The blue lines and tags only appear in the preview. Thin blue lines mark the perimeter of each container. A lower-right blue displays the container's unique identifier. Dragging the blue identifier will resize some containers.

Clone this wiki locally