tdecompletionbox.h

/* This file is part of the KDE libraries
 
   Copyright (c) 2000 Carsten Pfeiffer <pfeiffer@kde.org>
                 2000 Stefan Schimanski <1Stein@gmx.de>
                 2000,2001,2002,2003,2004 Dawit Alemayehu <adawit@kde.org>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License (LGPL) as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.
 
   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.
 
   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/
 
#ifndef TDECOMPLETIONBOX_H
#define TDECOMPLETIONBOX_H
 
class TQEvent;
#include <tqstringlist.h>
#include <tdelistbox.h>

class TDEUI_EXPORT TDECompletionBox : public TDEListBox
{
    TQ_OBJECT
    TQ_PROPERTY( bool isTabHandling READ isTabHandling WRITE setTabHandling )
    TQ_PROPERTY(TQString cancelledText READ cancelledText WRITE setCancelledText)
    TQ_PROPERTY( bool activateOnSelect READ activateOnSelect WRITE setActivateOnSelect )
 
public:
    TDECompletionBox( TQWidget *parent, const char *name = 0 );

    ~TDECompletionBox();
 
    virtual TQSize sizeHint() const;

    bool activateOnSelect() const;
 
public slots:
    TQStringList items() const;

    void insertItems( const TQStringList& items, int index = -1 );

    void setItems( const TQStringList& items );

    virtual void popup();

    void setTabHandling( bool enable );

    bool isTabHandling() const;

    void setCancelledText( const TQString& txt);

    TQString cancelledText() const;

    void setActivateOnSelect(bool state);
 

    void down();

    void up();

    void pageDown();

    void pageUp();

    void home();

    void end();

    virtual void show();

    virtual void hide();
 
signals:
    void activated( const TQString& );

    void userCancelled( const TQString& );
 
protected:
    TQRect calculateGeometry() const;

    void sizeAndPosition();

    virtual bool eventFilter( TQObject *, TQEvent * );
 
protected slots:
    virtual void slotActivated( TQListBoxItem * );
 
private slots:
    void slotSetCurrentItem( TQListBoxItem *i ) { setCurrentItem( i ); } // grrr
    void slotCurrentChanged();
    void canceled();
    void slotItemClicked( TQListBoxItem * );
 
protected:
    virtual void virtual_hook( int id, void* data );
 
private:
    class TDECompletionBoxPrivate;
    TDECompletionBoxPrivate* const d;
};
 
 
#endif // TDECOMPLETIONBOX_H