# class KURLCompletion | Completion of a single URL. More...
Definition | `#include <kurlcompletion.h>`
Inherits | KCompletion (kdecore) [public ]
Inherited by | KShellCompletion
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

#### Public Types

- enum Mode { ExeCompletion=1, FileCompletion }

#### Public Methods

- KURLCompletion ()
- KURLCompletion (Mode)
- virtual ~KURLCompletion ()
- virtual QString makeCompletion (const QString&)
- virtual void setDir ( QString dir)
- virtual QString dir ()
- virtual bool isRunning ()
- virtual void stop ()
- virtual Mode mode ()
- virtual void setMode ( Mode mode )
- virtual bool replaceEnv ()
- virtual void setReplaceEnv ( bool replace )
- virtual bool replaceHome ()
- virtual void setReplaceHome ( bool replace )
- QString replacedPath ( const QString& text )

#### Protected Methods

- void postProcessMatch ( QString *match )
- void postProcessMatches ( QStringList *matches )

#### Protected Slots

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

## 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

- ExeCompletion - executables in $PATH or with full path
- FileCompletion - all files with full path or in dir(), URLs are listed using KIO

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.

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]

- Version: $Id: kurlcompletion.h,v 1.12 2001/02/05 00:08:59 pfeiffer Exp $
- Author: David Smith <dsmith@algonet.se>
- Generated: root@i386.ports.openbsd.org on Wed Apr 25 13:58:36 2001, using kdoc 2.0a53.