qwidget-h.html

qtopiaphone英文帮助,用于初学者和开发人员,初学者可以用来学习,开发人员可以用来资料查询.

        ClickFocus = 0x2,
        StrongFocus = 0x3,
        WheelFocus = 0x7
    };

    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;

    // 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 _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();
#ifndef QT_NO_COMPAT
    void                iconify()       { showMinimized(); }
#endif
    virtual void        showMinimized();
    virtual void        showMaximized();
    void                showFullScreen(); // virtual 3.0
    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 & );

public:
    virtual bool        close( bool alsoDelete );
    bool                isVisible()     const;
    bool                isVisibleTo(QWidget*) const;
    bool                isVisibleToTLW() const; // obsolete
    QRect               visibleRect() const;
    bool                isHidden() const;
    bool                isMinimized() const;
    bool                isMaximized() const;

    virtual QSize       sizeHint() const;
    virtual QSize       minimumSizeHint() const;
    virtual QSizePolicy sizePolicy() const;
    void                setSizePolicy( QSizePolicy );
    virtual int heightForWidth(int) const;

    virtual void        adjustSize();
#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 // QWS 2.3.8+ only
                          };

    void setBackgroundOrigin( BackgroundOrigin );
    BackgroundOrigin backgroundOrigin() const;


    // whats this help
    virtual bool customWhatsThis() const;

    QWidget *           parentWidget() const;
    bool                testWState( uint n ) const;
    bool                testWFlags( WFlags f ) const;
    static QWidget *    find( WId );
    static QWidgetMapper *wmapper();

#if defined(_WS_QWS_)
    virtual QGfx * graphicsContext(bool clip_children=TRUE) const;
#endif

protected:
    // Event handlers
    bool         event( QEvent * );
    virtual void mousePressEvent( QMouseEvent * );
    virtual void mouseReleaseEvent( QMouseEvent * );
    virtual void mouseDoubleClickEvent( QMouseEvent * );
    virtual void mouseMoveEvent( QMouseEvent * );
    virtual void wheelEvent( QWheelEvent * );
    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 * );

#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 * );
    virtual void customEvent( QCustomEvent * );

#if defined(_WS_MAC_)
    virtual bool macEvent( MSG * );             // Macintosh event
    QWidget * mytop;                            // This widget's top-level widg
    int back_type;                              // Type of background
    QPixmap * bg_pix;
    virtual void fixport();
    virtual void propagateUpdates(int x,int y,int x2,int y2);
#elif defined(_WS_WIN_)
    virtual bool winEvent( MSG * );             // Windows event
#elif defined(_WS_X11_)
    virtual bool x11Event( XEvent * );          // X11 event
#elif defined(_WS_QWS_)
    virtual bool qwsEvent( QWSEvent * );
    virtual unsigned char * scanLine(int) const;
    virtual int bytesPerLine() const;
#endif

    virtual void updateMask();

    // Misc. protected functions

protected:
#ifndef QT_NO_STYLE
    virtual void styleChange( QStyle& );
#endif
    virtual void enabledChange( bool );
    virtual void backgroundColorChange( const QColor & );
    virtual void backgroundPixmapChange( const QPixmap & );
#ifndef QT_NO_PALETTE
    virtual void paletteChange( const QPalette & );
#endif
    virtual void fontChange( const QFont & );

#ifdef _WS_QWS_
    void         resetInputContext();
#endif
    int          metric( int )  const;

    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 void setFRect( const QRect & );
    virtual void setCRect( const QRect & );

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

private slots:
    void         focusProxyDestroyed();

private:
    void         setFontSys();
#ifndef QT_NO_LAYOUT
    void         setLayout( QLayout *l );
#endif
    void         setWinId( WId );
    void         showWindow();
    void         hideWindow();
    void         sendShowEventsToChildren( bool spontaneous );
    void         sendHideEventsToChildren( bool spontaneous );
    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();
#if defined(_WS_X11_)
    void         setBackgroundX11Relative();
    void         checkChildrenDnd();
#endif

    WId          winid;
    uint         widget_state;
    uint         widget_flags;
    uint         propagate_font : 2; // obsolete
    uint         propagate_palette : 2; // obsolete
    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;
    QPoint       fpos;
    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(_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;