$line » History » Version 12
Per Amundsen, 02/23/2023 04:24 PM
| 1 | 1 | Per Amundsen | _Added in 1.9.0_ |
|---|---|---|---|
| 2 | |||
| 3 | 9 | Per Amundsen | *$line(@window|#channel|nick|Status Window,N,[T])* |
| 4 | 1 | Per Amundsen | |
| 5 | Returns the Nth line of text in the specified window. |
||
| 6 | |||
| 7 | 9 | Per Amundsen | Works on any window. |
| 8 | |||
| 9 | 1 | Per Amundsen | *Parameters* |
| 10 | |||
| 11 | 12 | Per Amundsen | table(ktable). |
| 12 | |*Parameter*|*Description*| |
||
| 13 | | @window<notextile>|</notextile>#channel<notextile>|</notextile>nick<notextile>|</notextile>Status Window | The window to retrieve text from. | |
||
| 14 | | N | If N = 0 number of lines, otherwise the Nth line. | |
||
| 15 | | [T] | If T = 0 use display area (default) if T = 1, use side-listbox. (optional) | |
||
| 16 | 1 | Per Amundsen | |
| 17 | *Properties* |
||
| 18 | |||
| 19 | 12 | Per Amundsen | table(ktable). |
| 20 | |*Property*|*Description*| |
||
| 21 | | .state | Returns 1 if the line is selected in a side-listbox, otherwise 0. | |
||
| 22 | | .color | Returns the line or nick color. | |
||
| 23 | | .rgbcolor | For side-listbox returns the line color in [[$rgb]] format, otherwise returns the rgb line color if any *(AdiIRC only)* | |
||
| 24 | | .nickcolumn | Gets the line with the nickcolumn character intact. *(AdiIRC Only)* | |
||
| 25 | 2 | Per Amundsen | |
| 26 | 1 | Per Amundsen | *Example* |
| 27 | |||
| 28 | <pre> |
||
| 29 | ; Create a custom window. |
||
| 30 | /window @Example |
||
| 31 | |||
| 32 | ; Add a few lines to the window. |
||
| 33 | /aline @Example Test1 |
||
| 34 | /aline @Example Test2 |
||
| 35 | /aline @Example Test3 |
||
| 36 | |||
| 37 | ; Print number of lines in the window. |
||
| 38 | //echo -ag $line(@Example, 0) |
||
| 39 | |||
| 40 | ; Print the second line in the window. |
||
| 41 | //echo -ag $line(@Example, 2) |
||
| 42 | </pre> |