class KMimeType

Represent a mime type, like "text/plain". More...

Definition#include <kmimetype.h>
InheritsKServiceType
Inherited byKDEDesktopMimeType, KExecMimeType, KFolderType
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Types

Public Methods

Public Static Methods

Protected Methods

Protected Static Methods

Protected Members


Detailed Description

Represent a mime type, like "text/plain".

The starting point you need is often the static methods. See also KServiceType.

typedef KSharedPtr<KMimeType> Ptr

typedef QValueList<Ptr> List

 KMimeType ( const QString & _fullpath, const QString& _type, const QString& _icon, const QString& _comment, const QStringList& _patterns )

Constructor.

You may pass in arguments to create a mimetype with specific properties.

 KMimeType ( const QString & _fullpath )

Construct a mimetype and take all information from a config file.

 KMimeType ( KDesktopFile *config )

Construct a mimetype and take all information from a desktop file.

 KMimeType ( QDataStream& _str, int offset )

The stream must already be positionned at the correct offset

KMimeType ()

[virtual]

QString  icon ( const QString& , bool )

[const virtual]

Return the filename of the icon associated with the mimetype.

The arguments are unused, but provided so that KMimeType - derived classes can use them (e.g. KFolderType uses the URL to return one out of 2 icons)

Returns: The path to the icon associated with this MIME type.

Reimplemented from KServiceType.

QString  icon ( const KURL& , bool )

[const virtual]

This function differs from the above only in that a KURL may be provided instead of a QString for convenience.

Reimplemented from KServiceType.

QPixmap  pixmap ( int _group, int _force_size = 0, int _state = 0, QString * _path = 0L )

[const virtual]

Use this function only if you don't have a special URL for which you search a pixmap.

This function is useful to find out, which icon is usually chosen for a certain mime type. Since no URL is passed, it is impossible to obey icon hints in desktop entries for example.

Parameters:

QPixmap  pixmap ( const KURL& _url, int _group, int _force_size = 0, int _state = 0, QString * _path = 0L )

[const virtual]

Find the pixmap for a given file of this mimetype.

Convenience method that uses icon(), but also locates and load the pixmap.

Parameters:

QPixmap  pixmapForURL ( const KURL & _url, mode_t _mode = 0, int _group = 0, int _force_size = 0, int _state = 0, QString * _path = 0L )

[static]

Convenience method to find the pixmap for a URL

Call this one when you don't know the mimetype.

Parameters:

QString  iconForURL ( const KURL & _url, mode_t _mode = 0 )

[static]

The same functionality as pixmapForURL, but this method returns the name of the icon to load. You'll have to use KIconLoader to load the pixmap for it. The advantage of this method is that you can store the result, and then use it later on for any kind of size.

QString  comment ()

[const]

Returns: The desriptive comment associated with the MIME type.

Reimplemented from KServiceType.

QString  comment ( const QString&, bool )

[const virtual]

The arguments are unused, but provided so that KMimeType derived classes can use them.

Returns: The descriptive comment associated with the MIME type, if any.

Reimplemented from KServiceType.

QString  comment ( const KURL&, bool )

[const virtual]

This function differs from the above only in that a KURL may be provided instead of a QString for convenience.

Reimplemented from KServiceType.

const QStringList&  patterns ()

[const]

Retrieve the list of patterns associated with the MIME Type.

void  load ( QDataStream& )

[virtual]

Load the mimetype from a stream.

Reimplemented from KServiceType.

void  save ( QDataStream& )

[virtual]

Save the mimetype to a stream.

Reimplemented from KServiceType.

QVariant  property ( const QString& _name )

[const virtual]

Reimplemented from KServiceType.

QStringList  propertyNames ()

[const virtual]

Reimplemented from KServiceType.

Ptr  mimeType ( const QString& _name )

[static]

Retrieve a pointer to the mime type _name or a pointer to the default mime type "application/octet-stream".

0L is never returned.

Very important: Don't store the result in a KMimeType * !

Ptr  findByURL ( const KURL& _url, mode_t _mode = 0, bool _is_local_file = false, bool _fast_mode = false )

[static]

This function looks at mode_t first.

If that does not help it looks at the extension. This is find for FTP, FILE, TAR and friends, but is not for HTTP ( cgi scripts! ). You should use KRun instead, but this function returns immediately while KRun is async. If no extension matches, then KMimeMagic is used if the URL a local file or "application/octet-stream" is returned otherwise.

Parameters:

Returns: A pointer to the matching mimetype. 0L is never returned. Very Important: Don't store the result in a KMimeType * !

List  allMimeTypes ()

[static]

Get all the mimetypes.

Useful for showing the list of available mimetypes. More memory consuming than the ones above, don't use unless really necessary.

const QString &  defaultMimeType ()

[static]

Returns: name of the default mimetype Always application/octet-stream, but this method exists for performance purposes.

void  loadInternal ( QDataStream& )

[protected]

void  init ( KDesktopFile * )

[protected]

Reimplemented from KServiceType.

void  errorMissingMimeType ( const QString& _type )

[protected static]

Signal a missing mime type

void  buildDefaultType ()

[protected static]

This function makes sure that the default mime type exists.

void  checkEssentialMimeTypes ()

[protected static]

This function makes sure that vital mime types are installed.

static bool s_bChecked

[protected]

Returns true if check for vital mime types has been done.

QStringList m_lstPatterns

[protected]

static Ptr s_pDefaultType

[protected]


Generated by: baudens@ke.mandrakesoft.com on Thu Oct 26 17:36:34 2000, using kdoc 2.0a40.