/* * File: wb_win.h * Purpose: * Author: Julian Smart * Created: 1993 * Updated: * Copyright: (c) 1993, AIAI, University of Edinburgh */ /* sccsid[] = "@(#)wb_win.h 1.2 5/9/94" */ /* * Purpose: wxWindow class declaration. Base class for all windows and * panel items. */ #ifndef wxb_winh #define wxb_winh #ifdef __GNUG__ #pragma interface #endif #include "common.h" #include "wx_obj.h" #include "wx_stdev.h" #include "wx_list.h" #ifdef IN_CPROTO typedef void *wxFunction ; typedef void *wxbWindow ; #else class wxCursor; class wxFont; class wxIcon; class wxColourMap; class wxMenu; class wxWindow; class wxRectangle; class wxBitmap; class wxItem; class wxLayoutConstraints; // Callback function type definition typedef void (*wxFunction) (wxObject&, wxEvent&); /* * Event handler: windows have themselves as their event handlers * by default, but their event handlers could be set to another * object entirely. This separation can reduce the amount of * derivation required, and allow alteration of a window's functionality * (e.g. by a resource editor that temporarily switches event handlers). */ class wxEvtHandler: public wxObject { DECLARE_DYNAMIC_CLASS(wxEvtHandler) protected: wxEvtHandler *nextHandler; wxEvtHandler *previousHandler; char *wx_client_data; // Any user client data public: wxEvtHandler(void); ~wxEvtHandler(void); wxEvtHandler *GetNextHandler(void); wxEvtHandler *GetPreviousHandler(void); void SetNextHandler(wxEvtHandler *handler); void SetPreviousHandler(wxEvtHandler *handler); virtual void OnMenuCommand(int cmd) {}; virtual void OnMenuSelect(int cmd) {}; inline virtual void OnCommand(wxWindow& win, wxCommandEvent& event) {}; // Called if child control has no // callback function virtual void OnScroll(wxCommandEvent& event) {}; inline virtual void OnPaint(void) {}; // Called when needs painting virtual void OnSize(int width, int height) {}; // Called on resize inline virtual void OnMove(int x, int y) {}; // Called on move inline virtual void OnEvent(wxMouseEvent& event) {}; // Called on mouse event inline virtual void OnChar(wxKeyEvent& event) {}; // Called on character event // Under Windows, we can intercept character input per dialog or frame virtual inline Bool OnCharHook(wxKeyEvent& event) { return FALSE; } inline virtual Bool OnClose(void) { return FALSE; }; // Delete window if returns TRUE inline virtual void OnActivate(Bool active) {}; // Called on window activation (MSW) inline virtual void OnSetFocus(void) {}; // Called on setting focus inline virtual void OnKillFocus(void) {}; // Called on killing focus inline virtual void OnDropFiles(int n, char *files[], int x, int y) {}; // Called when files dropped // Members for editing dialogs/panels inline virtual void OnItemMove(wxItem *item, int x, int y) {}; inline virtual void OnItemSize(wxItem *item, int w, int h) {}; inline virtual void OnItemSelect(wxItem *item, Bool select) {}; // If clicked on panel inline virtual void OnLeftClick(int x, int y, int keys) {}; inline virtual void OnRightClick(int x, int y, int keys) {}; inline virtual void OnItemLeftClick(wxItem *item, int x, int y, int keys) {}; inline virtual void OnItemRightClick(wxItem *item, int x, int y, int keys) {}; virtual void OnItemEvent(wxItem *item, wxMouseEvent& event) {}; virtual void OnSelect(Bool select) {}; virtual void OnDefaultAction(wxItem *initiatingItem) {}; virtual void OnChangeFocus(wxItem *from, wxItem *to) {}; virtual Bool OnFunctionKey(wxKeyEvent &event) { return FALSE; }; char *GetClientData(void); void SetClientData(char *); }; /* * Base class for frame, panel, canvas, panel items, dialog box. * */ class wxWindow; class wxMenu; class wxSizer; class wxbWindow: public wxEvtHandler { protected: Bool editUIMode; // TRUE if user can edit interface long windowStyle; // Store the window's style wxEvtHandler *windowEventHandler; // Usually is 'this' wxFont *font; // Window's font wxList *children; // Window's children wxWindow *window_parent; // Each window always knows its parent public: int doubleClickAllowed ; // Font - created on demand, not deleted with window wxCursor *wx_cursor; // Window's cursor #if USE_CONSTRAINTS wxLayoutConstraints *constraints; // Constraints for this window wxList *constraintsInvolvedIn; // List of constraints we're involved in wxSizer *windowSizer; // Window's top-level sizer (if any) wxWindow *sizerParent; // Window's parent sizer (if any) Bool autoLayout; // Whether to call Layout() in OnSize #endif Bool paintingEnabled; Bool winCaptured; char *handle; // Pointer to real window char *windowName; // Window name wxFunction callback; // Callback associated with the window virtual void Callback(wxFunction); // Adds callback // Constructors/Destructors wxbWindow(void); virtual ~wxbWindow(void); virtual void GetSize(int *width, int *height) = 0; virtual void GetPosition(int *x, int *y) = 0; virtual void GetClientSize(int *width, int *height) = 0; // Size client can use virtual void SetSize(int x, int y, int width, int height, int sizeFlags = wxSIZE_AUTO) = 0; inline virtual void SetSize(int width, int height) { SetSize(-1, -1, width, height, wxSIZE_USE_EXISTING); } inline virtual void Move(int x, int y) { SetSize(x, y, -1, -1, wxSIZE_USE_EXISTING); } virtual void SetClientSize(int width, int size) = 0; virtual void ClientToScreen(int *x, int *y) = 0; virtual void ScreenToClient(int *x, int *y) = 0; virtual void Enable(Bool enable) = 0; virtual void SetFocus(void) = 0; virtual void CaptureMouse(void) = 0; virtual void ReleaseMouse(void) = 0; virtual void DragAcceptFiles(Bool accept) = 0; virtual void MakeModal(Bool modal); virtual char *GetHandle(void); virtual wxWindow *GetParent(void); virtual inline void SetParent(wxWindow *p) { window_parent = p; } virtual wxWindow *GetGrandParent(void); inline virtual wxList *GetChildren() { return children; } virtual Bool Show(Bool show) = 0; virtual wxCursor *SetCursor(wxCursor *cursor) = 0; virtual void SetColourMap(wxColourMap *cmap) = 0; virtual float GetCharWidth(void) = 0; virtual float GetCharHeight(void) = 0; inline virtual void GetTextExtent(const char *string, float *x, float *y, float *descent = NULL, float *externalLeading = NULL, wxFont *theFont = NULL) {}; // Font inline virtual void SetFont(wxFont *f) { font = f; } inline virtual wxFont *GetFont(void) { return font; } inline virtual void SetTitle(char *title) {}; // Set window title inline virtual char *GetTitle(void) { return NULL; }; // Set window title // Most windows have the concept of a label; for frames, this is the // title; for items, this is the label or button text. inline virtual char *GetLabel(void) { return GetTitle(); } inline virtual char *GetName(void) { return windowName; } virtual void SetName(char *name); inline virtual void Fit(void) {}; // Size window to fit contents inline virtual void Centre(int direction) {}; // Centre item on panel, // or frame on screen // Renamed from GetWindowStyle since it clashed with a // macro in windowsx.h. inline long GetWindowStyleFlag(void) { return windowStyle; } // A concession to our friends across the pond inline void Center(int direction = wxHORIZONTAL) { Centre(direction); } inline virtual void EnablePainting(Bool enable) { paintingEnabled = enable; } inline virtual void Paint(void) { OnPaint(); } virtual Bool PopupMenu(wxMenu *menu, float x, float y) = 0; // Scrolling virtual void SetScrollPos(int orient, int pos) {}; virtual void SetScrollRange(int orient, int range) {}; virtual int GetScrollPos(int orient) {return 0;}; virtual int GetScrollRange(int orient) {return 0;}; // Event handlers that do something by default virtual void OnSize(int width, int height); virtual void OnMenuSelect(int cmd) {}; virtual void OnCommand(wxWindow& win, wxCommandEvent& event); // Caret virtual void CreateCaret(int w, int h) {}; virtual void CreateCaret(wxBitmap *bitmap) {}; virtual void DestroyCaret(void) {}; virtual void ShowCaret(Bool show) {}; virtual void SetCaretPos(int x, int y) {}; virtual void GetCaretPos(int *x, int *y) {}; // INTERNAL FUNCTIONS virtual void AddChild(wxObject *child); // Adds reference to the child object virtual void RemoveChild(wxObject *child); // Removes reference to child // (but doesn't delete the child object) virtual void DestroyChildren(void); // Removes and destroys all children // Mode for manipulating the user interface virtual inline void SetUserEditMode(Bool edit) { editUIMode = edit; } virtual inline Bool GetUserEditMode(void) { return editUIMode; } virtual void SetEventHandler(wxEvtHandler *handler); virtual wxEvtHandler *GetEventHandler(void); #if USE_CONSTRAINTS // Mode for telling default OnSize members to // call Layout(), if not using Sizers, just top-down constraints virtual inline void SetAutoLayout(Bool a) { autoLayout = a; } virtual inline Bool GetAutoLayout(void) { return autoLayout; } // Constraint accessors inline wxLayoutConstraints *GetConstraints(void) { return constraints; } void SetConstraints(wxLayoutConstraints *c); inline wxList *GetConstraintsInvolvedIn(void) { return constraintsInvolvedIn; } // Back-pointer to other windows we're involved with, so if we delete // this window, we must delete any constraints we're involved with. void AddConstraintReference(wxWindow *otherWin); void DeleteRelatedConstraints(void); Bool Layout(void); virtual void SetSizer(wxSizer *sizer); // Adds sizer child to this window virtual wxSizer *GetSizer(void); virtual wxWindow *GetSizerParent(void); inline virtual void SetSizerParent(wxWindow *win) { sizerParent = win; } virtual void ResetConstraints(void); virtual void SetConstraintSizes(Bool recurse = TRUE); virtual Bool LayoutPhase1(int *noChanges); virtual Bool LayoutPhase2(int *noChanges); virtual Bool DoPhase(int); // Transforms from sizer coordinate space to actual // parent coordinate space virtual void TransformSizerToActual(int *x, int *y); // Set size with transformation to actual coordinates if nec. virtual void SizerSetSize(int x, int y, int w, int h); virtual void SizerMove(int x, int y); // Only set/get the size/position of the constraint (if any) virtual void SetSizeConstraint(int x, int y, int w, int h); virtual void MoveConstraint(int x, int y); virtual void GetSizeConstraint(int *w, int *h); virtual void GetClientSizeConstraint(int *w, int *h); virtual void GetPositionConstraint(int *x, int *y); #endif }; extern wxList wxTopLevelWindows; class wxRectangle: public wxObject { DECLARE_DYNAMIC_CLASS(wxRectangle) public: int x; int y; int width; int height; inline wxRectangle(void) { x = 0; y = 0; width = 0; height = 0; } }; #endif // IN_CPROTO #endif // wxb_winh