/***************************************************************************
                            kde_KURLRequesterDlg.h -  description
                             -------------------
    begin                : Wed Feb  6 15:12:26 2002
    copyright            : (C) 2000-2001 Lost Highway Ltd. All rights reserved.
    email                : Lost_Highway@tipitina.demon.co.uk
    generated by         : duke@tipitina on Wed Feb  6 15:12:26 2002, using kalyptus 0.9.
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   This library is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU Library General Public License as       *
 *   published by the Free Software Foundation; either version 2 of the    *
 *   License, or (at your option) any later version.                       *
 *                                                                         *
 ***************************************************************************/

#ifndef KDE_KURLREQUESTERDLG
#define KDE_KURLREQUESTERDLG

#include <qtc/qtc_types.h>

#include <kdec/kde_types.h>

/**

 Dialog in which a user can enter a filename or url. It is a dialog
 encapsulating @ref KURLRequester. The API is derived from
 @ref KFileDialog.

 @author Wilco Greven <j.w.greven@student.utwente.nl>
 
 @short Simple dialog to enter a filename/url.

*/

/** 
 Constructs a KURLRequesterDlg.

*/
kde_KURLRequesterDlg * kde_new_KURLRequesterDlg(qt_QString * url, qt_QWidget * parent, char* name, int modal);

/** 
 Constructs a KURLRequesterDlg.

*/
kde_KURLRequesterDlg * kde_new_KURLRequesterDlg1(qt_QString * url, qt_QString * text, qt_QWidget * parent, char* name, int modal);

/** 
 Destructs the dialog.
     
*/
void kde_del_KURLRequesterDlg( kde_KURLRequesterDlg* p );

/** 
 Returns the fully qualified filename.
     
*/
kde_KURL* kde_KURLRequesterDlg_selectedURL(kde_KURLRequesterDlg* instPointer);

/** 
 Returns a pointer to the file dialog used by the KURLRequester.
     
*/
kde_KFileDialog* kde_KURLRequesterDlg_fileDialog(kde_KURLRequesterDlg* instPointer);

/** 
 Returns a pointer to the KURLRequester.
     
*/
kde_KURLRequester* kde_KURLRequesterDlg_urlRequester(kde_KURLRequesterDlg* instPointer);

/** 
 Creates a modal dialog, executes it and returns the selected URL.

*/
kde_KURL* kde_KURLRequesterDlg_getURL( qt_QString * url, qt_QWidget * parent, qt_QString * caption);

#endif
