2005-07-24 16:12:37 +02:00
/* $Id$ */
2007-12-19 20:44:29 +01:00
/** @file window_gui.h Functions, definitions and such used only by the GUI. */
2007-02-23 02:48:53 +01:00
2007-12-19 20:44:29 +01:00
# ifndef WINDOW_GUI_H
# define WINDOW_GUI_H
2004-08-09 19:04:08 +02:00
2008-05-07 15:10:15 +02:00
# include "core/geometry_type.hpp"
2007-12-26 12:45:43 +01:00
# include "vehicle_type.h"
2008-01-09 10:45:45 +01:00
# include "viewport_type.h"
2008-09-30 22:51:04 +02:00
# include "company_type.h"
2008-04-13 21:25:14 +02:00
# include "core/alloc_type.hpp"
2008-05-07 15:10:15 +02:00
# include "window_type.h"
# include "tile_type.h"
2009-02-09 02:06:23 +01:00
# include "widget_type.h"
2004-08-09 19:04:08 +02:00
2008-04-07 22:28:58 +02:00
/**
* Flags to describe the look of the frame
*/
2007-03-07 13:11:48 +01:00
enum FrameFlags {
2007-12-04 18:51:50 +01:00
FR_NONE = 0 ,
FR_TRANSPARENT = 1 < < 0 , ///< Makes the background transparent if set
FR_BORDERONLY = 1 < < 4 , ///< Draw border only, no background
FR_LOWERED = 1 < < 5 , ///< If set the frame is lowered and the background color brighter (ie. buttons when pressed)
FR_DARKENED = 1 < < 6 , ///< If set the background is darker, allows for lowered frames with normal background color when used with FR_LOWERED (ie. dropdown boxes)
2007-03-07 13:11:48 +01:00
} ;
2006-08-29 08:07:57 +02:00
2007-01-10 19:56:51 +01:00
DECLARE_ENUM_AS_BIT_SET ( FrameFlags ) ;
2008-04-07 22:28:58 +02:00
/* wiget.cpp */
2006-08-29 08:07:57 +02:00
void DrawFrameRect ( int left , int top , int right , int bottom , int color , FrameFlags flags ) ;
2005-06-15 19:27:14 +02:00
2008-04-07 22:28:58 +02:00
/**
* High level window description
*/
2007-03-07 13:11:48 +01:00
struct WindowDesc {
2008-04-07 22:28:58 +02:00
int16 left ; ///< Prefered x position of left edge of the window, @see WindowDefaultPosition()
int16 top ; ///< Prefered y position of the top of the window, @see WindowDefaultPosition()
int16 minimum_width ; ///< Minimal width of the window
int16 minimum_height ; ///< Minimal height of the window
int16 default_width ; ///< Prefered initial width of the window
int16 default_height ; ///< Prefered initial height of the window
WindowClass cls ; ///< Class of the window, @see WindowClass
WindowClass parent_cls ; ///< Class of the parent window, @see WindowClass
uint32 flags ; ///< Flags, @see WindowDefaultFlags
const Widget * widgets ; ///< List of widgets with their position and size for the window
2007-03-07 13:11:48 +01:00
} ;
2004-08-09 19:04:08 +02:00
2008-04-07 22:28:58 +02:00
/**
* Window default widget / window handling flags
*/
2006-12-29 14:59:48 +01:00
enum WindowDefaultFlag {
2007-12-04 18:51:50 +01:00
WDF_STD_TOOLTIPS = 1 < < 0 , ///< use standard routine when displaying tooltips
2008-04-07 22:28:58 +02:00
WDF_DEF_WIDGET = 1 < < 1 , ///< Default widget control for some widgets in the on click event, @see DispatchLeftClickEvent()
WDF_STD_BTN = 1 < < 2 , ///< Default handling for close and titlebar widgets (widget no 0 and 1)
2009-02-04 17:59:41 +01:00
WDF_CONSTRUCTION = 1 < < 3 , ///< This window is used for construction; close it whenever changing company.
2007-12-06 16:58:39 +01:00
2008-04-07 22:28:58 +02:00
WDF_UNCLICK_BUTTONS = 1 < < 4 , ///< Unclick buttons when the window event times out
2007-12-04 18:51:50 +01:00
WDF_STICKY_BUTTON = 1 < < 5 , ///< Set window to sticky mode; they are not closed unless closed with 'X' (widget 2)
2008-04-07 22:28:58 +02:00
WDF_RESIZABLE = 1 < < 6 , ///< Window can be resized
2007-12-04 18:51:50 +01:00
WDF_MODAL = 1 < < 7 , ///< The window is a modal child of some other window, meaning the parent is 'inactive'
2009-02-09 02:22:29 +01:00
WDF_NO_FOCUS = 1 < < 8 , ///< This window won't get focus/make any other window lose focus when click
2004-08-09 19:04:08 +02:00
} ;
2008-04-07 22:28:58 +02:00
/**
* Special values for ' left ' and ' top ' to cause a specific placement
*/
2006-12-29 14:59:48 +01:00
enum WindowDefaultPosition {
2006-11-11 11:12:00 +01:00
WDP_AUTO = - 1 , ///< Find a place automatically
WDP_CENTER = - 2 , ///< Center the window (left/right or top/bottom)
WDP_ALIGN_TBR = - 3 , ///< Align the right side of the window with the right side of the main toolbar
WDP_ALIGN_TBL = - 4 , ///< Align the left side of the window with the left side of the main toolbar
2004-08-09 19:04:08 +02:00
} ;
2008-04-07 22:28:58 +02:00
/**
* Scrollbar data structure
*/
2007-03-07 13:11:48 +01:00
struct Scrollbar {
2008-04-07 22:28:58 +02:00
uint16 count ; ///< Number of elements in the list
uint16 cap ; ///< Number of visible elements of the scroll bar
2008-08-01 11:34:34 +02:00
uint16 pos ; ///< Index of first visible item of the list
2007-03-07 13:11:48 +01:00
} ;
2004-08-09 19:04:08 +02:00
2008-04-07 22:28:58 +02:00
/**
* Data structure for resizing a window
*/
2007-03-07 13:11:48 +01:00
struct ResizeInfo {
2008-04-07 22:28:58 +02:00
uint width ; ///< Minimum allowed width of the window
uint height ; ///< Minimum allowed height of the window
uint step_width ; ///< Step-size of width resize changes
uint step_height ; ///< Step-size of height resize changes
2007-03-07 13:11:48 +01:00
} ;
2005-01-03 20:45:18 +01:00
2008-05-17 14:48:06 +02:00
enum SortButtonState {
SBS_OFF ,
SBS_DOWN ,
SBS_UP ,
} ;
2008-04-07 22:28:58 +02:00
/**
2008-05-11 17:08:44 +02:00
* Data structure for a window viewport
*/
struct ViewportData : ViewPort {
VehicleID follow_vehicle ;
int32 scrollpos_x ;
int32 scrollpos_y ;
int32 dest_scrollpos_x ;
int32 dest_scrollpos_y ;
} ;
2008-05-17 05:29:16 +02:00
/**
2008-04-07 22:28:58 +02:00
* Data structure for an opened window
*/
2008-04-13 21:25:14 +02:00
struct Window : ZeroedMemoryAllocator {
2008-10-14 21:27:08 +02:00
/** State whether an event is handled or not */
2008-05-18 01:11:06 +02:00
enum EventState {
2008-10-14 21:27:08 +02:00
ES_HANDLED , ///< The passed event is handled
ES_NOT_HANDLED , ///< The passed event is not handled
2008-05-18 01:11:06 +02:00
} ;
2008-05-08 13:31:41 +02:00
protected :
2008-05-11 13:41:18 +02:00
void Initialize ( int x , int y , int min_width , int min_height ,
2008-05-19 11:48:47 +02:00
WindowClass cls , const Widget * widget , int window_number ) ;
2008-05-11 13:41:18 +02:00
void FindWindowPlacementAndResize ( int def_width , int def_height ) ;
void FindWindowPlacementAndResize ( const WindowDesc * desc ) ;
2008-05-08 13:31:41 +02:00
2008-05-04 12:05:50 +02:00
public :
2008-05-18 22:40:30 +02:00
Window ( int x , int y , int width , int height , WindowClass cls , const Widget * widget ) ;
2008-05-13 16:43:33 +02:00
Window ( const WindowDesc * desc , WindowNumber number = 0 ) ;
2008-05-08 13:31:41 +02:00
2008-05-06 23:28:30 +02:00
virtual ~ Window ( ) ;
2009-01-07 19:59:46 +01:00
/* Don't allow arrays; arrays of Windows are pointless as you need
* to destruct them all at the same time too , which is kinda hard . */
FORCEINLINE void * operator new [ ] ( size_t size ) { NOT_REACHED ( ) ; }
/* Don't free the window directly; it corrupts the linked list when iterating */
FORCEINLINE void operator delete ( void * ptr , size_t size ) { }
2008-05-04 12:05:50 +02:00
2008-04-07 22:28:58 +02:00
uint16 flags4 ; ///< Window flags, @see WindowFlags
WindowClass window_class ; ///< Window class
WindowNumber window_number ; ///< Window number within the window class
2004-08-09 19:04:08 +02:00
2008-04-07 22:28:58 +02:00
int left ; ///< x position of left edge of the window
int top ; ///< y position of top edge of the window
int width ; ///< width of the window (number of pixels to the right in x direction)
int height ; ///< Height of the window (number of pixels down in y direction)
2004-08-09 19:04:08 +02:00
2008-04-07 22:28:58 +02:00
Scrollbar hscroll ; ///< Horizontal scroll bar
Scrollbar vscroll ; ///< First vertical scroll bar
Scrollbar vscroll2 ; ///< Second vertical scroll bar
ResizeInfo resize ; ///< Resize information
2004-08-09 19:04:08 +02:00
2009-02-09 03:33:10 +01:00
Owner owner ; ///< The owner of the content shown in this window. Company colour is acquired from this variable.
2004-08-09 19:04:08 +02:00
2009-02-09 03:33:10 +01:00
ViewportData * viewport ; ///< Pointer to viewport data, if present
2008-04-07 22:28:58 +02:00
Widget * widget ; ///< Widgets of the window
uint widget_count ; ///< Number of widgets of the window
uint32 desc_flags ; ///< Window/widgets default flags setting, @see WindowDefaultFlag
2009-02-09 02:22:29 +01:00
const Widget * focused_widget ; ///< Currently focused widget or NULL, if no widget has focus
2004-08-09 19:04:08 +02:00
2008-04-07 22:28:58 +02:00
Window * parent ; ///< Parent window
2009-01-07 17:11:27 +01:00
Window * z_front ; ///< The window in front of us in z-order
Window * z_back ; ///< The window behind us in z-order
2007-12-02 01:59:48 +01:00
2007-12-08 03:55:47 +01:00
void HandleButtonClick ( byte widget ) ;
2007-12-02 01:59:48 +01:00
void SetWidgetDisabledState ( byte widget_index , bool disab_stat ) ;
void DisableWidget ( byte widget_index ) ;
void EnableWidget ( byte widget_index ) ;
2007-12-02 13:10:48 +01:00
bool IsWidgetDisabled ( byte widget_index ) const ;
2007-12-02 01:59:48 +01:00
void SetWidgetHiddenState ( byte widget_index , bool hidden_stat ) ;
void HideWidget ( byte widget_index ) ;
void ShowWidget ( byte widget_index ) ;
2007-12-02 13:10:48 +01:00
bool IsWidgetHidden ( byte widget_index ) const ;
2009-02-09 02:22:29 +01:00
void SetFocusedWidget ( byte widget_index ) ;
bool IsWidgetGloballyFocused ( byte widget_index ) const ;
bool IsWidgetFocused ( byte widget_index ) const ;
2007-12-02 01:59:48 +01:00
void SetWidgetLoweredState ( byte widget_index , bool lowered_stat ) ;
2007-12-02 14:32:41 +01:00
void ToggleWidgetLoweredState ( byte widget_index ) ;
2007-12-02 01:59:48 +01:00
void LowerWidget ( byte widget_index ) ;
void RaiseWidget ( byte widget_index ) ;
2007-12-02 13:10:48 +01:00
bool IsWidgetLowered ( byte widget_index ) const ;
2008-07-18 22:44:35 +02:00
void AlignWidgetRight ( byte widget_index_a , byte widget_index_b ) ;
int GetWidgetWidth ( byte widget_index ) const ;
2009-02-09 02:22:29 +01:00
bool HasWidgetOfType ( WidgetType widget_type ) const ;
2007-12-02 01:59:48 +01:00
void RaiseButtons ( ) ;
void CDECL SetWidgetsDisabledState ( bool disab_stat , int widgets , . . . ) ;
void CDECL SetWidgetsHiddenState ( bool hidden_stat , int widgets , . . . ) ;
void CDECL SetWidgetsLoweredState ( bool lowered_stat , int widgets , . . . ) ;
2007-12-07 18:42:15 +01:00
void InvalidateWidget ( byte widget_index ) const ;
2008-05-04 12:05:50 +02:00
2008-05-17 14:48:06 +02:00
void DrawWidgets ( ) const ;
void DrawViewport ( ) const ;
void DrawSortButtonState ( int widget , SortButtonState state ) const ;
2008-09-24 18:40:06 +02:00
void DeleteChildWindows ( ) const ;
2008-05-06 23:28:30 +02:00
void SetDirty ( ) const ;
2008-05-10 15:46:36 +02:00
/*** Event handling ***/
/**
* This window is currently being repainted .
*/
2008-05-19 11:48:47 +02:00
virtual void OnPaint ( ) { }
2008-05-10 15:46:36 +02:00
2009-02-09 02:22:29 +01:00
/**
* Called when window gains focus
*/
virtual void OnFocus ( ) { }
/**
* Called when window looses focus
*/
virtual void OnFocusLost ( ) { }
2008-05-10 15:46:36 +02:00
/**
* A key has been pressed .
* @ param key the Unicode value of the key .
* @ param keycode the untranslated key code including shift state .
2008-05-18 01:11:06 +02:00
* @ return ES_HANDLED if the key press has been handled and no other
2008-05-10 15:46:36 +02:00
* window should receive the event .
*/
2008-05-19 11:48:47 +02:00
virtual EventState OnKeyPress ( uint16 key , uint16 keycode ) { return ES_NOT_HANDLED ; }
2008-05-10 15:46:36 +02:00
/**
* The state of the control key has changed
2008-05-18 01:11:06 +02:00
* @ return ES_HANDLED if the change has been handled and no other
2008-05-10 15:46:36 +02:00
* window should receive the event .
*/
2008-05-19 11:48:47 +02:00
virtual EventState OnCTRLStateChange ( ) { return ES_NOT_HANDLED ; }
2008-05-10 15:46:36 +02:00
/**
* A click with the left mouse button has been made on the window .
* @ param pt the point inside the window that has been clicked .
* @ param widget the clicked widget .
*/
2008-05-19 11:48:47 +02:00
virtual void OnClick ( Point pt , int widget ) { }
2008-05-10 15:46:36 +02:00
/**
* A double click with the left mouse button has been made on the window .
* @ param pt the point inside the window that has been clicked .
* @ param widget the clicked widget .
*/
2008-05-17 01:30:10 +02:00
virtual void OnDoubleClick ( Point pt , int widget ) { }
2008-05-10 15:46:36 +02:00
/**
* A click with the right mouse button has been made on the window .
* @ param pt the point inside the window that has been clicked .
* @ param widget the clicked widget .
*/
2008-05-17 01:30:10 +02:00
virtual void OnRightClick ( Point pt , int widget ) { }
2008-05-10 15:46:36 +02:00
/**
* A dragged ' object ' has been released .
* @ param pt the point inside the window where the release took place .
* @ param widget the widget where the release took place .
*/
2008-05-17 01:30:10 +02:00
virtual void OnDragDrop ( Point pt , int widget ) { }
2008-05-10 15:46:36 +02:00
/**
* Handle the request for ( viewport ) scrolling .
* @ param delta the amount the viewport must be scrolled .
*/
2008-05-17 01:30:10 +02:00
virtual void OnScroll ( Point delta ) { }
2008-05-10 15:46:36 +02:00
/**
* The mouse is currently moving over the window or has just moved outside
* of the window . In the latter case pt is ( - 1 , - 1 ) .
* @ param pt the point inside the window that the mouse hovers over .
* @ param widget the widget the mouse hovers over .
*/
2008-05-17 01:30:10 +02:00
virtual void OnMouseOver ( Point pt , int widget ) { }
2008-05-10 15:46:36 +02:00
/**
* The mouse wheel has been turned .
* @ param wheel the amount of movement of the mouse wheel .
*/
2008-05-17 01:30:10 +02:00
virtual void OnMouseWheel ( int wheel ) { }
2008-05-10 15:46:36 +02:00
/**
* Called for every mouse loop run , which is at least once per ( game ) tick .
*/
2008-05-19 11:48:47 +02:00
virtual void OnMouseLoop ( ) { }
2008-05-10 15:46:36 +02:00
/**
* Called once per ( game ) tick .
*/
2008-05-19 11:48:47 +02:00
virtual void OnTick ( ) { }
2008-05-10 15:46:36 +02:00
/**
* Called once every 100 ( game ) ticks .
*/
2008-05-19 11:48:47 +02:00
virtual void OnHundredthTick ( ) { }
2008-05-10 15:46:36 +02:00
/**
* Called when this window ' s timeout has been reached .
*/
2008-05-19 11:48:47 +02:00
virtual void OnTimeout ( ) { }
2008-05-10 15:46:36 +02:00
/**
* Called when the window got resized .
* @ param new_size the new size of the window .
* @ param delta the amount of which the window size changed .
*/
2008-05-19 11:48:47 +02:00
virtual void OnResize ( Point new_size , Point delta ) { }
2008-05-10 15:46:36 +02:00
/**
* A dropdown option associated to this window has been selected .
* @ param widget the widget ( button ) that the dropdown is associated with .
* @ param index the element in the dropdown that is selected .
*/
2008-05-19 11:48:47 +02:00
virtual void OnDropdownSelect ( int widget , int index ) { }
2008-05-10 15:46:36 +02:00
/**
* The query window opened from this window has closed .
* @ param str the new value of the string or NULL if the window
* was cancelled .
*/
2008-05-19 11:48:47 +02:00
virtual void OnQueryTextFinished ( char * str ) { }
2008-05-10 15:46:36 +02:00
/**
* Some data on this window has become invalid .
* @ param data information about the changed data .
*/
2008-05-19 11:48:47 +02:00
virtual void OnInvalidateData ( int data = 0 ) { }
2008-05-10 15:46:36 +02:00
/**
* The user clicked some place on the map when a tile highlight mode
* has been set .
* @ param pt the exact point on the map that has been clicked .
* @ param tile the tile on the map that has been clicked .
*/
2008-05-19 11:48:47 +02:00
virtual void OnPlaceObject ( Point pt , TileIndex tile ) { }
2008-05-10 15:46:36 +02:00
/**
* The user cancelled a tile highlight mode that has been set .
*/
2008-05-19 11:48:47 +02:00
virtual void OnPlaceObjectAbort ( ) { }
2008-05-10 15:46:36 +02:00
/**
* The user is dragging over the map when the tile highlight mode
* has been set .
* @ param select_method the method of selection ( allowed directions )
* @ param select_proc what will be created when the drag is over .
* @ param pt the exact point on the map where the mouse is .
*/
2008-05-19 11:48:47 +02:00
virtual void OnPlaceDrag ( ViewportPlaceMethod select_method , ViewportDragDropSelectionProcess select_proc , Point pt ) { }
2008-05-10 15:46:36 +02:00
/**
* The user has dragged over the map when the tile highlight mode
* has been set .
* @ param select_method the method of selection ( allowed directions )
* @ param select_proc what should be created .
* @ param pt the exact point on the map where the mouse was released .
* @ param start_tile the begin tile of the drag .
* @ param end_tile the end tile of the drag .
*/
2008-05-19 11:48:47 +02:00
virtual void OnPlaceMouseUp ( ViewportPlaceMethod select_method , ViewportDragDropSelectionProcess select_proc , Point pt , TileIndex start_tile , TileIndex end_tile ) { }
2008-05-10 15:46:36 +02:00
/**
* The user moves over the map when a tile highlight mode has been set
* when the special mouse mode has been set to ' PRESIZE ' mode . An
* example of this is the tile highlight for dock building .
* @ param pt the exact point on the map where the mouse is .
* @ param tile the tile on the map where the mouse is .
*/
2008-05-19 11:48:47 +02:00
virtual void OnPlacePresize ( Point pt , TileIndex tile ) { }
2008-05-10 15:46:36 +02:00
/*** End of the event handling ***/
2004-08-09 19:04:08 +02:00
} ;
2008-05-17 05:29:16 +02:00
/**
* Data structure for a window opened from a toolbar
*/
class PickerWindowBase : public Window {
public :
2008-05-24 13:19:30 +02:00
PickerWindowBase ( const WindowDesc * desc , Window * parent ) : Window ( desc )
{
this - > parent = parent ;
} ;
2008-05-17 05:29:16 +02:00
virtual ~ PickerWindowBase ( ) ;
} ;
2008-04-07 22:28:58 +02:00
/**
* Window flags
*/
2004-08-09 19:04:08 +02:00
enum WindowFlags {
2008-09-23 21:25:00 +02:00
WF_TIMEOUT_TRIGGER = 1 , ///< When the timeout should start triggering
WF_TIMEOUT_BEGIN = 7 , ///< The initial value for the timeout
2008-09-23 17:24:15 +02:00
WF_TIMEOUT_MASK = 7 , ///< Window timeout counter bit mask (3 bits)
2008-04-07 22:28:58 +02:00
WF_DRAGGING = 1 < < 3 , ///< Window is being dragged
WF_SCROLL_UP = 1 < < 4 , ///< Upper scroll button has been pressed, @see ScrollbarClickHandler()
WF_SCROLL_DOWN = 1 < < 5 , ///< Lower scroll button has been pressed, @see ScrollbarClickHandler()
WF_SCROLL_MIDDLE = 1 < < 6 , ///< Scrollbar scrolling, @see ScrollbarClickHandler()
2006-08-22 16:38:37 +02:00
WF_HSCROLL = 1 < < 7 ,
WF_SIZING = 1 < < 8 ,
2008-04-07 22:28:58 +02:00
WF_STICKY = 1 < < 9 , ///< Window is made sticky by user
2005-01-03 20:45:18 +01:00
2008-04-07 22:28:58 +02:00
WF_DISABLE_VP_SCROLL = 1 < < 10 , ///< Window does not do autoscroll, @see HandleAutoscroll()
2004-08-09 19:04:08 +02:00
2006-08-22 16:38:37 +02:00
WF_WHITE_BORDER_ONE = 1 < < 11 ,
2006-12-29 18:16:12 +01:00
WF_WHITE_BORDER_MASK = 1 < < 12 | WF_WHITE_BORDER_ONE ,
2006-08-22 16:38:37 +02:00
WF_SCROLL2 = 1 < < 13 ,
2004-08-09 19:04:08 +02:00
} ;
Window * BringWindowToFrontById ( WindowClass cls , WindowNumber number ) ;
Window * FindWindowFromPt ( int x , int y ) ;
2008-05-08 13:50:34 +02:00
/**
* Open a new window .
2008-10-14 21:27:08 +02:00
* @ param desc The pointer to the WindowDesc to be created
2008-05-08 13:50:34 +02:00
* @ param window_number the window number of the new window
* @ return see Window pointer of the newly created window
*/
template < typename Wcls >
2008-05-13 16:43:33 +02:00
Wcls * AllocateWindowDescFront ( const WindowDesc * desc , int window_number )
2008-05-08 13:50:34 +02:00
{
if ( BringWindowToFrontById ( desc - > cls , window_number ) ) return NULL ;
2008-05-13 16:43:33 +02:00
return new Wcls ( desc , window_number ) ;
2008-05-08 13:50:34 +02:00
}
2004-08-09 19:04:08 +02:00
void RelocateAllWindows ( int neww , int newh ) ;
2007-02-23 02:48:53 +01:00
/* misc_gui.cpp */
2008-08-02 13:26:25 +02:00
void GuiShowTooltips ( StringID str , uint paramcount = 0 , const uint64 params [ ] = NULL , bool use_left_mouse_button = false ) ;
2006-10-03 22:16:20 +02:00
2007-02-23 02:48:53 +01:00
/* widget.cpp */
2005-09-18 22:56:44 +02:00
int GetWidgetFromPos ( const Window * w , int x , int y ) ;
2004-08-09 19:04:08 +02:00
2007-02-23 02:48:53 +01:00
/* window.cpp */
2009-01-07 17:11:27 +01:00
extern Window * _z_front_window ;
extern Window * _z_back_window ;
2009-02-09 02:22:29 +01:00
extern Window * _focused_window ;
2008-10-14 21:27:08 +02:00
/** Iterate over all windows */
2009-01-07 19:59:46 +01:00
# define FOR_ALL_WINDOWS_FROM_BACK_FROM(w, start) for (w = start; w != NULL; w = w->z_front) if (w->window_class != WC_INVALID)
# define FOR_ALL_WINDOWS_FROM_FRONT_FROM(w, start) for (w = start; w != NULL; w = w->z_back) if (w->window_class != WC_INVALID)
# define FOR_ALL_WINDOWS_FROM_BACK(w) FOR_ALL_WINDOWS_FROM_BACK_FROM(w, _z_back_window)
# define FOR_ALL_WINDOWS_FROM_FRONT(w) FOR_ALL_WINDOWS_FROM_FRONT_FROM(w, _z_front_window)
2004-08-09 19:04:08 +02:00
2008-01-13 14:36:01 +01:00
extern Point _cursorpos_drag_start ;
2004-08-09 19:04:08 +02:00
2008-01-13 14:36:01 +01:00
extern int _scrollbar_start_pos ;
extern int _scrollbar_size ;
extern byte _scroller_click_timeout ;
2004-08-09 19:04:08 +02:00
2008-01-13 14:36:01 +01:00
extern bool _scrolling_scrollbar ;
extern bool _scrolling_viewport ;
2004-08-09 19:04:08 +02:00
2008-01-13 14:36:01 +01:00
extern byte _special_mouse_mode ;
2004-08-09 19:04:08 +02:00
enum SpecialMouseMode {
2006-08-22 16:38:37 +02:00
WSM_NONE = 0 ,
2004-08-09 19:04:08 +02:00
WSM_DRAGDROP = 1 ,
2006-08-22 16:38:37 +02:00
WSM_SIZING = 2 ,
WSM_PRESIZE = 3 ,
2004-08-09 19:04:08 +02:00
} ;
2008-04-19 15:28:48 +02:00
Window * GetCallbackWnd ( ) ;
2009-02-09 02:22:29 +01:00
void SetFocusedWindow ( Window * w ) ;
const Widget * GetGloballyFocusedWidget ( ) ;
bool EditBoxInGlobalFocus ( ) ;
2004-08-09 19:04:08 +02:00
void ScrollbarClickHandler ( Window * w , const Widget * wi , int x , int y ) ;
2007-01-24 03:36:55 +01:00
void ResizeButtons ( Window * w , byte left , byte right ) ;
2008-08-03 19:35:08 +02:00
void ResizeWindowForWidget ( Window * w , uint widget , int delta_x , int delta_y ) ;
2008-01-26 21:55:04 +01:00
2008-05-29 08:49:56 +02:00
void SetVScrollCount ( Window * w , int num ) ;
void SetVScroll2Count ( Window * w , int num ) ;
void SetHScrollCount ( Window * w , int num ) ;
2007-12-02 01:59:48 +01:00
/**
* Sets the enabled / disabled status of a widget .
* By default , widgets are enabled .
* On certain conditions , they have to be disabled .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
* @ param disab_stat status to use ie : disabled = true , enabled = false
2007-12-02 01:59:48 +01:00
*/
inline void Window : : SetWidgetDisabledState ( byte widget_index , bool disab_stat )
{
assert ( widget_index < this - > widget_count ) ;
SB ( this - > widget [ widget_index ] . display_flags , WIDG_DISABLED , 1 , ! ! disab_stat ) ;
}
/**
* Sets a widget to disabled .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
2007-12-02 01:59:48 +01:00
*/
inline void Window : : DisableWidget ( byte widget_index )
{
SetWidgetDisabledState ( widget_index , true ) ;
}
/**
* Sets a widget to Enabled .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
2007-12-02 01:59:48 +01:00
*/
2007-12-02 13:10:48 +01:00
inline void Window : : EnableWidget ( byte widget_index )
{
SetWidgetDisabledState ( widget_index , false ) ;
}
2007-12-02 01:59:48 +01:00
/**
* Gets the enabled / disabled status of a widget .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
2007-12-02 01:59:48 +01:00
* @ return status of the widget ie : disabled = true , enabled = false
*/
2007-12-02 13:10:48 +01:00
inline bool Window : : IsWidgetDisabled ( byte widget_index ) const
2007-12-02 01:59:48 +01:00
{
assert ( widget_index < this - > widget_count ) ;
return HasBit ( this - > widget [ widget_index ] . display_flags , WIDG_DISABLED ) ;
}
/**
* Sets the hidden / shown status of a widget .
* By default , widgets are visible .
* On certain conditions , they have to be hidden .
* @ param widget_index index of this widget in the window
* @ param hidden_stat status to use ie . hidden = true , visible = false
*/
inline void Window : : SetWidgetHiddenState ( byte widget_index , bool hidden_stat )
{
assert ( widget_index < this - > widget_count ) ;
SB ( this - > widget [ widget_index ] . display_flags , WIDG_HIDDEN , 1 , ! ! hidden_stat ) ;
}
/**
* Sets a widget hidden .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
2007-12-02 01:59:48 +01:00
*/
inline void Window : : HideWidget ( byte widget_index )
{
SetWidgetHiddenState ( widget_index , true ) ;
}
/**
* Sets a widget visible .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
2007-12-02 01:59:48 +01:00
*/
inline void Window : : ShowWidget ( byte widget_index )
{
SetWidgetHiddenState ( widget_index , false ) ;
}
/**
* Gets the visibility of a widget .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
2007-12-02 01:59:48 +01:00
* @ return status of the widget ie : hidden = true , visible = false
*/
2007-12-02 13:10:48 +01:00
inline bool Window : : IsWidgetHidden ( byte widget_index ) const
2007-12-02 01:59:48 +01:00
{
assert ( widget_index < this - > widget_count ) ;
return HasBit ( this - > widget [ widget_index ] . display_flags , WIDG_HIDDEN ) ;
}
2009-02-09 02:22:29 +01:00
/**
* Set focus within this window to given widget . The function however don ' t
* change which window that has focus .
* @ param widget_index : index of the widget in the window to set focus to
*/
inline void Window : : SetFocusedWidget ( byte widget_index )
{
if ( widget_index < this - > widget_count ) {
/* Repaint the widget that loss focus. A focused edit box may else leave the caret left on the screen */
if ( this - > focused_widget & & this - > focused_widget - this - > widget ! = widget_index ) {
this - > InvalidateWidget ( this - > focused_widget - this - > widget ) ;
}
this - > focused_widget = & this - > widget [ widget_index ] ;
}
}
/**
* Check if given widget has user input focus . This means that both the window
* has focus and that the given widget has focus within the window .
* @ param widget_index : index of the widget in the window to check
* @ return true if given widget is the focused window in this window and this window has focus
*/
inline bool Window : : IsWidgetGloballyFocused ( byte widget_index ) const
{
return _focused_window = = this & & IsWidgetFocused ( widget_index ) ;
}
/**
* Check if given widget is focused within this window
* @ param widget_index : index of the widget in the window to check
* @ return true if given widget is the focused window in this window
*/
inline bool Window : : IsWidgetFocused ( byte widget_index ) const
{
return this - > focused_widget = = & this - > widget [ widget_index ] ;
}
2007-12-02 01:59:48 +01:00
/**
* Sets the lowered / raised status of a widget .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
* @ param lowered_stat status to use ie : lowered = true , raised = false
2007-12-02 01:59:48 +01:00
*/
inline void Window : : SetWidgetLoweredState ( byte widget_index , bool lowered_stat )
{
assert ( widget_index < this - > widget_count ) ;
SB ( this - > widget [ widget_index ] . display_flags , WIDG_LOWERED , 1 , ! ! lowered_stat ) ;
}
/**
* Invert the lowered / raised status of a widget .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
2007-12-02 01:59:48 +01:00
*/
2007-12-02 14:32:41 +01:00
inline void Window : : ToggleWidgetLoweredState ( byte widget_index )
2007-12-02 01:59:48 +01:00
{
assert ( widget_index < this - > widget_count ) ;
ToggleBit ( this - > widget [ widget_index ] . display_flags , WIDG_LOWERED ) ;
}
/**
* Marks a widget as lowered .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
2007-12-02 01:59:48 +01:00
*/
inline void Window : : LowerWidget ( byte widget_index )
{
SetWidgetLoweredState ( widget_index , true ) ;
}
/**
* Marks a widget as raised .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
2007-12-02 01:59:48 +01:00
*/
inline void Window : : RaiseWidget ( byte widget_index )
{
SetWidgetLoweredState ( widget_index , false ) ;
}
/**
* Gets the lowered state of a widget .
2008-10-14 21:27:08 +02:00
* @ param widget_index index of this widget in the window
2007-12-02 01:59:48 +01:00
* @ return status of the widget ie : lowered = true , raised = false
*/
2007-12-02 13:10:48 +01:00
inline bool Window : : IsWidgetLowered ( byte widget_index ) const
2007-12-02 01:59:48 +01:00
{
assert ( widget_index < this - > widget_count ) ;
return HasBit ( this - > widget [ widget_index ] . display_flags , WIDG_LOWERED ) ;
}
2008-07-18 22:44:35 +02:00
/**
* Align widgets a and b next to each other .
* @ param widget_index_a the left widget
* @ param widget_index_b the right widget ( fixed )
*/
inline void Window : : AlignWidgetRight ( byte widget_index_a , byte widget_index_b )
{
assert ( widget_index_a < this - > widget_count ) ;
assert ( widget_index_b < this - > widget_count ) ;
int w = this - > widget [ widget_index_a ] . right - this - > widget [ widget_index_a ] . left ;
this - > widget [ widget_index_a ] . right = this - > widget [ widget_index_b ] . left - 1 ;
this - > widget [ widget_index_a ] . left = this - > widget [ widget_index_a ] . right - w ;
}
/**
* Get the width of a widget .
* @ param widget_index the widget
* @ return width of the widget
*/
inline int Window : : GetWidgetWidth ( byte widget_index ) const
{
assert ( widget_index < this - > widget_count ) ;
return this - > widget [ widget_index ] . right - this - > widget [ widget_index ] . left + 1 ;
}
2007-12-19 20:44:29 +01:00
# endif /* WINDOW_GUI_H */