KIO::UntrustedProgramHandlerInterface
#include <untrustedprogramhandlerinterface.h>
Signals | |
void | result (bool confirmed) |
Public Member Functions | |
bool | makeServiceFileExecutable (const QString &fileName, QString &errorString) |
bool | setExecuteBit (const QString &fileName, QString &errorString) |
virtual void | showUntrustedProgramWarning (KJob *job, const QString &programName) |
Public Member Functions inherited from QObject | |
QObject (QObject *parent) | |
QBindable< QString > | bindableObjectName () |
bool | blockSignals (bool block) |
const QObjectList & | children () const const |
QMetaObject::Connection | connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const |
void | deleteLater () |
void | destroyed (QObject *obj) |
bool | disconnect (const char *signal, const QObject *receiver, const char *method) const const |
bool | disconnect (const QObject *receiver, const char *method) const const |
void | dumpObjectInfo () const const |
void | dumpObjectTree () const const |
QList< QByteArray > | dynamicPropertyNames () const const |
virtual bool | event (QEvent *e) |
virtual bool | eventFilter (QObject *watched, QEvent *event) |
T | findChild (const QString &name, Qt::FindChildOptions options) const const |
QList< T > | findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const |
QList< T > | findChildren (const QString &name, Qt::FindChildOptions options) const const |
QList< T > | findChildren (Qt::FindChildOptions options) const const |
bool | inherits (const char *className) const const |
void | installEventFilter (QObject *filterObj) |
bool | isQuickItemType () const const |
bool | isWidgetType () const const |
bool | isWindowType () const const |
void | killTimer (int id) |
virtual const QMetaObject * | metaObject () const const |
void | moveToThread (QThread *targetThread) |
QString | objectName () const const |
void | objectNameChanged (const QString &objectName) |
QObject * | parent () const const |
QVariant | property (const char *name) const const |
Q_CLASSINFO (Name, Value) | |
Q_EMIT Q_EMIT | |
Q_ENUM (...) | |
Q_ENUM_NS (...) | |
Q_ENUMS (...) | |
Q_FLAG (...) | |
Q_FLAG_NS (...) | |
Q_FLAGS (...) | |
Q_GADGET Q_GADGET | |
Q_GADGET_EXPORT (EXPORT_MACRO) | |
Q_INTERFACES (...) | |
Q_INVOKABLE Q_INVOKABLE | |
Q_MOC_INCLUDE Q_MOC_INCLUDE | |
Q_NAMESPACE Q_NAMESPACE | |
Q_NAMESPACE_EXPORT (EXPORT_MACRO) | |
Q_OBJECT Q_OBJECT | |
Q_PROPERTY (...) | |
Q_REVISION Q_REVISION | |
Q_SET_OBJECT_NAME (Object) | |
Q_SIGNAL Q_SIGNAL | |
Q_SIGNALS Q_SIGNALS | |
Q_SLOT Q_SLOT | |
Q_SLOTS Q_SLOTS | |
T | qobject_cast (const QObject *object) |
T | qobject_cast (QObject *object) |
QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT | |
void | removeEventFilter (QObject *obj) |
void | setObjectName (const QString &name) |
void | setObjectName (QAnyStringView name) |
void | setParent (QObject *parent) |
bool | setProperty (const char *name, const QVariant &value) |
bool | setProperty (const char *name, QVariant &&value) |
bool | signalsBlocked () const const |
int | startTimer (int interval, Qt::TimerType timerType) |
int | startTimer (std::chrono::milliseconds interval, Qt::TimerType timerType) |
QThread * | thread () const const |
Protected Member Functions | |
UntrustedProgramHandlerInterface (QObject *parent=nullptr) | |
~UntrustedProgramHandlerInterface () override | |
Protected Member Functions inherited from QObject | |
virtual void | childEvent (QChildEvent *event) |
virtual void | connectNotify (const QMetaMethod &signal) |
virtual void | customEvent (QEvent *event) |
virtual void | disconnectNotify (const QMetaMethod &signal) |
bool | isSignalConnected (const QMetaMethod &signal) const const |
int | receivers (const char *signal) const const |
QObject * | sender () const const |
int | senderSignalIndex () const const |
virtual void | timerEvent (QTimerEvent *event) |
Additional Inherited Members | |
Public Types inherited from QObject | |
typedef | QObjectList |
Properties inherited from QObject | |
objectName | |
Static Public Member Functions inherited from QObject | |
QMetaObject::Connection | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type) |
QMetaObject::Connection | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type) |
QMetaObject::Connection | connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type) |
QMetaObject::Connection | connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type) |
QMetaObject::Connection | connect (const QObject *sender, PointerToMemberFunction signal, Functor functor) |
bool | disconnect (const QMetaObject::Connection &connection) |
bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method) |
bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method) |
bool | disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method) |
QString | tr (const char *sourceText, const char *disambiguation, int n) |
Detailed Description
The UntrustedProgramHandlerInterface class allows ApplicationLauncherJob to prompt the user about an untrusted executable or desktop file.
This extension mechanism for jobs is similar to KIO::JobUiDelegateExtension.
The class also provides helper methods to set the execute bit so that the program can be started.
- Since
- 5.70
Definition at line 27 of file untrustedprogramhandlerinterface.h.
Constructor & Destructor Documentation
◆ UntrustedProgramHandlerInterface()
|
explicitprotected |
Constructor.
Definition at line 16 of file untrustedprogramhandlerinterface.cpp.
◆ ~UntrustedProgramHandlerInterface()
|
overrideprotected |
Destructor.
Definition at line 22 of file untrustedprogramhandlerinterface.cpp.
Member Function Documentation
◆ makeServiceFileExecutable()
bool UntrustedProgramHandlerInterface::makeServiceFileExecutable | ( | const QString & | fileName, |
QString & | errorString ) |
Helper function that attempts to make a desktop file executable.
In addition to the execute bit, this includes fixing its first line to ensure that it says #!/usr/bin/env xdg-open.
- Parameters
-
fileName the full path to the file errorString output parameter so the method can return an error message
- Returns
- true on success, false on error
Definition at line 33 of file untrustedprogramhandlerinterface.cpp.
◆ result
|
signal |
Implementations of this interface must emit result in showUntrustedProgramWarning.
- Parameters
-
confirmed true if the user confirms running this program, false on cancel
◆ setExecuteBit()
bool UntrustedProgramHandlerInterface::setExecuteBit | ( | const QString & | fileName, |
QString & | errorString ) |
Helper function that attempts to set execute bit for given file.
- Parameters
-
fileName the full path to the file errorString output parameter so the method can return an error message
- Returns
- true on success, false on error
Definition at line 103 of file untrustedprogramhandlerinterface.cpp.
◆ showUntrustedProgramWarning()
|
virtual |
Show a warning to the user about the program not being trusted for execution.
This could be an executable which is not a script and without the execute bit. Or it could be a desktop file outside the standard locations, without the execute bit.
- Parameters
-
job the job calling this. Useful to get the associated window. programName the full path to the executable or desktop file
If this function emits result(true), the caller should then call either setExecuteBit or makeServiceFileExecutable; those helper methods are provided by this class.
The default implementation in this base class simply emits result(false). Any application using KIO::JobUiDelegate (KIOWidgets) will benefit from an automatically registered subclass which implements this method using QtWidgets.
Definition at line 26 of file untrustedprogramhandlerinterface.cpp.
The documentation for this class was generated from the following files:
Documentation copyright © 1996-2024 The KDE developers.
Generated on Sat Dec 21 2024 16:58:46 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.