From c60cb335f21b602eeee84c7865db4b2bbfe87cfe Mon Sep 17 00:00:00 2001 From: Vincent Sanders Date: Thu, 16 Feb 2017 15:18:29 +0000 Subject: add local history corewindow API --- desktop/local_history.h | 110 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 110 insertions(+) create mode 100644 desktop/local_history.h (limited to 'desktop/local_history.h') diff --git a/desktop/local_history.h b/desktop/local_history.h new file mode 100644 index 000000000..a23cbd3ed --- /dev/null +++ b/desktop/local_history.h @@ -0,0 +1,110 @@ +/* + * Copyright 2017 Vincent Sanders + * + * 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 . + */ + +#ifndef NETSURF_DESKTOP_LOCAL_HISTORY_H +#define NETSURF_DESKTOP_LOCAL_HISTORY_H + +#include +#include + +#include "utils/errors.h" +#include "netsurf/mouse.h" + +struct core_window_callback_table; +struct redraw_context; +struct nsurl; +struct rect; +struct local_history_session; +struct browser_window; + +/** + * Initialise the global history. + * + * This iterates through the URL database, generating the global history data, + * and creates a treeview. + * + * This must be called before any other local_history_* function. + * + * \param cw_t Callback table for core_window containing the treeview. + * \param core_window_handle The core_window in which the treeview is shown. + * \param[out] session The created local history session context. + * \return NSERROR_OK on success and session set, appropriate error code otherwise + */ +nserror local_history_init(struct core_window_callback_table *cw_t, + void *core_window_handle, + struct browser_window *bw, + struct local_history_session **session); + +/** + * Finalise the global history. + * + * This destroys the global history treeview and the global history module's + * internal data. After calling this if global history is required again, + * local_history_init must be called. + * + * \param session The local history session to finalise. + * \return NSERROR_OK on success, appropriate error otherwise + */ +nserror local_history_fini(struct local_history_session *session); + + +/** + * Redraw the global history. + * + * \param session The local history session context. + * \param x X coordinate to render treeview at + * \param y Y coordinate to render treeview at + * \param clip Current clip rectangle (wrt tree origin) + * \param ctx Current redraw context + */ +nserror local_history_redraw(struct local_history_session *session, int x, int y, struct rect *clip, const struct redraw_context *ctx); + +/** + * Handles all kinds of mouse action + * + * \param session The local history session context. + * \param mouse The current mouse state + * \param x X coordinate + * \param y Y coordinate + */ +void local_history_mouse_action(struct local_history_session *session, enum browser_mouse_state mouse, int x, int y); + +/** + * Key press handling. + * + * \param key The ucs4 character codepoint + * \param session The local history session context. + * \return true if the keypress is dealt with, false otherwise. + */ +bool local_history_keypress(struct local_history_session *session, uint32_t key); + +/** + * Change the browser window to draw local history for. + * + * \param session The local history session context. + */ +nserror local_history_set(struct local_history_session *session, struct browser_window *bw); + +/** + * get size of local history content area + * + * \param session The local history session context. + */ +nserror local_history_get_size(struct local_history_session *session, int *width, int *height); + +#endif -- cgit v1.2.3