Interface: IWindowOptions

Enable various window manipulation and report features (CSI Ps ; Ps ; Ps t).

Most settings have no default implementation, as they heavily rely on the embedding environment.

To implement a feature, create a custom CSI hook like this:

term.parser.addCsiHandler({final: 't'}, params => {
  const ps = params[0];
  switch (ps) {
    case XY:
      ...            // your implementation for option XY
      return true;   // signal Ps=XY was handled
  }
  return false;      // any Ps that was not handled
});

Note on security: Most features are meant to deal with some information of the host machine where the terminal runs on. This is seen as a security risk possibly leaking sensitive data of the host to the program in the terminal. Therefore all options (even those without a default implementation) are guarded by the boolean flag and disabled by default.

Hierarchy

  • IWindowOptions

Index

Properties

Properties

Optional fullscreenWin

• fullscreenWin? : boolean

Defined in xterm.d.ts:707

Ps=10 ; 0 Undo full-screen mode. Ps=10 ; 1 Change to full-screen. Ps=10 ; 2 Toggle full-screen. No default implementation.

Optional getCellSizePixels

• getCellSizePixels? : boolean

Defined in xterm.d.ts:735

Ps=16 Report xterm character cell size in pixels. Result is “CSI 6 ; height ; width t”. Has a default implementation.

Optional getIconTitle

• getIconTitle? : boolean

Defined in xterm.d.ts:750

Ps=20 Report xterm window’s icon label. Result is “OSC L label ST”. No default implementation.

Optional getScreenSizeChars

• getScreenSizeChars? : boolean

Defined in xterm.d.ts:745

Ps=19 Report the size of the screen in characters. Result is “CSI 9 ; height ; width t”. No default implementation.

Optional getScreenSizePixels

• getScreenSizePixels? : boolean

Defined in xterm.d.ts:730

Ps=15 Report size of the screen in pixels. Result is “CSI 5 ; height ; width t”. No default implementation.

Optional getWinPosition

• getWinPosition? : boolean

Defined in xterm.d.ts:719

Ps=13 Report xterm window position. Result is “CSI 3 ; x ; y t”. Ps=13 ; 2 Report xterm text-area position. Result is “CSI 3 ; x ; y t”. No default implementation.

Optional getWinSizeChars

• getWinSizeChars? : boolean

Defined in xterm.d.ts:740

Ps=18 Report the size of the text area in characters. Result is “CSI 8 ; height ; width t”. Has a default implementation.

Optional getWinSizePixels

• getWinSizePixels? : boolean

Defined in xterm.d.ts:725

Ps=14 Report xterm text area size in pixels. Result is “CSI 4 ; height ; width t”. Ps=14 ; 2 Report xterm window size in pixels. Result is “CSI 4 ; height ; width t”. Has a default implementation.

Optional getWinState

• getWinState? : boolean

Defined in xterm.d.ts:713

Ps=11 Report xterm window state. If the xterm window is non-iconified, it returns “CSI 1 t”. If the xterm window is iconified, it returns “CSI 2 t”. No default implementation.

Optional getWinTitle

• getWinTitle? : boolean

Defined in xterm.d.ts:755

Ps=21 Report xterm window’s title. Result is “OSC l label ST”. No default implementation.

Optional lowerWin

• lowerWin? : boolean

Defined in xterm.d.ts:682

Ps=6 Lower the xterm window to the bottom of the stacking order. No default implementation.

Optional maximizeWin

• maximizeWin? : boolean

Defined in xterm.d.ts:700

Ps=9 ; 0 Restore maximized window. Ps=9 ; 1 Maximize window (i.e., resize to screen size). Ps=9 ; 2 Maximize window vertically. Ps=9 ; 3 Maximize window horizontally. No default implementation.

Optional minimizeWin

• minimizeWin? : boolean

Defined in xterm.d.ts:658

Ps=2 Iconify window. No default implementation.

Optional popTitle

• popTitle? : boolean

Defined in xterm.d.ts:769

Ps=23 ; 0 Restore xterm icon and window title from stack. Ps=23 ; 1 Restore xterm icon title from stack. Ps=23 ; 2 Restore xterm window title from stack. All variants have a default implementation.

Optional pushTitle

• pushTitle? : boolean

Defined in xterm.d.ts:762

Ps=22 ; 0 Save xterm icon and window title on stack. Ps=22 ; 1 Save xterm icon title on stack. Ps=22 ; 2 Save xterm window title on stack. All variants have a default implementation.

Optional raiseWin

• raiseWin? : boolean

Defined in xterm.d.ts:677

Ps=5 Raise the window to the front of the stacking order. No default implementation.

Optional refreshWin

• refreshWin? : boolean

Defined in xterm.d.ts:684

Ps=7 Refresh the window.

Optional restoreWin

• restoreWin? : boolean

Defined in xterm.d.ts:653

Ps=1 De-iconify window. No default implementation.

Optional setWinLines

• setWinLines? : boolean

Defined in xterm.d.ts:775

Ps>=24 Resize to Ps lines (DECSLPP). DECSLPP is not implemented. This settings is also used to enable / disable DECCOLM (earlier variant of DECSLPP).

Optional setWinPosition

• setWinPosition? : boolean

Defined in xterm.d.ts:664

Ps=3 ; x ; y Move window to [x, y]. No default implementation.

Optional setWinSizeChars

• setWinSizeChars? : boolean

Defined in xterm.d.ts:692

Ps = 8 ; height ; width Resize the text area to given height and width in characters. Omitted parameters should reuse the current height or width. Zero parameters use the display’s height or width. No default implementation.

Optional setWinSizePixels

• setWinSizePixels? : boolean

Defined in xterm.d.ts:672

Ps = 4 ; height ; width Resize the window to given height and width in pixels. Omitted parameters should reuse the current height or width. Zero parameters should use the display’s height or width. No default implementation.