openttd-mini: comparison src/window.h

equal deleted inserted replaced

-:0a63874accb6
+:6507b2a7e71d
 /* $Id$ */
+/** @file window.h regroups declarations for all windowing system, as well as a few helper functions */
 #ifndef WINDOW_H
 #define WINDOW_H
 #include "macros.h"
 	/* The following flags are used by the system to specify what is disabled, hidden, or clicked
 	 * They are used in the same place as the above RESIZE_x flags, Widget visual_flags.
 	 * These states are used in exceptions. If nothing is specified, they will indicate
 	 * Enabled, visible or unclicked widgets*/
-	WIDG_DISABLED = 4,  // widget is greyed out, not available
+	WIDG_DISABLED = 4,  ///< widget is greyed out, not available
-	WIDG_HIDDEN   = 5,  // widget is made invisible
+	WIDG_HIDDEN   = 5,  ///< widget is made invisible
-	WIDG_LOWERED  = 6,  // widget is paint lowered, a pressed button in fact
+	WIDG_LOWERED  = 6,  ///< widget is paint lowered, a pressed button in fact
 } ResizeFlag;
 /* used to indicate the end of widgets' list for vararg functions */
 enum {
 	WIDGET_LIST_END = -1,
 };
 typedef struct Widget {
-	byte type;                        ///< Widget type, see @WindowWidgetTypes
+	byte type;                        ///< Widget type, see WindowWidgetTypes
-	byte display_flags;               ///< Resize direction, alignment, etc. during resizing, see @ResizeFlags
+	byte display_flags;               ///< Resize direction, alignment, etc. during resizing, see ResizeFlags
 	byte color;                       ///< Widget colour, see docs/ottd-colourtext-palette.png
 	int16 left, right, top, bottom;   ///< The position offsets inside the window
 	uint16 data;                      ///< The String/Image or special code (list-matrixes) of a widget
 	StringID tooltips;                ///< Tooltips that are shown when rightclicking on a widget
 } Widget;
 			Point pt;
 			int widget;
 		} mouseover;
 		struct {
-			bool cont;     // continue the search? (default true)
+			bool cont;      ///< continue the search? (default true)
-			uint16 key;    // 16-bit Unicode value of the key
+			uint16 key;     ///< 16-bit Unicode value of the key
-			uint16 keycode;// untranslated key (including shift-state)
+			uint16 keycode; ///< untranslated key (including shift-state)
 		} keypress;
 		struct {
-			int msg;      // message to be sent
+			int msg;      ///< message to be sent
-			int wparam;   // additional message-specific information
+			int wparam;   ///< additional message-specific information
-			int lparam;   // additional message-specific information
+			int lparam;   ///< additional message-specific information
 		} message;
 		struct {
-			Point delta;   // delta position against position of last call
+			Point delta;   ///< delta position against position of last call
 		} scroll;
 		struct {
-			int wheel;     // how much was 'wheel'd'
+			int wheel;     ///< how much was 'wheel'd'
 		} wheel;
 	} we;
 };
 typedef struct WindowDesc {
 	const Widget *widgets;
 	WindowProc *proc;
 } WindowDesc;
 enum WindowDefaultFlag {
-	WDF_STD_TOOLTIPS    =   1, /* use standard routine when displaying tooltips */
+	WDF_STD_TOOLTIPS    =   1, ///< use standard routine when displaying tooltips
-	WDF_DEF_WIDGET      =   2, /* default widget control for some widgets in the on click event */
+	WDF_DEF_WIDGET      =   2, ///< default widget control for some widgets in the on click event
-	WDF_STD_BTN         =   4, /* default handling for close and drag widgets (widget no 0 and 1) */
+	WDF_STD_BTN         =   4, ///< default handling for close and drag widgets (widget no 0 and 1)
-	WDF_UNCLICK_BUTTONS =  16, /* Unclick buttons when the window event times out */
+	WDF_UNCLICK_BUTTONS =  16, ///< Unclick buttons when the window event times out */
-	WDF_STICKY_BUTTON   =  32, /* Set window to sticky mode; they are not closed unless closed with 'X' (widget 2) */
+	WDF_STICKY_BUTTON   =  32, ///< Set window to sticky mode; they are not closed unless closed with 'X' (widget 2)
-	WDF_RESIZABLE       =  64, /* A window can be resized */
+	WDF_RESIZABLE       =  64, ///< A window can be resized
-	WDF_MODAL           = 128, /* The window is a modal child of some other window, meaning the parent is 'inactive' */
+	WDF_MODAL           = 128, ///< The window is a modal child of some other window, meaning the parent is 'inactive'
 };
 /* can be used as x or y coordinates to cause a specific placement */
 enum WindowDefaultPosition {
 	WDP_AUTO      = -1, ///< Find a place automatically
 	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
 };
 typedef struct Textbuf {
-	char *buf;                  /* buffer in which text is saved */
+	char *buf;                  ///< buffer in which text is saved
-	uint16 maxlength, maxwidth; /* the maximum size of the buffer. Maxwidth specifies screensize in pixels, maxlength is in bytes */
+	uint16 maxlength, maxwidth; ///< the maximum size of the buffer. Maxwidth specifies screensize in pixels, maxlength is in bytes
-	uint16 length, width;       /* the current size of the string. Width specifies screensize in pixels, length is in bytes */
+	uint16 length, width;       ///< the current size of the string. Width specifies screensize in pixels, length is in bytes
-	bool caret;                 /* is the caret ("_") visible or not */
+	bool caret;                 ///< is the caret ("_") visible or not
-	uint16 caretpos;            /* the current position of the caret in the buffer, in bytes */
+	uint16 caretpos;            ///< the current position of the caret in the buffer, in bytes
-	uint16 caretxoffs;          /* the current position of the caret in pixels */
+	uint16 caretxoffs;          ///< the current position of the caret in pixels
 } Textbuf;
 #define WP(ptr,str) (*(str*)(ptr)->custom)
 /* You cannot 100% reliably calculate the biggest custom struct as
 * the number of pointers in it and alignment will have a huge impact.
 typedef struct Scrollbar {
 	uint16 count, cap, pos;
 } Scrollbar;
 typedef struct ResizeInfo {
-	uint width; /* Minimum width and height */
+	uint width; ///< Minimum width and height
 	uint height;
-	uint step_width; /* In how big steps the width and height go */
+	uint step_width; ///< In how big steps the width and height go
 	uint step_height;
 } ResizeInfo;
 typedef struct WindowMessage {
 		int msg;
 	bool handled;
 } querystr_d;
 assert_compile(WINDOW_CUSTOM_SIZE >= sizeof(querystr_d));
 typedef struct {
-	byte item_count;      /* follow_vehicle */
+	byte item_count;      ///< follow_vehicle
-	byte sel_index;       /* scrollpos_x */
+	byte sel_index;       ///< scrollpos_x
-	byte main_button;     /* scrollpos_y */
+	byte main_button;     ///< scrollpos_y
 	byte action_id;
-	StringID string_id;   /* unk30 */
+	StringID string_id;   ///< unk30
-	uint16 checked_items; /* unk32 */
+	uint16 checked_items; ///< unk32
 	byte disabled_items;
 } menu_d;
 assert_compile(WINDOW_CUSTOM_SIZE >= sizeof(menu_d));
 typedef struct {
 	byte vehicle_type;
 	union {
 		RailTypeByte railtype;
 		AirportFTAClass::Flags flags;
 	} filter;
-	byte sel_index;  // deprecated value, used for 'unified' ship and road
+	byte sel_index;  ///< deprecated value, used for 'unified' ship and road
 	bool descending_sort_order;
 	byte sort_criteria;
 	bool regenerate_list;
 	EngineID sel_engine;
 	EngineID rename_engine;
 typedef struct {
 	byte sel_index[2];
 	EngineID sel_engine[2];
 	uint16 count[2];
-	bool wagon_btnstate; // true means engine is selected
+	bool wagon_btnstate; ///< true means engine is selected
 	EngineList list[2];
 	bool update_left;
 	bool update_right;
 	bool init_lists;
 } replaceveh_d;
 	int32 scrollpos_x;
 	int32 scrollpos_y;
 } vp_d;
 assert_compile(WINDOW_CUSTOM_SIZE >= sizeof(vp_d));
-// vp2_d is the same as vp_d, except for the data_# values..
+/* vp2_d is the same as vp_d, except for the data_# values.. */
 typedef struct {
 	VehicleID follow_vehicle;
 	int32 scrollpos_x;
 	int32 scrollpos_y;
 	byte data_1;
 } scroller_d;
 assert_compile(WINDOW_CUSTOM_SIZE >= sizeof(scroller_d));
 typedef enum SortListFlags {
 	VL_NONE    = 0x00,
-	VL_DESC    = 0x01,  // sort descending or ascending
+	VL_DESC    = 0x01,  ///< sort descending or ascending
-	VL_RESORT  = 0x02,  // instruct the code to resort the list in the next loop
+	VL_RESORT  = 0x02,  ///< instruct the code to resort the list in the next loop
-	VL_REBUILD = 0x04,  // create sort-listing to use for qsort and friends
+	VL_REBUILD = 0x04,  ///< create sort-listing to use for qsort and friends
 	VL_END     = 0x08
 } SortListFlags;
 DECLARE_ENUM_AS_BIT_SET(SortListFlags);
 typedef struct Listing {
-	bool order;    // Ascending/descending
+	bool order;    ///< Ascending/descending
-	byte criteria; // Sorting criteria
+	byte criteria; ///< Sorting criteria
 } Listing;
 typedef struct list_d {
-	uint16 list_length;  // length of the list being sorted
+	uint16 list_length;  ///< length of the list being sorted
-	byte sort_type;      // what criteria to sort on
+	byte sort_type;      ///< what criteria to sort on
-	SortListFlags flags; // used to control sorting/resorting/etc.
+	SortListFlags flags; ///< used to control sorting/resorting/etc.
-	uint16 resort_timer; // resort list after a given amount of ticks if set
+	uint16 resort_timer; ///< resort list after a given amount of ticks if set
 } list_d;
 assert_compile(WINDOW_CUSTOM_SIZE >= sizeof(list_d));
 typedef struct message_d {
 	int msg;
 enum WindowWidgetTypes {
 	WWT_EMPTY,
-	WWT_PANEL,      /* simple depressed panel */
+	WWT_PANEL,      ///< simple depressed panel
-	WWT_INSET,      /* pressed (inset) panel, most commonly used as combo box _text_ area */
+	WWT_INSET,      ///< pressed (inset) panel, most commonly used as combo box _text_ area
-	WWT_IMGBTN,     /* button with image */
+	WWT_IMGBTN,     ///< button with image
-	WWT_IMGBTN_2,   /* button with diff image when clicked */
+	WWT_IMGBTN_2,   ///< button with diff image when clicked
-	WWT_TEXTBTN,    /* button with text */
+	WWT_TEXTBTN,    ///< button with text
-	WWT_TEXTBTN_2,  /* button with diff text when clicked */
+	WWT_TEXTBTN_2,  ///< button with diff text when clicked
-	WWT_LABEL,      /* centered label */
+	WWT_LABEL,      ///< centered label
 	WWT_MATRIX,
 	WWT_SCROLLBAR,
-	WWT_FRAME,      /* frame */
+	WWT_FRAME,      ///< frame
 	WWT_CAPTION,
 	WWT_HSCROLLBAR,
 	WWT_STICKYBOX,
-	WWT_SCROLL2BAR, /* 2nd vertical scrollbar*/
+	WWT_SCROLL2BAR, ///< 2nd vertical scrollbar
 	WWT_RESIZEBOX,
 	WWT_CLOSEBOX,
-	WWT_LAST,       /* Last Item. use WIDGETS_END to fill up padding!! */
+	WWT_LAST,       ///< Last Item. use WIDGETS_END to fill up padding!!
 	WWT_MASK = 0x1F,
 	WWT_PUSHBTN     = WWT_PANEL   | WWB_PUSHBUTTON,
 	WWT_PUSHTXTBTN  = WWT_TEXTBTN | WWB_PUSHBUTTON,
 	WF_WHITE_BORDER_ONE  = 1 << 11,
 	WF_WHITE_BORDER_MASK = 1 << 12 | WF_WHITE_BORDER_ONE,
 	WF_SCROLL2           = 1 << 13,
 };
-/* window.c */
+/* window.cpp */
 void CallWindowEventNP(Window *w, int event);
 void CallWindowTickEvent(void);
 void SetWindowDirty(const Window *w);
 void SendWindowMessage(WindowClass wnd_class, WindowNumber wnd_num, int msg, int wparam, int lparam);
 void SendWindowMessageClass(WindowClass wnd_class, int msg, int wparam, int lparam);
 int PositionMainToolbar(Window *w);
 void CDECL SetWindowWidgetsDisabledState(Window *w, bool disab_stat, int widgets, ...);
 void CDECL SetWindowWidgetsHiddenState(Window *w, bool hidden_stat, int widgets, ...);
 void CDECL SetWindowWidgetsLoweredState(Window *w, bool lowered_stat, int widgets, ...);
-/* misc_gui.c*/
+/* misc_gui.cpp */
 void GuiShowTooltipsWithArgs(StringID str, uint paramcount, const uint params[]);
 static inline void GuiShowTooltips(StringID str)
 {
 	GuiShowTooltipsWithArgs(str, 0, NULL);
 }
-/* widget.c */
+/* widget.cpp */
 int GetWidgetFromPos(const Window *w, int x, int y);
 void DrawWindowWidgets(const Window *w);
 void ShowDropDownMenu(Window *w, const StringID *strings, int selected, int button, uint32 disabled_mask, uint32 hidden_mask);
 void HandleButtonClick(Window *w, byte widget);
 void DeleteAllNonVitalWindows(void);
 void HideVitalWindows(void);
 void ShowVitalWindows(void);
 Window **FindWindowZPosition(const Window *w);
-/* window.c */
+/* window.cpp */
 extern Window *_z_windows[];
 extern Window **_last_z_window;
 #define FOR_ALL_WINDOWS(wz) for (wz = _z_windows; wz != _last_z_window; wz++)
 VARDEF Point _cursorpos_drag_start;

changeset 6117	6507b2a7e71d
parent 6024	37e72f8f6a99
child 6179	d19b0137d8e4