5b781a6729
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@9334 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
400 lines
13 KiB
C++
400 lines
13 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: window.h
|
|
// Purpose: wxWindow class
|
|
// Author: AUTHOR
|
|
// Modified by:
|
|
// Created: ??/??/98
|
|
// RCS-ID: $Id$
|
|
// Copyright: (c) AUTHOR
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_WINDOW_H_
|
|
#define _WX_WINDOW_H_
|
|
|
|
#ifdef __GNUG__
|
|
#pragma interface "window.h"
|
|
#endif
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// forward declarations
|
|
// ---------------------------------------------------------------------------
|
|
|
|
class WXDLLEXPORT wxButton;
|
|
class WXDLLEXPORT wxScrollBar;
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// constants
|
|
// ---------------------------------------------------------------------------
|
|
|
|
// FIXME does anybody use those? they're unused by wxWindows...
|
|
enum
|
|
{
|
|
wxKEY_SHIFT = 1,
|
|
wxKEY_CTRL = 2
|
|
};
|
|
|
|
class WXDLLEXPORT wxWindow: public wxWindowBase
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxWindow);
|
|
|
|
friend class wxDC;
|
|
friend class wxPaintDC;
|
|
|
|
public:
|
|
typedef struct MacWindowData
|
|
{
|
|
SInt16 m_macWindowBackgroundTheme ;
|
|
WindowRef m_macWindow ;
|
|
ControlHandle m_macRootControl ;
|
|
wxWindow* m_macFocus ;
|
|
} MacWindowData ;
|
|
|
|
|
|
wxWindow() { Init(); }
|
|
|
|
wxWindow(wxWindow *parent,
|
|
wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxString& name = wxPanelNameStr)
|
|
{
|
|
Init();
|
|
Create(parent, id, pos, size, style, name);
|
|
}
|
|
|
|
virtual ~wxWindow();
|
|
|
|
bool Create(wxWindow *parent,
|
|
wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxString& name = wxPanelNameStr);
|
|
|
|
|
|
// implement base class pure virtuals
|
|
virtual void SetTitle( const wxString& title);
|
|
virtual wxString GetTitle() const;
|
|
|
|
virtual void Raise();
|
|
virtual void Lower();
|
|
|
|
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 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 DoPopupMenu( 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 );
|
|
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 );
|
|
|
|
#if wxUSE_DRAG_AND_DROP
|
|
virtual void SetDropTarget( wxDropTarget *dropTarget );
|
|
#endif // wxUSE_DRAG_AND_DROP
|
|
|
|
// Accept files for dragging
|
|
virtual void DragAcceptFiles(bool accept);
|
|
|
|
#if WXWIN_COMPATIBILITY
|
|
// Set/get scroll attributes
|
|
virtual void SetScrollRange(int orient, int range, bool refresh = TRUE);
|
|
virtual void SetScrollPage(int orient, int page, bool refresh = TRUE);
|
|
virtual int OldGetScrollRange(int orient) const;
|
|
virtual int GetScrollPage(int orient) const;
|
|
|
|
// event handlers
|
|
// Handle a control command
|
|
virtual void OnCommand(wxWindow& win, wxCommandEvent& event);
|
|
|
|
// Override to define new behaviour for default action (e.g. double
|
|
// clicking on a listbox)
|
|
virtual void OnDefaultAction(wxControl * WXUNUSED(initiatingItem)) { }
|
|
#endif // WXWIN_COMPATIBILITY
|
|
|
|
#if wxUSE_CARET && WXWIN_COMPATIBILITY
|
|
// caret manipulation (old MSW only functions, see wxCaret class for the
|
|
// new API)
|
|
void CreateCaret(int w, int h);
|
|
void CreateCaret(const wxBitmap *bitmap);
|
|
void DestroyCaret();
|
|
void ShowCaret(bool show);
|
|
void SetCaretPos(int x, int y);
|
|
void GetCaretPos(int *x, int *y) const;
|
|
#endif // wxUSE_CARET
|
|
|
|
// Native resource loading (implemented in src/msw/nativdlg.cpp)
|
|
// FIXME: should they really be all virtual?
|
|
wxWindow* GetWindowChild1(wxWindowID id);
|
|
wxWindow* GetWindowChild(wxWindowID id);
|
|
|
|
// implementation from now on
|
|
// --------------------------
|
|
|
|
void MacClientToRootWindow( int *x , int *y ) const ;
|
|
void MacRootWindowToClient( int *x , int *y ) const ;
|
|
|
|
virtual wxString MacGetToolTipString( wxPoint &where ) ;
|
|
|
|
// simple accessors
|
|
// ----------------
|
|
|
|
// WXHWND GetHWND() const { return m_hWnd; }
|
|
// void SetHWND(WXHWND hWnd) { m_hWnd = hWnd; }
|
|
virtual WXWidget GetHandle() const { return (WXWidget) NULL ; }
|
|
|
|
bool GetUseCtl3D() const { return m_useCtl3D; }
|
|
bool GetTransparentBackground() const { return m_backgroundTransparent; }
|
|
void SetTransparent(bool t = TRUE) { m_backgroundTransparent = t; }
|
|
|
|
// event handlers
|
|
// --------------
|
|
void OnEraseBackground(wxEraseEvent& event);
|
|
void OnIdle(wxIdleEvent& event);
|
|
void MacOnScroll(wxScrollEvent&event ) ;
|
|
|
|
bool AcceptsFocus() const ;
|
|
|
|
public:
|
|
// 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);
|
|
|
|
wxWindow *FindItem(long id) const;
|
|
wxWindow *FindItemByHWND(WXHWND hWnd, bool controlOnly = FALSE) const;
|
|
|
|
// Make a Windows extended style from the given wxWindows window style
|
|
static WXDWORD MakeExtendedStyle(long style,
|
|
bool eliminateBorders = TRUE);
|
|
// Determine whether 3D effects are wanted
|
|
WXDWORD Determine3DEffects(WXDWORD defaultBorderStyle, bool *want3D) const;
|
|
|
|
// MSW only: TRUE if this control is part of the main control
|
|
virtual bool ContainsHWND(WXHWND WXUNUSED(hWnd)) const { return FALSE; };
|
|
|
|
#if WXWIN_COMPATIBILITY
|
|
wxObject *GetChild(int number) const;
|
|
virtual void MSWDeviceToLogical(float *x, float *y) const;
|
|
#endif // WXWIN_COMPATIBILITY
|
|
|
|
// Setup background and foreground colours correctly
|
|
virtual void SetupColours();
|
|
|
|
|
|
#if WXWIN_COMPATIBILITY
|
|
void SetShowing(bool show) { (void)Show(show); }
|
|
bool IsUserEnabled() const { return IsEnabled(); }
|
|
#endif // WXWIN_COMPATIBILITY
|
|
|
|
// Responds to colour changes: passes event on to children.
|
|
void OnSysColourChanged(wxSysColourChangedEvent& event);
|
|
public :
|
|
virtual void MacCreateRealWindow( const wxString& title,
|
|
const wxPoint& pos,
|
|
const wxSize& size,
|
|
long style,
|
|
const wxString& name ) ;
|
|
static bool MacGetWindowFromPoint( const wxPoint &point , wxWindow** outWin ) ;
|
|
virtual void MacActivate( EventRecord *ev , bool inIsActivating ) ;
|
|
virtual void MacUpdate( EventRecord *ev ) ;
|
|
virtual void MacUpdateImmediately() ;
|
|
virtual void MacRedraw( RgnHandle updatergn , long time) ;
|
|
virtual void MacMouseDown( EventRecord *ev , short windowPart ) ;
|
|
virtual void MacMouseUp( EventRecord *ev , short windowPart ) ;
|
|
virtual void MacMouseMoved( EventRecord *ev , short windowPart ) ;
|
|
virtual void MacKeyDown( EventRecord *ev ) ;
|
|
virtual bool MacCanFocus() const { return true ; }
|
|
|
|
virtual void MacFireMouseEvent( EventRecord *ev ) ;
|
|
virtual bool MacDispatchMouseEvent(wxMouseEvent& event ) ;
|
|
virtual void MacEraseBackground( Rect *rect ) ;
|
|
virtual void MacPaintBorders() ;
|
|
// obsolete : only for link compatibility
|
|
virtual void MacPaint( wxPaintEvent &event ) ;
|
|
WindowRef GetMacRootWindow() const ;
|
|
|
|
virtual ControlHandle MacGetContainerForEmbedding() ;
|
|
|
|
virtual long MacGetLeftBorderSize() const ;
|
|
virtual long MacGetRightBorderSize() const ;
|
|
virtual long MacGetTopBorderSize() const ;
|
|
virtual long MacGetBottomBorderSize() const ;
|
|
|
|
static long MacRemoveBordersFromStyle( long style ) ;
|
|
virtual void MacSuperChangedPosition() ;
|
|
virtual void MacSuperShown( bool show ) ;
|
|
/*
|
|
bool MacSetupFocusPort() ;
|
|
bool MacSetupDrawingPort() ;
|
|
bool MacSetupFocusClientPort() ;
|
|
bool MacSetupDrawingClientPort() ;
|
|
*/
|
|
virtual bool MacSetPortFocusParams( const Point & localOrigin, const Rect & clipRect, WindowRef window , wxWindow* rootwin ) ;
|
|
virtual bool MacSetPortDrawingParams( const Point & localOrigin, const Rect & clipRect, WindowRef window , wxWindow* rootwin ) ;
|
|
|
|
virtual void MacGetPortParams(Point* localOrigin, Rect* clipRect, WindowRef *window , wxWindow** rootwin ) ;
|
|
virtual void MacGetPortClientParams(Point* localOrigin, Rect* clipRect, WindowRef *window , wxWindow** rootwin) ;
|
|
virtual void MacDoGetPortClientParams(Point* localOrigin, Rect* clipRect, WindowRef *window , wxWindow** rootwin) ;
|
|
MacWindowData* MacGetWindowData() { return m_macWindowData ; }
|
|
static WindowRef MacGetWindowInUpdate() { return s_macWindowInUpdate ; }
|
|
bool MacIsWindowScrollbar( const wxScrollBar* sb ) { return (m_hScrollBar == sb || m_vScrollBar == sb) ; }
|
|
static wxWindow* s_lastMouseWindow ;
|
|
private:
|
|
virtual bool MacGetWindowFromPointSub( const wxPoint &point , wxWindow** outWin ) ;
|
|
protected:
|
|
|
|
MacWindowData* m_macWindowData ;
|
|
static WindowRef s_macWindowInUpdate ;
|
|
RgnHandle m_macUpdateRgn ;
|
|
|
|
int m_x ;
|
|
int m_y ;
|
|
int m_width ;
|
|
int m_height ;
|
|
|
|
wxScrollBar* m_hScrollBar ;
|
|
wxScrollBar* m_vScrollBar ;
|
|
wxString m_label ;
|
|
|
|
void MacCreateScrollBars( long style ) ;
|
|
void MacRepositionScrollBars() ;
|
|
|
|
// additional (MSW specific) flags
|
|
bool m_useCtl3D:1; // Using CTL3D for this control
|
|
bool m_backgroundTransparent:1;
|
|
bool m_mouseInWindow:1;
|
|
bool m_doubleClickAllowed:1;
|
|
bool m_winCaptured:1;
|
|
|
|
// the size of one page for scrolling
|
|
int m_xThumbSize;
|
|
int m_yThumbSize;
|
|
|
|
// WXHMENU m_hMenu; // Menu, if any
|
|
|
|
// implement the base class pure virtuals
|
|
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);
|
|
virtual void DoSetClientSize(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
|
|
// ::MoveWindow() except for composite controls which will want to arrange
|
|
// themselves inside the given rectangle
|
|
virtual void DoMoveWindow(int x, int y, int width, int height);
|
|
|
|
#if wxUSE_TOOLTIPS
|
|
virtual void DoSetToolTip( wxToolTip *tip );
|
|
#endif // wxUSE_TOOLTIPS
|
|
|
|
private:
|
|
// common part of all ctors
|
|
void Init();
|
|
|
|
DECLARE_NO_COPY_CLASS(wxWindow);
|
|
DECLARE_EVENT_TABLE()
|
|
};
|
|
|
|
// associate mac windows with wx counterparts
|
|
|
|
wxWindow* wxFindWinFromMacWindow( WindowRef inWindow ) ;
|
|
void wxAssociateWinWithMacWindow(WindowRef inWindow, wxWindow *win) ;
|
|
void wxRemoveMacWindowAssociation(wxWindow *win) ;
|
|
|
|
/*
|
|
class wxMacFocusHelper
|
|
{
|
|
public :
|
|
wxMacFocusHelper( wxWindow * theWindow ) ;
|
|
~wxMacFocusHelper() ;
|
|
bool Ok() { return m_ok ; }
|
|
|
|
private :
|
|
GrafPtr m_formerPort ;
|
|
GrafPtr m_currentPort ;
|
|
bool m_ok ;
|
|
} ;
|
|
*/
|
|
|
|
class wxMacDrawingHelper
|
|
{
|
|
public :
|
|
wxMacDrawingHelper( wxWindow * theWindow ) ;
|
|
~wxMacDrawingHelper() ;
|
|
bool Ok() { return m_ok ; }
|
|
|
|
private :
|
|
GrafPtr m_formerPort ;
|
|
GrafPtr m_currentPort ;
|
|
PenState m_savedPenState ;
|
|
bool m_ok ;
|
|
} ;
|
|
/*
|
|
class wxMacFocusClientHelper
|
|
{
|
|
public :
|
|
wxMacFocusClientHelper( wxWindow * theWindow ) ;
|
|
~wxMacFocusClientHelper() ;
|
|
bool Ok() { return m_ok ; }
|
|
|
|
private :
|
|
GrafPtr m_formerPort ;
|
|
GrafPtr m_currentPort ;
|
|
bool m_ok ;
|
|
} ;
|
|
*/
|
|
class wxMacDrawingClientHelper
|
|
{
|
|
public :
|
|
wxMacDrawingClientHelper( wxWindow * theWindow ) ;
|
|
~wxMacDrawingClientHelper() ;
|
|
bool Ok() { return m_ok ; }
|
|
|
|
private :
|
|
GrafPtr m_formerPort ;
|
|
GrafPtr m_currentPort ;
|
|
PenState m_savedPenState ;
|
|
bool m_ok ;
|
|
} ;
|
|
|
|
#endif
|
|
// _WX_WINDOW_H_
|