Revision as of 19:07, 17 March 2023

The aline command is used to add a single line of text to a custom window. This command is limited to custom @windows, If you need a more general command that is able to print to both custom windows, channel, and query consider using the /echo command instead.

Note: If the main window is sorted (text or listbox and /window -s has been used), lines added with /echo to that window won't be sorted, only lines added with /aline will.

Synopsis

/aline -scNahpinl [c] <@name> <text>

Switches

• -s - Clears the old selection in a listbox and selects the newly added item
• -a - Selects the newly added item while keeping the old selection in a listbox
• -h - Highlights the window's node in the treebar/switchbar if the window is minimized
• -p - Forces the line to be wrapped if it's too long to fit in on one line (does not apply to listboxes)
• -i[N] - Indent the newly added line (does not apply to listboxes) by N spaces, default to 2 spaces
• -n - Prevent the line from being added if it already exists
• -l - Specify the action to take place on the side-listbox
• -t - forces a re-wrap of all lines in a window that have not yet been wrapped to the current window size.
• -cN - Same as specifying the [c] parameter for the color of the line but via a switch

Parameters

• [c] - An optional color number for the line.
• <@name> - The name of the window.
• <text> - The text to be added.

Example

Alias Example {
  ;open a desktop custom window (main window is a listbox, no side-listbox and with an editbox)
  Window -lde @Foo
 
  ;Add a line, line colored in yellow (8)
  Aline 8 @Foo Line A
 
  ;Add a line, color Dark Green (3), selected, clear old selection
  Aline -s 3 @Foo Line B
}

Compatibility

Added: mIRC v5.0
Added on: 02 Apr 1997
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See also

• List of commands
• List of identifiers
• $line
• $fline
• $sline
• /cline
• /dline
• /echo
• /iline
• /rline
• /sline
• /window