X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/3b72cd917f4198b70578f60e7667b307acae91ab..2bf8f4c0d57be03ee27a0f84d041ebcb99202497:/include/wx/msw/window.h diff --git a/include/wx/msw/window.h b/include/wx/msw/window.h index f26f55877f..281e88278d 100644 --- a/include/wx/msw/window.h +++ b/include/wx/msw/window.h @@ -1,6 +1,6 @@ ///////////////////////////////////////////////////////////////////////////// // Name: wx/msw/window.h -// Purpose: wxWindow class +// Purpose: wxWindowMSW class // Author: Julian Smart // Modified by: Vadim Zeitlin on 13.05.99: complete refont of message handling, // elimination of Default(), ... @@ -13,21 +13,6 @@ #ifndef _WX_WINDOW_H_ #define _WX_WINDOW_H_ -// --------------------------------------------------------------------------- -// headers -// --------------------------------------------------------------------------- - -#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA) - #pragma interface "window.h" -#endif - -// [at least] some version of Windows send extra mouse move messages after -// a mouse click or a key press - to temporarily fix this problem, set the -// define below to 1 -// -// a better solution should be found later... -#define wxUSE_MOUSEEVENT_HACK 0 - // --------------------------------------------------------------------------- // constants // --------------------------------------------------------------------------- @@ -47,6 +32,12 @@ enum class WXDLLEXPORT wxWindowMSW : public wxWindowBase { + friend class wxSpinCtrl; + friend class wxSlider; + friend class wxRadioBox; +#if defined __VISUALC__ && __VISUALC__ <= 1200 + friend class wxWindowMSW; +#endif public: wxWindowMSW() { Init(); } @@ -71,8 +62,8 @@ 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(); @@ -92,8 +83,10 @@ public: virtual void Update(); virtual void Freeze(); virtual void Thaw(); + virtual bool IsFrozen() const { return m_frozenness > 0; } - virtual void SetWindowStyleFlag( long style ); + virtual void SetWindowStyleFlag(long style); + virtual void SetExtraStyle(long exStyle); virtual bool SetCursor( const wxCursor &cursor ); virtual bool SetFont( const wxFont &font ); @@ -106,10 +99,6 @@ public: const wxFont *theFont = (const wxFont *) NULL) const; -#if wxUSE_MENUS_NATIVE - virtual bool DoPopupMenu( wxMenu *menu, int x, int y ); -#endif // wxUSE_MENUS_NATIVE - virtual void SetScrollbar( int orient, int pos, int thumbVisible, int range, bool refresh = true ); virtual void SetScrollPos( int orient, int pos, bool refresh = true ); @@ -122,6 +111,12 @@ public: virtual bool ScrollLines(int lines); virtual bool ScrollPages(int pages); + virtual void SetLayoutDirection(wxLayoutDirection dir); + virtual wxLayoutDirection GetLayoutDirection() const; + virtual wxCoord AdjustForLayoutDirection(wxCoord x, + wxCoord width, + wxCoord widthTotal) const; + #if wxUSE_DRAG_AND_DROP virtual void SetDropTarget( wxDropTarget *dropTarget ); #endif // wxUSE_DRAG_AND_DROP @@ -150,6 +145,11 @@ public: virtual bool UnregisterHotKey(int hotkeyId); #endif // wxUSE_HOTKEY +#ifdef __POCKETPC__ + bool IsContextMenuEnabled() const { return m_contextMenuEnabled; } + void EnableContextMenu(bool enable = true) { m_contextMenuEnabled = enable; } +#endif + // window handle stuff // ------------------- @@ -160,6 +160,9 @@ public: void AssociateHandle(WXWidget handle); void DissociateHandle(); + // does this window have deferred position and/or size? + bool IsSizeDeferred() const; + // implementation from now on // ========================== @@ -174,10 +177,6 @@ public: #endif public: - // For implementation purposes - sometimes decorations make the client area - // smaller - virtual wxPoint GetClientAreaOrigin() const; - // Windows subclassing void SubclassWin(WXHWND hWnd); void UnsubclassWin(); @@ -196,6 +195,11 @@ public: // MSW only: true if this control is part of the main control virtual bool ContainsHWND(WXHWND WXUNUSED(hWnd)) const { return false; }; +#if wxUSE_TOOLTIPS + // MSW only: true if this window or any of its children have a tooltip + virtual bool HasToolTips() const { return GetToolTip() != NULL; } +#endif // wxUSE_TOOLTIPS + // translate wxWidgets style flags for this control into the Windows style // and optional extended style for the corresponding native control // @@ -210,6 +214,11 @@ public: WXDWORD MSWGetCreateWindowFlags(WXDWORD *exflags = NULL) const { return MSWGetStyle(GetWindowStyle(), exflags); } + // update the real underlying window style flags to correspond to the + // current wxWindow object style (safe to call even if window isn't fully + // created yet) + void MSWUpdateStyle(long flagsOld, long exflagsOld); + // translate wxWidgets coords into Windows ones suitable to be passed to // ::CreateWindow() // @@ -280,9 +289,7 @@ public: WXWORD pos, WXHWND control); // child control notifications -#ifdef __WIN95__ virtual bool MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result); -#endif // __WIN95__ // owner-drawn controls need to process these messages virtual bool MSWOnDrawItem(int id, WXDRAWITEMSTRUCT *item); @@ -294,7 +301,8 @@ public: bool HandleDestroy(); bool HandlePaint(); - bool HandleEraseBkgnd(WXHDC pDC); + bool HandlePrintClient(WXHDC hDC); + bool HandleEraseBkgnd(WXHDC hDC); bool HandleMinimize(); bool HandleMaximize(); @@ -314,6 +322,7 @@ public: bool HandleSysColorChange(); bool HandleDisplayChange(); bool HandleCaptureChanged(WXHWND gainedCapture); + virtual bool HandleSettingChange(WXWPARAM wParam, WXLPARAM lParam); bool HandleQueryEndSession(long logOff, bool *mayEnd); bool HandleEndSession(bool endSession, long logOff); @@ -336,11 +345,16 @@ public: #ifdef __WIN32__ int HandleMenuChar(int chAccel, WXLPARAM lParam); #endif + // Create and process a clipboard event specified by type. + bool HandleClipboardEvent( WXUINT nMsg ); bool HandleQueryDragIcon(WXHICON *hIcon); bool HandleSetCursor(WXHWND hWnd, short nHitTest, int mouseMsg); + bool HandlePower(WXWPARAM wParam, WXLPARAM lParam, bool *vetoed); + + // Window procedure virtual WXLRESULT MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam); @@ -362,45 +376,40 @@ public: // called when the window is about to be destroyed virtual void MSWDestroyWindow(); - // this function should return the brush to paint the window background - // with or 0 for the default brush - virtual WXHBRUSH MSWControlColor(WXHDC hDC); // this function should return the brush to paint the children controls // background or 0 if this window doesn't impose any particular background // on its children // - // the base class version uses MSWGetBgColourForChild() and returns a solid - // brush if we have a non default background colour or 0 otherwise - virtual WXHBRUSH MSWGetBgBrushForChild(WXHDC WXUNUSED(hDC), wxWindow *child) - { - return MSWGetSolidBgBrushForChild(child); - } + // the base class version returns a solid brush if we have a non default + // background colour or 0 otherwise + virtual WXHBRUSH MSWGetBgBrushForChild(WXHDC hDC, WXHWND hWnd); - // return the background colour of this window under the given child - // (possible grand child) + // return the background brush to use for painting the given window by + // quering the parent windows via their MSWGetBgBrushForChild() recursively // - // this is a hack as if the background is themed, there is no single colour - // representing it, but sometimes we can't use the pattern brush returned - // by MSWGetBgBrushForChild() anyhow and then this function is used as - // fallback - // - // the base class version returns bg colour if it had been explicitely set - // or wxNullColour otherwise - virtual wxColour MSWGetBgColourForChild(wxWindow *child); + // hWndToPaint is normally NULL meaning this window itself, but it can also + // be a child of this window which is used by the static box and could be + // potentially useful for other transparent controls + WXHBRUSH MSWGetBgBrush(WXHDC hDC, WXHWND hWndToPaint = NULL); - // convenience function: returns a solid brush of the colour returned by - // MSWGetBgColourForChild() or 0 - WXHBRUSH MSWGetSolidBgBrushForChild(wxWindow *child); + // gives the parent the possibility to draw its children background, e.g. + // this is used by wxNotebook to do it using DrawThemeBackground() + // + // return true if background was drawn, false otherwise + virtual bool MSWPrintChild(WXHDC WXUNUSED(hDC), wxWindow * WXUNUSED(child)) + { + return false; + } - // normally just calls MSWGetBgBrushForChild() on the parent window but may - // be overridden if the default background brush is not suitable for some - // reason (e.g. wxStaticBox uses MSWGetSolidBgBrushForChild() instead) - virtual WXHBRUSH MSWGetBgBrushForSelf(wxWindow *parent, WXHDC hDC); + // some controls (e.g. wxListBox) need to set the return value themselves + // + // return true to let parent handle it if we don't, false otherwise + virtual bool MSWShouldPropagatePrintChild() + { + return true; + } - // return the background brush to use for this window by quering the parent - // windows via their MSWGetBgBrushForChild() recursively - WXHBRUSH MSWGetBgBrush(WXHDC hDC); // Responds to colour changes: passes event on to children. void OnSysColourChanged(wxSysColourChangedEvent& event); @@ -411,11 +420,22 @@ public: // check if mouse is in the window bool IsMouseInWindow() const; + // check if a native double-buffering applies for this window + virtual bool IsDoubleBuffered() const; + + // synthesize a wxEVT_LEAVE_WINDOW event and set m_mouseInWindow to false + void GenerateMouseLeave(); + // virtual function for implementing internal idle // behaviour - virtual void OnInternalIdle() ; + virtual void OnInternalIdle(); protected: + +#if wxUSE_MENUS_NATIVE + virtual bool DoPopupMenu( wxMenu *menu, int x, int y ); +#endif // wxUSE_MENUS_NATIVE + // the window handle WXHWND m_hWnd; @@ -430,13 +450,6 @@ protected: int m_xThumbSize; int m_yThumbSize; -#if wxUSE_MOUSEEVENT_HACK - // the coordinates of the last mouse event and the type of it - long m_lastMouseX, - m_lastMouseY; - int m_lastMouseEvent; -#endif // wxUSE_MOUSEEVENT_HACK - // implement the base class pure virtuals virtual void DoClientToScreen( int *x, int *y ) const; virtual void DoScreenToClient( int *x, int *y ) const; @@ -451,8 +464,13 @@ protected: virtual void DoCaptureMouse(); virtual void DoReleaseMouse(); - // has the window been frozen by Freeze()? - bool IsFrozen() const { return m_frozenness > 0; } + // this simply moves/resizes the given HWND which is supposed to be our + // sibling (this is useful for controls which are composite at MSW level + // and for which DoMoveWindow() is not enough) + // + // returns true if the window move was deferred, false if it was moved + // immediately (no error return) + bool DoMoveSibling(WXHWND hwnd, int x, int y, int width, int height); // move the window to the specified location and resize it: this is called // from both DoSetSize() and DoSetClientSize() and would usually just call @@ -476,8 +494,16 @@ protected: // default OnEraseBackground() implementation, return true if we did erase - // the background, false otherwise - bool DoEraseBackground(wxDC& dc); + // the background, false otherwise (i.e. the system should erase it) + bool DoEraseBackground(WXHDC hDC); + + // generate WM_CHANGEUISTATE if it's needed for the OS we're running under + // + // action should be one of the UIS_XXX constants + // state should be one or more of the UISF_XXX constants + // if action == UIS_INITIALIZE then it doesn't seem to matter what we use + // for state as the system will decide for us what needs to be set + void MSWUpdateUIState(int action, int state = 0); private: // common part of all ctors @@ -487,10 +513,7 @@ private: bool HandleMove(int x, int y); bool HandleMoving(wxRect& rect); bool HandleJoystickEvent(WXUINT msg, int x, int y, WXUINT flags); - -#ifdef __WIN95__ bool HandleNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result); -#endif // __WIN95__ // list of disabled children before last call to our Disable() wxWindowList *m_childrenDisabled; @@ -501,6 +524,17 @@ private: // current defer window position operation handle (may be NULL) WXHANDLE m_hDWP; +protected: + // When deferred positioning is done these hold the pending changes, and + // are used for the default values if another size/pos changes is done on + // this window before the group of deferred changes is completed. + wxPoint m_pendingPosition; + wxSize m_pendingSize; + +private: +#ifdef __POCKETPC__ + bool m_contextMenuEnabled; +#endif DECLARE_DYNAMIC_CLASS(wxWindowMSW) DECLARE_NO_COPY_CLASS(wxWindowMSW) @@ -525,7 +559,7 @@ inline void wxWindowMSW::SetTransparent(bool WXUNUSED(t)) { } // kbd code translation WXDLLEXPORT int wxCharCodeMSWToWX(int keySym, WXLPARAM lParam = 0); -WXDLLEXPORT WXWORD wxCharCodeWXToMSW(int id, bool *IsVirtual); +WXDLLEXPORT WXWORD wxCharCodeWXToMSW(int id, bool *IsVirtual = NULL); // window creation helper class: before creating a new HWND, instantiate an // object of this class on stack - this allows to process the messages sent to @@ -554,5 +588,4 @@ WX_DECLARE_HASH(wxWindowMSW, wxWindowList, wxWinHashTable); extern wxWinHashTable *wxWinHandleHash; -#endif - // _WX_WINDOW_H_ +#endif // _WX_WINDOW_H_