wxAuiPaneInfo(3erl)

📦
version 25.3.2.8 · 5 versions
, in ubuntu noble

💅 wxAuiPaneInfo(3erl) — Erlang Module Definition 🎀

🌸 NAME 🌸

wxAuiPaneInfo — Functions for wxAuiPaneInfo class. Periodt.

✨ DESCRIPTION ✨

okay so bestie, wxAuiPaneInfo is part of the wxAUI class framework. See also overview_aui. 🦋

wxAuiPaneInfo 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. It’s giving very “pane’s whole personality in one object” energy. 💅

See: wxAuiManager, wxAuiDockArt

wxWidgets docs: wxAuiPaneInfo

🧁 DATA TYPES 🧁

  • wxAuiPaneInfo() = wx:wx_object()

👑 EXPORTS 👑

  • new() -> wxAuiPaneInfo()
  • new(C) -> wxAuiPaneInfo()
    • Types: C = wxAuiPaneInfo()
    • Copy constructor. It copies, bestie. No cap. ✨
  • bestSize(This, Size) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Size = {W :: integer(), H :: integer()}
    • bestSize/3 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. 🎀
  • bestSize(This, X, Y) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); X = Y = integer()
  • bottom(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
    • bottom/1 sets the pane dock position to the bottom side of the frame. This is the same thing as calling Direction(wxAUI_DOCK_BOTTOM). 🫶
  • bottomDockable(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
  • bottomDockable(This, Options :: [Option]) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Option = {b, boolean()}
    • bottomDockable/2 indicates whether a pane can be docked at the bottom of the frame. 💖
  • caption(This, C) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); C = unicode:chardata()
    • caption/2 sets the caption of the pane. Cute little nameplate moment. 🎀
  • captionVisible(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
  • captionVisible(This, Options :: [Option]) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Option = {visible, boolean()}
    • CaptionVisible indicates that a pane caption should be visible. If false, no pane caption is drawn. Simple as that. 💅
  • centre(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
    • Center() (not implemented in wx) sets the pane dock position to the left side of the frame. Yep, that’s what the doc says — keeping it exactly like that, bestie. 😭
    • 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(wxAUI_DOCK_CENTRE). 🌈
  • centrePane(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
    • centrePane/1 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. Iconic. ✨
  • closeButton(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
  • closeButton(This, Options :: [Option]) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Option = {visible, boolean()}
    • closeButton/2 indicates that a close button should be drawn for the pane. X to close, lowkey essential. 💀
  • defaultPane(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
    • defaultPane/1 specifies that the pane should adopt the default pane settings. 💖
  • destroyOnClose(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
  • destroyOnClose(This, Options :: [Option]) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Option = {b, boolean()}
    • destroyOnClose/2 indicates whether a pane should be destroyed 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. So like, actually gone-gone. 🫶
  • direction(This, Direction) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Direction = integer()
    • direction/2 determines the direction of the docked pane. It is functionally the same as calling left/1, right/1, top/1 or bottom/1, except that docking direction may be specified programmatically via the parameter. 🦋
  • dock(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
    • dock/1 indicates that a pane should be docked. It is the opposite of float/1. Slay, stay put. 💅
  • dockable(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
  • dockable(This, Options :: [Option]) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Option = {b, boolean()}
    • dockable/2 specifies whether a frame can be docked or not. It is the same as specifying TopDockable(b).BottomDockable(b).LeftDockable(b).RightDockable(b). Periodt. 🌈
  • fixed(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
    • fixed/1 forces a pane to be fixed size so that it cannot be resized. After calling fixed/1, isFixed/1 will return true. No resizing, no negotiating. 💀
  • float(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
    • float/1 indicates that a pane should be floated. It is the opposite of dock/1. Main character floating energy. 🦋
  • floatable(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
  • floatable(This, Options :: [Option]) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Option = {b, boolean()}
    • floatable/2 sets whether the user will be able to undock a pane and turn it into a floating window. 🎀
  • floatingPosition(This, Pos) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Pos = {X :: integer(), Y :: integer()}
    • floatingPosition/3 sets the position of the floating pane. ✨
  • floatingPosition(This, X, Y) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); X = Y = integer()
  • floatingSize(This, Size) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Size = {W :: integer(), H :: integer()}
    • floatingSize/3 sets the size of the floating pane. 💖
  • floatingSize(This, X, Y) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); X = Y = integer()
  • gripper(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
  • gripper(This, Options :: [Option]) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Option = {visible, boolean()}
    • gripper/2 indicates that a gripper should be drawn for the pane. Little grabby handle moment. 🫶
  • gripperTop(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
  • gripperTop(This, Options :: [Option]) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo(); Option = {attop, boolean()}
    • gripperTop/2 indicates that a gripper should be drawn at the top of the pane. ✨
  • hasBorder(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • hasBorder/1 returns true if the pane displays a border. 💅
  • hasCaption(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • hasCaption/1 returns true if the pane displays a caption. 🎀
  • hasCloseButton(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • hasCloseButton/1 returns true if the pane displays a button to close the pane. 💀
  • hasFlag(This, Flag) -> boolean()
    • Types: This = wxAuiPaneInfo(); Flag = integer()
    • hasFlag/2 returns true if the property specified by flag is active for the pane. 🦋
  • hasGripper(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • hasGripper/1 returns true if the pane displays a gripper. 🫶
  • hasGripperTop(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • hasGripper/1 returns true if the pane displays a gripper at the top. (Yes, it says hasGripper/1 right there in the original — keeping it exact, bestie.) 😭
  • hasMaximizeButton(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • hasMaximizeButton/1 returns true if the pane displays a button to maximize the pane. 🔥
  • hasMinimizeButton(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • hasMinimizeButton/1 returns true if the pane displays a button to minimize the pane. 💖
  • hasPinButton(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • hasPinButton/1 returns true if the pane displays a button to float the pane. 📌✨
  • hide(This) -> wxAuiPaneInfo()
    • Types: This = wxAuiPaneInfo()
    • hide/1 indicates that a pane should be hidden. Ghost mode. 🙈
  • isBottomDockable(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • isBottomDockable/1 returns true if the pane can be docked at the bottom of the managed frame. See: IsDockable() (not implemented in wx). 🦋
  • isDocked(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • isDocked/1 returns true if the pane is currently docked. 💅
  • isFixed(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • isFixed/1 returns true if the pane cannot be resized. No cap. 💀
  • isFloatable(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • isFloatable/1 returns true if the pane can be undocked and displayed as a floating window. 🦋
  • isFloating(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • isFloating/1 returns true if the pane is floating. Main character in the air. ✨
  • isLeftDockable(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • isLeftDockable/1 returns true if the pane can be docked on the left of the managed frame. See: IsDockable() (not implemented in wx). 🌸
  • isMovable(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
    • IsMoveable() returns true if the docked frame can be undocked or moved to another dock position. 🫶
  • isOk(This) -> boolean()
    • Types: This = wxAuiPaneInfo()
  • isOk(This) -> boolean() — types: This = wxAuiPaneInfo()

isOk/1 returns true if the wxAuiPaneInfo structure is valid.

And bestie, a pane structure is valid only if it has an associated window. No window, no validity. That's the whole vibe check 💅

  • isResizable(This) -> boolean() — types: This = wxAuiPaneInfo()

isResizable/1 returns true if the pane can be resized.

  • isRightDockable(This) -> boolean() — types: This = wxAuiPaneInfo()

isRightDockable/1 returns true if the pane can be docked on the right of the managed frame.

See: IsDockable() (not implemented in wx) 👀

  • isShown(This) -> boolean() — types: This = wxAuiPaneInfo()

isShown/1 returns true if the pane is currently shown.

  • isToolbar(This) -> boolean() — types: This = wxAuiPaneInfo()

isToolbar/1 returns true if the pane contains a toolbar.

  • isTopDockable(This) -> boolean() — types: This = wxAuiPaneInfo()

isTopDockable/1 returns true if the pane can be docked at the top of the managed frame.

See: IsDockable() (not implemented in wx) 👀

  • layer(This, Layer) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Layer = integer()

layer/2 determines the layer of the docked pane.

Okay so the dock layer is literally an onion 🧅 — the inner-most layer is layer 0, and every shell moving outward gets a higher layer number. This is what lets you build more complex docking layout formations. Layers of slay, fr.

  • left(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()

left/1 sets the pane dock position to the left side of the frame.

This is the same thing as calling Direction(wxAUI_DOCK_LEFT).

  • leftDockable(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()
  • leftDockable(This, Options :: [Option]) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Option = {b, boolean()}

leftDockable/2 indicates whether a pane can be docked on the left of the frame.

  • maxSize(This, Size) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Size = {W :: integer(), H :: integer()}

maxSize/3 sets the maximum size of the pane.

  • maxSize(This, X, Y) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), X = Y = integer()
  • maximizeButton(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()
  • maximizeButton(This, Options :: [Option]) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Option = {visible, boolean()}

maximizeButton/2 indicates that a maximize button should be drawn for the pane.

  • minSize(This, Size) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Size = {W :: integer(), H :: integer()}

minSize/3 sets the minimum size of the pane.

Okay ngl, please note that this is only partially supported as of this writing. Cute in theory, kinda flaky in practice 🙈
  • minSize(This, X, Y) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), X = Y = integer()
  • minimizeButton(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()
  • minimizeButton(This, Options :: [Option]) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Option = {visible, boolean()}

minimizeButton/2 indicates that a minimize button should be drawn for the pane.

  • movable(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()
  • movable(This, Options :: [Option]) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Option = {b, boolean()}

Movable indicates whether a frame can be moved.

  • name(This, N) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), N = unicode:chardata()

name/2 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. Surprise name drop 🎀

  • paneBorder(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()
  • paneBorder(This, Options :: [Option]) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Option = {visible, boolean()}

PaneBorder indicates that a border should be drawn for the pane.

  • pinButton(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()
  • pinButton(This, Options :: [Option]) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Option = {visible, boolean()}

pinButton/2 indicates that a pin button should be drawn for the pane.

  • position(This, Pos) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Pos = integer()

position/2 determines the position of the docked pane.

  • resizable(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()
  • resizable(This, Options :: [Option]) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Option = {resizable, boolean()}

resizable/2 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/1. They're giving opposites-attract energy 🫶

  • right(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()

right/1 sets the pane dock position to the right side of the frame.

This is the same thing as calling Direction(wxAUI_DOCK_RIGHT).

  • rightDockable(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()
  • rightDockable(This, Options :: [Option]) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Option = {b, boolean()}

rightDockable/2 indicates whether a pane can be docked on the right of the frame.

  • row(This, Row) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Row = integer()

row/2 determines the row of the docked pane.

  • safeSet(This, Source) -> ok — types: This = Source = wxAuiPaneInfo()

Write the safe parts of a PaneInfo object "source" into "this".

And what counts as "safe parts"? All the non-UI elements — like, all the layout determining parameters such as the size, position, etc. The "unsafe parts" (pointers to button, frame and window) are not modified by this write operation. They stay exactly where they are, no touchy ✋

Remark: This method is used when loading perspectives.

  • setFlag(This, Flag, Option_state) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Flag = integer(), Option_state = boolean()

setFlag/3 turns the property given by flag on or off with the option_state parameter.

  • show(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()
  • show(This, Options :: [Option]) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Option = {show, boolean()}

show/2 indicates that a pane should be shown.

  • toolbarPane(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()

toolbarPane/1 specifies that the pane should adopt the default toolbar pane settings.

  • top(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()

top/1 sets the pane dock position to the top of the frame.

This is the same thing as calling Direction(wxAUI_DOCK_TOP).

  • topDockable(This) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo()
  • topDockable(This, Options :: [Option]) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), Option = {b, boolean()}

topDockable/2 indicates whether a pane can be docked at the top of the frame.

  • window(This, W) -> wxAuiPaneInfo() — types: This = wxAuiPaneInfo(), W = wxWindow:wxWindow()

window/2 assigns the window pointer that the wxAuiPaneInfo should use.

This normally does not need to be specified, as the window pointer is automatically assigned to the wxAuiPaneInfo structure as soon as it is added to the manager. It's basically set-and-forget, iykyk ✨

  • getWindow(This) -> wxWindow:wxWindow() — types: This = wxAuiPaneInfo()
  • getFrame(This) -> wxFrame:wxFrame() — types: This = wxAuiPaneInfo()
  • getDirection(This) -> integer() — types: This = wxAuiPaneInfo()
  • getLayer(This) -> integer() — types: This = wxAuiPaneInfo()
  • getRow(This) -> integer() — types: This = wxAuiPaneInfo()
  • getPosition(This) -> integer() — types: This = wxAuiPaneInfo()
  • getFloatingPosition(This) -> {X :: integer(), Y :: integer()} — types: This = wxAuiPaneInfo()
  • getFloatingSize(This) -> {W :: integer(), H :: integer()} — types: This = wxAuiPaneInfo()
  • destroy(This :: wxAuiPaneInfo()) -> ok

Destroys the object. Bye bestie, it was iconic 💀✨

And that's a wrap on the whole wxAuiPaneInfo journey! 🌈🦋 This page came to you courtesy of the wxWidgets team, straight from the wx 2.2.2.1 docs — go forth and dock those panes like the main character you are 👑💖

📦 where this page comes from