Editbox Control » History » Version 26
Per Amundsen, 03/27/2021 10:29 PM
1 | 3 | Per Amundsen | {{>toc}} |
---|---|---|---|
2 | |||
3 | 2 | Per Amundsen | h1. Editbox |
4 | 1 | Per Amundsen | |
5 | !editbox.png! |
||
6 | |||
7 | The Editbox is where you type messages to channels and users, it can also be used to type [[Scripting Commands|commands]]. |
||
8 | |||
9 | 26 | Per Amundsen | _See also [[Editbox Options]]._ |
10 | |||
11 | 3 | Per Amundsen | h2. Typing Commands |
12 | 1 | Per Amundsen | |
13 | Typing a command with one forward slash */command parameters* executes a built-in command, scripted identifier or a plugin command. |
||
14 | |||
15 | 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. |
16 | 1 | Per Amundsen | |
17 | 13 | Per Amundsen | Pressing the %(key)CTRL% key while pressing %(key)ENTER% allows sending commands as plain text without executing them. |
18 | 12 | Per Amundsen | |
19 | 3 | Per Amundsen | h2. Spellcheck |
20 | 1 | Per Amundsen | |
21 | Editbox supports spellchecking, see [[Spellcheck]] for a installation guide. |
||
22 | |||
23 | 3 | Per Amundsen | h2. History |
24 | 1 | Per Amundsen | |
25 | 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. |
||
26 | |||
27 | By default each Editbox have it's own history, this can be changed to using a global history for all Editboxes in [[Editbox Options]]. |
||
28 | |||
29 | 19 | Per Amundsen | h2. Clear history |
30 | |||
31 | History can be cleared using the [[/clear]] command with the *-h* parameter or by using the Editbox right-click menu. |
||
32 | |||
33 | !history.png! |
||
34 | |||
35 | 3 | Per Amundsen | h2. Tabcomplete |
36 | 1 | Per Amundsen | |
37 | The Editbox supports various tab completions including nick completions using the %(key)TAB% key, see [[Tabcomplete]] for more information. |
||
38 | |||
39 | 15 | Per Amundsen | _See "this script":/boards/5/topics/1302 for tab completing spellchecking._ |
40 | 1 | Per Amundsen | |
41 | 23 | Per Amundsen | _See also [[on TABCOMP]]._ |
42 | |||
43 | 3 | Per Amundsen | h2. Customization |
44 | 1 | Per Amundsen | |
45 | See [[Editbox Options]] for available options. |
||
46 | |||
47 | The colors can be changed in [[Options Dialog|Options]] -> [[Colors Options|Colors]] -> Editbox. |
||
48 | |||
49 | The font can be changed in [[Options Dialog|Options]] -> [[Fonts Options|Fonts]] or through the [[/font]] command. |
||
50 | |||
51 | 5 | Per Amundsen | It's possible to add padding around the Editbox in [[Options Dialog|Options]] -> [[Fonts Options|Windows]] -> Editbox padding. |
52 | |||
53 | 18 | Per Amundsen | It's possible to change colors per channel using the [[/editbox]] command. |
54 | |||
55 | 3 | Per Amundsen | h2. Using scripts to extend Editbox features |
56 | 1 | Per Amundsen | |
57 | It's possible to respond to keydown/keydown events using the [[on KEYDOWN]] and [[on KEYUP]] events. |
||
58 | |||
59 | It's possible to respond to pressing enter using the [[on INPUT]] event. |
||
60 | |||
61 | It's possible to respond to tab completion/tab key the [[on TABCOMP]] event. |
||
62 | |||
63 | Check the "Scripting Forums":/projects/adiirc/boards/5 for examples. |
||
64 | |||
65 | The [[/editbox]] command and the [[$editbox]] identifier allows retrieving or changing the Editbox text and selection. |
||
66 | |||
67 | 6 | Per Amundsen | _See also [[$spellcheck]], [[$editboxhistory]]._ |
68 | 1 | Per Amundsen | |
69 | 7 | Per Amundsen | h2. Using plugins to extend Editbox features |
70 | |||
71 | 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. |
72 | 7 | Per Amundsen | |
73 | 3 | Per Amundsen | h2. Tips |
74 | 1 | Per Amundsen | |
75 | 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. |
||
76 | |||
77 | 22 | Per Amundsen | Typing /! in a Editbox restores the last line written in any Editbox. |
78 | |||
79 | 1 | Per Amundsen | _See also [[Shortcuts]], there are many relevant to the Editbox._ |
80 | 10 | Per Amundsen | |
81 | 16 | Per Amundsen | h2. Auto replacing text |
82 | |||
83 | "This script":/boards/5/topics/275 can auto replace text while typing, it also has a user interface. |
||
84 | |||
85 | 10 | Per Amundsen | h2. Known issues |
86 | |||
87 | 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. |
88 | 10 | Per Amundsen | |
89 | 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. |
90 | 20 | Per Amundsen | |
91 | 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) |
92 | 24 | Per Amundsen | |
93 | 25 | Per Amundsen | Using certain characters and certain fonts may cause the Editbox to have different characters in 2 separate fonts, this is not a bug. The windows control does this to substitute characters not available in the current font, you'll see the same thing in Notepad which uses the same control. |