---

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., 59 Temple Place - Suite 330,
    Boston, MA 02111-1307, USA.
*/


#ifndef KURLREQUESTER_H
#define KURLREQUESTER_H

#include <qhbox.h>

#include <keditlistbox.h>
#include <kfile.h>
#include <kpushbutton.h>
#include <kurl.h>

class KComboBox;
class KFileDialog;
class KLineEdit;
class KURLCompletion;
class KURLDragPushButton;

class QString;
class QTimer;

class KURLRequester : public QHBox
{
    Q_OBJECT
    Q_PROPERTY( QString url READ url WRITE setURL )

public:
    KURLRequester( QWidget *parent=0, const char *name=0 );

    KURLRequester( const QString& url, QWidget *parent=0, const char *name=0 );
    KURLRequester( QWidget *editWidget, QWidget *parent, const char *name=0 );
    ~KURLRequester();

    QString url() const;

    void setShowLocalProtocol( bool b );

    void setMode( unsigned int m );

    void setFilter( const QString& filter );

    bool showLocalProtocol() const { return myShowLocalProt; }

    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 QString& url );

    virtual void setCaption( const QString& caption );

    void clear();

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

    void returnPressed();

    void returnPressed( const QString& );

    void openFileDialog( KURLRequester * );

    void urlSelected( const QString& );

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 );
private:
    class KURLRequesterPrivate;
    KURLRequesterPrivate *d;
};

#endif // KURLREQUESTER_H

---