Project

General

Profile

Editbox Control » History » Version 22

Per Amundsen, 11/17/2018 12:35 AM

1 3 Per Amundsen
{{>toc}}
2 3 Per Amundsen
3 2 Per Amundsen
h1. Editbox
4 1 Per Amundsen
5 1 Per Amundsen
!editbox.png!
6 1 Per Amundsen
7 1 Per Amundsen
The Editbox is where you type messages to channels and users, it can also be used to type [[Scripting Commands|commands]].
8 1 Per Amundsen
9 3 Per Amundsen
h2. Typing Commands
10 1 Per Amundsen
11 1 Per Amundsen
Typing a command with one forward slash */command parameters* executes a built-in command, scripted identifier or a plugin command.
12 1 Per Amundsen
13 4 Per Amundsen
Typing a command with two forward slashes *//command parameters* evaluates the parameters before executing a built-in command, scripted alias or a plugin command.
14 1 Per Amundsen
15 13 Per Amundsen
Pressing the %(key)CTRL% key while pressing %(key)ENTER% allows sending commands as plain text without executing them.
16 12 Per Amundsen
17 3 Per Amundsen
h2. Spellcheck
18 1 Per Amundsen
19 1 Per Amundsen
Editbox supports spellchecking, see [[Spellcheck]] for a installation guide.
20 1 Per Amundsen
21 3 Per Amundsen
h2. History
22 1 Per Amundsen
23 1 Per Amundsen
The Edibox have a history of previously sent messages/commands which you can cycle through using the %(key)UP% or %(key)DOWN% key, if the Editbox currently have multiple lines, you must press %(key)ALT% + %(key)UP% / %(key)DOWN% instead, this is so you can use %(key)UP% / %(key)DOWN% to move the cursor between the lines.
24 1 Per Amundsen
25 1 Per Amundsen
By default each Editbox have it's own history, this can be changed to using a global history for all Editboxes in [[Editbox Options]].
26 1 Per Amundsen
27 19 Per Amundsen
h2. Clear history
28 19 Per Amundsen
29 19 Per Amundsen
History can be cleared using the [[/clear]] command with the *-h* parameter or by using the Editbox right-click menu.
30 19 Per Amundsen
31 19 Per Amundsen
!history.png!
32 19 Per Amundsen
33 3 Per Amundsen
h2. Tabcomplete
34 1 Per Amundsen
35 1 Per Amundsen
The Editbox supports various tab completions including nick completions using the %(key)TAB% key, see [[Tabcomplete]] for more information.
36 1 Per Amundsen
37 15 Per Amundsen
_See "this script":/boards/5/topics/1302 for tab completing spellchecking._
38 1 Per Amundsen
39 3 Per Amundsen
h2. Customization
40 1 Per Amundsen
41 1 Per Amundsen
See [[Editbox Options]] for available options.
42 1 Per Amundsen
43 1 Per Amundsen
The colors can be changed in [[Options Dialog|Options]] -> [[Colors Options|Colors]] -> Editbox.
44 1 Per Amundsen
45 1 Per Amundsen
The font can be changed in [[Options Dialog|Options]] -> [[Fonts Options|Fonts]] or through the [[/font]] command.
46 1 Per Amundsen
47 5 Per Amundsen
It's possible to add padding around the Editbox in [[Options Dialog|Options]] -> [[Fonts Options|Windows]] -> Editbox padding.
48 5 Per Amundsen
49 18 Per Amundsen
It's possible to change colors per channel using the [[/editbox]] command.
50 18 Per Amundsen
51 3 Per Amundsen
h2. Using scripts to extend Editbox features
52 1 Per Amundsen
53 1 Per Amundsen
It's possible to respond to keydown/keydown events using the [[on KEYDOWN]] and [[on KEYUP]] events.
54 1 Per Amundsen
55 1 Per Amundsen
It's possible to respond to pressing enter using the [[on INPUT]] event.
56 1 Per Amundsen
57 1 Per Amundsen
It's possible to respond to tab completion/tab key the [[on TABCOMP]] event.
58 1 Per Amundsen
59 1 Per Amundsen
Check the "Scripting Forums":/projects/adiirc/boards/5 for examples.
60 1 Per Amundsen
61 1 Per Amundsen
The [[/editbox]] command and the [[$editbox]] identifier allows retrieving or changing the Editbox text and selection.
62 1 Per Amundsen
63 6 Per Amundsen
_See also [[$spellcheck]], [[$editboxhistory]]._
64 1 Per Amundsen
65 7 Per Amundsen
h2. Using plugins to extend Editbox features
66 7 Per Amundsen
67 9 Per Amundsen
Check the "plugin api":https://adiirc.github.io/apiv2/generated/html/05878b69-8978-3495-2565-4fd3a3a5e83e.htm for the IEditbox interface and the "Editbox tutorial":https://github.com/AdiIRC/apiv2/blob/master/docs/tutorial/chapter5/README.md.
68 7 Per Amundsen
69 3 Per Amundsen
h2. Tips
70 1 Per Amundsen
71 1 Per Amundsen
Typing and then selecting a nick and then pressing %(key)CTRL% + %(key)Space% opens the nicklist menu for that nick, otherwise opens the Editbox right-click menu.
72 1 Per Amundsen
73 22 Per Amundsen
Typing /! in a Editbox restores the last line written in any Editbox.
74 22 Per Amundsen
75 1 Per Amundsen
_See also [[Shortcuts]], there are many relevant to the Editbox._
76 10 Per Amundsen
77 16 Per Amundsen
h2. Auto replacing text
78 16 Per Amundsen
79 16 Per Amundsen
"This script":/boards/5/topics/275 can auto replace text while typing, it also has a user interface.
80 16 Per Amundsen
81 10 Per Amundsen
h2. Known issues
82 10 Per Amundsen
83 17 Per Amundsen
When typing or pasting characters not available in the specified font, they will appear as empty squares for Windows versions below 10.
84 10 Per Amundsen
85 14 Per Amundsen
When using spellchecking, the Editbox switches to a custom undo/redo stack. It is not as intelligent as the built-in stack (it only allows undo one typed character at the time), there will be some improvements in the future.
86 20 Per Amundsen
87 21 Per Amundsen
Windows build 1809 introduced a bug causing some fonts to not work properly in the Editbox, it can be fixed for now by typing [[/setoption]] Misc UseOldRtb True. (This disables emoji support in the Editbox)