summaryrefslogtreecommitdiff
path: root/frontends/riscos/hotlist.h
blob: 14a661e88c5d88d28bf4089c97d2b72a4b3dc3fd (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
/*
 * Copyright 2006 Richard Wilson <info@tinct.net>
 * Copyright 2010, 2013 Stephen Fryatt <stevef@netsurf-browser.org>
 *
 * This file is part of NetSurf, http://www.netsurf-browser.org/
 *
 * NetSurf 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; version 2 of the License.
 *
 * NetSurf 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/>.
 */

/** \file
 * Hotlist (interface).
 */

#ifndef _NETSURF_RISCOS_HOTLIST_H_
#define _NETSURF_RISCOS_HOTLIST_H_

/* Hotlist Protocol Messages, which are currently not in OSLib. */

#ifndef message_HOTLIST_ADD_URL
#define message_HOTLIST_ADD_URL 0x4af81
#endif

#ifndef message_HOTLIST_CHANGED
#define message_HOTLIST_CHANGED 0x4af82
#endif

struct nsurl;

/**
 * initialise the hotlist window template ready for subsequent use.
 */
void ro_gui_hotlist_initialise(void);

/**
 * make the cookie window visible.
 *
 * \return NSERROR_OK on success else appropriate error code on faliure.
 */
nserror ro_gui_hotlist_present(void);

/**
 * Free any resources allocated for the cookie window.
 *
 * \return NSERROR_OK on success else appropriate error code on faliure.
 */
nserror ro_gui_hotlist_finalise(void);

bool ro_gui_hotlist_check_window(wimp_w window);
bool ro_gui_hotlist_check_menu(wimp_menu *menu);

/**
 * Add a URL to the hotlist.
 *
 * This will be passed on to the core hotlist, then
 * Message_HotlistAddURL will broadcast to any bookmark applications
 * via the Hotlist Protocol.
 *
 * \param *url	The URL to be added.
 */
void ro_gui_hotlist_add_page(struct nsurl *url);

/**
 * Clean up RMA storage used by the Message_HotlistAddURL protocol.
 */
void ro_gui_hotlist_add_cleanup(void);

/**
 * Remove a URL from the hotlist.
 *
 * This will be passed on to the core hotlist, unless we're configured
 * to use external hotlists in which case we ignore it.
 *
 * \param *url	The URL to be removed.
 */
void ro_gui_hotlist_remove_page(struct nsurl *url);

/**
 * Report whether the hotlist contains a given URL.
 *
 * This will be passed on to the core hotlist, unless we're configured
 * to use an external hotlist in which case we always report false.
 *
 * \param url The URL to be tested.
 * \return true if the hotlist contains the URL; else false.
 */
bool ro_gui_hotlist_has_page(struct nsurl *url);

#endif