kio Library API Documentation

KOpenWithDlg Class Reference

"Open with" dialog box. More...

#include <kopenwith.h>

Inheritance diagram for KOpenWithDlg:

QDialog List of all members.

Public Slots

void slotClear ()
 The slot for clearing the edit widget.


Public Methods

 KOpenWithDlg (const KURL::List &urls, QWidget *parent=0L)
 Create a dialog that asks for a application to open a given URL(s) with.

 KOpenWithDlg (const KURL::List &urls, const QString &text, const QString &value, QWidget *parent=0L)
 Create a dialog that asks for a application to open a given URL(s) with.

 KOpenWithDlg (const QString &serviceType, const QString &value, QWidget *parent=0L)
 Create a dialog to select a service for a given service type.

 KOpenWithDlg (QWidget *parent=0L)
 Create a dialog to select an application Note that this dialog doesn't apply to URLs.

 ~KOpenWithDlg ()
 Destructor.

QString text () const
KService::Ptr service () const

Protected Slots

virtual void accept ()
 Reimplemented from QDialog::accept() to save history of the combobox.


Protected Methods

void setServiceType (const KURL::List &_urls)
 Determine service type from URLs.

void init (const QString &text, const QString &value)
 Create a dialog that asks for a application to open a given URL(s) with.


Detailed Description

"Open with" dialog box.

Used automatically by KRun, and used by libkonq.

Author:
David Faure <faure@kde.org>

Definition at line 47 of file kopenwith.h.


Constructor & Destructor Documentation

KOpenWithDlg::KOpenWithDlg const KURL::List   urls,
QWidget   parent = 0L
 

Create a dialog that asks for a application to open a given URL(s) with.

Parameters:
urls  the URLs that should be opened. The list can be empty, if the dialog is used to choose an application but not for some particular URLs.
parent  parent widget

Definition at line 271 of file kopenwith.cpp.

References QString::arg(), init(), setServiceType(), and text().

KOpenWithDlg::KOpenWithDlg const KURL::List   urls,
const QString   text,
const QString   value,
QWidget   parent = 0L
 

Create a dialog that asks for a application to open a given URL(s) with.

Parameters:
urls  is the URL that should be opened
text  appears as a label on top of the entry box.
value  is the initial value of the line
parent  parent widget

Definition at line 289 of file kopenwith.cpp.

References KStringHandler::csqueeze(), QString::fromLatin1(), init(), and setServiceType().

KOpenWithDlg::KOpenWithDlg const QString   serviceType,
const QString   value,
QWidget   parent = 0L
 

Create a dialog to select a service for a given service type.

Note that this dialog doesn't apply to URLs.

Parameters:
serviceType  the service type we want to choose an application for.
value  is the initial value of the line
parent  parent widget

Definition at line 301 of file kopenwith.cpp.

References QString::arg(), init(), QCheckBox::setChecked(), and text().

KOpenWithDlg::KOpenWithDlg QWidget   parent = 0L
 

Create a dialog to select an application Note that this dialog doesn't apply to URLs.

Parameters:
parent  parent widget
Since:
3.1

Definition at line 318 of file kopenwith.cpp.

References init(), and text().

KOpenWithDlg::~KOpenWithDlg  
 

Destructor.

Definition at line 449 of file kopenwith.cpp.


Member Function Documentation

QString KOpenWithDlg::text  
 

Returns:
the text the user entered

Definition at line 660 of file kopenwith.cpp.

References QString::isEmpty(), and KURLRequester::url().

Referenced by KRun::displayOpenWithDialog(), KFileOpenWithHandler::displayOpenWithDialog(), and KOpenWithDlg().

KService::Ptr KOpenWithDlg::service   const [inline]
 

Returns:
the chosen service in the application tree Can be null, if the user typed some text and didn't select a service.

Definition at line 105 of file kopenwith.h.

Referenced by KRun::displayOpenWithDialog(), and KFileOpenWithHandler::displayOpenWithDialog().

void KOpenWithDlg::slotClear   [slot]
 

The slot for clearing the edit widget.

Definition at line 455 of file kopenwith.cpp.

References KURLRequester::setURL().

Referenced by init().

void KOpenWithDlg::accept   [protected, virtual, slot]
 

Reimplemented from QDialog::accept() to save history of the combobox.

Reimplemented from QDialog.

Definition at line 668 of file kopenwith.cpp.

References QDialog::accept(), KHistoryCombo::addToHistory(), KURLRequester::comboBox(), KGlobal::config(), QString::fromLatin1(), KHistoryCombo::historyItems(), and KURLRequester::url().

void KOpenWithDlg::setServiceType const KURL::List   _urls [protected]
 

Determine service type from URLs.

Definition at line 329 of file kopenwith.cpp.

References KMimeType::findByURL(), and QString::fromLatin1().

Referenced by KOpenWithDlg().

void KOpenWithDlg::init const QString   text,
const QString   value
[protected]
 

Create a dialog that asks for a application to open a given URL(s) with.

Parameters:
text  appears as a label on top of the entry box.
value  is the initial value of the line

Definition at line 341 of file kopenwith.cpp.

References QToolTip::add(), KButtonBox::addButton(), KButtonBox::addStretch(), QBoxLayout::addWidget(), KURLRequester::button(), KURLRequester::comboBox(), KGlobalSettings::Completion, KGlobalSettings::completionMode(), KGlobal::config(), QString::fromLatin1(), QString::isNull(), KButtonBox::layout(), KURLRequester::lineEdit(), KDialog::marginHint(), QDialog::reject(), KCompletionBase::setCompletionObject(), QPushButton::setDefault(), KHistoryCombo::setHistoryItems(), QToolButton::setIconSet(), KLineEdit::setReadOnly(), KURLRequester::setURL(), slotClear(), and KDialog::spacingHint().

Referenced by KOpenWithDlg().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdelibs Version 3.1.0.
Documentation copyright © 1996-2002 the KDE developers.
Generated on Wed Oct 8 12:21:36 2003 by doxygen 1.2.18 written by Dimitri van Heesch, © 1997-2001