qwidget.h
This is the verbatim text of the qwidget.h include file. It is provided only for illustration; the copyright remains with Trolltech.
/****************************************************************************
** $Id$
**
** Definition of QWidget class
**
** Created : 931029
**
** Copyright (C) 1992-2003 Trolltech AS. All rights reserved.
**
** This file is part of the kernel module of the Qt GUI Toolkit.
**
** This file may be distributed under the terms of the Q Public License
** as defined by Trolltech AS of Norway and appearing in the file
** LICENSE.QPL included in the packaging of this file.
**
** This file may be distributed and/or modified under the terms of the
** GNU General Public License version 2 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.
**
** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
** licenses may use this file in accordance with the Qt Commercial License
** Agreement provided with the Software.
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
** information about Qt Commercial License Agreements.
** See http://www.trolltech.com/qpl/ for QPL licensing information.
** See http://www.trolltech.com/gpl/ for GPL licensing information.
**
** Contact info@trolltech.com if any conditions of this licensing are
** not clear to you.
**
**********************************************************************/
#ifndef QWIDGET_H
#define QWIDGET_H
#ifndef QT_H
#include "qwindowdefs.h"
#include "qobject.h"
#include "qpaintdevice.h"
#include "qpalette.h"
#include "qfont.h"
#include "qfontmetrics.h"
#include "qfontinfo.h"
#include "qsizepolicy.h"
#endif // QT_H
class QLayout;
struct QWExtra;
struct QTLWExtra;
class QFocusData;
class QCursor;
class QWSRegionManager;
class QStyle;
class Q_EXPORT QWidget : public QObject, public QPaintDevice
{
Q_OBJECT
Q_ENUMS( BackgroundMode FocusPolicy BackgroundOrigin )
Q_PROPERTY( bool isTopLevel READ isTopLevel )
Q_PROPERTY( bool isDialog READ isDialog )
Q_PROPERTY( bool isModal READ isModal )
Q_PROPERTY( bool isPopup READ isPopup )
Q_PROPERTY( bool isDesktop READ isDesktop )
Q_PROPERTY( bool enabled READ isEnabled WRITE setEnabled )
Q_PROPERTY( QRect geometry READ geometry WRITE setGeometry )
Q_PROPERTY( QRect frameGeometry READ frameGeometry )
Q_PROPERTY( int x READ x )
Q_PROPERTY( int y READ y )
Q_PROPERTY( QPoint pos READ pos WRITE move DESIGNABLE false STORED false )
Q_PROPERTY( QSize frameSize READ frameSize )
Q_PROPERTY( QSize size READ size WRITE resize DESIGNABLE false STORED false )
Q_PROPERTY( int width READ width )
Q_PROPERTY( int height READ height )
Q_PROPERTY( QRect rect READ rect )
Q_PROPERTY( QRect childrenRect READ childrenRect )
Q_PROPERTY( QRegion childrenRegion READ childrenRegion )
Q_PROPERTY( QSizePolicy sizePolicy READ sizePolicy WRITE setSizePolicy )
Q_PROPERTY( QSize minimumSize READ minimumSize WRITE setMinimumSize )
Q_PROPERTY( QSize maximumSize READ maximumSize WRITE setMaximumSize )
Q_PROPERTY( int minimumWidth READ minimumWidth WRITE setMinimumWidth STORED false DESIGNABLE false )
Q_PROPERTY( int minimumHeight READ minimumHeight WRITE setMinimumHeight STORED false DESIGNABLE false )
Q_PROPERTY( int maximumWidth READ maximumWidth WRITE setMaximumWidth STORED false DESIGNABLE false )
Q_PROPERTY( int maximumHeight READ maximumHeight WRITE setMaximumHeight STORED false DESIGNABLE false )
Q_PROPERTY( QSize sizeIncrement READ sizeIncrement WRITE setSizeIncrement )
Q_PROPERTY( QSize baseSize READ baseSize WRITE setBaseSize )
Q_PROPERTY( BackgroundMode backgroundMode READ backgroundMode WRITE setBackgroundMode DESIGNABLE false )
Q_PROPERTY( QColor paletteForegroundColor READ paletteForegroundColor WRITE setPaletteForegroundColor RESET unsetPalette )
Q_PROPERTY( QColor paletteBackgroundColor READ paletteBackgroundColor WRITE setPaletteBackgroundColor RESET unsetPalette )
Q_PROPERTY( QPixmap paletteBackgroundPixmap READ paletteBackgroundPixmap WRITE setPaletteBackgroundPixmap RESET unsetPalette )
Q_PROPERTY( QBrush backgroundBrush READ backgroundBrush )
Q_PROPERTY( QColorGroup colorGroup READ colorGroup )
Q_PROPERTY( QPalette palette READ palette WRITE setPalette RESET unsetPalette STORED ownPalette )
Q_PROPERTY( BackgroundOrigin backgroundOrigin READ backgroundOrigin WRITE setBackgroundOrigin )
Q_PROPERTY( bool ownPalette READ ownPalette )
Q_PROPERTY( QFont font READ font WRITE setFont RESET unsetFont STORED ownFont )
Q_PROPERTY( bool ownFont READ ownFont )
#ifndef QT_NO_CURSOR
Q_PROPERTY( QCursor cursor READ cursor WRITE setCursor RESET unsetCursor STORED ownCursor )
Q_PROPERTY( bool ownCursor READ ownCursor )
#endif
#ifndef QT_NO_WIDGET_TOPEXTRA
Q_PROPERTY( QString caption READ caption WRITE setCaption )
Q_PROPERTY( QPixmap icon READ icon WRITE setIcon )
Q_PROPERTY( QString iconText READ iconText WRITE setIconText )
#endif
Q_PROPERTY( bool mouseTracking READ hasMouseTracking WRITE setMouseTracking )
Q_PROPERTY( bool underMouse READ hasMouse )
Q_PROPERTY( bool isActiveWindow READ isActiveWindow )
Q_PROPERTY( bool focusEnabled READ isFocusEnabled )
Q_PROPERTY( FocusPolicy focusPolicy READ focusPolicy WRITE setFocusPolicy )
Q_PROPERTY( bool focus READ hasFocus )
Q_PROPERTY( bool updatesEnabled READ isUpdatesEnabled WRITE setUpdatesEnabled DESIGNABLE false )
Q_PROPERTY( bool visible READ isVisible )
Q_PROPERTY( QRect visibleRect READ visibleRect ) // obsolete
Q_PROPERTY( bool hidden READ isHidden WRITE setHidden DESIGNABLE false SCRIPTABLE false )
Q_PROPERTY( bool shown READ isShown WRITE setShown DESIGNABLE false SCRIPTABLE false )
Q_PROPERTY( bool minimized READ isMinimized )
Q_PROPERTY( bool maximized READ isMaximized )
Q_PROPERTY( bool fullScreen READ isFullScreen )
Q_PROPERTY( QSize sizeHint READ sizeHint )
Q_PROPERTY( QSize minimumSizeHint READ minimumSizeHint )
Q_PROPERTY( QRect microFocusHint READ microFocusHint )
Q_PROPERTY( bool acceptDrops READ acceptDrops WRITE setAcceptDrops )
Q_PROPERTY( bool autoMask READ autoMask WRITE setAutoMask DESIGNABLE false SCRIPTABLE false )
Q_PROPERTY( bool customWhatsThis READ customWhatsThis )
Q_PROPERTY( bool inputMethodEnabled READ isInputMethodEnabled WRITE setInputMethodEnabled DESIGNABLE false SCRIPTABLE false )
public:
Q_EXPLICIT QWidget( QWidget* parent=0, const char* name=0, WFlags f=0 );
~QWidget();
WId winId() const;
void setName( const char *name );
#ifndef QT_NO_STYLE
// GUI style setting
QStyle &style() const;
void setStyle( QStyle * );
QStyle* setStyle( const QString& );
#endif
// Widget types and states
bool isTopLevel() const;
bool isDialog() const;
bool isPopup() const;
bool isDesktop() const;
bool isModal() const;
bool isEnabled() const;
bool isEnabledTo(QWidget*) const;
bool isEnabledToTLW() const;
public slots:
virtual void setEnabled( bool );
void setDisabled( bool );
// Widget coordinates
public:
QRect frameGeometry() const;
const QRect &geometry() const;
int x() const;
int y() const;
QPoint pos() const;
QSize frameSize() const;
QSize size() const;
int width() const;
int height() const;
QRect rect() const;
QRect childrenRect() const;
QRegion childrenRegion() const;
QSize minimumSize() const;
QSize maximumSize() const;
int minimumWidth() const;
int minimumHeight() const;
int maximumWidth() const;
int maximumHeight() const;
void setMinimumSize( const QSize & );
virtual void setMinimumSize( int minw, int minh );
void setMaximumSize( const QSize & );
virtual void setMaximumSize( int maxw, int maxh );
void setMinimumWidth( int minw );
void setMinimumHeight( int minh );
void setMaximumWidth( int maxw );
void setMaximumHeight( int maxh );
QSize sizeIncrement() const;
void setSizeIncrement( const QSize & );
virtual void setSizeIncrement( int w, int h );
QSize baseSize() const;
void setBaseSize( const QSize & );
void setBaseSize( int basew, int baseh );
void setFixedSize( const QSize & );
void setFixedSize( int w, int h );
void setFixedWidth( int w );
void setFixedHeight( int h );
// Widget coordinate mapping
QPoint mapToGlobal( const QPoint & ) const;
QPoint mapFromGlobal( const QPoint & ) const;
QPoint mapToParent( const QPoint & ) const;
QPoint mapFromParent( const QPoint & ) const;
QPoint mapTo( QWidget *, const QPoint & ) const;
QPoint mapFrom( QWidget *, const QPoint & ) const;
QWidget *topLevelWidget() const;
// Widget attribute functions
BackgroundMode backgroundMode() const;
virtual void setBackgroundMode( BackgroundMode );
void setBackgroundMode( BackgroundMode, BackgroundMode );
const QColor & foregroundColor() const;
const QColor & eraseColor() const;
virtual void setEraseColor( const QColor & );
const QPixmap * erasePixmap() const;
virtual void setErasePixmap( const QPixmap & );
#ifndef QT_NO_PALETTE
const QColorGroup & colorGroup() const;
const QPalette & palette() const;
bool ownPalette() const;
virtual void setPalette( const QPalette & );
void unsetPalette();
#endif
const QColor & paletteForegroundColor() const;
void setPaletteForegroundColor( const QColor & );
const QColor & paletteBackgroundColor() const;
virtual void setPaletteBackgroundColor( const QColor & );
const QPixmap * paletteBackgroundPixmap() const;
virtual void setPaletteBackgroundPixmap( const QPixmap & );
const QBrush& backgroundBrush() const;
QFont font() const;
bool ownFont() const;
virtual void setFont( const QFont & );
void unsetFont();
QFontMetrics fontMetrics() const;
QFontInfo fontInfo() const;
#ifndef QT_NO_CURSOR
const QCursor &cursor() const;
bool ownCursor() const;
virtual void setCursor( const QCursor & );
virtual void unsetCursor();
#endif
#ifndef QT_NO_WIDGET_TOPEXTRA
QString caption() const;
const QPixmap *icon() const;
QString iconText() const;
#endif
bool hasMouseTracking() const;
bool hasMouse() const;
virtual void setMask( const QBitmap & );
virtual void setMask( const QRegion & );
void clearMask();
const QColor & backgroundColor() const; // obsolete, use eraseColor()
virtual void setBackgroundColor( const QColor & ); // obsolete, use setEraseColor()
const QPixmap * backgroundPixmap() const; // obsolete, use erasePixmap()
virtual void setBackgroundPixmap( const QPixmap & ); // obsolete, use setErasePixmap()
public slots:
#ifndef QT_NO_WIDGET_TOPEXTRA
virtual void setCaption( const QString &);
virtual void setIcon( const QPixmap & );
virtual void setIconText( const QString &);
#endif
virtual void setMouseTracking( bool enable );
// Keyboard input focus functions
virtual void setFocus();
void clearFocus();
public:
enum FocusPolicy {
NoFocus = 0,
TabFocus = 0x1,
ClickFocus = 0x2,
StrongFocus = TabFocus | ClickFocus | 0x8,
WheelFocus = StrongFocus | 0x4
};
bool isActiveWindow() const;
virtual void setActiveWindow();
bool isFocusEnabled() const;
FocusPolicy focusPolicy() const;
virtual void setFocusPolicy( FocusPolicy );
bool hasFocus() const;
static void setTabOrder( QWidget *, QWidget * );
virtual void setFocusProxy( QWidget * );
QWidget * focusProxy() const;
void setInputMethodEnabled( bool b );
bool isInputMethodEnabled() const;
// Grab functions
void grabMouse();
#ifndef QT_NO_CURSOR
void grabMouse( const QCursor & );
#endif
void releaseMouse();
void grabKeyboard();
void releaseKeyboard();
static QWidget * mouseGrabber();
static QWidget * keyboardGrabber();
// Update/refresh functions
bool isUpdatesEnabled() const;
#if 0 //def Q_WS_QWS
void repaintUnclipped( const QRegion &, bool erase = TRUE );
#endif
public slots:
virtual void setUpdatesEnabled( bool enable );
void update();
void update( int x, int y, int w, int h );
void update( const QRect& );
void repaint();
void repaint( bool erase );
void repaint( int x, int y, int w, int h, bool erase=TRUE );
void repaint( const QRect &, bool erase = TRUE );
void repaint( const QRegion &, bool erase = TRUE );
// Widget management functions
virtual void show();
virtual void hide();
void setShown( bool show );
void setHidden( bool hide );
#ifndef QT_NO_COMPAT
void iconify() { showMinimized(); }
#endif
virtual void showMinimized();
virtual void showMaximized();
void showFullScreen();
virtual void showNormal();
virtual void polish();
void constPolish() const;
bool close();
void raise();
void lower();
void stackUnder( QWidget* );
virtual void move( int x, int y );
void move( const QPoint & );
virtual void resize( int w, int h );
void resize( const QSize & );
virtual void setGeometry( int x, int y, int w, int h );
virtual void setGeometry( const QRect & ); // ### make non virtual in Qt 4?
public:
virtual bool close( bool alsoDelete );
bool isVisible() const;
bool isVisibleTo(QWidget*) const;
bool isVisibleToTLW() const; // obsolete
QRect visibleRect() const; // obsolete
bool isHidden() const;
bool isShown() const;
bool isMinimized() const;
bool isMaximized() const;
bool isFullScreen() const;
virtual QSize sizeHint() const;
virtual QSize minimumSizeHint() const;
virtual QSizePolicy sizePolicy() const;
virtual void setSizePolicy( QSizePolicy );
void setSizePolicy( QSizePolicy::SizeType hor, QSizePolicy::SizeType ver, bool hfw = FALSE );
virtual int heightForWidth(int) const;
QRegion clipRegion() const;
// ### move together with other slots in Qt 4.0
public slots:
virtual void adjustSize();
public:
#ifndef QT_NO_LAYOUT
QLayout * layout() const { return lay_out; }
#endif
void updateGeometry();
virtual void reparent( QWidget *parent, WFlags, const QPoint &,
bool showIt=FALSE );
void reparent( QWidget *parent, const QPoint &,
bool showIt=FALSE );
#ifndef QT_NO_COMPAT
void recreate( QWidget *parent, WFlags f, const QPoint & p,
bool showIt=FALSE ) { reparent(parent,f,p,showIt); }
#endif
void erase();
void erase( int x, int y, int w, int h );
void erase( const QRect & );
void erase( const QRegion & );
void scroll( int dx, int dy );
void scroll( int dx, int dy, const QRect& );
void drawText( int x, int y, const QString &);
void drawText( const QPoint &, const QString &);
// Misc. functions
QWidget * focusWidget() const;
QRect microFocusHint() const;
// drag and drop
bool acceptDrops() const;
virtual void setAcceptDrops( bool on );
// transparency and pseudo transparency
virtual void setAutoMask(bool);
bool autoMask() const;
enum BackgroundOrigin { WidgetOrigin, ParentOrigin, WindowOrigin, AncestorOrigin };
virtual void setBackgroundOrigin( BackgroundOrigin );
BackgroundOrigin backgroundOrigin() const;
QPoint backgroundOffset() const;
// whats this help
virtual bool customWhatsThis() const;
QWidget * parentWidget( bool sameWindow = FALSE ) const;
WState testWState( WState s ) const;
WFlags testWFlags( WFlags f ) const;
static QWidget * find( WId );
static QWidgetMapper *wmapper();
QWidget *childAt( int x, int y, bool includeThis = FALSE ) const;
QWidget *childAt( const QPoint &, bool includeThis = FALSE ) const;
#if defined(Q_WS_QWS)
virtual QGfx * graphicsContext(bool clip_children=TRUE) const;
#endif
#if defined(Q_WS_MAC)
QRegion clippedRegion(bool do_children=TRUE);
uint clippedSerial(bool do_children=TRUE);
#ifndef QMAC_NO_QUARTZ
CGContextRef macCGContext(bool clipped=TRUE) const;
#endif
#endif
protected:
// Event handlers
bool event( QEvent * );
virtual void mousePressEvent( QMouseEvent * );
virtual void mouseReleaseEvent( QMouseEvent * );
virtual void mouseDoubleClickEvent( QMouseEvent * );
virtual void mouseMoveEvent( QMouseEvent * );
#ifndef QT_NO_WHEELEVENT
virtual void wheelEvent( QWheelEvent * );
#endif
virtual void keyPressEvent( QKeyEvent * );
virtual void keyReleaseEvent( QKeyEvent * );
virtual void focusInEvent( QFocusEvent * );
virtual void focusOutEvent( QFocusEvent * );
virtual void enterEvent( QEvent * );
virtual void leaveEvent( QEvent * );
virtual void paintEvent( QPaintEvent * );
virtual void moveEvent( QMoveEvent * );
virtual void resizeEvent( QResizeEvent * );
virtual void closeEvent( QCloseEvent * );
virtual void contextMenuEvent( QContextMenuEvent * );
virtual void imStartEvent( QIMEvent * );
virtual void imComposeEvent( QIMEvent * );
virtual void imEndEvent( QIMEvent * );
virtual void tabletEvent( QTabletEvent * );
#ifndef QT_NO_DRAGANDDROP
virtual void dragEnterEvent( QDragEnterEvent * );
virtual void dragMoveEvent( QDragMoveEvent * );
virtual void dragLeaveEvent( QDragLeaveEvent * );
virtual void dropEvent( QDropEvent * );
#endif
virtual void showEvent( QShowEvent * );
virtual void hideEvent( QHideEvent * );
#if defined(Q_WS_MAC)
virtual bool macEvent( MSG * );
#endif
#if defined(Q_WS_WIN)
virtual bool winEvent( MSG * );
#endif
#if defined(Q_WS_X11)
virtual bool x11Event( XEvent * );
#endif
#if defined(Q_WS_QWS)
virtual bool qwsEvent( QWSEvent * );
virtual unsigned char *scanLine( int ) const;
virtual int bytesPerLine() const;
#endif
virtual void updateMask();
// Misc. protected functions
#ifndef QT_NO_STYLE
virtual void styleChange( QStyle& );
#endif
virtual void enabledChange( bool oldEnabled );
#ifndef QT_NO_PALETTE
virtual void paletteChange( const QPalette & );
#endif
virtual void fontChange( const QFont & );
virtual void windowActivationChange( bool oldActive );
int metric( int ) const;
void resetInputContext();
virtual void create( WId = 0, bool initializeWindow = TRUE,
bool destroyOldWindow = TRUE );
virtual void destroy( bool destroyWindow = TRUE,
bool destroySubWindows = TRUE );
uint getWState() const;
virtual void setWState( uint );
void clearWState( uint n );
WFlags getWFlags() const;
virtual void setWFlags( WFlags );
void clearWFlags( WFlags n );
virtual bool focusNextPrevChild( bool next );
QWExtra *extraData();
QTLWExtra *topData();
QFocusData *focusData();
virtual void setKeyCompression(bool);
virtual void setMicroFocusHint(int x, int y, int w, int h, bool text=TRUE, QFont *f = 0);
#if defined(Q_WS_MAC)
void dirtyClippedRegion(bool);
bool isClippedRegionDirty();
virtual void setRegionDirty(bool);
virtual void macWidgetChangedWindow();
#endif
private slots:
void focusProxyDestroyed();
private:
void setFontSys( QFont *f = 0 );
#if defined(Q_WS_X11)
void createInputContext();
void destroyInputContext();
void focusInputContext();
void checkChildrenDnd();
#elif defined(Q_WS_MAC)
uint own_id : 1, macDropEnabled : 1;
EventHandlerRef window_event;
//mac event functions
void propagateUpdates(bool update_rgn=TRUE);
void update( const QRegion& );
//friends, way too many - fix this immediately!
friend void qt_clean_root_win();
friend bool qt_recreate_root_win();
friend QPoint posInWindow(QWidget *);
friend bool qt_mac_update_sizer(QWidget *, int);
friend QWidget *qt_recursive_match(QWidget *widg, int x, int y);
friend bool qt_paint_children(QWidget *,QRegion &, uchar ops);
friend QMAC_PASCAL OSStatus qt_window_event(EventHandlerCallRef er, EventRef event, void *);
friend void qt_event_request_updates(QWidget *, const QRegion &, bool subtract=FALSE);
friend bool qt_window_rgn(WId, short, RgnHandle, bool);
friend class QDragManager;
#endif
#ifndef QT_NO_LAYOUT
void setLayout( QLayout *l );
#endif
void setWinId( WId );
void showWindow();
void hideWindow();
void showChildren( bool spontaneous );
void hideChildren( bool spontaneous );
void reparentSys( QWidget *parent, WFlags, const QPoint &, bool showIt);
void createTLExtra();
void createExtra();
void deleteExtra();
void createSysExtra();
void deleteSysExtra();
void createTLSysExtra();
void deleteTLSysExtra();
void deactivateWidgetCleanup();
void internalSetGeometry( int, int, int, int, bool );
void reparentFocusWidgets( QWidget * );
QFocusData *focusData( bool create );
void setBackgroundFromMode();
void setBackgroundColorDirect( const QColor & );
void setBackgroundPixmapDirect( const QPixmap & );
void setBackgroundModeDirect( BackgroundMode );
void setBackgroundEmpty();
void updateFrameStrut() const;
#if defined(Q_WS_X11)
void setBackgroundX11Relative();
#endif
WId winid;
uint widget_state;
uint widget_flags;
uint focus_policy : 4;
uint own_font :1;
uint own_palette :1;
uint sizehint_forced :1;
uint is_closing :1;
uint in_show : 1;
uint in_show_maximized : 1;
uint fstrut_dirty : 1;
uint im_enabled : 1;
QRect crect;
QColor bg_col;
#ifndef QT_NO_PALETTE
QPalette pal;
#endif
QFont fnt;
#ifndef QT_NO_LAYOUT
QLayout *lay_out;
#endif
QWExtra *extra;
#if defined(Q_WS_QWS)
QRegion req_region; // Requested region
mutable QRegion paintable_region; // Paintable region
mutable bool paintable_region_dirty;// needs to be recalculated
mutable QRegion alloc_region; // Allocated region
mutable bool alloc_region_dirty; // needs to be recalculated
mutable int overlapping_children; // Handle overlapping children
int alloc_region_index;
int alloc_region_revision;
void updateOverlappingChildren() const;
void setChildrenAllocatedDirty();
void setChildrenAllocatedDirty( const QRegion &r, const QWidget *dirty=0 );
bool isAllocatedRegionDirty() const;
void updateRequestedRegion( const QPoint &gpos );
QRegion requestedRegion() const;
QRegion allocatedRegion() const;
QRegion paintableRegion() const;
void setActivePainter( QPainter *painter ) const;
void clearActivePainter() const;
void updateActivePainter() const;
void updateGraphicsContext( QGfx *qgfx_qws, bool clip_children ) const;
#ifndef QT_NO_CURSOR
void updateCursor( const QRegion &r ) const;
#endif
// used to accumulate dirty region when children moved/resized.
QRegion dirtyChildren;
bool isSettingGeometry;
friend class QWSManager;
#endif
static int instanceCounter; // Current number of widget instances
static int maxInstances; // Maximum number of widget instances
static void createMapper();
static void destroyMapper();
static QWidgetList *wList();
static QWidgetList *tlwList();
static QWidgetMapper *mapper;
friend class QApplication;
friend class QBaseApplication;
friend class QPainter;
friend class QFontMetrics;
friend class QFontInfo;
friend class QETWidget;
friend class QLayout;
private: // Disabled copy constructor and operator=
#if defined(Q_DISABLE_COPY)
QWidget( const QWidget & );
QWidget &operator=( const QWidget & );
#endif
public: // obsolete functions to dissappear or to become inline in 3.0
#ifndef QT_NO_PALETTE
void setPalette( const QPalette &p, bool ) { setPalette( p ); }
#endif
void setFont( const QFont &f, bool ) { setFont( f ); }
};
inline Qt::WState QWidget::testWState( WState s ) const
{ return (widget_state & s); }
inline Qt::WFlags QWidget::testWFlags( WFlags f ) const
{ return (widget_flags & f); }
inline WId QWidget::winId() const
{ return winid; }
inline bool QWidget::isTopLevel() const
{ return testWFlags(WType_TopLevel); }
inline bool QWidget::isDialog() const
{ return testWFlags(WType_Dialog); }
inline bool QWidget::isPopup() const
{ return testWFlags(WType_Popup); }
inline bool QWidget::isDesktop() const
{ return testWFlags(WType_Desktop); }
inline bool QWidget::isEnabled() const
{ return !testWState(WState_Disabled); }
inline bool QWidget::isModal() const
{ return testWFlags(WShowModal); }
inline bool QWidget::isEnabledToTLW() const
{ return isEnabled(); }
inline const QRect &QWidget::geometry() const
{ return crect; }
inline QSize QWidget::size() const
{ return crect.size(); }
inline int QWidget::width() const
{ return crect.width(); }
inline int QWidget::height() const
{ return crect.height(); }
inline QRect QWidget::rect() const
{ return QRect(0,0,crect.width(),crect.height()); }
inline int QWidget::minimumWidth() const
{ return minimumSize().width(); }
inline int QWidget::minimumHeight() const
{ return minimumSize().height(); }
inline int QWidget::maximumWidth() const
{ return maximumSize().width(); }
inline int QWidget::maximumHeight() const
{ return maximumSize().height(); }
inline void QWidget::setMinimumSize( const QSize &s )
{ setMinimumSize(s.width(),s.height()); }
inline void QWidget::setMaximumSize( const QSize &s )
{ setMaximumSize(s.width(),s.height()); }
inline void QWidget::setSizeIncrement( const QSize &s )
{ setSizeIncrement(s.width(),s.height()); }
inline void QWidget::setBaseSize( const QSize &s )
{ setBaseSize(s.width(),s.height()); }
inline const QColor &QWidget::eraseColor() const
{ return bg_col; }
#ifndef QT_NO_PALETTE
inline const QPalette &QWidget::palette() const
{ return pal; }
#endif
inline QFont QWidget::font() const
{ return fnt; }
inline QFontMetrics QWidget::fontMetrics() const
{ return QFontMetrics(font()); }
inline QFontInfo QWidget::fontInfo() const
{ return QFontInfo(font()); }
inline bool QWidget::hasMouseTracking() const
{ return testWState(WState_MouseTracking); }
inline bool QWidget::hasMouse() const
{ return testWState(WState_HasMouse); }
inline bool QWidget::isFocusEnabled() const
{ return (FocusPolicy)focus_policy != NoFocus; }
inline QWidget::FocusPolicy QWidget::focusPolicy() const
{ return (FocusPolicy)focus_policy; }
inline bool QWidget::isUpdatesEnabled() const
{ return !testWState(WState_BlockUpdates); }
inline void QWidget::update( const QRect &r )
{ update( r.x(), r.y(), r.width(), r.height() ); }
inline void QWidget::repaint()
{ repaint( TRUE ); }
inline void QWidget::repaint( const QRect &r, bool erase )
{ repaint( r.x(), r.y(), r.width(), r.height(), erase ); }
inline void QWidget::erase()
{ erase( 0, 0, crect.width(), crect.height() ); }
inline void QWidget::erase( const QRect &r )
{ erase( r.x(), r.y(), r.width(), r.height() ); }
inline bool QWidget::close()
{ return close( FALSE ); }
inline bool QWidget::isVisible() const
{ return testWState(WState_Visible); }
inline bool QWidget::isVisibleToTLW() const // obsolete
{ return isVisible(); }
inline bool QWidget::isHidden() const
{ return testWState(WState_ForceHide); }
inline bool QWidget::isShown() const
{ return !testWState(WState_ForceHide); }
inline void QWidget::move( const QPoint &p )
{ move( p.x(), p.y() ); }
inline void QWidget::resize( const QSize &s )
{ resize( s.width(), s.height()); }
inline void QWidget::setGeometry( const QRect &r )
{ setGeometry( r.left(), r.top(), r.width(), r.height() ); }
inline void QWidget::drawText( const QPoint &p, const QString &s )
{ drawText( p.x(), p.y(), s ); }
inline QWidget *QWidget::parentWidget( bool sameWindow ) const
{
if ( sameWindow )
return isTopLevel() ? 0 : (QWidget *)QObject::parent();
return (QWidget *)QObject::parent();
}
inline QWidgetMapper *QWidget::wmapper()
{ return mapper; }
inline uint QWidget::getWState() const
{ return widget_state; }
inline void QWidget::setWState( uint f )
{ widget_state |= f; }
inline void QWidget::clearWState( uint f )
{ widget_state &= ~f; }
inline Qt::WFlags QWidget::getWFlags() const
{ return widget_flags; }
inline void QWidget::setWFlags( WFlags f )
{ widget_flags |= f; }
inline void QWidget::clearWFlags( WFlags f )
{ widget_flags &= ~f; }
inline void QWidget::constPolish() const
{
if ( !testWState(WState_Polished) ) {
QWidget* that = (QWidget*) this;
that->polish();
that->setWState(WState_Polished); // be on the safe side...
}
}
#ifndef QT_NO_CURSOR
inline bool QWidget::ownCursor() const
{
return testWState( WState_OwnCursor );
}
#endif
inline bool QWidget::ownFont() const
{
return own_font;
}
#ifndef QT_NO_PALETTE
inline bool QWidget::ownPalette() const
{
return own_palette;
}
#endif
inline void QWidget::setSizePolicy( QSizePolicy::SizeType hor, QSizePolicy::SizeType ver, bool hfw )
{
setSizePolicy( QSizePolicy( hor, ver, hfw) );
}
inline bool QWidget::isInputMethodEnabled() const
{
return (bool)im_enabled;
}
// Extra QWidget data
// - to minimize memory usage for members that are seldom used.
// - top-level widgets have extra extra data to reduce cost further
class QFocusData;
class QWSManager;
#if defined(Q_WS_WIN)
class QOleDropTarget;
#endif
#if defined(Q_WS_MAC)
class QMacDndExtra;
#endif
struct Q_EXPORT QTLWExtra {
#ifndef QT_NO_WIDGET_TOPEXTRA
QString caption; // widget caption
QString iconText; // widget icon text
QPixmap *icon; // widget icon
#endif
QFocusData *focusData; // focus data (for TLW)
short incw, inch; // size increments
// frame strut
ulong fleft, fright, ftop, fbottom;
uint iconic: 1; // iconified [cur. win32 only]
uint fullscreen : 1; // full-screen mode
uint showMode: 2; // 0 normal, 1 minimized, 2 maximized, 3 reset
uint savedFlags; // Save widgetflags while showing fullscreen
short basew, baseh; // base sizes
#if defined(Q_WS_X11)
WId parentWinId; // parent window Id (valid after reparenting)
uint embedded : 1; // window is embedded in another Qt application
uint spont_unmapped: 1; // window was spontaneously unmapped
uint reserved: 1; // reserved
uint dnd : 1; // DND properties installed
uint uspos : 1; // User defined position
uint ussize : 1; // User defined size
void *xic; // XIM Input Context
#endif
#if defined(Q_WS_MAC)
WindowGroupRef group;
uint is_moved: 1;
uint resizer : 4;
#endif
#if defined(Q_WS_QWS) && !defined ( QT_NO_QWS_MANAGER )
QRegion decor_allocated_region; // decoration allocated region
QWSManager *qwsManager;
#endif
#if defined(Q_WS_WIN)
HICON winIcon; // internal Windows icon
#endif
QRect normalGeometry; // used by showMin/maximized/FullScreen
};
#define QWIDGETSIZE_MAX 32767
// dear user: you can see this struct, but it is internal. do not touch.
struct Q_EXPORT QWExtra {
Q_INT16 minw, minh; // minimum size
Q_INT16 maxw, maxh; // maximum size
QPixmap *bg_pix; // background pixmap
QWidget *focus_proxy;
#ifndef QT_NO_CURSOR
QCursor *curs;
#endif
QTLWExtra *topextra; // only useful for TLWs
#if defined(Q_WS_WIN)
QOleDropTarget *dropTarget; // drop target
#endif
#if defined(Q_WS_X11)
WId xDndProxy; // XDND forwarding to embedded windows
#endif
#if defined(Q_WS_MAC)
QRegion clip_saved, clip_sibs, clip_children;
QMacDndExtra *macDndExtra;
QRegion dirty_area;
uint clip_dirty : 1, clip_serial : 15;
uint child_dirty : 1, child_serial : 15;
#ifndef QMAC_NO_QUARTZ
uint ctx_children_clipped:1;
#endif // QMAC_NO_QUARTZ
uint has_dirty_area:1;
#endif // Q_WS_MAC
uint bg_origin : 2;
#if defined(Q_WS_X11)
uint children_use_dnd : 1;
uint compress_events : 1;
#endif
#if defined(Q_WS_QWS) || defined(Q_WS_MAC)
QRegion mask; // widget mask
#endif
char bg_mode; // background mode
char bg_mode_visual; // visual background mode
#ifndef QT_NO_STYLE
QStyle* style;
#endif
QRect micro_focus_hint; // micro focus hint
QSizePolicy size_policy;
};
#define Q_DEFINED_QWIDGET
#include "qwinexport.h"
#endif // QWIDGET_H
Best Of
Actualités les plus lues
Le Qt Labs au hasard
Les Qt Labs sont les laboratoires des développeurs de Qt, où ils peuvent partager des impressions sur le framework, son utilisation, ce que pourrait être son futur.
Lire l'article.
Communauté
Ressources
Liens utiles
Contact
Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).
Qt dans le magazine