summaryrefslogtreecommitdiff
path: root/client/widgets/lineedit.h
blob: 650924c744228bc1e0cd18b415cb357c4b8392fe (plain)
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/***************************************************************************
 *            lineedit.h
 *
 *  Fri Jul 13 12:38:45 CEST 2007
 *  Copyright 2007 Bent Bisballe Nyeng and Lars Bisballe Jensen
 *  deva@aasimon.org and elsenator@gmail.com
 ****************************************************************************/

/*
 *  This file is part of Pracro.
 *
 *  Pracro 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.
 *
 *  Pracro 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 Pracro; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA.
 */
#ifndef __PRACRO_LINEEDIT_H__
#define __PRACRO_LINEEDIT_H__

#include <QStringList>

#include "widget.h"

/***
 * Line Edit Widget
 * @tag lineedit
 * @extends widget
 * @screenshot
 * The lineedit is a single line textual input field.
 * @att readonly Make the lineedit readonly (not changeable by the user), but
 * still able to select and copy text.
 */

class QLineEdit;
class QEvent;
class LineEdit : public Widget
{
Q_OBJECT
public:
  LineEdit(QDomNode &node, MacroWindow *macrowindow);
  ~LineEdit();

  QString value();
  void setValue(QString value, QString source);

  void setWdgValid(bool valid);

  void clearSuggestions();
  void addSuggestion(QString suggestion);
  bool isSuggested(QString value);
  void showSuggestions();

public slots:
  void changed();
  void user_changed();

protected:
  void changeEvent(QEvent *event);

private:
  bool eventFilter(QObject *, QEvent *event);

  QLineEdit *lineedit;
  QStringList suggestions;
};

/***
 * @method nil clearSuggestions()
 * This method clears the suggestion list.
 */
int lin_clear_suggestions(lua_State *L);

/***
 * @method nil showSuggestions()
 * This method forces showing of the suggestion list.
 */
int lin_show_suggestions(lua_State *L);

/***
 * @method boolean isSuggested(string value, boolean joker)
 * This method makes a lookup in the suggestion list, searching for value.
 * @param value A string containing the text to look for in the suggestion list.
 * @return a boolean with the value true if the string was found, false
 * if not.
 */
int lin_is_suggested(lua_State *L);

/***
 * @method nil addSuggestion(string suggestion)
 * Adds a suggestion to the suggestion list. The list is popped up each time 
 * a character is entered into the lineedit by the user, or it is explicitly
 * opened by calling @ref showSuggestions().
 * @param suggestion A string containing the value to be added to the
 * suggestion list.
 */
int lin_add_suggestion(lua_State *L);

#define LINEDT_METHS \
  {"clearSuggestions", lin_clear_suggestions},  \
  {"showSuggestions", lin_show_suggestions},\
  {"isSuggested", lin_is_suggested},\
  {"addSuggestion", lin_add_suggestion}

const struct luaL_Reg linedt_meths[] =
  { WDG_METHS, LINEDT_METHS, {NULL, NULL} };

inline void register_lineedit(lua_State *L)
{
  luaL_newmetatable(L, "LineEdit");
  lua_pushliteral(L, "__index");
  lua_pushvalue(L, -2);
  lua_rawset(L, -3);
  luaL_register(L, NULL, linedt_meths);
}

#endif/*__PRACRO_LINEEDIT_H__*/