kurlrequester.h

/* This file is part of the KDE libraries
    Copyright (C) 1999,2000,2001 Carsten Pfeiffer <pfeiffer@kde.org>
 
    library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License version 2, as published by the Free Software Foundation.
 
    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 KURLREQUESTER_H
#define KURLREQUESTER_H
 
#include <tqhbox.h>
 
#include <keditlistbox.h>
#include <tdefile.h>
#include <kpushbutton.h>
#include <kurl.h>
 
class KComboBox;
class KFileDialog;
class KLineEdit;
class KURLCompletion;
class KURLDragPushButton;
 
class TQString;
class TQTimer;

class TDEIO_EXPORT KURLRequester : public TQHBox
{
    TQ_OBJECT
    TQ_PROPERTY( TQString url READ url WRITE setURL )
    TQ_PROPERTY( bool showLocalProtocol READ showLocalProtocol WRITE setShowLocalProtocol )
    TQ_PROPERTY( TQString filter READ filter WRITE setFilter )
    TQ_PROPERTY( uint mode READ mode WRITE setMode )
 
public:
    KURLRequester( TQWidget *parent=0, const char *name=0 );

    KURLRequester( const TQString& url, TQWidget *parent=0, const char *name=0 );

    KURLRequester( TQWidget *editWidget, TQWidget *parent, const char *name=0 );
    ~KURLRequester();

    TQString url() const;

    void setShowLocalProtocol( bool b );

    void setMode( uint m );

    uint mode() const;
 

    void setFilter( const TQString& filter );

    TQString filter() const;

    bool showLocalProtocol() const { return myShowLocalProt; }
    // ## KDE4: there's no reason to keep this, it should always be false

    virtual KFileDialog * fileDialog() const;

    KLineEdit * lineEdit() const;

    KComboBox * comboBox() const;

    KPushButton * button() const;

    KURLCompletion *completionObject() const { return myCompletion; }

    KEditListBox::CustomEditor customEditor();
 
public slots:
    void setURL( const TQString& url );

    void setKURL( const KURL& url );

    virtual void setCaption( const TQString& caption );

    void clear();
 
signals:
    // forwards from LineEdit
    void textChanged( const TQString& );

    void returnPressed();

    void returnPressed( const TQString& );

    void openFileDialog( KURLRequester * );

    void urlSelected( const TQString& );
 
protected:
    void        init();
 
    KURLCompletion *    myCompletion;
 
 
private:
    KURLDragPushButton * myButton;
    bool        myShowLocalProt;
    mutable KFileDialog * myFileDialog;
 
 
protected slots:
    void slotOpenDialog();
 
private slots:
    void slotUpdateURL();
 
protected:
    virtual void virtual_hook( int id, void* data );
    bool eventFilter( TQObject *obj, TQEvent *ev );
private:
    class KURLRequesterPrivate;
    KURLRequesterPrivate *d;
};

class TDEIO_EXPORT KURLComboRequester : public KURLRequester
{
    TQ_OBJECT
public:
    KURLComboRequester( TQWidget *parent=0, const char *name=0 );
};
 
 
#endif // KURLREQUESTER_H