Core Library0.xAPI Reference

Choose documentation 3

latest

Current version

latest
English

Early release libtmux is released, and its APIs may still change between releases. This site's structure and URLs may change too.

struct libtmux-go latest

CopyModeRequest

CopyModeRequest configures tmux copy mode. Its zero value enters copy mode on the receiver without scrolling. Fields may be combined. tmux resolves the receiver and optional SourcePane before processing Cancel, so a stale target can prevent reset. After resolution, Cancel takes precedence over other actions, though SourcePane validation and the PageDown version probe still occur first.

Source and package
Qualified name
tmux.CopyModeRequest
Package
tmux
Distribution
github.com/libtmux/libtmux-go/tmux
Source
tmux/pane_modes.go
struct tmux.CopyModeRequest

Fields6#

CopyModeRequest fields
NameTypeDescription
Cancel bool Cancel exits copy mode and any other active pane mode after tmux resolves the receiver and optional SourcePane. A resolution failure prevents the reset; after successful resolution, tmux ignores the other action fields.
ExitOnBottom bool ExitOnBottom makes copy mode exit after scrolling back to the visible screen, until another non-scrolling key disables that behavior.
MouseDrag bool MouseDrag begins a copy-mode mouse drag and is meaningful from a mouse binding.
PageDown bool PageDown enters copy mode one page below the current position. It requires tmux 3.5 and follows UnsupportedPolicy. Its version probe still occurs when Cancel is set.
ScrollUp bool ScrollUp enters copy mode one page above the current position.
SourcePane PaneID SourcePane selects a stable pane whose content is copied while the receiver remains the pane placed in copy mode. Zero uses the receiver. A nonzero value is validated by the library and resolved by tmux even when Cancel is set; a stale or nonexistent pane can prevent cancellation.
Esc

Type to search.

Reference previewOpen reference