summaryrefslogtreecommitdiff
path: root/indra/llui/llchatentry.h
blob: 3f13691a3051287526707b84aba491c200c4c630 (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
/**
 * @file llchatentry.h
 * @author Paul Guslisty
 * @brief Text editor widget which is used for user input
 *
 * Features:
 *			Optional line history so previous entries can be recalled by CTRL UP/DOWN
 *			Optional auto-resize behavior on input chat field
 *
 * $LicenseInfo:firstyear=2001&license=viewerlgpl$
 * Second Life Viewer Source Code
 * Copyright (C) 2012, Linden Research, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation;
 * version 2.1 of the License only.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 *
 * Linden Research, Inc., 945 Battery Street, San Francisco, CA  94111  USA
 * $/LicenseInfo$
 */

#ifndef LLCHATENTRY_H_
#define LLCHATENTRY_H_

#include "lltexteditor.h"

class LLChatEntry : public LLTextEditor
{
public:

	struct Params : public LLInitParam::Block<Params, LLTextEditor::Params>
	{
		Optional<bool>		has_history,
							is_expandable;

		Optional<int>		expand_lines_count;

		Params();
	};

	virtual ~LLChatEntry();

protected:

	friend class LLUICtrlFactory;
	LLChatEntry(const Params& p);
    /*virtual*/ void    beforeValueChange();
    /*virtual*/ void    onValueChange(S32 start, S32 end);
    /*virtual*/ bool    useLabel() const;

public:

	virtual void	draw();
	virtual	void	onCommit();
    /*virtual*/ void	onFocusReceived();
    /*virtual*/ void	onFocusLost();

	void enableSingleLineMode(bool single_line_mode);
	boost::signals2::connection setTextExpandedCallback(const commit_signal_t::slot_type& cb);

private:

	/**
	 * Implements auto-resize behavior.
	 * When user's typing reaches the right edge of the chat field
	 * the chat field expands vertically by one line. The bottom of
	 * the chat field remains bottom-justified. The chat field does
	 * not expand beyond mExpandLinesCount.
	 */
	void	expandText();

	/**
	 * Implements line history so previous entries can be recalled by CTRL UP/DOWN
	 */
	void	updateHistory();

	BOOL	handleSpecialKey(const KEY key, const MASK mask);


	// Fired when text height expanded to mExpandLinesCount
	commit_signal_t*			mTextExpandedSignal;

	// line history support:
	typedef std::vector<std::string>	line_history_t;
	line_history_t::iterator			mCurrentHistoryLine;	// currently browsed history line
	line_history_t						mLineHistory;			// line history storage
	bool								mHasHistory;			// flag for enabled/disabled line history
	bool								mIsExpandable;
	bool								mSingleLineMode;

	S32									mExpandLinesCount;
	S32									mPrevLinesCount;
	S32									mPrevExpandedLineCount;
};

#endif /* LLCHATENTRY_H_ */