KUrlCompletion

Search for usage in LXR

#include <KUrlCompletion>

Inheritance diagram for KUrlCompletion:

Public Types

enum  Mode { ExeCompletion = 1 , FileCompletion , DirCompletion }
 
- Public Types inherited from KCompletion
enum  CompletionMode
 
enum  CompOrder
 
typedef std::function< void(QStringList &)> SorterFunction
 
- Public Types inherited from QObject
typedef  QObjectList
 

Public Member Functions

 KUrlCompletion ()
 
 KUrlCompletion (Mode)
 
 ~KUrlCompletion () override
 
virtual QUrl dir () const
 
virtual bool isRunning () const
 
QString makeCompletion (const QString &text) override
 
QStringList mimeTypeFilters () const
 
virtual Mode mode () const
 
QString replacedPath (const QString &text) const
 
virtual bool replaceEnv () const
 
virtual bool replaceHome () const
 
virtual void setDir (const QUrl &dir)
 
void setMimeTypeFilters (const QStringList &mimeTypes)
 
virtual void setMode (Mode mode)
 
virtual void setReplaceEnv (bool replace)
 
virtual void setReplaceHome (bool replace)
 
virtual void stop ()
 
- Public Member Functions inherited from KCompletion
QStringList allMatches ()
 
QStringList allMatches (const QString &string)
 
KCompletionMatches allWeightedMatches ()
 
KCompletionMatches allWeightedMatches (const QString &string)
 
CompletionMode completionMode () const
 
bool hasMultipleMatches () const
 
bool ignoreCase () const
 
bool isEmpty () const
 
QStringList items () const
 
virtual const QStringlastMatch () const
 
CompOrder order () const
 
virtual void setCompletionMode (CompletionMode mode)
 
virtual void setIgnoreCase (bool ignoreCase)
 
virtual void setOrder (CompOrder order)
 
virtual void setSoundsEnabled (bool enable)
 
bool shouldAutoSuggest () const
 
bool soundsEnabled () const
 
QStringList substringCompletion (const QString &string) const
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
QBindable< QStringbindableObjectName ()
 
bool blockSignals (bool block)
 
const QObjectListchildren () 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< QByteArraydynamicPropertyNames () const const
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
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 QMetaObjectmetaObject () const const
 
void moveToThread (QThread *targetThread)
 
QString objectName () const const
 
void objectNameChanged (const QString &objectName)
 
QObjectparent () 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
 
qobject_cast (const QObject *object)
 
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)
 
QThreadthread () const const
 

Static Public Member Functions

static QString replacedPath (const QString &text, bool replaceHome, bool replaceEnv=true)
 
- 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)
 

Protected Member Functions

void postProcessMatch (QString *match) const override
 
void postProcessMatches (KCompletionMatches *matches) const override
 
void postProcessMatches (QStringList *matches) const override
 
- Protected Member Functions inherited from KCompletion
void setShouldAutoSuggest (bool shouldAutosuggest)
 
void setSorterFunction (SorterFunction sortFunc)
 
- 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
 
QObjectsender () const const
 
int senderSignalIndex () const const
 
virtual void timerEvent (QTimerEvent *event)
 

Additional Inherited Members

- Properties inherited from QObject
 objectName
 
- Signals inherited from KCompletion
void match (const QString &item)
 
void matches (const QStringList &matchlist)
 
void multipleMatches ()
 
- Public Slots inherited from KCompletion
void addItem (const QString &item)
 
void addItem (const QString &item, uint weight)
 
virtual void clear ()
 
void insertItems (const QStringList &items)
 
QString nextMatch ()
 
QString previousMatch ()
 
void removeItem (const QString &item)
 
virtual void setItems (const QStringList &itemList)
 
- Public Attributes inherited from KCompletion
 CompletionAuto
 
 CompletionMan
 
 CompletionNone
 
 CompletionPopup
 
 CompletionPopupAuto
 
 CompletionShell
 
 Insertion
 
 Sorted
 
 Weighted
 

Detailed Description

This class does completion of URLs including user directories (~user) and environment variables.

Remote URLs are passed to KIO.

Completion of a single URL

Author
David Smith dsmit.nosp@m.h@al.nosp@m.gonet.nosp@m..se

Definition at line 40 of file kurlcompletion.h.

Member Enumeration Documentation

◆ Mode

Determines how completion is done.

  • ExeCompletion - executables in $PATH or with full path.
  • FileCompletion - all files with full path or in dir(), URLs are listed using KIO.
  • DirCompletion - Same as FileCompletion but only returns directories.

Definition at line 52 of file kurlcompletion.h.

Constructor & Destructor Documentation

◆ KUrlCompletion() [1/2]

KUrlCompletion::KUrlCompletion ( )

Constructs a KUrlCompletion object in FileCompletion mode.

Definition at line 522 of file kurlcompletion.cpp.

◆ KUrlCompletion() [2/2]

KUrlCompletion::KUrlCompletion ( Mode _mode)

This overloaded constructor allows you to set the Mode to ExeCompletion or FileCompletion without using setMode.

Default is FileCompletion.

Definition at line 527 of file kurlcompletion.cpp.

◆ ~KUrlCompletion()

KUrlCompletion::~KUrlCompletion ( )
override

Destructs the KUrlCompletion object.

Definition at line 533 of file kurlcompletion.cpp.

Member Function Documentation

◆ dir()

QUrl KUrlCompletion::dir ( ) const
virtual

Returns the current directory, as it was given in setDir.

Returns
the current directory, as a URL (use QUrl::toLocalFile for local paths)

Definition at line 543 of file kurlcompletion.cpp.

◆ isRunning()

bool KUrlCompletion::isRunning ( ) const
virtual

Check whether asynchronous completion is in progress.

Returns
true if asynchronous completion is in progress

Definition at line 687 of file kurlcompletion.cpp.

◆ makeCompletion()

QString KUrlCompletion::makeCompletion ( const QString & text)
overridevirtual

Finds completions to the given text.

Remote URLs are listed with KIO. For performance reasons, local files are listed with KIO only if KURLCOMPLETION_LOCAL_KIO is set. The completion is done asynchronously if KIO is used.

Returns the first match for user, environment, and local dir completion and QString() for asynchronous completion (KIO or threaded).

Parameters
textthe text to complete
Returns
the first match, or QString() if not found

Reimplemented from KCompletion.

Definition at line 583 of file kurlcompletion.cpp.

◆ mimeTypeFilters()

QStringList KUrlCompletion::mimeTypeFilters ( ) const

Returns the MIME type filters for the file dialog.

See also
QFileDialog::mimeTypeFilters()
Since
5.38

Definition at line 1350 of file kurlcompletion.cpp.

◆ mode()

KUrlCompletion::Mode KUrlCompletion::mode ( ) const
virtual

Returns the completion mode: exe or file completion (default FileCompletion).

Returns
the completion mode

Definition at line 548 of file kurlcompletion.cpp.

◆ postProcessMatch()

void KUrlCompletion::postProcessMatch ( QString * match) const
overrideprotectedvirtual

Reimplemented from KCompletion.

Definition at line 1257 of file kurlcompletion.cpp.

◆ postProcessMatches() [1/2]

void KUrlCompletion::postProcessMatches ( KCompletionMatches * matches) const
overrideprotectedvirtual

Reimplemented from KCompletion.

Definition at line 1295 of file kurlcompletion.cpp.

◆ postProcessMatches() [2/2]

void KUrlCompletion::postProcessMatches ( QStringList * matches) const
overrideprotectedvirtual

Reimplemented from KCompletion.

Definition at line 1288 of file kurlcompletion.cpp.

◆ replacedPath() [1/2]

QString KUrlCompletion::replacedPath ( const QString & text) const

Replaces username and/or environment variables, depending on the current settings and returns the filtered url.

Only works with local files, i.e. returns back the original string for non-local urls.

Parameters
textthe text to process
Returns
the path or URL resulting from this operation. If you want to convert it to a QUrl, use QUrl::fromUserInput.

Definition at line 1340 of file kurlcompletion.cpp.

◆ replacedPath() [2/2]

QString KUrlCompletion::replacedPath ( const QString & text,
bool replaceHome,
bool replaceEnv = true )
static

I'll let ossi add a real one to KShell :)

Definition at line 1325 of file kurlcompletion.cpp.

◆ replaceEnv()

bool KUrlCompletion::replaceEnv ( ) const
virtual

Checks whether environment variables are completed and whether they are replaced internally while finding completions.

Default is enabled.

Returns
true if environment variables will be replaced

Definition at line 558 of file kurlcompletion.cpp.

◆ replaceHome()

bool KUrlCompletion::replaceHome ( ) const
virtual

Returns whether ~username is completed and whether ~username is replaced internally with the user's home directory while finding completions.

Default is enabled.

Returns
true to replace tilde with the home directory

Definition at line 568 of file kurlcompletion.cpp.

◆ setDir()

void KUrlCompletion::setDir ( const QUrl & dir)
virtual

Sets the current directory (used as base for completion).

Default = $HOME.

Parameters
dirthe current directory, as a URL (use QUrl::fromLocalFile for local paths)

Definition at line 538 of file kurlcompletion.cpp.

◆ setMimeTypeFilters()

void KUrlCompletion::setMimeTypeFilters ( const QStringList & mimeTypes)

Sets the MIME type filters for the file dialog.

See also
QFileDialog::setMimeTypeFilters()
Since
5.38

Definition at line 1345 of file kurlcompletion.cpp.

◆ setMode()

void KUrlCompletion::setMode ( Mode mode)
virtual

Changes the completion mode: exe or file completion.

Parameters
modethe new completion mode

Definition at line 553 of file kurlcompletion.cpp.

◆ setReplaceEnv()

void KUrlCompletion::setReplaceEnv ( bool replace)
virtual

Enables/disables completion and replacement (internally) of environment variables in URLs.

Default is enabled.

Parameters
replacetrue to replace environment variables

Definition at line 563 of file kurlcompletion.cpp.

◆ setReplaceHome()

void KUrlCompletion::setReplaceHome ( bool replace)
virtual

Enables/disables completion of ~username and replacement (internally) of ~username with the user's home directory.

Default is enabled.

Parameters
replacetrue to replace tilde with the home directory

Definition at line 573 of file kurlcompletion.cpp.

◆ stop()

void KUrlCompletion::stop ( )
virtual

Stops asynchronous completion.

Definition at line 697 of file kurlcompletion.cpp.


The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Fri Oct 11 2024 12:11:14 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.