git.saurik.com Git - wxWidgets.git/blame_incremental

... / ...

Commit	Line	Data
	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: tooltip.h
	3	// Purpose: interface of wxToolTip
	4	// Author: wxWidgets team
	5	// RCS-ID: $Id$
	6	// Licence: wxWindows licence
	7	/////////////////////////////////////////////////////////////////////////////
	8
	9	/**
	10	@class wxToolTip
	11
	12	This class holds information about a tooltip associated with a window (see
	13	wxWindow::SetToolTip()).
	14
	15	The four static methods, wxToolTip::Enable(), wxToolTip::SetDelay()
	16	wxToolTip::SetAutoPop() and wxToolTip::SetReshow() can be used to globally
	17	alter tooltips behaviour.
	18
	19	@library{wxcore}
	20	@category{help}
	21	*/
	22	class wxToolTip : public wxObject
	23	{
	24	public:
	25	/**
	26	Constructor.
	27	*/
	28	wxToolTip(const wxString& tip);
	29
	30	/**
	31	Enable or disable tooltips globally.
	32
	33	@note May not be supported on all platforms (eg. wxCocoa).
	34	*/
	35	static void Enable(bool flag);
	36
	37	/**
	38	Get the tooltip text.
	39	*/
	40	wxString GetTip() const;
	41
	42	/**
	43	Get the associated window.
	44	*/
	45	wxWindow* GetWindow() const;
	46
	47	/**
	48	Set the delay after which the tooltip disappears or how long a tooltip
	49	remains visible.
	50
	51	@note May not be supported on all platforms (eg. wxCocoa, GTK, Palmos).
	52	*/
	53	static void SetAutoPop(long msecs);
	54
	55	/**
	56	Set the delay after which the tooltip appears.
	57
	58	@note May not be supported on all platforms (eg. wxCocoa).
	59	*/
	60	static void SetDelay(long msecs);
	61
	62	/**
	63	Set tooltip maximal width in pixels.
	64
	65	By default, tooltips are wrapped at a suitably chosen width. You can
	66	pass -1 as @a width to disable wrapping them completely, 0 to restore
	67	the default behaviour or an arbitrary positive value to wrap them at
	68	the given width.
	69
	70	Notice that this function does not change the width of the tooltips
	71	created before calling it.
	72
	73	@note Currently this function is wxMSW-only.
	74	*/
	75	static void SetMaxWidth(int width);
	76
	77	/**
	78	Set the delay between subsequent tooltips to appear.
	79
	80	@note May not be supported on all platforms (eg. wxCocoa, GTK, Palmos).
	81	*/
	82	static void SetReshow(long msecs);
	83
	84	/**
	85	Set the tooltip text.
	86	*/
	87	void SetTip(const wxString& tip);
	88	};
	89