class KURLCompletion

Completion of a single URL. More...

Definition#include <kurlcompletion.h>
InheritsKCompletion (kdecore) [public ]
Inherited byKShellCompletion
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Types

Public Methods

Protected Methods

Protected Slots


Detailed Description

This class does completion of URLs including user directories (~user) and environment variables. Remote URLs are passed to KIO.

enum Mode { ExeCompletion=1, FileCompletion }

Mode

Determines how completion is done

 KURLCompletion ()

KURLCompletion

 KURLCompletion (Mode)

KURLCompletion

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

 ~KURLCompletion ()

~KURLCompletion

[virtual]

QString  makeCompletion (const QString&)

makeCompletion

[virtual]

Find 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 asyncronously if KIO is used.

Returns the first match for user, environment, and local dir completion and QString::null for asyncronous completion (KIO)

Reimplemented from KCompletion.

void  setDir ( QString dir)

setDir

[virtual]

Set the current directory (used as base for completion) Default = $HOME

QString  dir ()

dir

[virtual]

Get the current directory

bool  isRunning ()

isRunning

[virtual]

Returns true if asyncronous completion is in progress

void  stop ()

stop

[virtual]

Stop asyncronous copmpletion

Mode  mode ()

mode

[virtual]

Return completion mode: exe or file completion (default FileCompletion)

void  setMode ( Mode mode )

setMode

[virtual]

Change completion mode: exe or file completion

bool  replaceEnv ()

replaceEnv

[virtual]

Returns whether environment variables are completed and whether they are replaced internally while finding completions. Default is enabled.

void  setReplaceEnv ( bool replace )

setReplaceEnv

[virtual]

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

bool  replaceHome ()

replaceHome

[virtual]

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

void  setReplaceHome ( bool replace )

setReplaceHome

[virtual]

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

QString  replacedPath ( const QString& text )

replacedPath

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.

void  postProcessMatch ( QString *match )

postProcessMatch

[protected]

Reimplemented from KCompletion.

void  postProcessMatches ( QStringList *matches )

postProcessMatches

[protected]

Reimplemented from KCompletion.

void  slotEntries ( KIO::Job *, const KIO::UDSEntryList& )

slotEntries

[protected slots slot]

void  slotIOFinished ( KIO::Job * )

slotIOFinished

[protected slots slot]