4f4c5fcfdf
This is a combination of running clang-tidy with modernize-use-nullptr check for some ports (GTK, X11, OSX) and manual changes to the ports for which it couldn't be used easily (MSW, DFB) and also manually updating the docs. Also replace NULL with null or nullptr in the comments as this is more consistent with the use of nullptr in the code and makes it simpler to grep for the remaining occurrences of NULL itself. And also use null in the assert messages. Only a few occurrences of "NULL" are still left in non-C files, mostly corresponding to unclear comments or string output which it might not be safe to change.
259 lines
9.6 KiB
C++
259 lines
9.6 KiB
C++
///////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/qt/window.h
|
|
// Purpose: wxWindow class
|
|
// Author: Peter Most, Javier Torres, Mariano Reingart
|
|
// Copyright: (c) 2009 wxWidgets dev team
|
|
// Licence: wxWindows licence
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_QT_WINDOW_H_
|
|
#define _WX_QT_WINDOW_H_
|
|
|
|
class QShortcut;
|
|
template < class T > class QList;
|
|
|
|
class QWidget;
|
|
class QScrollArea;
|
|
class QScrollBar;
|
|
class QPicture;
|
|
class QPainter;
|
|
|
|
class QPaintEvent;
|
|
class QResizeEvent;
|
|
class QWheelEvent;
|
|
class QKeyEvent;
|
|
class QMouseEvent;
|
|
class QEvent;
|
|
class QMoveEvent;
|
|
class QEvent;
|
|
class QEvent;
|
|
class QCloseEvent;
|
|
class QContextMenuEvent;
|
|
class QFocusEvent;
|
|
|
|
class WXDLLIMPEXP_FWD_CORE wxScrollBar;
|
|
class WXDLLIMPEXP_FWD_CORE wxQtShortcutHandler;
|
|
|
|
/* wxQt specific notes:
|
|
*
|
|
* Remember to implement the Qt object getters on all subclasses:
|
|
* - GetHandle() returns the Qt object
|
|
* - QtGetScrollBarsContainer() returns the widget where scrollbars are placed
|
|
* For example, for wxFrame, GetHandle() is the QMainWindow,
|
|
* QtGetScrollBarsContainer() is the central widget and QtGetContainer() is a widget
|
|
* in a layout inside the central widget that also contains the scrollbars.
|
|
* Return 0 from QtGetScrollBarsContainer() to disable SetScrollBar() and friends
|
|
* for wxWindow subclasses.
|
|
*
|
|
*
|
|
* Event handling is achieved by using the template class wxQtEventForwarder
|
|
* found in winevent_qt.(h|cpp) to send all Qt events here to QtHandleXXXEvent()
|
|
* methods. All these methods receive the Qt event and the handler. This is
|
|
* done because events of the containers (the scrolled part of the window) are
|
|
* sent to the same wxWindow instance, that must be able to differentiate them
|
|
* as some events need different handling (paintEvent) depending on that.
|
|
* We pass the QWidget pointer to all event handlers for consistency.
|
|
*/
|
|
class WXDLLIMPEXP_CORE wxWindowQt : public wxWindowBase
|
|
{
|
|
public:
|
|
wxWindowQt();
|
|
~wxWindowQt();
|
|
wxWindowQt(wxWindowQt *parent,
|
|
wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxString& name = wxASCII_STR(wxPanelNameStr));
|
|
|
|
bool Create(wxWindowQt *parent,
|
|
wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxString& name = wxASCII_STR(wxPanelNameStr));
|
|
|
|
// Used by all window classes in the widget creation process.
|
|
void PostCreation( bool generic = true );
|
|
|
|
void AddChild( wxWindowBase *child ) override;
|
|
|
|
virtual bool Show( bool show = true ) override;
|
|
|
|
virtual void SetLabel(const wxString& label) override;
|
|
virtual wxString GetLabel() const override;
|
|
|
|
virtual void DoEnable( bool enable ) override;
|
|
virtual void SetFocus() override;
|
|
|
|
// Parent/Child:
|
|
static void QtReparent( QWidget *child, QWidget *parent );
|
|
virtual bool Reparent( wxWindowBase *newParent ) override;
|
|
|
|
// Z-order
|
|
virtual void Raise() override;
|
|
virtual void Lower() override;
|
|
|
|
// move the mouse to the specified position
|
|
virtual void WarpPointer(int x, int y) override;
|
|
|
|
virtual void Update() override;
|
|
virtual void Refresh( bool eraseBackground = true,
|
|
const wxRect *rect = nullptr ) override;
|
|
|
|
virtual bool SetCursor( const wxCursor &cursor ) override;
|
|
virtual bool SetFont(const wxFont& font) override;
|
|
|
|
// get the (average) character size for the current font
|
|
virtual int GetCharHeight() const override;
|
|
virtual int GetCharWidth() const override;
|
|
|
|
virtual void SetScrollbar( int orient,
|
|
int pos,
|
|
int thumbvisible,
|
|
int range,
|
|
bool refresh = true ) override;
|
|
virtual void SetScrollPos( int orient, int pos, bool refresh = true ) override;
|
|
virtual int GetScrollPos( int orient ) const override;
|
|
virtual int GetScrollThumb( int orient ) const override;
|
|
virtual int GetScrollRange( int orient ) const override;
|
|
|
|
// scroll window to the specified position
|
|
virtual void ScrollWindow( int dx, int dy,
|
|
const wxRect* rect = nullptr ) override;
|
|
|
|
// Styles
|
|
virtual void SetWindowStyleFlag( long style ) override;
|
|
virtual void SetExtraStyle( long exStyle ) override;
|
|
|
|
virtual bool SetBackgroundStyle(wxBackgroundStyle style) override;
|
|
virtual bool IsTransparentBackgroundSupported(wxString* reason = nullptr) const override;
|
|
virtual bool SetTransparent(wxByte alpha) override;
|
|
virtual bool CanSetTransparent() override { return true; }
|
|
|
|
virtual bool SetBackgroundColour(const wxColour& colour) override;
|
|
virtual bool SetForegroundColour(const wxColour& colour) override;
|
|
|
|
QWidget *GetHandle() const override;
|
|
|
|
#if wxUSE_DRAG_AND_DROP
|
|
virtual void SetDropTarget( wxDropTarget *dropTarget ) override;
|
|
#endif
|
|
|
|
#if wxUSE_ACCEL
|
|
// accelerators
|
|
// ------------
|
|
virtual void SetAcceleratorTable( const wxAcceleratorTable& accel ) override;
|
|
#endif // wxUSE_ACCEL
|
|
|
|
// wxQt implementation internals:
|
|
|
|
// Caller maintains ownership of pict - window will NOT delete it
|
|
void QtSetPicture( QPicture* pict );
|
|
|
|
QPainter *QtGetPainter();
|
|
|
|
virtual bool QtHandlePaintEvent ( QWidget *handler, QPaintEvent *event );
|
|
virtual bool QtHandleResizeEvent ( QWidget *handler, QResizeEvent *event );
|
|
virtual bool QtHandleWheelEvent ( QWidget *handler, QWheelEvent *event );
|
|
virtual bool QtHandleKeyEvent ( QWidget *handler, QKeyEvent *event );
|
|
virtual bool QtHandleMouseEvent ( QWidget *handler, QMouseEvent *event );
|
|
virtual bool QtHandleEnterEvent ( QWidget *handler, QEvent *event );
|
|
virtual bool QtHandleMoveEvent ( QWidget *handler, QMoveEvent *event );
|
|
virtual bool QtHandleShowEvent ( QWidget *handler, QEvent *event );
|
|
virtual bool QtHandleChangeEvent ( QWidget *handler, QEvent *event );
|
|
virtual bool QtHandleCloseEvent ( QWidget *handler, QCloseEvent *event );
|
|
virtual bool QtHandleContextMenuEvent ( QWidget *handler, QContextMenuEvent *event );
|
|
virtual bool QtHandleFocusEvent ( QWidget *handler, QFocusEvent *event );
|
|
|
|
static void QtStoreWindowPointer( QWidget *widget, const wxWindowQt *window );
|
|
static wxWindowQt *QtRetrieveWindowPointer( const QWidget *widget );
|
|
static void QtSendSetCursorEvent(wxWindowQt* win, wxPoint posClient);
|
|
|
|
#if wxUSE_ACCEL
|
|
virtual void QtHandleShortcut ( int command );
|
|
#endif // wxUSE_ACCEL
|
|
|
|
virtual QScrollArea *QtGetScrollBarsContainer() const;
|
|
|
|
#if wxUSE_TOOLTIPS
|
|
// applies tooltip to the widget.
|
|
virtual void QtApplyToolTip(const wxString& text);
|
|
#endif // wxUSE_TOOLTIPS
|
|
|
|
protected:
|
|
virtual void DoGetTextExtent(const wxString& string,
|
|
int *x, int *y,
|
|
int *descent = nullptr,
|
|
int *externalLeading = nullptr,
|
|
const wxFont *font = nullptr) const override;
|
|
|
|
// coordinates translation
|
|
virtual void DoClientToScreen( int *x, int *y ) const override;
|
|
virtual void DoScreenToClient( int *x, int *y ) const override;
|
|
|
|
// capture/release the mouse, used by Capture/ReleaseMouse()
|
|
virtual void DoCaptureMouse() override;
|
|
virtual void DoReleaseMouse() override;
|
|
|
|
// retrieve the position/size of the window
|
|
virtual void DoGetPosition(int *x, int *y) const override;
|
|
|
|
virtual void DoSetSize(int x, int y, int width, int height, int sizeFlags = wxSIZE_AUTO) override;
|
|
virtual void DoGetSize(int *width, int *height) const override;
|
|
|
|
// same as DoSetSize() for the client size
|
|
virtual void DoSetClientSize(int width, int height) override;
|
|
virtual void DoGetClientSize(int *width, int *height) const override;
|
|
|
|
virtual void DoMoveWindow(int x, int y, int width, int height) override;
|
|
|
|
#if wxUSE_TOOLTIPS
|
|
virtual void DoSetToolTip( wxToolTip *tip ) override;
|
|
#endif // wxUSE_TOOLTIPS
|
|
|
|
#if wxUSE_MENUS
|
|
virtual bool DoPopupMenu(wxMenu *menu, int x, int y) override;
|
|
#endif // wxUSE_MENUS
|
|
|
|
// Return the parent to use for children being reparented to us: this is
|
|
// overridden in wxFrame to use its central widget rather than the frame
|
|
// itself.
|
|
virtual QWidget* QtGetParentWidget() const { return GetHandle(); }
|
|
|
|
virtual bool EnableTouchEvents(int eventsMask) override;
|
|
|
|
QWidget *m_qtWindow;
|
|
|
|
private:
|
|
void Init();
|
|
QScrollArea *m_qtContainer; // either nullptr or the same as m_qtWindow pointer
|
|
|
|
QScrollBar *m_horzScrollBar; // owned by m_qtWindow when allocated
|
|
QScrollBar *m_vertScrollBar; // owned by m_qtWindow when allocated
|
|
|
|
// Return the viewport of m_qtContainer, if it's used, or just m_qtWindow.
|
|
//
|
|
// Always returns non-null pointer if the window has been already created.
|
|
QWidget *QtGetClientWidget() const;
|
|
|
|
QScrollBar *QtGetScrollBar( int orientation ) const;
|
|
QScrollBar *QtSetScrollBar( int orientation, QScrollBar *scrollBar=nullptr );
|
|
|
|
bool QtSetBackgroundStyle();
|
|
|
|
QPicture *m_qtPicture; // not owned
|
|
wxScopedPtr<QPainter> m_qtPainter; // always allocated
|
|
|
|
bool m_mouseInside;
|
|
|
|
#if wxUSE_ACCEL
|
|
wxVector<QShortcut*> m_qtShortcuts; // owned by whatever GetHandle() returns
|
|
wxScopedPtr<wxQtShortcutHandler> m_qtShortcutHandler; // always allocated
|
|
bool m_processingShortcut;
|
|
#endif // wxUSE_ACCEL
|
|
|
|
wxDECLARE_DYNAMIC_CLASS_NO_COPY( wxWindowQt );
|
|
};
|
|
|
|
#endif // _WX_QT_WINDOW_H_
|