****************** wx.aui.AuiPaneInfo ****************** Inheritance diagram for `wx.aui.AuiPaneInfo`: | .. inheritance-diagram:: wx.aui.AuiPaneInfo | Description =========== `wx.aui.AuiPaneInfo` is part of the wxAUI class framework. `wx.aui.AuiPaneInfo` specifies all the parameters for a pane. These parameters specify where the pane is on the screen, whether it is docked or floating, or hidden. In addition, these parameters specify the pane's docked position, floating position, preferred size, minimum size, caption text among many other parameters. .. seealso:: `wx.aui.AuiManager `_, `wx.aui.AuiDockArt `_ Constants ^^^^^^^^^ `wxAuiPaneInsertLevel` data structure: ======================================================== =================================================== Flags Value ======================================================== =================================================== ``wx.aui.AUI_INSERT_PANE`` 0 ``wx.aui.AUI_INSERT_ROW`` 1 ``wx.aui.AUI_INSERT_DOCK`` 2 ======================================================== =================================================== | Methods Summary ^^^^^^^^^^^^^^^ * `__init__ <#__init__>`_ * `BestSize <#BestSize>`_ * `Bottom <#Bottom>`_ * `BottomDockable <#BottomDockable>`_ * `Caption <#Caption>`_ * `CaptionVisible <#CaptionVisible>`_ * `Center <#Center>`_ * `CenterPane <#CenterPane>`_ * `Centre <#Centre>`_ * `CentrePane <#CentrePane>`_ * `CloseButton <#CloseButton>`_ * `DefaultPane <#DefaultPane>`_ * `DestroyOnClose <#DestroyOnClose>`_ * `Direction <#Direction>`_ * `Dock <#Dock>`_ * `DockFixed <#DockFixed>`_ * `Dockable <#Dockable>`_ * `Fixed <#Fixed>`_ * `Float <#Float>`_ * `Floatable <#Floatable>`_ * `FloatingPosition <#FloatingPosition>`_ * `FloatingSize <#FloatingSize>`_ * `Gripper <#Gripper>`_ * `GripperTop <#GripperTop>`_ * `HasBorder <#HasBorder>`_ * `HasCaption <#HasCaption>`_ * `HasCloseButton <#HasCloseButton>`_ * `HasFlag <#HasFlag>`_ * `HasGripper <#HasGripper>`_ * `HasGripperTop <#HasGripperTop>`_ * `HasMaximizeButton <#HasMaximizeButton>`_ * `HasMinimizeButton <#HasMinimizeButton>`_ * `HasPinButton <#HasPinButton>`_ * `Hide <#Hide>`_ * `IsBottomDockable <#IsBottomDockable>`_ * `IsDestroyOnClose <#IsDestroyOnClose>`_ * `IsDocked <#IsDocked>`_ * `IsFixed <#IsFixed>`_ * `IsFloatable <#IsFloatable>`_ * `IsFloating <#IsFloating>`_ * `IsLeftDockable <#IsLeftDockable>`_ * `IsMaximized <#IsMaximized>`_ * `IsMovable <#IsMovable>`_ * `IsOk <#IsOk>`_ * `IsResizable <#IsResizable>`_ * `IsRightDockable <#IsRightDockable>`_ * `IsShown <#IsShown>`_ * `IsToolbar <#IsToolbar>`_ * `IsTopDockable <#IsTopDockable>`_ * `Layer <#Layer>`_ * `Left <#Left>`_ * `LeftDockable <#LeftDockable>`_ * `MaxSize <#MaxSize>`_ * `Maximize <#Maximize>`_ * `MaximizeButton <#MaximizeButton>`_ * `MinSize <#MinSize>`_ * `MinimizeButton <#MinimizeButton>`_ * `Movable <#Movable>`_ * `Name <#Name>`_ * `PaneBorder <#PaneBorder>`_ * `PinButton <#PinButton>`_ * `Position <#Position>`_ * `Resizable <#Resizable>`_ * `Restore <#Restore>`_ * `Right <#Right>`_ * `RightDockable <#RightDockable>`_ * `Row <#Row>`_ * `SafeSet <#SafeSet>`_ * `SetFlag <#SetFlag>`_ * `Show <#Show>`_ * `ToolbarPane <#ToolbarPane>`_ * `Top <#Top>`_ * `TopDockable <#TopDockable>`_ * `Window <#Window>`_ Properties Summary ^^^^^^^^^^^^^^^^^^ * `best_size <#best_size>`_ * `buttons <#buttons>`_ * `caption <#caption>`_ * `dock_direction <#dock_direction>`_ * `dock_layer <#dock_layer>`_ * `dock_pos <#dock_pos>`_ * `dock_proportion <#dock_proportion>`_ * `dock_row <#dock_row>`_ * `floating_pos <#floating_pos>`_ * `floating_size <#floating_size>`_ * `frame <#frame>`_ * `max_size <#max_size>`_ * `min_size <#min_size>`_ * `name <#name>`_ * `rect <#rect>`_ * `state <#state>`_ * `window <#window>`_ Class API ========= Methods ^^^^^^^ .. method:: __init__() `No docstrings available for this method.` -------- .. method:: BestSize(size) Sets the ideal size for the pane. The docking manager will attempt to use this size as much as possible when docking or floating the pane. **Parameters:** * `size` (`wx.Size <../Widgets/wx.Size.html>`_) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Bottom() Sets the pane dock position to the bottom side of the frame. This is the same thing as calling `Direction <#Direction>`_ (``wx.aui.AUI_DOCK_BOTTOM``). | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: BottomDockable(b=True) Indicates whether a pane can be docked at the bottom of the frame. **Parameters:** * `b` (bool): ``True`` if the pane can be docked at the bottom, ``False`` otherwise. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Caption(c) Sets the caption of the pane. **Parameters:** * `c` (string): The pane caption. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: CaptionVisible(visible=True) Indicates that a pane caption should be visible. If ``False``, no pane caption is drawn. **Parameters:** * `visible` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Center() See `Centre <#Centre>`_. -------- .. method:: CenterPane() See `CentrePane <#CentrePane>`_. -------- .. method:: Centre() Sets the pane dock position to the left side of the frame. The centre pane is the space in the middle after all border panes (left, top, right, bottom) are subtracted from the layout. This is the same thing as calling `Direction <#Direction>`_ (``wx.aui.AUI_DOCK_CENTRE``). | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: CentrePane() Specifies that the pane should adopt the default center pane settings. Centre panes usually do not have caption bars. This function provides an easy way of preparing a pane to be displayed in the center dock position. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: CloseButton(visible=True) Indicates that a close button should be drawn for the pane. **Parameters:** * `visible` (bool): ``True`` to show the close button, ``False`` otherwise. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: DefaultPane() Specifies that the pane should adopt the default pane settings. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: DestroyOnClose(b=True) Indicates whether a pane should be detroyed when it is closed. Normally a pane is simply hidden when the close button is clicked. Setting DestroyOnClose to ``True`` will cause the window to be destroyed when the user clicks the pane's close button. **Parameters:** * `b` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Direction(direction) Determines the direction of the docked pane. It is functionally the same as calling `Left() <#Left>`_, `Right() <#Right>`_, `Top() <#Top>`_ or `Bottom() <#Bottom>`_, except that docking direction may be specified programmatically via the parameter `direction`. **Parameters:** * `direction` (int) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Dock() Indicates that a pane should be docked. It is the opposite of `Float <#Float>`_. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: DockFixed(b=True) Causes the containing dock to have no resize sash. This is useful for creating panes that span the entire width or height of a dock, but should not be resizable in the other direction. **Parameters:** * `b` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Dockable(b=True) Specifies whether a frame can be docked or not. It is the same as specifying `TopDockable(b).BottomDockable(b).LeftDockable(b).RightDockable(b)`. **Parameters:** * `b` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Fixed() Forces a pane to be fixed size so that it cannot be resized. After calling `Fixed`, `IsFixed <#IsFixed>`_ will return ``True``. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Float() Indicates that a pane should be floated. It is the opposite of `Dock <#Dock>`_. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Floatable(b=True) Sets whether the user will be able to undock a pane and turn it into a floating window. **Parameters:** * `b` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: FloatingPosition(pos) Sets the position of the floating pane. **Parameters:** * `pos` (`wx.Point <../Widgets/wx.Point.html>`_) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: FloatingSize(size) Sets the size of the floating pane. **Parameters:** * `size` (`wx.Size <../Widgets/wx.Size.html>`_) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Gripper(visible=True) Indicates that a gripper should be drawn for the pane. **Parameters:** * `visible` (bool): ``True`` to show the gripper, ``False`` otherwise. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: GripperTop(attop=True) Indicates that a gripper should be drawn at the top of the pane. **Parameters:** * `attop` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: HasBorder() Returns ``True`` if the pane displays a border. | **Returns:** `bool` -------- .. method:: HasCaption() Returns ``True`` if the pane displays a caption. | **Returns:** `bool` -------- .. method:: HasCloseButton() Returns ``True`` if the pane displays a button to close the pane. | **Returns:** `bool` -------- .. method:: HasFlag(flag) Returns ``True`` if the the property specified by flag is active for the pane. **Parameters:** * `flag` (int) | **Returns:** `bool` -------- .. method:: HasGripper() Returns ``True`` if the pane displays a gripper. | **Returns:** `bool` -------- .. method:: HasGripperTop() Returns ``True`` if the pane displays a gripper at the top. | **Returns:** `bool` -------- .. method:: HasMaximizeButton() Returns ``True`` if the pane displays a button to maximize the pane. | **Returns:** `bool` -------- .. method:: HasMinimizeButton() Returns ``True`` if the pane displays a button to minimize the pane. | **Returns:** `bool` -------- .. method:: HasPinButton() Returns ``True`` if the pane displays a button to float the pane. | **Returns:** `bool` -------- .. method:: Hide() Indicates that a pane should be hidden. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: IsBottomDockable() Returns ``True`` if the pane can be docked at the bottom of the managed frame. | **Returns:** `bool` -------- .. method:: IsDestroyOnClose() `No docstrings available for this method.` -------- .. method:: IsDocked() Returns ``True`` if the pane is docked. | **Returns:** `bool` -------- .. method:: IsFixed() Returns ``True`` if the pane cannot be resized. | **Returns:** `bool` -------- .. method:: IsFloatable() Returns ``True`` if the pane can be undocked and displayed as a floating window. | **Returns:** `bool` -------- .. method:: IsFloating() Returns ``True`` if the pane is floating. | **Returns:** `bool` -------- .. method:: IsLeftDockable() Returns ``True`` if the pane can be docked on the left of the managed frame. | **Returns:** `bool` -------- .. method:: IsMaximized() `No docstrings available for this method.` -------- .. method:: IsMovable() Returns ``True`` if the docked frame can be undocked or moved to another dock position. | **Returns:** `bool` -------- .. method:: IsOk() Returns ``True`` if the `wx.aui.AuiPaneInfo` structure is valid. A pane structure is valid if it has an associated window. | **Returns:** `bool` -------- .. method:: IsResizable() Returns ``True`` if the pane can be resized. | **Returns:** `bool` -------- .. method:: IsRightDockable() Returns ``True`` if the pane can be docked on the right of the managed frame. | **Returns:** `bool` -------- .. method:: IsShown() Returns ``True`` if the pane is currently shown. | **Returns:** `bool` -------- .. method:: IsToolbar() Returns ``True`` if the pane contains a toolbar. | **Returns:** `bool` -------- .. method:: IsTopDockable() Returns ``True`` if the pane can be docked at the top of the managed frame. | **Returns:** `bool` -------- .. method:: Layer(layer) Determines the layer of the docked pane. The dock layer is similar to an onion, the inner-most layer being layer 0. Each shell moving in the outward direction has a higher layer number. This allows for more complex docking layout formation. **Parameters:** * `layer` (int) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Left() Sets the pane dock position to the left side of the frame. This is the same thing as calling `Direction <#Direction>`_ (``wx.aui.AUI_DOCK_LEFT``). | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: LeftDockable(b=True) Indicates whether a pane can be docked on the left of the frame. **Parameters:** * `b` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: MaxSize(size) Sets the maximum size of the pane. **Parameters:** * `size` (`wx.Size <../Widgets/wx.Size.html>`_) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Maximize() `No docstrings available for this method.` -------- .. method:: MaximizeButton(visible=True) Indicates that a maximize button should be drawn for the pane. **Parameters:** * `visible` (bool): ``True`` to show the maximize button, ``False`` otherwise. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: MinSize(size) Sets the minimum size of the pane. **Parameters:** * `size` (`wx.Size <../Widgets/wx.Size.html>`_) | **Returns:** `wx.aui.AuiPaneInfo `_ .. note:: Please note that this is only partially supported as of this writing. -------- .. method:: MinimizeButton(visible=True) Indicates that a minimize button should be drawn for the pane. **Parameters:** * `visible` (bool): ``True`` to show the minimize button, ``False`` otherwise. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Movable(b=True) Indicates whether a frame can be moved. **Parameters:** * `b` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Name(n) Sets the name of the pane so it can be referenced in lookup functions. If a name is not specified by the user, a random name is assigned to the pane when it is added to the manager. **Parameters:** * `n` (string) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: PaneBorder(visible=True) PaneBorder indicates that a border should be drawn for the pane. **Parameters:** * `visible` (bool): whether to show a pane border or not. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: PinButton(visible=True) Indicates that a pin button should be drawn for the pane. **Parameters:** * `visible` (bool): whether to show a pin button or not. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Position(pos) Determines the position of the docked pane. **Parameters:** * `pos` (int) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Resizable(resizable=True) Allows a pane to be resized if the parameter is ``True``, and forces it to be a fixed size if the parameter is ``False``. This is simply an antonym for `Fixed() <#Fixed>`_. **Parameters:** * `resizable` (bool): whether the pane should be resizable or not. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Restore() `No docstrings available for this method.` -------- .. method:: Right() Sets the pane dock position to the right side of the frame. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: RightDockable(b=True) Indicates whether a pane can be docked on the right of the frame. **Parameters:** * `b` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Row(row) Determines the row of the docked pane. **Parameters:** * `row` (int) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: SafeSet(source) Write the safe parts of a newly loaded `wx.aui.AuiPaneInfo` structure `source` into `self`. Used on loading perspectives etc... **Parameters:** * `source` (`wx.aui.AuiPaneInfo `_) -------- .. method:: SetFlag(flag, option_state) Turns the property given by flag on or off with the `option_state` parameter. **Parameters:** * `flag` (unsigned int) * `option_state` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Show(show=True) Indicates that a pane should be shown. **Parameters:** * `show` (bool): whether to show or not the pane. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: ToolbarPane() Specifies that the pane should adopt the default toolbar pane settings. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Top() Sets the pane dock position to the top of the frame. | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: TopDockable(b=True) Indicates whether a pane can be docked at the top of the frame. **Parameters:** * `b` (bool) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- .. method:: Window(w) Assigns the window pointer that the `wx.aui.AuiPaneInfo` should use. This normally does not need to be specified, as the window pointer is automatically assigned to the `wx.aui.AuiPaneInfo` structure as soon as it is added to the manager. **Parameters:** * `w` (`wx.Window <../Widgets/wx.Window.html>`_) | **Returns:** `wx.aui.AuiPaneInfo `_ -------- Properties ^^^^^^^^^^ .. attribute:: best_size .. attribute:: buttons .. attribute:: caption .. attribute:: dock_direction .. attribute:: dock_layer .. attribute:: dock_pos .. attribute:: dock_proportion .. attribute:: dock_row .. attribute:: floating_pos .. attribute:: floating_size .. attribute:: frame .. attribute:: max_size .. attribute:: min_size .. attribute:: name .. attribute:: rect .. attribute:: state .. attribute:: window