wxWidgets/include/wx/gtk1/window.h

/////////////////////////////////////////////////////////////////////////////
// Name:        window.h
// Purpose:
// Author:      Robert Roebling
// Id:          $Id$
// Copyright:   (c) 1998 Robert Roebling
// Licence:     wxWindows licence
/////////////////////////////////////////////////////////////////////////////


#ifndef __GTKWINDOWH__
#define __GTKWINDOWH__

#ifdef __GNUG__
    #pragma interface
#endif

#include "wx/defs.h"
#include "wx/object.h"
#include "wx/list.h"
#include "wx/event.h"
#include "wx/validate.h"
#include "wx/cursor.h"
#include "wx/font.h"
#include "wx/region.h"
#include "wx/accel.h"

//-----------------------------------------------------------------------------
// global data
//-----------------------------------------------------------------------------

extern const char *wxFrameNameStr;
extern wxWindowList wxTopLevelWindows;

//-----------------------------------------------------------------------------
// global function
//-----------------------------------------------------------------------------

extern wxWindow* wxGetActiveWindow();

//-----------------------------------------------------------------------------
// classes
//-----------------------------------------------------------------------------

class wxLayoutConstraints;
class wxSizer;
class wxDC;
class wxClientData;
class wxVoidClientData;
class wxWindow;
#if wxUSE_WX_RESOURCES
    class wxResourceTable;
    class wxItemResource;
#endif
#if wxUSE_DRAG_AND_DROP
    class wxDropTarget;
#endif
class wxToolTip;

//-----------------------------------------------------------------------------
// callback definition for inserting a window (internal)
//-----------------------------------------------------------------------------

typedef void (*wxInsertChildFunction)( wxWindow*, wxWindow* );

//-----------------------------------------------------------------------------
// global data
//-----------------------------------------------------------------------------

extern const char *wxPanelNameStr;
extern const wxSize wxDefaultSize;
extern const wxPoint wxDefaultPosition;

//-----------------------------------------------------------------------------
// wxClientData
//-----------------------------------------------------------------------------

class wxClientData
{
public:
    wxClientData() { }
    virtual ~wxClientData() { }
};

//-----------------------------------------------------------------------------
// wxStringClientData
//-----------------------------------------------------------------------------

class wxStringClientData : public wxClientData
{
public:
    wxStringClientData() { }
    wxStringClientData( wxString &data ) { m_data = data; }
    void SetData( wxString &data ) { m_data = data; }
    wxString GetData() const { return m_data; }

private:
    wxString  m_data;
};

//-----------------------------------------------------------------------------
// wxWindow
//-----------------------------------------------------------------------------

class wxWindow : public wxEvtHandler
{
    DECLARE_DYNAMIC_CLASS(wxWindow)

public:
    // creating the window
    // -------------------
    wxWindow();
    wxWindow(wxWindow *parent, wxWindowID id,
            const wxPoint& pos = wxDefaultPosition,
            const wxSize& size = wxDefaultSize,
            long style = 0,
            const wxString& name = wxPanelNameStr);
    bool Create(wxWindow *parent, wxWindowID id,
            const wxPoint& pos = wxDefaultPosition,
            const wxSize& size = wxDefaultSize,
            long style = 0,
            const wxString& name = wxPanelNameStr);
    virtual ~wxWindow();

#if wxUSE_WX_RESOURCES
    virtual bool LoadFromResource(wxWindow *parent,
                                  const wxString& resourceName,
                                  const wxResourceTable *table = (const wxResourceTable *) NULL);
    virtual wxControl *CreateItem(const wxItemResource* childResource,
                                  const wxItemResource* parentResource,
                                  const wxResourceTable *table = (const wxResourceTable *) NULL);
#endif // wxUSE_WX_RESOURCES

    // closing the window
    // ------------------
    bool Close( bool force = FALSE );
    virtual bool Destroy();
    virtual bool DestroyChildren();

    bool IsBeingDeleted();

    // moving/resizing
    // ---------------

        // set the window size and/or position
    void SetSize( int x, int y, int width, int height,
                  int sizeFlags = wxSIZE_AUTO )
        {  DoSetSize(x, y, width, height, sizeFlags); }

    void SetSize( int width, int height )
        { DoSetSize( -1, -1, width, height, wxSIZE_USE_EXISTING ); }

    void SetSize( const wxSize& size )
        { SetSize( size.x, size.y); }

    void SetSize(const wxRect& rect, int sizeFlags = wxSIZE_AUTO)
        { DoSetSize(rect.x, rect.y, rect.width, rect.height, sizeFlags); }

    void Move( int x, int y )
        { DoSetSize( x, y, -1, -1, wxSIZE_USE_EXISTING ); }

    void Move(const wxPoint& pt)
        { Move(pt.x, pt.y); }

        // client size is the size of area available for subwindows
    void SetClientSize( int width, int height )
        { DoSetClientSize(width, height); }

    void SetClientSize( const wxSize& size )
        { DoSetClientSize(size.x, size.y); }

    void SetClientSize(const wxRect& rect)
        { SetClientSize( rect.width, rect.height ); }

        // get the window position and/or size
    virtual void GetPosition( int *x, int *y ) const;
    wxPoint GetPosition() const
    {
        int w, h;
        GetPosition(& w, & h);

        return wxPoint(w, h);
    }

    virtual void GetSize( int *width, int *height ) const;

    wxSize GetSize() const
    {
        int w, h;
        GetSize(& w, & h);
        return wxSize(w, h);
    }

    wxRect GetRect() const
    {
        int x, y, w, h;
        GetPosition(& x, & y);
        GetSize(& w, & h);

        return wxRect(x, y, w, h);
    }

    virtual void GetClientSize( int *width, int *height ) const;
    wxSize GetClientSize() const
    {
        int w, h;
        GetClientSize(& w, & h);
        return wxSize(w, h);
    }

        // position with respect to the the parent window
    virtual void Centre( int direction = wxHORIZONTAL );
    void Center(int direction = wxHORIZONTAL) { Centre(direction); }
    virtual void Fit();

        // set min/max size of the window
    virtual void SetSizeHints( int minW, int minH,
                               int maxW = -1, int maxH = -1,
                               int incW = -1, int incH = -1 );

    // Dialog units translations. Implemented in wincmn.cpp.
    // -----------------------------------------------------

    wxPoint ConvertPixelsToDialog( const wxPoint& pt );
    wxPoint ConvertDialogToPixels( const wxPoint& pt );
    wxSize ConvertPixelsToDialog( const wxSize& sz )
    {
        wxPoint pt(ConvertPixelsToDialog(wxPoint(sz.x, sz.y)));
        
        return wxSize(pt.x, pt.y);
    }

    wxSize ConvertDialogToPixels( const wxSize& sz )
    {
        wxPoint pt(ConvertDialogToPixels(wxPoint(sz.x, sz.y)));

        return wxSize(pt.x, pt.y);
    }

    void OnSize( wxSizeEvent &event );

    // window state
    // ------------

    virtual bool Show( bool show );
    virtual void Enable( bool enable );
    virtual void MakeModal( bool modal );
    virtual bool IsEnabled() const { return m_isEnabled; }
    inline bool Enabled() const { return IsEnabled(); }

    virtual void SetFocus();
    static wxWindow *FindFocus();

    void SetReturnCode( int retCode );
    int GetReturnCode();

    // parent/children relations
    // -------------------------

    virtual void AddChild( wxWindow *child );
    wxList& GetChildren() { return m_children; }

    virtual void RemoveChild( wxWindow *child );

    wxWindow *GetParent() const
        { return m_parent; }
    wxWindow *GetGrandParent() const
        { return (m_parent ? m_parent->m_parent : (wxWindow*)NULL); }
    void SetParent( wxWindow *parent )
        { m_parent = parent; }
    virtual wxWindow *ReParent( wxWindow *newParent );

    // event handler stuff
    // -------------------

    wxEvtHandler *GetEventHandler() const;
    void SetEventHandler( wxEvtHandler *handler );
    void PushEventHandler( wxEvtHandler *handler );
    wxEvtHandler *PopEventHandler( bool deleteHandler = FALSE );

    // validators and client data
    // --------------------------

    virtual void SetValidator( const wxValidator &validator );
    virtual wxValidator *GetValidator();

    virtual void SetClientObject( wxClientData *data );
    virtual wxClientData *GetClientObject();

    virtual void SetClientData( void *data );
    virtual void *GetClientData();

    // accelerators
    // ------------
    virtual void SetAcceleratorTable( const wxAcceleratorTable& accel );
    virtual wxAcceleratorTable *GetAcceleratorTable() { return &m_acceleratorTable; }

    void SetId( wxWindowID id );
    wxWindowID GetId() const;

    void SetCursor( const wxCursor &cursor );

    virtual void PrepareDC( wxDC &dc );

    void WarpPointer(int x, int y);

#if wxUSE_TOOLTIPS
    void SetToolTip( const wxString &tip );
    virtual void SetToolTip( wxToolTip *tip );
    wxToolTip* GetToolTip() const { return m_toolTip; }
#endif // wxUSE_TOOLTIPS

    virtual void Refresh( bool eraseBackground = TRUE, const wxRect *rect = (const wxRect *) NULL );
    virtual void Clear();

    virtual wxRegion GetUpdateRegion() const;
    virtual bool IsExposed( int x, int y ) const;
    virtual bool IsExposed( int x, int y, int w, int h ) const;
    virtual bool IsExposed( const wxPoint& pt ) const;
    virtual bool IsExposed( const wxRect& rect ) const;

    // colours
    // -------

    virtual wxColour GetBackgroundColour() const;
    virtual void SetBackgroundColour( const wxColour &colour );
    virtual wxColour GetForegroundColour() const;
    virtual void SetForegroundColour( const wxColour &colour );

    // fonts
    // -----

    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, bool use16 = FALSE) const;

    virtual void SetFont( const wxFont &font );
    virtual wxFont& GetFont() { return m_font; }

    // For backward compatibility
    virtual void SetButtonFont(const wxFont& font) { SetFont(font); }
    virtual void SetLabelFont(const wxFont& font) { SetFont(font); }
    virtual wxFont& GetLabelFont() { return GetFont(); };
    virtual wxFont& GetButtonFont() { return GetFont(); };

    virtual void SetWindowStyleFlag( long flag );
    virtual long GetWindowStyleFlag() const;

    virtual void CaptureMouse();
    virtual void ReleaseMouse();

    virtual void SetTitle( const wxString &title );
    virtual wxString GetTitle() const;
    virtual void SetName( const wxString &name );
    virtual wxString GetName() const;
    virtual wxString GetLabel() const;

    void OnSysColourChanged( wxSysColourChangedEvent &WXUNUSED(event) ) { }
    void OnKeyDown( wxKeyEvent &event );

    virtual bool IsShown() const;

    virtual void Raise();
    virtual void Lower();

    virtual bool IsRetained();
    virtual wxWindow *FindWindow( long id );
    virtual wxWindow *FindWindow( const wxString& name );

    void AllowDoubleClick( bool WXUNUSED(allow) ) { }
    void SetDoubleClick( bool WXUNUSED(allow) ) { }

    virtual void ClientToScreen( int *x, int *y );
    virtual void ScreenToClient( int *x, int *y );

    virtual bool Validate();
    virtual bool TransferDataToWindow();
    virtual bool TransferDataFromWindow();
    void OnInitDialog( wxInitDialogEvent &event );
    virtual void InitDialog();

    virtual bool PopupMenu( wxMenu *menu, int x, int y );

#if wxUSE_DRAG_AND_DROP
    virtual void SetDropTarget( wxDropTarget *dropTarget );
    virtual wxDropTarget *GetDropTarget() const;
#endif

    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 );

    virtual bool AcceptsFocus() const;

    void UpdateWindowUI();

    // implementation

    bool HasVMT();

    /* I don't want users to override what's done in idle so everything that
       has to be done in idle time in order for wxGTK to work is done in
       OnInternalIdle */
    virtual void OnInternalIdle();

    /* For compatibility across platforms (not in event table) */
    void OnIdle(wxIdleEvent& WXUNUSED(event)) {};

    /* used by all classes in the widget creation process */
    void PreCreation( wxWindow *parent, wxWindowID id, const wxPoint &pos,
            const wxSize &size, long style, const wxString &name );
    void PostCreation();

    /* the methods below are required because many native widgets
       are composed of several subwidgets and setting a style for
       the widget means setting it for all subwidgets as well.
       also, it is nor clear, which native widget is the top
       widget where (most of) the input goes. even tooltips have
       to be applied to all subwidgets. */

    virtual GtkWidget* GetConnectWidget();
    virtual bool IsOwnGtkWindow( GdkWindow *window );
    void ConnectWidget( GtkWidget *widget );

    GtkStyle *GetWidgetStyle();
    void SetWidgetStyle();
    virtual void ApplyWidgetStyle();

#if wxUSE_TOOLTIPS
    virtual void ApplyToolTip( GtkTooltips *tips, const char *tip );
#endif // wxUSE_TOOLTIPS

    /* private member variables */

    wxWindow            *m_parent;
    wxList               m_children;
    int                  m_x,m_y;
    int                  m_width,m_height;
    int                  m_minWidth,m_minHeight;
    int                  m_maxWidth,m_maxHeight;
    int                  m_retCode;
    wxEvtHandler        *m_eventHandler;
    wxValidator         *m_windowValidator;
#if wxUSE_DRAG_AND_DROP
    wxDropTarget        *m_dropTarget;
#endif
    wxWindowID           m_windowId;
    wxCursor            *m_cursor;
    wxFont               m_font;
    wxColour             m_backgroundColour;
    wxColour             m_foregroundColour;
    wxRegion             m_updateRegion;
    long                 m_windowStyle;
    bool                 m_isShown;
    bool                 m_isEnabled;
    wxString             m_windowName;
    wxAcceleratorTable   m_acceleratorTable;
    wxClientData        *m_clientObject;
    void                *m_clientData;

#if wxUSE_TOOLTIPS
    wxToolTip           *m_toolTip;
#endif // wxUSE_TOOLTIPS

    GtkWidget           *m_widget;
    GtkWidget           *m_wxwindow;
    GtkAdjustment       *m_hAdjust,*m_vAdjust;
    float                m_oldHorizontalPos;
    float                m_oldVerticalPos;
    bool                 m_needParent;    /* ! wxFrame, wxDialog, wxNotebookPage ?  */
    bool                 m_hasScrolling;
    bool                 m_isScrolling;
    bool                 m_hasVMT;
    bool                 m_sizeSet;
    bool                 m_resizing;
    GdkGC               *m_scrollGC;
    GtkStyle            *m_widgetStyle;
    bool                 m_isStaticBox;   /* faster than IS_KIND_OF */
    bool                 m_isFrame;       /* faster than IS_KIND_OF */
    bool                 m_acceptsFocus;  /* ! wxStaticBox etc.  */

    wxInsertChildFunction  m_insertCallback;

public:

    wxLayoutConstraints *m_constraints;
    wxList              *m_constraintsInvolvedIn;
    wxSizer             *m_windowSizer;
    wxWindow            *m_sizerParent;
    bool                 m_autoLayout;

    wxLayoutConstraints *GetConstraints() const;
    void SetConstraints( wxLayoutConstraints *constraints );
    void SetAutoLayout( bool autoLayout );
    bool GetAutoLayout() const;
    bool Layout();
    void SetSizer( wxSizer *sizer );
    wxSizer *GetSizer() const;
    void SetSizerParent( wxWindow *win );
    wxWindow *GetSizerParent() const;
    void UnsetConstraints(wxLayoutConstraints *c);
    inline wxList *GetConstraintsInvolvedIn() const ;
    void AddConstraintReference(wxWindow *otherWin);
    void RemoveConstraintReference(wxWindow *otherWin);
    void DeleteRelatedConstraints();
    virtual void ResetConstraints();
    virtual void SetConstraintSizes(bool recurse = TRUE);
    virtual bool LayoutPhase1(int *noChanges);
    virtual bool LayoutPhase2(int *noChanges);
    virtual bool DoPhase(int);
    virtual void TransformSizerToActual(int *x, int *y) const ;
    virtual void SizerSetSize(int x, int y, int w, int h);
    virtual void SizerMove(int x, int y);
    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) const ;
    virtual void GetClientSizeConstraint(int *w, int *h) const ;
    virtual void GetPositionConstraint(int *x, int *y) const ;

protected:
    // common part of all ctors
    void Init();

    // this is the virtual function to be overriden in any derived class which
    // wants to change how SetSize() or Move() works - it is called by all
    // versions of these functions in the base class
    virtual void DoSetSize(int x, int y,
                           int width, int height,
                           int sizeFlags = wxSIZE_AUTO);

    // same as DoSetSize() for the client size
    virtual void DoSetClientSize(int width, int height);

private:
    DECLARE_EVENT_TABLE()
};

#endif // __GTKWINDOWH__