• Table of contents
• Custom Windows
  • /window
  • /titlebar
  • /renwin
  • /aline
  • /aline
  • /rline
  • /cline
  • /sline
  • Custom Window's Menus
  • $window
  • $line
  • $fline
  • $sline

Custom Windows¶

/window¶

Added in 1.9.0

/window [-aAbBcCde[N]fg[N]hHij[N]k[N]l[N]mMn[N]opq[N]rRsST[N]uvw[N]xz] [-tN,..,N] [+bdeflLmnstx] <@name> [rgb|[x y [w h]]] [/command] [popup.txt] [font [size]] [iconfile [N]]

Creates or manipulates a custom window with a Topicbox/Editbox/Text area/Listbox depending on the parameters used, see Custom Windows for more information.

If -p is specified, a picture window is created which can be custom drawn using various commands/identifiers, see Picture Windows for more information.

Option Switches

Tab Switches

Appearance Switches

These causes graphical glitches for MDI windows because .net MDI does not like windows without proper borders.

Parameters

Example

alias example1 {
  ; Create a desktop + picture window, Coordinates: (250,250), size 300x300.
  /window -dep @Example 250 250 300 300

  ; Color it with the control code color 3. (default is green)
  /drawfill @Example 3 3 1 1 100 100

  ; Draw text "Hello world!".
  /drawtext @Example 1 Arial 30 50 100 Hello World!

  ; Close the window.
  /window -c @Example
}

/titlebar¶

Added in 1.9.0

/titlebar [@window] <text>

Sets the main application Titlebar. If you specify a custom @window name, then the Titlebar for that custom window is changed.

See also $titlebar, Titlebar.

Parameters

Example

; Changes AdiIRC's titlebar to Hello world!
/titlebar Hello world!

; Open a custom window.
/window -e @Example

; Changes @Example Titlebar to Hello world!
/titlebar @Example Hello world!

/renwin¶

Added in 1.9.2

/renwin <@oldname> <@newname> [topic]

Allows you to change the name of an existing window to a different one, and an optional topic can be specified.

Parameters

Example

; Open a custom window.
/window -e @Example1

; Rename @Example1 to @Example2 and add topic 'Hello world'.
/renwin @Example1 @Example2 Hello World

/aline¶

Added in 1.9.1

/dline [-hlSW] <@name> <N[-N2]>

Deletes the Nth line through N2th line in a custom window.

Switches

Parameters

Example

alias example {
  ;Open a custom window.
  /window -de @Foo

  ;Add a line, line colored in yellow. (8)
  /aline 8 @Foo Line A

  ;Add a line, color Dark Green. (3)
  /aline 3 @Foo Line B

  ;Add a line, color Dark Green. (3)
  /aline -s 3 @Foo Line C

  ;Add a line, color Dark Green. (3)
  /aline -s 3 @Foo Line D

  ;Delete line 2 and 3 with range 2-3, only A D remain.
  /dline @Foo 2-3
}

/aline¶

Added in 2.2

/iline [-ahilnpsbTNSW] [color] <@name> <N> <text>

Inserts <text> into the Nth line in a custom window named <@name>.

Switches

Parameters

Example

; Open a custom window.
/window -de @Example

; Add 3 blue colored lines.
/aline 12 @Example Line1
/aline 12 @Example Line2
/aline 12 @Example Line3

; Insert a red colored lines at line number 2
/iline 4 @Example 2 Line4

/rline¶

Added in 1.9.5

/rline [-ahslbTNSW] [c] <@name> <N> <text>

Replaces the Nth line in any window with a new line.

Switches

Parameters

Example

alias example {
  ; Open a custom window.
  /window -de @Example

  ; Add a line with the text 'Line A'.
  /aline @Example Line A

  ; Add a line with the text 'Line B'.
  /aline @Example Line B

  ; Add a line with the text 'Line C'.
  /aline @Example Line C

  ; Change the text of the second line to 'Line D'.
  /dline @Example 2 Line D
}

/cline¶

Added in 1.9.3

/cline [-bhlmrSW] [c] <#channel|@name> <N|nick>

Changes the color of the Nth line or nick to color [c].

If [c] is not defined, the line will be reset to default color.

Switches

Parameters

Example

alias example {
  ; Open a custom window.
  /window @Example

  ; Add a 'Hello World' line to the custom window.
  /aline @Example Hello World

  ; Change the color of the first line to red (4).
  /cline 4 @Example 1

  ; Change the color of the first line to rgb color blue
  /cline -b $rgb(0,0,255) 1
}

/sline¶

Added in 1.9.0

/sline [-arSW] <#channel> <N|nick>

Selects or de-selects lines in a channel nickname listbox. It can select either the Nth nickname in a listbox, or a specified nickname.

Switches

Parameters

Custom Window's Menus¶

Scripting Menus

$window¶

Added in 1.9.0

$window(N/@name/@wildcard, M)

Returns properties for a window.

See also /window.

Parameters

Properties

$line¶

Added in 1.9.0

$line(@window|#channel|nick|Status Window,N,[T])

Returns the Nth line of text in the specified window.

Works on any window.

Parameters

Properties

Example

; Create a custom window.
/window @Example

; Add a few lines to the window.
/aline @Example Test1
/aline @Example Test2
/aline @Example Test3

; Print number of lines in the window.
//echo -ag $line(@Example, 0)

; Print the second line in the window.
//echo -ag $line(@Example, 2)

$fline¶

Added in 1.9.0

$fline(@name,wildtext,[N],[T],[S])

Returns Nth position of line which matches the specified wildcard text.

See also $flinen.

Parameters

Properties

Example

; Open a custom window.
/window @Example

; Add some lines
/aline @Example Test1
/aline @Example Test2
/aline @Example Test3

; Search the display area for the wildtext 'Text*' and print number of results.
//echo -ag $fline(@Example, Test*, 0)

; Search the display area for the wildtext 'Text*' and print the second result.
//echo -ag $fline(@Example, Test*, 2)

$sline¶

Added in 1.9.0

$sline(@name,N)

Returns the Nth selected line in a listbox.

Parameters

Properties

Example

; Create a custom window with a listbox.
/window -l @example

; Add some items to the listbox.
/aline @example Test1
/aline @example Test2
/aline @example Test2

; Select the second line in the listbox.
/sline @example 2

; Print the number og selected lines in the listbox.
//echo -ag $sline(@example, 0)

; Print the value of the first selected line in the listbox.
//echo -ag $sline(@example, 1)

; Print the line number of the first selected line in the listbox.
//echo -ag $sline(@example, 1).ln