summaryrefslogtreecommitdiff
path: root/indra/llui/llurlmatch.h
blob: 7090dd3f93ff417ba92354afbda9fd2df1021e32 (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
/** 
 * @file llurlmatch.h
 * @author Martin Reddy
 * @brief Specifies a matched Url in a string, as returned by LLUrlRegistry
 *
 * $LicenseInfo:firstyear=2009&license=viewergpl$
 * 
 * Copyright (c) 2009, Linden Research, Inc.
 * 
 * Second Life Viewer Source Code
 * The source code in this file ("Source Code") is provided by Linden Lab
 * to you under the terms of the GNU General Public License, version 2.0
 * ("GPL"), unless you have obtained a separate licensing agreement
 * ("Other License"), formally executed by you and Linden Lab.  Terms of
 * the GPL can be found in doc/GPL-license.txt in this distribution, or
 * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
 * 
 * There are special exceptions to the terms and conditions of the GPL as
 * it is applied to this Source Code. View the full text of the exception
 * in the file doc/FLOSS-exception.txt in this software distribution, or
 * online at
 * http://secondlifegrid.net/programs/open_source/licensing/flossexception
 * 
 * By copying, modifying or distributing this software, you acknowledge
 * that you have read and understood your obligations described above,
 * and agree to abide by those obligations.
 * 
 * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
 * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
 * COMPLETENESS OR PERFORMANCE.
 * $/LicenseInfo$
 */

#ifndef LL_LLURLMATCH_H
#define LL_LLURLMATCH_H

#include "linden_common.h"

#include <string>
#include <vector>
#include "lluicolor.h"

///
/// LLUrlMatch describes a single Url that was matched within a string by 
/// the LLUrlRegistry::findUrl() method. It includes the actual Url that
/// was matched along with its first/last character offset in the string.
/// An alternate label is also provided for creating a hyperlink, as well
/// as tooltip/status text, an icon, and a XUI file for a context menu
/// that can be used in a popup for a Url (e.g., Open, Copy URL, etc.)
///
class LLUrlMatch
{
public:
	LLUrlMatch();

	/// return true if this object does not contain a valid Url match yet
	bool empty() const { return mUrl.empty(); }

	/// return the offset in the string for the first character of the Url
	U32 getStart() const { return mStart; }

	/// return the offset in the string for the last character of the Url
	U32 getEnd() const { return mEnd; }

	/// return the Url that has been matched in the input string
	std::string getUrl() const { return mUrl; }

	/// return a label that can be used for the display of this Url
	std::string getLabel() const { return mLabel; }

	/// return a message that could be displayed in a tooltip or status bar
	std::string getTooltip() const { return mTooltip; }

	/// return the filename for an icon that can be displayed next to this Url
	std::string getIcon() const { return mIcon; }

	/// Return the color to render the displayed text
	LLUIColor getColor() const { return mColor; }

	/// Return the name of a XUI file containing the context menu items
	std::string getMenuName() const { return mMenuName; }

	/// return the SL location that this Url describes, or "" if none.
	std::string getLocation() const { return mLocation; }

	/// is this a match for a URL that should not be hyperlinked?
	bool isLinkDisabled() const { return mDisabledLink; }

	/// Should this link text be underlined only when mouse is hovered over it?
	bool underlineOnHoverOnly() const { return mUnderlineOnHoverOnly; }

	/// Change the contents of this match object (used by LLUrlRegistry)
	void setValues(U32 start, U32 end, const std::string &url, const std::string &label,
	               const std::string &tooltip, const std::string &icon,
				   const LLUIColor& color, const std::string &menu, 
				   const std::string &location, bool disabled_link
				   , const LLUUID& id, bool underline_on_hover_only  = false );

	const LLUUID& getID() const { return mID;}

private:
	U32         mStart;
	U32         mEnd;
	std::string mUrl;
	std::string mLabel;
	std::string mTooltip;
	std::string mIcon;
	std::string mMenuName;
	std::string mLocation;

	LLUUID		mID;
	LLUIColor	mColor;
	bool        mDisabledLink;
	bool		mUnderlineOnHoverOnly;
};

#endif