# libtmux::Pane

- **Module:** libtmux
- **Package:** libtmux-cxx
- **Language:** C++
- **Kind:** class
- **Source:** https://github.com/libtmux/libtmux-cxx/blob/393d4b0ad666f18a6581f1eb281741a75a7503f0/include/libtmux/entities.hpp#L666
- **Page:** https://libtmux.org/en/cxx/latest/reference/libtmux-pane/

One pane, as one listing saw it.

The narrowest thing tmux addresses, and the only one that owns a process: `pid` is the command tmux started, not the shell's children, so a pane running a program under a shell reports the shell.

Reads its own fields without touching tmux, on the same terms as `Session`.

## Members

- `kNoun` (attribute)
- `kSessionNameField` (attribute)
- `kFields` (attribute)
- `Pane` (method)
- `id` (method)
- `command` (method): What is running in the pane now, which is not what started it.
- `active` (method)
- `window_id` (method)
- `session_id` (method)
- `index` (method)
- `title` (method)
- `pid` (method)
- `tty` (method)
- `path` (method)
- `width` (method)
- `height` (method)
- `dead` (method): A pane whose program exited while `remain-on-exit` kept it on screen.
- `in_mode` (method): Copy mode and its relatives, in which sent keys move the cursor rather than reaching the program.
- `at_top` (method)
- `at_bottom` (method)
- `at_left` (method)
- `at_right` (method)
- `piping` (method): Whether this pane's output is currently being copied to a command.
- `left` (method): Position within the window, in cells from its top-left corner — the geometry `select_layout`'s saved arrangement places panes at.
- `top` (method): Its counterpart along the other axis.
- `exit_status` (method): What the pane's process exited with, once it has.
- `session_name` (method): The owning psmux route carried by Windows live snapshots.
- `window` (method)
- `session` (method)
- `send_text` (method): Literal text, never interpreted as key names or formats, and never followed by a newline the caller did not ask for.
- `send_key` (method)
- `send_line` (method): The text and then Enter, as one tmux invocation.
- `split` (method): Split this exact pane rather than whichever pane in its window happens to be active.
- `capture` (method): The visible contents, as tmux printed them.
- `wait_for_text` (method)
- `set_width` (method)
- `set_height` (method)
- `swap_with` (method)
- `toggle_zoom` (method): Toggle whether this pane's window is zoomed onto it — the whole window given over to one pane, full size.
- `break_out` (method): Take this pane out into a window of its own, which is returned.
- `join` (method): Move this pane into another window, splitting it.
- `enter_copy_mode` (method): Put this pane into copy mode, where its contents can be scrolled and selected rather than typed into.
- `leave_mode` (method): Leave whatever mode the pane is in.
- `pipe_to` (method): Copy everything this pane prints to a shell command, until told to stop.
- `stop_piping` (method): Stop copying. Harmless on a pane that was not piping.
- `set_title` (method): Name this pane.
- `respawn` (method): Start the pane's command again.
- `clear_history` (method)
- `expand` (method): Ask tmux to expand a format against this pane.
- `show_message` (method): Show a message to the clients watching this pane's session, expanded against this pane.
- `paste` (method): Deliver a buffer's text to this pane, as if it had been typed.
- `select` (method)
- `kill` (method)
- `refresh` (method)
- `options` (method): Pane options, the narrowest scope tmux has, and the end of an inheritance chain that runs pane, window, session, global.
- `option` (method)
- `set_option` (method)
- `unset_option` (method)