.TH "KOpenWithDlg" 3 "28 Jan 2004" "kio Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KOpenWithDlg \- 'Open with' dialog box.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kopenwith.h>\fP
.PP
Inherits \fBQDialog\fP.
.PP
.SS "Public Slots"

.in +1c
.ti -1c
.RI "void \fBslotClear\fP ()"
.br
.RI "\fIThe slot for clearing the edit widget. \fP"
.ti -1c
.RI "void \fBslotSelected\fP (const  \fBQString\fP &_name, const  \fBQString\fP &_exec)"
.br
.ti -1c
.RI "void \fBslotHighlighted\fP (const  \fBQString\fP &_name, const  \fBQString\fP &_exec)"
.br
.ti -1c
.RI "void \fBslotTextChanged\fP ()"
.br
.ti -1c
.RI "void \fBslotTerminalToggled\fP (bool)"
.br
.ti -1c
.RI "void \fBslotDbClick\fP ()"
.br
.ti -1c
.RI "void \fBslotOK\fP ()"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKOpenWithDlg\fP (const  \fBKURL::List\fP &urls, \fBQWidget\fP *parent=0L)"
.br
.RI "\fICreate a dialog that asks for a application to open a given URL(s) with. \fP"
.ti -1c
.RI "\fBKOpenWithDlg\fP (const  \fBKURL::List\fP &urls, const  \fBQString\fP &text, const  \fBQString\fP &value, \fBQWidget\fP *parent=0L)"
.br
.RI "\fICreate a dialog that asks for a application to open a given URL(s) with. \fP"
.ti -1c
.RI "\fBKOpenWithDlg\fP (const  \fBQString\fP &serviceType, const  \fBQString\fP &value, \fBQWidget\fP *parent=0L)"
.br
.RI "\fICreate a dialog to select a service for a given service type. \fP"
.ti -1c
.RI "\fBKOpenWithDlg\fP (\fBQWidget\fP *parent=0L)"
.br
.RI "\fICreate a dialog to select an application Note that this dialog doesn't apply to URLs. \fP"
.ti -1c
.RI "\fB~KOpenWithDlg\fP ()"
.br
.RI "\fIDestructor. \fP"
.ti -1c
.RI "\fBQString\fP \fBtext\fP () const "
.br
.ti -1c
.RI "\fBKService::Ptr\fP \fBservice\fP () const "
.br
.in -1c
.SS "Protected Slots"

.in +1c
.ti -1c
.RI "virtual void \fBaccept\fP ()"
.br
.RI "\fIReimplemented from \fBQDialog::accept()\fP to save history of the combobox. \fP"
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "void \fBsetServiceType\fP (const  \fBKURL::List\fP &_urls)"
.br
.RI "\fIDetermine service type from URLs. \fP"
.ti -1c
.RI "void \fBinit\fP (const  \fBQString\fP &text, const  \fBQString\fP &value)"
.br
.RI "\fICreate a dialog that asks for a application to open a given URL(s) with. \fP"
.in -1c
.SS "Protected Attributes"

.in +1c
.ti -1c
.RI "\fBKURLRequester\fP * \fBedit\fP"
.br
.ti -1c
.RI "\fBQString\fP \fBm_command\fP"
.br
.ti -1c
.RI "KApplicationTree * \fBm_pTree\fP"
.br
.ti -1c
.RI "\fBQLabel\fP * \fBlabel\fP"
.br
.ti -1c
.RI "\fBQString\fP \fBqName\fP"
.br
.ti -1c
.RI "\fBQString\fP \fBqServiceType\fP"
.br
.ti -1c
.RI "bool \fBm_terminaldirty\fP"
.br
.ti -1c
.RI "\fBQCheckBox\fP * \fBterminal\fP"
.br
.ti -1c
.RI "\fBQCheckBox\fP * \fBremember\fP"
.br
.ti -1c
.RI "\fBQCheckBox\fP * \fBUNUSED_IN_BRANCH\fP"
.br
.ti -1c
.RI "\fBQPushButton\fP * \fBUNUSED\fP"
.br
.ti -1c
.RI "\fBQPushButton\fP * \fBUNUSED2\fP"
.br
.ti -1c
.RI "\fBKService::Ptr\fP \fBm_pService\fP"
.br
.ti -1c
.RI "KOpenWithDlgPrivate * \fBd\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
'Open with' dialog box. 

Used automatically by \fBKRun\fP, and used by libkonq.
.PP
\fBAuthor:\fP
.RS 4
David Faure <faure@kde.org> 
.RE
.PP

.PP
Definition at line 47 of file kopenwith.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KOpenWithDlg::KOpenWithDlg (const \fBKURL::List\fP & urls, \fBQWidget\fP * parent = 0L)"
.PP
Create a dialog that asks for a application to open a given URL(s) with. \fBParameters:\fP
.RS 4
\fIurls\fP 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. 
.br
\fIparent\fP parent widget 
.RE
.PP
Definition at line 283 of file kopenwith.cpp.
.PP
References QString::arg(), QValueList< KURL >::count(), QValueList< KURL >::first(), init(), setServiceType(), and text().
.SS "KOpenWithDlg::KOpenWithDlg (const \fBKURL::List\fP & urls, const \fBQString\fP & text, const \fBQString\fP & value, \fBQWidget\fP * parent = 0L)"
.PP
Create a dialog that asks for a application to open a given URL(s) with. \fBParameters:\fP
.RS 4
\fIurls\fP is the URL that should be opened 
.br
\fItext\fP appears as a label on top of the entry box. 
.br
\fIvalue\fP is the initial value of the line 
.br
\fIparent\fP parent widget 
.RE
.PP
Definition at line 301 of file kopenwith.cpp.
.PP
References QValueList< KURL >::count(), KStringHandler::csqueeze(), QValueList< KURL >::first(), QString::fromLatin1(), init(), and setServiceType().
.SS "KOpenWithDlg::KOpenWithDlg (const \fBQString\fP & serviceType, const \fBQString\fP & value, \fBQWidget\fP * parent = 0L)"
.PP
Create a dialog to select a service for a given service type. Note that this dialog doesn't apply to URLs.
.PP
\fBParameters:\fP
.RS 4
\fIserviceType\fP the service type we want to choose an application for. 
.br
\fIvalue\fP is the initial value of the line 
.br
\fIparent\fP parent widget 
.RE
.PP
Definition at line 313 of file kopenwith.cpp.
.PP
References QString::arg(), init(), QCheckBox::setChecked(), and text().
.SS "KOpenWithDlg::KOpenWithDlg (\fBQWidget\fP * parent = 0L)"
.PP
Create a dialog to select an application Note that this dialog doesn't apply to URLs. \fBParameters:\fP
.RS 4
\fIparent\fP parent widget 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 330 of file kopenwith.cpp.
.PP
References init(), and text().
.SS "KOpenWithDlg::~\fBKOpenWithDlg\fP ()"
.PP
Destructor. Definition at line 461 of file kopenwith.cpp.
.SH "Member Function Documentation"
.PP 
.SS "\fBQString\fP KOpenWithDlg::text () const"
.PP
\fBReturns:\fP
.RS 4
the text the user entered 
.RE
.PP
Definition at line 673 of file kopenwith.cpp.
.PP
References QString::isEmpty(), and KURLRequester::url().
.PP
Referenced by KRun::displayOpenWithDialog(), KFileOpenWithHandler::displayOpenWithDialog(), and KOpenWithDlg().
.SS "\fBKService::Ptr\fP KOpenWithDlg::service () const\fC [inline]\fP"
.PP
\fBReturns:\fP
.RS 4
the chosen service in the application tree Can be null, if the user typed some text and didn't select a service. 
.RE
.PP
Definition at line 105 of file kopenwith.h.
.PP
Referenced by KRun::displayOpenWithDialog(), and KFileOpenWithHandler::displayOpenWithDialog().
.SS "void KOpenWithDlg::slotClear ()\fC [slot]\fP"
.PP
The slot for clearing the edit widget. Definition at line 467 of file kopenwith.cpp.
.PP
References KURLRequester::setURL().
.PP
Referenced by init().
.SS "void KOpenWithDlg::accept ()\fC [protected, virtual, slot]\fP"
.PP
Reimplemented from \fBQDialog::accept()\fP to save history of the combobox. Reimplemented from \fBQDialog\fP.
.PP
Definition at line 681 of file kopenwith.cpp.
.PP
References QDialog::accept(), KHistoryCombo::addToHistory(), KURLRequester::comboBox(), KCompletionBase::completionMode(), KGlobal::config(), QString::fromLatin1(), KHistoryCombo::historyItems(), KConfigBase::sync(), KURLRequester::url(), and KConfigBase::writeEntry().
.SS "void KOpenWithDlg::setServiceType (const \fBKURL::List\fP & _urls)\fC [protected]\fP"
.PP
Determine service type from URLs. Definition at line 341 of file kopenwith.cpp.
.PP
References QValueList< KURL >::count(), KMimeType::findByURL(), QValueList< KURL >::first(), and QString::fromLatin1().
.PP
Referenced by KOpenWithDlg().
.SS "void KOpenWithDlg::init (const \fBQString\fP & text, const \fBQString\fP & value)\fC [protected]\fP"
.PP
Create a dialog that asks for a application to open a given URL(s) with. \fBParameters:\fP
.RS 4
\fItext\fP appears as a label on top of the entry box. 
.br
\fIvalue\fP is the initial value of the line 
.RE
.PP
Definition at line 353 of file kopenwith.cpp.
.PP
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(), KConfigBase::readListEntry(), KConfigBase::readNumEntry(), QDialog::reject(), KCompletionBase::setCompletionMode(), KCompletionBase::setCompletionObject(), QPushButton::setDefault(), QComboBox::setDuplicatesEnabled(), KHistoryCombo::setHistoryItems(), QToolButton::setIconSet(), QComboBox::setMaxCount(), KLineEdit::setReadOnly(), KURLRequester::setURL(), slotClear(), and KDialog::spacingHint().
.PP
Referenced by KOpenWithDlg().

.SH "Author"
.PP 
Generated automatically by Doxygen for kio Library from the source code.
