tmux.NewPaneRequest

struct tmux.NewPaneRequest

struct [source] ¶

struct [source] ¶

struct tmux.NewPaneRequest

NewPaneRequest configures a floating pane and requires tmux 3.7 or later. Its zero value creates a detached floating pane with tmux's default size, position, styles, and command. Nil pointer fields omit their options; nonnil pointers are explicit, including empty style or message strings. Width and Height must be nonnegative. Empty and Command are mutually exclusive. Unsupported tmux versions return VersionTooLowError rather than omitting fields.

Methods copy pointers and Environment before I/O; concurrent mutation during the copy is unsafe.

Members

• ActiveBorderStyle attribute ActiveBorderStyle sets the active border style; nil omits it.
• Attach attribute Attach lets the created pane become active in the exact target winlink; false preserves its active pane.
• Command attribute Command starts the pane with this shell command; empty uses tmux's default.
• Empty attribute Empty creates a pane without starting a command.
• Environment attribute Environment is emitted in lexically sorted key order. The map is not retained; nil and an empty map both add no entries.
• Height attribute Height sets a nonnegative pane height; nil lets tmux choose.
• InactiveBorderStyle attribute InactiveBorderStyle sets the inactive border style; nil omits it.
• Keep attribute Keep preserves the pane after its command exits.
• Message attribute Message sets the pane message; nil omits it.
• StartDirectory attribute StartDirectory expands ~ and ~/... for the current user. Named-user forms such as ~other are rejected; empty inherits tmux's default.
• Style attribute Style sets the pane style; nil omits it.
• Width attribute Width sets a nonnegative pane width; nil lets tmux choose.
• X attribute X sets the horizontal position; nil lets tmux choose.
• Y attribute Y sets the vertical position; nil lets tmux choose.
• Zoom attribute Zoom preserves the target window's zoomed state.