Method add_row

PySimpleGUI/PySimpleGUI.py:10228–10284

Adds a single row of elements to a window's self.Rows variables. Generally speaking this is NOT how users should be building Window layouts. Users, create a single layout (a list of lists) and pass as a parameter to Window object, or call Window.Layout(layout) :para

(self, *args)

    # ------------------------- Add ONE Row to Form ------------------------- #
    def add_row(self, *args):
        """
        Adds a single row of elements to a window's self.Rows variables.
        Generally speaking this is NOT how users should be building Window layouts.
        Users, create a single layout (a list of lists) and pass as a parameter to Window object, or call Window.Layout(layout)

        :param *args: List[Elements]
        :type *args:
        """
        NumRows = len(self.Rows)  # number of existing rows is our row number
        CurrentRowNumber = NumRows  # this row's number
        CurrentRow = []  # start with a blank row and build up
        # -------------------------  Add the elements to a row  ------------------------- #
        for i, element in enumerate(args):  # Loop through list of elements and add them to the row

            if isinstance(element, tuple) or isinstance(element, list):
                self.add_row(*element)
                continue
                _error_popup_with_traceback('Error creating Window layout',
                                            'Layout has a LIST instead of an ELEMENT',
                                            'This sometimes means you have a badly placed ]',
                                            'The offensive list is:',
                                            element,
                                            'This list will be stripped from your layout'
                                            )
                continue
            elif callable(element) and not isinstance(element, Element):
                _error_popup_with_traceback('Error creating Window layout',
                                            'Layout has a FUNCTION instead of an ELEMENT',
                                            'This likely means you are missing () from your layout',
                                            'The offensive list is:',
                                            element,
                                            'This item will be stripped from your layout')
                continue
            if element.ParentContainer is not None:
                warnings.warn(
                    '*** YOU ARE ATTEMPTING TO REUSE AN ELEMENT IN YOUR LAYOUT! Once placed in a layout, an element cannot be used in another layout. ***',
                    UserWarning)
                _error_popup_with_traceback('Error detected in layout - Contains an element that has already been used.',
                                            'You have attempted to reuse an element in your layout.',
                                            "The layout specified has an element that's already been used.",
                                            'You MUST start with a "clean", unused layout every time you create a window',
                                            'The offensive Element = ',
                                            element,
                                            'and has a key = ', element.Key,
                                            'This item will be stripped from your layout',
                                            'Hint - try printing your layout and matching the IDs "print(layout)"')
                continue
            element.Position = (CurrentRowNumber, i)
            element.ParentContainer = self
            CurrentRow.append(element)
            # if this element is a titlebar, then automatically set the window margins to (0,0) and turn off normal titlebar
            if element.metadata == TITLEBAR_METADATA_MARKER:
                self.Margins = (0, 0)
                self.NoTitleBar = True
        # -------------------------  Append the row to list of Rows  ------------------------- #
        self.Rows.append(CurrentRow)