/
lineeditwidget.h
111 lines (90 loc) · 2.73 KB
/
lineeditwidget.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
/** @file lineeditwidget.h Widget for word-wrapped text editing.
*
* @authors Copyright © 2013 Jaakko Keränen <jaakko.keranen@iki.fi>
*
* @par License
* GPL: http://www.gnu.org/licenses/gpl.html
*
* <small>This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by the
* Free Software Foundation; either version 2 of the License, or (at your
* option) any later version. This program is distributed in the hope that it
* will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
* of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
* Public License for more details. You should have received a copy of the GNU
* General Public License along with this program; if not, see:
* http://www.gnu.org/licenses</small>
*/
#ifndef LIBSHELL_LINEEDITWIDGET_H
#define LIBSHELL_LINEEDITWIDGET_H
#include "libshell.h"
#include "TextWidget"
namespace de {
namespace shell {
class Lexicon;
/**
* Widget for word-wrapped text editing.
*
* The widget adjusts its height automatically to fit to the full contents of
* the edited, wrapped line.
*/
class LIBSHELL_PUBLIC LineEditWidget : public TextWidget
{
Q_OBJECT
public:
/**
* The height rule of the widget is set up during construction.
*
* @param name Widget name.
*/
LineEditWidget(String const &name = "");
virtual ~LineEditWidget();
/**
* Sets the prompt that is displayed in front of the edited text.
*
* @param promptText Text for the prompt.
*/
void setPrompt(String const &promptText);
void setText(String const &lineText);
String text() const;
void setCursor(int index);
int cursor() const;
/**
* Defines the terms and rules for auto-completion.
*
* @param lexicon Lexicon.
*/
void setLexicon(Lexicon const &lexicon);
enum EchoMode
{
NormalEchoMode,
PasswordEchoMode
};
/**
* Determines how the entered text is drawn on screen.
* @param mode Echo mode.
*/
void setEchoMode(EchoMode mode);
/**
* Enables or disables the signal emitted when the edit widget receives an
* Enter key. By default, a signal is emitted.
*
* @param enterSignal @c true to enable signal, @c false to disable.
*/
void setSignalOnEnter(int enterSignal);
Vector2i cursorPosition() const;
bool handleControlKey(int key);
// Events.
void viewResized();
void update();
void draw();
bool handleEvent(Event const &event);
signals:
void enterPressed(de::String text);
private:
struct Instance;
Instance *d;
};
} // namespace shell
} // namespace de
#endif // LIBSHELL_LINEEDITWIDGET_H