Most applications have some sort of main window that they want to show to allow their users to interact with the software. In wxPython, this window is called a frame. The frame is the main top-level container and the base for building most user interfaces in wxPython. This recipe will show how to create a frame and add it to an application.
You can do this by performing the following steps:
Start by making a subclass of
wx.Framewith the following code:class MyFrame(wx.Frame): def __init__(self, parent, title=""): super(MyFrame, self).__init__(parent, title=title) # Set an application icon self.SetIcon(wx.Icon("appIcon.png")) # Set the panel self.panel = wx.Panel(self)Next, create an instance of the frame and show it using the following code:
class MyApp(wx.App): def OnInit(self): self.frame = MyFrame(None, title="Main Frame") self.frame.Show() return TrueRun the script and take a look at what we made:
The Frame class creates a top-level window that can be used to present any number of other controls. A frame can be created without any parent window and will remain in the application until it is dismissed by the user.
In this recipe, we set up a couple of items on the MyFrame class:
We called
SetIconto set the custom application icon on the title bar of the frame. This icon was created from theappIcon.pngfile, which exists in the same directory as the script.We created a
Panelobject and set the frame as its parent object. A panel is a plain rectangular control used to contain other controls and is shown as the rectangular area inside the frame's borders. A panel must have a parent window in order to be created.
Finally, in the App object's OnInit method, we created an instance of the frame specifying the title that we wanted to show in the frame's title bar and then called its Show method to display it on the screen. This recipe can be used as the preparation to create any wxPython application.
The wx.Frame constructor has several style flags that can be specified in its constructor to modify its behavior and appearance.
These style flags can be passed in any combination using a bitwise operator to turn off any of the features that you may not want to provide on all frames. Multiple flags can be combined using a bitwise or operation.