X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/34636400a0018eba4a1f63dda18cf32e944b959e..a4301b8f14d21b7d28fc4f6a247b740d945ca6dc:/include/wx/motif/window.h?ds=sidebyside diff --git a/include/wx/motif/window.h b/include/wx/motif/window.h index 10e6402259..82c1793220 100644 --- a/include/wx/motif/window.h +++ b/include/wx/motif/window.h @@ -1,5 +1,5 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: window.h +// Name: wx/motif/window.h // Purpose: wxWindow class // Author: Julian Smart // Modified by: @@ -12,20 +12,16 @@ #ifndef _WX_WINDOW_H_ #define _WX_WINDOW_H_ -#ifdef __GNUG__ - #pragma interface "window.h" -#endif +#include "wx/region.h" // ---------------------------------------------------------------------------- // wxWindow class for Motif - see also wxWindowBase // ---------------------------------------------------------------------------- -class wxWindow : public wxWindowBase +class WXDLLIMPEXP_CORE wxWindow : public wxWindowBase { -DECLARE_DYNAMIC_CLASS(wxWindow) - -friend class WXDLLEXPORT wxDC; -friend class WXDLLEXPORT wxWindowDC; + friend class WXDLLIMPEXP_FWD_CORE wxDC; + friend class WXDLLIMPEXP_FWD_CORE wxWindowDC; public: wxWindow() { Init(); } @@ -51,47 +47,39 @@ public: const wxString& name = wxPanelNameStr); // implement base class pure virtuals - virtual void SetTitle( const wxString& title); - virtual wxString GetTitle() const; + virtual void SetLabel(const wxString& label); + virtual wxString GetLabel() const; virtual void Raise(); virtual void Lower(); - virtual bool Show( bool show = TRUE ); - virtual bool Enable( bool enable = TRUE ); + virtual bool Show( bool show = true ); + virtual bool Enable( bool enable = true ); virtual void SetFocus(); virtual void WarpPointer(int x, int y); - virtual void CaptureMouse(); - virtual void ReleaseMouse(); - virtual void Refresh( bool eraseBackground = TRUE, - const wxRect *rect = (const wxRect *) NULL ); - virtual void Clear(); + virtual void Refresh( bool eraseBackground = true, + const wxRect *rect = (const wxRect *) NULL ); + + virtual bool SetBackgroundColour( const wxColour &colour ); + virtual bool SetForegroundColour( const wxColour &colour ); virtual bool SetCursor( const wxCursor &cursor ); virtual bool SetFont( const wxFont &font ); virtual int GetCharHeight() const; virtual int GetCharWidth() const; - virtual void GetTextExtent(const wxString& string, - int *x, int *y, - int *descent = (int *) NULL, - int *externalLeading = (int *) NULL, - const wxFont *theFont = (const wxFont *) NULL) - const; - - virtual bool PopupMenu( wxMenu *menu, int x, int y ); virtual void SetScrollbar( int orient, int pos, int thumbVisible, - int range, bool refresh = TRUE ); - virtual void SetScrollPos( int orient, int pos, bool refresh = TRUE ); + int range, bool refresh = true ); + virtual void SetScrollPos( int orient, int pos, bool refresh = true ); virtual int GetScrollPos( int orient ) const; virtual int GetScrollThumb( int orient ) const; virtual int GetScrollRange( int orient ) const; virtual void ScrollWindow( int dx, int dy, - const wxRect* rect = (wxRect *) NULL ); + const wxRect* rect = NULL ); #if wxUSE_DRAG_AND_DROP virtual void SetDropTarget( wxDropTarget *dropTarget ); @@ -100,50 +88,19 @@ public: // Accept files for dragging virtual void DragAcceptFiles(bool accept); -protected: - // event handlers (not virtual by design) - void OnIdle(wxIdleEvent& event); - - // For implementation purposes - sometimes decorations make the client area - // smaller - virtual wxPoint GetClientAreaOrigin() const; - - // Makes an adjustment to the window position (for example, a frame that has - // a toolbar that it manages itself). - virtual void AdjustForParentClientOrigin(int& x, int& y, int sizeFlags); - - virtual void AddChild(wxWindow *child); // Adds reference to the child object - virtual void RemoveChild(wxWindow *child); // Removes reference to child - virtual void DestroyChildren(); // Removes and destroys all children - - wxWindow *GetChild(int number) const - { return GetChildren().Item(number)->GetData(); } - - // Responds to colour changes: passes event on to children. - void OnSysColourChanged(wxSysColourChangedEvent& event); - - // Motif-specific - - // empties the m_updateRects list - void ClearUpdateRects(); - - // CanvasXXXSiize functions - void CanvasGetSize(int* width, int* height) const; // If have drawing area - void CanvasGetClientSize(int *width, int *height) const; - void CanvasGetPosition(int *x, int *y) const; // If have drawing area - void CanvasSetClientSize(int width, int size); - void CanvasSetSize(int x, int y, int width, int height, int sizeFlags = wxSIZE_AUTO); + // Get the unique identifier of a window + virtual WXWidget GetHandle() const { return GetMainWidget(); } - // Gives window a chance to do something in response to a size message, e.g. - // arrange status bar, toolbar etc. - virtual bool PreResize() { return TRUE; } + // implementation from now on + // -------------------------- // accessors // --------- // Get main widget for this window, e.g. a text widget virtual WXWidget GetMainWidget() const; - // Get the widget that corresponds to the label (for font setting, label setting etc.) + // Get the widget that corresponds to the label (for font setting, + // label setting etc.) virtual WXWidget GetLabelWidget() const; // Get the client widget for this window (something we can create other // windows on) @@ -153,26 +110,82 @@ protected: // implements this window. virtual WXWidget GetTopWidget() const; - // base class pure virtual - virtual WXWidget GetHandle() const { return GetMainWidget(); } - - void SetMainWidget(WXWidget w) { m_mainWidget = w; } - - bool CanAddEventHandler() const { return m_canAddEventHandler; } - void SetCanAddEventHandler(bool flag) { m_canAddEventHandler = flag; } - // Get the underlying X window and display + WXWindow GetClientXWindow() const; WXWindow GetXWindow() const; WXDisplay *GetXDisplay() const; + void SetLastClick(int button, long timestamp) + { m_lastButton = button; m_lastTS = timestamp; } + + int GetLastClickedButton() const { return m_lastButton; } + long GetLastClickTime() const { return m_lastTS; } + + // Gives window a chance to do something in response to a size message, + // e.g. arrange status bar, toolbar etc. + virtual bool PreResize(); + + // Generates a paint event + virtual void DoPaint(); + + // update rectangle/region manipulation + // (for wxWindowDC and Motif callbacks only) + // ----------------------------------------- + + // Adds a recangle to the updates list + void AddUpdateRect(int x, int y, int w, int h); + + void ClearUpdateRegion() { m_updateRegion.Clear(); } + void SetUpdateRegion(const wxRegion& region) { m_updateRegion = region; } + + // post-creation activities + void PostCreation(); + + // pre-creation activities + void PreCreation(); + +protected: + // Responds to colour changes: passes event on to children. + void OnSysColourChanged(wxSysColourChangedEvent& event); + + // Motif-specific + + void SetMainWidget(WXWidget w) { m_mainWidget = w; } + + // See src/motif/window.cpp, near the top, for an explanation + // why this is necessary + void CanvasSetSizeIntr(int x, int y, int width, int height, + int sizeFlags, bool fromCtor); + void DoSetSizeIntr(int x, int y, + int width, int height, + int sizeFlags, bool fromCtor); + + // for DoMoveWindowIntr flags + enum + { + wxMOVE_X = 1, + wxMOVE_Y = 2, + wxMOVE_WIDTH = 4, + wxMOVE_HEIGHT = 8 + }; + + void DoMoveWindowIntr(int x, int y, int width, int height, + int flags); + + // helper function, to remove duplicate code, used in wxScrollBar + WXWidget DoCreateScrollBar(WXWidget parent, wxOrientation orientation, + void (*callback)()); +public: WXPixmap GetBackingPixmap() const { return m_backingPixmap; } + void SetBackingPixmap(WXPixmap pixmap) { m_backingPixmap = pixmap; } int GetPixmapWidth() const { return m_pixmapWidth; } int GetPixmapHeight() const { return m_pixmapHeight; } + void SetPixmapWidth(int w) { m_pixmapWidth = w; } + void SetPixmapHeight(int h) { m_pixmapHeight = h; } // Change properties - virtual void ChangeFont(bool keepOriginalSize = TRUE); // Change to the current font (often overridden) - virtual void DoChangeForegroundColour(WXWidget widget, wxColour& foregroundColour); - virtual void DoChangeBackgroundColour(WXWidget widget, wxColour& backgroundColour, bool changeArmColour = FALSE); + // Change to the current font (often overridden) + virtual void ChangeFont(bool keepOriginalSize = true); // Change background and foreground colour using current background colour // setting (Motif generates foreground based on background) @@ -180,39 +193,45 @@ protected: // Change foreground colour using current foreground colour setting virtual void ChangeForegroundColour(); +protected: // Adds the widget to the hash table and adds event handlers. bool AttachWidget(wxWindow* parent, WXWidget mainWidget, - WXWidget formWidget, int x, int y, int width, int height); + WXWidget formWidget, int x, int y, int width, int height); bool DetachWidget(WXWidget widget); - // Generates a paint event - virtual void DoPaint(); - // How to implement accelerators. If we find a key event, translate to - // wxWindows wxKeyEvent form. Find a widget for the window. Now find a + // wxWidgets wxKeyEvent form. Find a widget for the window. Now find a // wxWindow for the widget. If there isn't one, go up the widget hierarchy // trying to find one. Once one is found, call ProcessAccelerator for the - // window. If it returns TRUE (processed the event), skip the X event, - // otherwise carry on up the wxWindows window hierarchy calling - // ProcessAccelerator. If all return FALSE, process the X event as normal. + // window. If it returns true (processed the event), skip the X event, + // otherwise carry on up the wxWidgets window hierarchy calling + // ProcessAccelerator. If all return false, process the X event as normal. // Eventually we can implement OnCharHook the same way, but concentrate on // accelerators for now. ProcessAccelerator must look at the current // accelerator table, and try to find what menu id or window (beneath it) // has this ID. Then construct an appropriate command // event and send it. +public: virtual bool ProcessAccelerator(wxKeyEvent& event); protected: // unmanage and destroy an X widget f it's !NULL (passing NULL is ok) void UnmanageAndDestroy(WXWidget widget); - // map or unmap an X widget (passing NULL is ok), returns TRUE if widget was - // mapped/unmapped + // map or unmap an X widget (passing NULL is ok), + // returns true if widget was mapped/unmapped bool MapOrUnmap(WXWidget widget, bool map); + // scrolling stuff + // --------------- + + // create/destroy window scrollbars + void CreateScrollbar(wxOrientation orientation); + void DestroyScrollbar(wxOrientation orientation); + // get either hor or vert scrollbar widget WXWidget GetScrollbar(wxOrientation orient) const - { return orient == wxHORIZONTAL ? m_hScrollBar : m_vScrollBar; } + { return orient == wxHORIZONTAL ? m_hScrollBar : m_vScrollBar; } // set the scroll pos void SetInternalScrollPos(wxOrientation orient, int pos) @@ -224,16 +243,13 @@ protected: } // Motif-specific flags + // -------------------- + bool m_needsRefresh:1; // repaint backing store? - bool m_canAddEventHandler:1; // ??? - bool m_button1Pressed:1; - bool m_button2Pressed:1; - bool m_button3Pressed:1; // For double-click detection - long m_lastTS; // last timestamp - int m_lastButton; // last pressed button - wxList m_updateRects; // List of wxRects representing damaged region + long m_lastTS; // last timestamp + unsigned m_lastButton:2; // last pressed button protected: WXWidget m_mainWidget; @@ -242,30 +258,37 @@ protected: WXWidget m_borderWidget; WXWidget m_scrolledWindow; WXWidget m_drawingArea; - bool m_winCaptured; - bool m_hScroll; - bool m_vScroll; + bool m_winCaptured:1; WXPixmap m_backingPixmap; int m_pixmapWidth; int m_pixmapHeight; int m_pixmapOffsetX; int m_pixmapOffsetY; - // Store the last scroll pos, since in wxWin the pos isn't set automatically - // by system + // Store the last scroll pos, since in wxWin the pos isn't set + // automatically by system int m_scrollPosX; int m_scrollPosY; // implement the base class pure virtuals + virtual void DoGetTextExtent(const wxString& string, + int *x, int *y, + int *descent = NULL, + int *externalLeading = NULL, + const wxFont *font = NULL) const; virtual void DoClientToScreen( int *x, int *y ) const; virtual void DoScreenToClient( int *x, int *y ) const; virtual void DoGetPosition( int *x, int *y ) const; virtual void DoGetSize( int *width, int *height ) const; virtual void DoGetClientSize( int *width, int *height ) const; virtual void DoSetSize(int x, int y, - int width, int height, - int sizeFlags = wxSIZE_AUTO); + int width, int height, + int sizeFlags = wxSIZE_AUTO); virtual void DoSetClientSize(int width, int height); + virtual void DoMoveWindow(int x, int y, int width, int height); + virtual bool DoPopupMenu(wxMenu *menu, int x, int y); + virtual void DoCaptureMouse(); + virtual void DoReleaseMouse(); #if wxUSE_TOOLTIPS virtual void DoSetToolTip( wxToolTip *tip ); @@ -275,27 +298,33 @@ private: // common part of all ctors void Init(); - DECLARE_NO_COPY_CLASS(wxWindow); + DECLARE_DYNAMIC_CLASS(wxWindow) + wxDECLARE_NO_COPY_CLASS(wxWindow); DECLARE_EVENT_TABLE() }; // ---------------------------------------------------------------------------- -// A little class to switch off size optimization while an instance of the object -// exists +// A little class to switch off `size optimization' while an instance of the +// object exists: this may be useful to temporarily disable the optimisation +// which consists to do nothing when the new size is equal to the old size - +// although quite useful usually to avoid flicker, sometimes it leads to +// undesired effects. // -// TODO what is it for?? +// Usage: create an instance of this class on the stack to disable the size +// optimisation, it will be reenabled as soon as the object goes out +// from scope. // ---------------------------------------------------------------------------- -class WXDLLEXPORT wxNoOptimize: public wxObject + +class WXDLLIMPEXP_CORE wxNoOptimize { public: - wxNoOptimize(); - ~wxNoOptimize(); + wxNoOptimize() { ms_count++; } + ~wxNoOptimize() { ms_count--; } - static bool CanOptimize(); + static bool CanOptimize() { return ms_count == 0; } protected: - static int m_count; + static int ms_count; }; -#endif - // _WX_WINDOW_H_ +#endif // _WX_WINDOW_H_