You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
148 lines
4.2 KiB
148 lines
4.2 KiB
/*
|
|
* Copyright 2005 Richard Wilson <info@tinct.net>
|
|
* Copyright 2011 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
|
|
* Throbber (interface).
|
|
*/
|
|
|
|
#ifndef _NETSURF_RISCOS_THROBBER_H_
|
|
#define _NETSURF_RISCOS_THROBBER_H_
|
|
|
|
#include <stdbool.h>
|
|
#include "riscos/theme.h"
|
|
|
|
struct throbber;
|
|
|
|
|
|
/**
|
|
* Create a new throbber widget.
|
|
*
|
|
* \param *theme The theme to apply (or NULL for the default).
|
|
* \return A throbber handle, or NULL on failure.
|
|
*/
|
|
|
|
struct throbber *ro_gui_throbber_create(struct theme_descriptor *theme);
|
|
|
|
/**
|
|
* Place a throbber into a toolbar window and initialise any theme-specific
|
|
* settings. Any previous incarnation of the throbber will be forgotten: this
|
|
* is for use when a new toolbar is being created, or when a toolbar has been
|
|
* deleted and rebuilt following a theme change.
|
|
*
|
|
* \param *throbber The throbber to rebuild.
|
|
* \param *theme The theme to apply (or NULL for current).
|
|
* \param style The theme style to apply.
|
|
* \param window The window that the throbber is in.
|
|
* \param shaded true if the bar should be throbber; else false.
|
|
* \return true on success; else false.
|
|
*/
|
|
|
|
bool ro_gui_throbber_rebuild(struct throbber *throbber,
|
|
struct theme_descriptor *theme, theme_style style,
|
|
wimp_w window, bool shaded);
|
|
|
|
|
|
/**
|
|
* Destroy a throbber widget.
|
|
*
|
|
* \param *throbber The throbber to destroy.
|
|
*/
|
|
|
|
void ro_gui_throbber_destroy(struct throbber *throbber);
|
|
|
|
|
|
/**
|
|
* Return the MINIMUM dimensions required by the throbber, in RO units,
|
|
* allowing for the current theme.
|
|
*
|
|
* \param *throbber The throbber of interest.
|
|
* \param *width Return the required width.
|
|
* \param *height Return the required height.
|
|
* \return true if values are returned; else false.
|
|
*/
|
|
|
|
bool ro_gui_throbber_get_dims(struct throbber *throbber,
|
|
int *width, int *height);
|
|
|
|
|
|
/**
|
|
* Set or update the dimensions to be used by the throbber in RO units
|
|
*
|
|
* If these are greater than the minimum required, the throbber will fill
|
|
* the extended space; if less, the call will fail.
|
|
*
|
|
* \param throbber The throbber to update.
|
|
* \param x0 top left of bounding box x coordinate
|
|
* \param y0 top left of bounding box y coordinate
|
|
* \param x1 bottom right of bounding box x coordinate
|
|
* \param y1 bottom right of bounding box y coordinate
|
|
* \return true if size updated; else false.
|
|
*/
|
|
|
|
bool ro_gui_throbber_set_extent(struct throbber *throbber,
|
|
int x0, int y0, int x1, int y1);
|
|
|
|
|
|
/**
|
|
* Show or hide a throbber.
|
|
*
|
|
* \param *throbber The throbber to hide.
|
|
* \param hide true to hide the throbber; false to show it.
|
|
* \return true if successful; else false.
|
|
*/
|
|
|
|
bool ro_gui_throbber_hide(struct throbber *throbber, bool hide);
|
|
|
|
|
|
/**
|
|
* Translate mouse data into an interactive help message for the throbber.
|
|
*
|
|
* \param throbber The throbber to process.
|
|
* \param i The wimp icon under the pointer.
|
|
* \param screenpos The screen position.
|
|
* \param state The toolbar window state.
|
|
* \param buttons The mouse button state.
|
|
* \param suffix Return a help token suffix, or "" for none.
|
|
* \return true if handled exclusively; else false.
|
|
*/
|
|
|
|
bool ro_gui_throbber_help_suffix(struct throbber *throbber, wimp_i i,
|
|
os_coord *screenpos, wimp_window_state *state,
|
|
wimp_mouse_state buttons, const char **suffix);
|
|
|
|
/**
|
|
* Start or update the amimation of a throbber.
|
|
*
|
|
* \param *throbber The throbber to amimate.
|
|
*/
|
|
|
|
bool ro_gui_throbber_animate(struct throbber *throbber);
|
|
|
|
|
|
/**
|
|
* Stop the amimation of a throbber.
|
|
*
|
|
* \param *throbber The throbber to amimate.
|
|
*/
|
|
|
|
bool ro_gui_throbber_stop(struct throbber *throbber);
|
|
|
|
#endif
|
|
|