Commit | Line | Data |
---|---|---|
12b55d76 KL |
1 | /* |
2 | * Jexer - Java Text User Interface | |
3 | * | |
4 | * The MIT License (MIT) | |
5 | * | |
6 | * Copyright (C) 2017 Kevin Lamonte | |
7 | * | |
8 | * Permission is hereby granted, free of charge, to any person obtaining a | |
9 | * copy of this software and associated documentation files (the "Software"), | |
10 | * to deal in the Software without restriction, including without limitation | |
11 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, | |
12 | * and/or sell copies of the Software, and to permit persons to whom the | |
13 | * Software is furnished to do so, subject to the following conditions: | |
14 | * | |
15 | * The above copyright notice and this permission notice shall be included in | |
16 | * all copies or substantial portions of the Software. | |
17 | * | |
18 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
19 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
20 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL | |
21 | * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
22 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING | |
23 | * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER | |
24 | * DEALINGS IN THE SOFTWARE. | |
25 | * | |
26 | * @author Kevin Lamonte [kevin.lamonte@gmail.com] | |
27 | * @version 1 | |
28 | */ | |
29 | package jexer; | |
30 | ||
71a389c9 KL |
31 | import java.io.IOException; |
32 | ||
12b55d76 KL |
33 | import jexer.bits.CellAttributes; |
34 | import jexer.event.TKeypressEvent; | |
35 | import jexer.event.TMouseEvent; | |
e8a11f98 | 36 | import jexer.event.TResizeEvent; |
12b55d76 KL |
37 | import jexer.teditor.Document; |
38 | import jexer.teditor.Line; | |
39 | import jexer.teditor.Word; | |
40 | import static jexer.TKeypress.*; | |
41 | ||
42 | /** | |
43 | * TEditorWidget displays an editable text document. It is unaware of | |
44 | * scrolling behavior, but can respond to mouse and keyboard events. | |
45 | */ | |
46 | public final class TEditorWidget extends TWidget { | |
47 | ||
48 | /** | |
49 | * The document being edited. | |
50 | */ | |
51 | private Document document; | |
52 | ||
e8a11f98 KL |
53 | /** |
54 | * The default color for the TEditor class. | |
55 | */ | |
56 | private CellAttributes defaultColor = null; | |
57 | ||
58 | /** | |
59 | * The topmost line number in the visible area. 0-based. | |
60 | */ | |
61 | private int topLine = 0; | |
62 | ||
63 | /** | |
64 | * The leftmost column number in the visible area. 0-based. | |
65 | */ | |
66 | private int leftColumn = 0; | |
67 | ||
12b55d76 KL |
68 | /** |
69 | * Public constructor. | |
70 | * | |
71 | * @param parent parent widget | |
72 | * @param text text on the screen | |
73 | * @param x column relative to parent | |
74 | * @param y row relative to parent | |
75 | * @param width width of text area | |
76 | * @param height height of text area | |
77 | */ | |
78 | public TEditorWidget(final TWidget parent, final String text, final int x, | |
79 | final int y, final int width, final int height) { | |
80 | ||
81 | // Set parent and window | |
82 | super(parent, x, y, width, height); | |
83 | ||
84 | setCursorVisible(true); | |
e8a11f98 KL |
85 | |
86 | defaultColor = getTheme().getColor("teditor"); | |
87 | document = new Document(text, defaultColor); | |
12b55d76 KL |
88 | } |
89 | ||
90 | /** | |
91 | * Draw the text box. | |
92 | */ | |
93 | @Override | |
94 | public void draw() { | |
12b55d76 KL |
95 | for (int i = 0; i < getHeight(); i++) { |
96 | // Background line | |
e8a11f98 | 97 | getScreen().hLineXY(0, i, getWidth(), ' ', defaultColor); |
12b55d76 KL |
98 | |
99 | // Now draw document's line | |
e8a11f98 KL |
100 | if (topLine + i < document.getLineCount()) { |
101 | Line line = document.getLine(topLine + i); | |
12b55d76 KL |
102 | int x = 0; |
103 | for (Word word: line.getWords()) { | |
e8a11f98 KL |
104 | // For now, we are cheating: draw outside the left region |
105 | // if needed and let screen do the clipping. | |
106 | getScreen().putStringXY(x - leftColumn, i, word.getText(), | |
12b55d76 KL |
107 | word.getColor()); |
108 | x += word.getDisplayLength(); | |
e8a11f98 | 109 | if (x - leftColumn > getWidth()) { |
12b55d76 KL |
110 | break; |
111 | } | |
112 | } | |
113 | } | |
114 | } | |
12b55d76 KL |
115 | } |
116 | ||
117 | /** | |
118 | * Handle mouse press events. | |
119 | * | |
120 | * @param mouse mouse button press event | |
121 | */ | |
122 | @Override | |
123 | public void onMouseDown(final TMouseEvent mouse) { | |
124 | if (mouse.isMouseWheelUp()) { | |
71a389c9 KL |
125 | if (topLine > 0) { |
126 | topLine--; | |
127 | alignDocument(false); | |
e8a11f98 | 128 | } |
12b55d76 KL |
129 | return; |
130 | } | |
131 | if (mouse.isMouseWheelDown()) { | |
71a389c9 KL |
132 | if (topLine < document.getLineCount() - 1) { |
133 | topLine++; | |
134 | alignDocument(true); | |
e8a11f98 | 135 | } |
12b55d76 KL |
136 | return; |
137 | } | |
138 | ||
e8a11f98 KL |
139 | if (mouse.isMouse1()) { |
140 | // Set the row and column | |
141 | int newLine = topLine + mouse.getY(); | |
142 | int newX = leftColumn + mouse.getX(); | |
df602ccf | 143 | if (newLine > document.getLineCount() - 1) { |
e8a11f98 KL |
144 | // Go to the end |
145 | document.setLineNumber(document.getLineCount() - 1); | |
146 | document.end(); | |
df602ccf KL |
147 | if (newLine > document.getLineCount() - 1) { |
148 | setCursorY(document.getLineCount() - 1 - topLine); | |
e8a11f98 | 149 | } else { |
df602ccf | 150 | setCursorY(mouse.getY()); |
e8a11f98 KL |
151 | } |
152 | alignCursor(); | |
153 | return; | |
154 | } | |
155 | ||
156 | document.setLineNumber(newLine); | |
157 | setCursorY(mouse.getY()); | |
158 | if (newX > document.getCurrentLine().getDisplayLength()) { | |
159 | document.end(); | |
160 | alignCursor(); | |
161 | } else { | |
df602ccf | 162 | document.setCursor(newX); |
e8a11f98 KL |
163 | setCursorX(mouse.getX()); |
164 | } | |
165 | return; | |
166 | } | |
12b55d76 KL |
167 | |
168 | // Pass to children | |
169 | super.onMouseDown(mouse); | |
170 | } | |
171 | ||
71a389c9 KL |
172 | /** |
173 | * Align visible area with document current line. | |
174 | * | |
175 | * @param topLineIsTop if true, make the top visible line the document | |
176 | * current line if it was off-screen. If false, make the bottom visible | |
177 | * line the document current line. | |
178 | */ | |
179 | private void alignTopLine(final boolean topLineIsTop) { | |
180 | int line = document.getLineNumber(); | |
181 | ||
182 | if ((line < topLine) || (line > topLine + getHeight() - 1)) { | |
183 | // Need to move topLine to bring document back into view. | |
184 | if (topLineIsTop) { | |
185 | topLine = line - (getHeight() - 1); | |
186 | } else { | |
187 | topLine = line; | |
188 | } | |
189 | } | |
190 | ||
191 | /* | |
192 | System.err.println("line " + line + " topLine " + topLine); | |
193 | */ | |
194 | ||
195 | // Document is in view, let's set cursorY | |
196 | setCursorY(line - topLine); | |
197 | alignCursor(); | |
198 | } | |
199 | ||
200 | /** | |
201 | * Align document current line with visible area. | |
202 | * | |
203 | * @param topLineIsTop if true, make the top visible line the document | |
204 | * current line if it was off-screen. If false, make the bottom visible | |
205 | * line the document current line. | |
206 | */ | |
207 | private void alignDocument(final boolean topLineIsTop) { | |
208 | int line = document.getLineNumber(); | |
df602ccf | 209 | int cursor = document.getCursor(); |
71a389c9 KL |
210 | |
211 | if ((line < topLine) || (line > topLine + getHeight() - 1)) { | |
212 | // Need to move document to ensure it fits view. | |
213 | if (topLineIsTop) { | |
214 | document.setLineNumber(topLine); | |
215 | } else { | |
216 | document.setLineNumber(topLine + (getHeight() - 1)); | |
217 | } | |
df602ccf KL |
218 | if (cursor < document.getCurrentLine().getDisplayLength()) { |
219 | document.setCursor(cursor); | |
220 | } | |
71a389c9 KL |
221 | } |
222 | ||
223 | /* | |
224 | System.err.println("getLineNumber() " + document.getLineNumber() + | |
225 | " topLine " + topLine); | |
226 | */ | |
227 | ||
228 | // Document is in view, let's set cursorY | |
229 | setCursorY(document.getLineNumber() - topLine); | |
230 | alignCursor(); | |
231 | } | |
232 | ||
e8a11f98 KL |
233 | /** |
234 | * Align visible cursor with document cursor. | |
235 | */ | |
236 | private void alignCursor() { | |
237 | int width = getWidth(); | |
238 | ||
239 | int desiredX = document.getCursor() - leftColumn; | |
240 | if (desiredX < 0) { | |
241 | // We need to push the screen to the left. | |
242 | leftColumn = document.getCursor(); | |
243 | } else if (desiredX > width - 1) { | |
244 | // We need to push the screen to the right. | |
245 | leftColumn = document.getCursor() - (width - 1); | |
246 | } | |
247 | ||
248 | /* | |
249 | System.err.println("document cursor " + document.getCursor() + | |
250 | " leftColumn " + leftColumn); | |
df602ccf KL |
251 | */ |
252 | ||
e8a11f98 KL |
253 | |
254 | setCursorX(document.getCursor() - leftColumn); | |
255 | } | |
256 | ||
12b55d76 KL |
257 | /** |
258 | * Handle keystrokes. | |
259 | * | |
260 | * @param keypress keystroke event | |
261 | */ | |
262 | @Override | |
263 | public void onKeypress(final TKeypressEvent keypress) { | |
264 | if (keypress.equals(kbLeft)) { | |
df602ccf KL |
265 | document.left(); |
266 | alignTopLine(false); | |
12b55d76 | 267 | } else if (keypress.equals(kbRight)) { |
df602ccf KL |
268 | document.right(); |
269 | alignTopLine(true); | |
12b55d76 | 270 | } else if (keypress.equals(kbUp)) { |
71a389c9 KL |
271 | document.up(); |
272 | alignTopLine(false); | |
12b55d76 | 273 | } else if (keypress.equals(kbDown)) { |
71a389c9 KL |
274 | document.down(); |
275 | alignTopLine(true); | |
12b55d76 | 276 | } else if (keypress.equals(kbPgUp)) { |
71a389c9 KL |
277 | document.up(getHeight() - 1); |
278 | alignTopLine(false); | |
12b55d76 | 279 | } else if (keypress.equals(kbPgDn)) { |
71a389c9 KL |
280 | document.down(getHeight() - 1); |
281 | alignTopLine(true); | |
12b55d76 | 282 | } else if (keypress.equals(kbHome)) { |
e8a11f98 KL |
283 | if (document.home()) { |
284 | leftColumn = 0; | |
285 | if (leftColumn < 0) { | |
286 | leftColumn = 0; | |
287 | } | |
288 | setCursorX(0); | |
289 | } | |
12b55d76 | 290 | } else if (keypress.equals(kbEnd)) { |
e8a11f98 KL |
291 | if (document.end()) { |
292 | alignCursor(); | |
293 | } | |
12b55d76 KL |
294 | } else if (keypress.equals(kbCtrlHome)) { |
295 | document.setLineNumber(0); | |
296 | document.home(); | |
e8a11f98 KL |
297 | topLine = 0; |
298 | leftColumn = 0; | |
299 | setCursorX(0); | |
300 | setCursorY(0); | |
12b55d76 KL |
301 | } else if (keypress.equals(kbCtrlEnd)) { |
302 | document.setLineNumber(document.getLineCount() - 1); | |
303 | document.end(); | |
71a389c9 | 304 | alignTopLine(false); |
12b55d76 KL |
305 | } else if (keypress.equals(kbIns)) { |
306 | document.setOverwrite(!document.getOverwrite()); | |
307 | } else if (keypress.equals(kbDel)) { | |
308 | document.del(); | |
71a389c9 | 309 | alignCursor(); |
12b55d76 KL |
310 | } else if (keypress.equals(kbBackspace)) { |
311 | document.backspace(); | |
df602ccf KL |
312 | alignTopLine(false); |
313 | } else if (keypress.equals(kbTab)) { | |
314 | // TODO: tab character. For now just add spaces until we hit | |
315 | // modulo 8. | |
316 | for (int i = document.getCursor(); (i + 1) % 8 != 0; i++) { | |
317 | document.addChar(' '); | |
318 | } | |
e8a11f98 | 319 | alignCursor(); |
71a389c9 | 320 | } else if (keypress.equals(kbEnter)) { |
df602ccf KL |
321 | document.enter(); |
322 | alignTopLine(true); | |
12b55d76 KL |
323 | } else if (!keypress.getKey().isFnKey() |
324 | && !keypress.getKey().isAlt() | |
325 | && !keypress.getKey().isCtrl() | |
326 | ) { | |
327 | // Plain old keystroke, process it | |
328 | document.addChar(keypress.getKey().getChar()); | |
71a389c9 | 329 | alignCursor(); |
12b55d76 KL |
330 | } else { |
331 | // Pass other keys (tab etc.) on to TWidget | |
332 | super.onKeypress(keypress); | |
333 | } | |
334 | } | |
335 | ||
e8a11f98 KL |
336 | /** |
337 | * Method that subclasses can override to handle window/screen resize | |
338 | * events. | |
339 | * | |
340 | * @param resize resize event | |
341 | */ | |
342 | @Override | |
343 | public void onResize(final TResizeEvent resize) { | |
344 | // Change my width/height, and pull the cursor in as needed. | |
345 | if (resize.getType() == TResizeEvent.Type.WIDGET) { | |
346 | setWidth(resize.getWidth()); | |
347 | setHeight(resize.getHeight()); | |
348 | // See if the cursor is now outside the window, and if so move | |
349 | // things. | |
350 | if (getCursorX() >= getWidth()) { | |
351 | leftColumn += getCursorX() - (getWidth() - 1); | |
352 | setCursorX(getWidth() - 1); | |
353 | } | |
354 | if (getCursorY() >= getHeight()) { | |
355 | topLine += getCursorY() - (getHeight() - 1); | |
356 | setCursorY(getHeight() - 1); | |
357 | } | |
358 | } else { | |
359 | // Let superclass handle it | |
360 | super.onResize(resize); | |
361 | } | |
362 | } | |
363 | ||
71a389c9 KL |
364 | /** |
365 | * Get the number of lines in the underlying Document. | |
366 | * | |
367 | * @return the number of lines | |
368 | */ | |
369 | public int getLineCount() { | |
370 | return document.getLineCount(); | |
371 | } | |
372 | ||
373 | /** | |
374 | * Get the current editing row number. 1-based. | |
375 | * | |
376 | * @return the editing row number. Row 1 is the first row. | |
377 | */ | |
378 | public int getEditingRowNumber() { | |
379 | return document.getLineNumber() + 1; | |
380 | } | |
381 | ||
382 | /** | |
383 | * Set the current editing row number. 1-based. | |
384 | * | |
385 | * @param row the new editing row number. Row 1 is the first row. | |
386 | */ | |
387 | public void setEditingRowNumber(final int row) { | |
388 | document.setLineNumber(row - 1); | |
389 | } | |
390 | ||
391 | /** | |
392 | * Get the current editing column number. 1-based. | |
393 | * | |
394 | * @return the editing column number. Column 1 is the first column. | |
395 | */ | |
396 | public int getEditingColumnNumber() { | |
397 | return document.getCursor() + 1; | |
398 | } | |
399 | ||
400 | /** | |
401 | * Set the current editing column number. 1-based. | |
402 | * | |
403 | * @param column the new editing column number. Column 1 is the first | |
404 | * column. | |
405 | */ | |
406 | public void setEditingColumnNumber(final int column) { | |
407 | document.setCursor(column - 1); | |
408 | } | |
409 | ||
410 | /** | |
411 | * Get the maximum possible row number. 1-based. | |
412 | * | |
413 | * @return the maximum row number. Row 1 is the first row. | |
414 | */ | |
415 | public int getMaximumRowNumber() { | |
416 | return document.getLineCount() + 1; | |
417 | } | |
418 | ||
419 | /** | |
420 | * Get the maximum possible column number. 1-based. | |
421 | * | |
422 | * @return the maximum column number. Column 1 is the first column. | |
423 | */ | |
424 | public int getMaximumColumnNumber() { | |
425 | return document.getLineLengthMax() + 1; | |
426 | } | |
427 | ||
428 | /** | |
429 | * Get the dirty value. | |
430 | * | |
431 | * @return true if the buffer is dirty | |
432 | */ | |
433 | public boolean isDirty() { | |
434 | return document.isDirty(); | |
435 | } | |
436 | ||
437 | /** | |
438 | * Save contents to file. | |
439 | * | |
440 | * @param filename file to save to | |
441 | * @throws IOException if a java.io operation throws | |
442 | */ | |
443 | public void saveToFilename(final String filename) throws IOException { | |
444 | document.saveToFilename(filename); | |
445 | } | |
446 | ||
12b55d76 | 447 | } |