Project

General

Profile

Editbox Control » History » Version 12

Per Amundsen, 05/20/2018 03:54 AM

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 3 Per Amundsen
h2. Typing Commands
10 1 Per Amundsen
11
Typing a command with one forward slash */command parameters* executes a built-in command, scripted identifier or a plugin command.
12
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 12 Per Amundsen
Pressing the %(key)CTRL% key while pressing %(key)ENTER% allows sending /commands as plain text without executing them.
16
17 3 Per Amundsen
h2. Spellcheck
18 1 Per Amundsen
19
Editbox supports spellchecking, see [[Spellcheck]] for a installation guide.
20
21 3 Per Amundsen
h2. History
22 1 Per Amundsen
23
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
25
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
27 3 Per Amundsen
h2. Tabcomplete
28 1 Per Amundsen
29
The Editbox supports various tab completions including nick completions using the %(key)TAB% key, see [[Tabcomplete]] for more information.
30
31
_See https://dev.adiirc.com/boards/5/topics/1302 for tab completing spellchecking._
32
33 3 Per Amundsen
h2. Customization
34 1 Per Amundsen
35
See [[Editbox Options]] for available options.
36
37
The colors can be changed in [[Options Dialog|Options]] -> [[Colors Options|Colors]] -> Editbox.
38
39
The font can be changed in [[Options Dialog|Options]] -> [[Fonts Options|Fonts]] or through the [[/font]] command.
40
41 5 Per Amundsen
It's possible to add padding around the Editbox in [[Options Dialog|Options]] -> [[Fonts Options|Windows]] -> Editbox padding.
42
43 3 Per Amundsen
h2. Using scripts to extend Editbox features
44 1 Per Amundsen
45
It's possible to respond to keydown/keydown events using the [[on KEYDOWN]] and [[on KEYUP]] events.
46
47
It's possible to respond to pressing enter using the [[on INPUT]] event.
48
49
It's possible to respond to tab completion/tab key the [[on TABCOMP]] event.
50
51
Check the "Scripting Forums":/projects/adiirc/boards/5 for examples.
52
53
The [[/editbox]] command and the [[$editbox]] identifier allows retrieving or changing the Editbox text and selection.
54
55 6 Per Amundsen
_See also [[$spellcheck]], [[$editboxhistory]]._
56 1 Per Amundsen
57 7 Per Amundsen
h2. Using plugins to extend Editbox features
58
59 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.
60 7 Per Amundsen
61 3 Per Amundsen
h2. Tips
62 1 Per Amundsen
63
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.
64
65
_See also [[Shortcuts]], there are many relevant to the Editbox._
66 10 Per Amundsen
67
h2. Known issues
68
69 11 Per Amundsen
When typing or pasting characters not available in the specified font, they will appear as empty squares, "this seems to be fixed in .NET 4.7":https://stackoverflow.com/questions/32591157/richtextbox-selection-highlight/32618479#32618479, so should be fixed in AdiIRC when it's upgraded to 4.7.
70 10 Per Amundsen
71
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.