======Synopsis:====== $__windowctl__(REFNUM ) \\ $__windowctl__(REFNUMS) \\ $__windowctl__(REFNUMS_BY_PRIORITY) \\ $__windowctl__(REFNUMS_ON_SCREEN) \\ $__windowctl__(NEW) \\ $__windowctl__(NEW_HIDE) \\ $__windowctl__(GET ) \\ $__windowctl__(SET ) ======Technical:====== ^ Verb ^ Description ^ | REFNUM | Return a window's refnum given it's refnum, name, or uuid| | REFNUMS | Return all window refnums globally | | REFNUMS_BY_PRIORITY | Return all window refnums in the order they were last visited | | REFNUMS_ON_SCREEN | Return all windows on the current input screen| | NEW | Create a new split window and return its refnum | | NEW_HIDE | Create a new hidden window and return its refnum | | GET | Get a data field for a window | | SET | Set a data field for a window (see "Can set") | ^ Field ^ Can set ^ Description ^ | ACTIVITY_DATA | Y | The th activity data for this window [[window activity_data]] | | ACTIVITY_FORMAT | Y | The th activity format for this window [[window activity_format]] | | BEEP_ALWAYS | N | 1 if window will beep even when hidden; 0 if only when visible [[window beep_always]] | | BOTTOM | N | The final line/row of this window's display | | CHANGE_LINE | N | Which line will be overwritten [[xecho|xecho -line]] | | CHANNELS | N | All the channels on this window | | COLUMNS | N | How many columns are in this window | | CURRENT_ACTIVITY | Y | Which activity the window is currently using for %E status line expando [[window current_activity]] | | CURSOR | N | Where the cursor is in the window (next line gets output here) | | DECEASED | N | Internal flag | | DISPLAY_BUFFER_SIZE | N | How many items are in the scrollback buffer | | DISPLAY_BUFFER_MAX | N | How many items can be in the scrollback buffer before we start expiring the oldest one [[window scrollback]] | | DISPLAY_COUNTER | N | Internal flag | | DISPLAY_SIZE | N | How many lines of scrollable area the window has | | DOUBLE | N | 1 - Two status bars are showing 0 - One status bar is showing [[window double ]] | | FIXED | N | 1 if [[window fixed]] is on, 0 if off (does window resize when screen does) | | HOLD_INTERVAL | N | How often the %H status bar expando updates [[window hold_slider]] | | HOLD_SLIDER | N | How much the hold view slides when you hit [[bind send_line]]. [[window hold_slider]] | | HOLDING_DISTANCE | N | Internal flag | | INDENT | Y | Whether to indent second and subsequent lines of output (or not) [[window indent]] | | LASTLOG_LEVEL | N | What kinds of output gets added to the window's [[lastlog]] | | LASTLOG_MAX | N | How many lines of output are added to the window's [[lastlog]] before we expire the oldest one | | LASTLOG_SIZE | N | How many lines of output are actually in this window's [[lastlog]] | | LINE | N | A previously displayed _scrollback_ line. Starts counting from 0 from the bottom | | LOGFILE | N | When logging, the file being written to [[window logfile]] | | LOGGING | N | Whether this window is writing all output to a logfile [[window log]] | | LOG_MANGLE | Y | When logging, how the output should be mangled before writing [[window log_mangle]] | | LOG_REWRITE | Y | When logging, how the output should be rewritten before writing [[window log_rewrite]] | | NAME | N | The window's name [[window name]] | | NICKLIST | N | All of the nicks/queries for this window [[window add]] | | NOTIFIED | N | Whether window is currently notifying (hidden + output) [[window notified]] | | NOTIFY | N | Whether window notifies (%F) when output when hidden [[window notify]] | | NOTIFY_LEVEL | N | What kinds of output cause notification when hidden [[window notify_level]] | | NOTIFY_NAME | Y | What shows with %F [[window notify_name]] | | OLD_SIZE | N | Internal flag | | PRIORITY | N | The window's priority (when it was last visited) [[window refnum]] | | QUERY_NICK | N | The current query for this window [[window query]] [[window add]] | | REFNUM | N | The window's refnum [[window number]] | | SCREEN | N | Refnum of the screen window is on (-1 if hidden) | | SCROLLADJ | N | When the window grows, whether lines previously scrolled off show up at the top, or blank lines at the bottom [[window scrolladj]] | | SCROLLBACK_DISTANCE | N | Internal flag | | SCROLLING_DISTANCE | N | Internal flag | | SCROLL_LINES | N | When the window scrolls, how many lines it scrolls by at a time [[window scroll_lines]] | | SERVER | N | The window's server refnum [[window server ]] | | SERVER_STRING | N | The original server string [[window server]] | | SKIP | N | Whether [[bind next_window]] should skip this window | | STATUS_FORMAT | N | Custom status format for this window (single status bar) [[window status_format]] | | STATUS_FORMAT1 | N | Custom status format for the top status (double status bar) [[window status_format1 ]] | | STATUS_FORMAT2 | N | Custom status format for the bottom status (double status bar) [[window status_format2 ]] | | STATUS_LINE | N | Current rendered status bar (single status bar) | | STATUS_LINE1 | N | Current rendered top status bar (double status bar) | | STATUS_LINE2 | N | Current rendered bottom status bar (double status bar) | | SWAPPABLE | N | Whether this window can be hidden when visible or made visible when hidden [[window hide]] [[window swap]] | | TOP | N | The first line/row of this window's display | | TOPLINE | Y | The th topline for this window [[window topline]] | | TOPLINES | N | How many toplines should be showing (if there was enough room) [[window toplines]] | | UPDATE | N | Internal flag | | UUID | N | The window's immutable internal refnum (never changes, always unique) | | VISIBLE | N | 1 if window is visible, 0 if window is hidden | | WAITING_CHANNEL | N | Channels you [[join]]ed but which haven't completed joining yet | | WINDOW_LEVEL | N | What kinds of output should go to this window [[window level]] | ======History:====== The $windowctl() function first appeared in EPIC4-1.2.0 \\ SWAPPABLE first appeared in EPIC4-1.2.2. \\ TOPLINES first appeared in EPIC5-0.0.3. \\ ACTIVITY_* first appeared in EPIC5-0.0.6.