Session.CreateWindowWithReceiptAsync
Creates a window and returns its initial pane identity.
Source and package
- Module
- LibTmux
- Declared in
- Session
- Package
- LibTmux
- Source
- src/LibTmux/Session.Lifecycle.cs
- CreateWindowWithReceiptAsync ( request : New
Window ? , cancellationToken : CancellationRequest Token ) Task<WindowCreation >Result -
Description#
Rejects
SelectExistingbefore dispatch because an existing window has no creation receipt. The pane identifier comes from creation, not a later listing; the pane may have moved or disappeared before readback. A failed readback publishes no receipt or cleanup ownership.- Parameters
-
-
request ( New
Window ? ) – The window to create.Request -
cancellationToken ( Cancellation
Token ) – Cancels creation and readback.
-
- Returns
-
The created window in this session and its initial pane identifier.
- Raises
-
-
Argument
Exception – The request may select an existing window. -
Lib
Tmux – Creation or readback failed; a failure after creation has unknown dispatch outcome.Exception
-