Editing mirc/commands/aline

{{mirc title|/aline Command}}
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 -scNahpinlt [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 ==
<syntaxhighlight lang="mIRC">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
}</syntaxhighlight>

== Compatibility ==
{{mIRC compatibility|5.0}}

== See also ==
* [[List of commands - mIRC|List of commands]]
* [[List of identifiers - mIRC|List of identifiers]]
* {{mIRC|$line}}
* {{mIRC|$fline}}
* {{mIRC|$sline}}
* {{mIRC|/cline}}
* {{mIRC|/dline}}
* {{mIRC|/echo}}
* {{mIRC|/iline}}
* {{mIRC|/rline}}
* {{mIRC|/sline}}
* {{mIRC|/window}}
{{mIRC command list}}

[[Category:mIRC commands|aline command - mIRC]]