class KMimeType

Public Types

• typedef KSharedPtr<KMimeType> Ptr
• typedef QValueList<Ptr> List

Public Methods

•  KMimeType ( const QString & _fullpath, const QString& _type, const QString& _icon, const QString& _comment, const QStringList& _patterns )
•  KMimeType ( const QString & _fullpath )
•  KMimeType ( KDesktopFile *config )
•  KMimeType ( QDataStream& _str, int offset )
• virtual ~ KMimeType ()
• virtual QString  icon ( const QString& , bool ) const
• virtual QString  icon ( const KURL& , bool ) const
• virtual QPixmap  pixmap ( int _group, int _force_size = 0, int _state = 0, QString * _path = 0L ) const
• virtual QPixmap  pixmap ( const KURL& _url, int _group, int _force_size = 0, int _state = 0, QString * _path = 0L ) const
• QString  comment () const
• virtual QString  comment ( const QString&, bool ) const
• virtual QString  comment ( const KURL&, bool ) const
• const QStringList&  patterns () const
• virtual void  load ( QDataStream& )
• virtual void  save ( QDataStream& )
• virtual QVariant  property ( const QString& _name ) const
• virtual QStringList  propertyNames () const

Public Static Methods

• static QPixmap  pixmapForURL ( const KURL & _url, mode_t _mode = 0, int _group = 0, int _force_size = 0, int _state = 0, QString * _path = 0L )
• static Ptr  mimeType ( const QString& _name )
• static Ptr  findByURL ( const KURL& _url, mode_t _mode = 0, bool _is_local_file = false, bool _fast_mode = false )
• static List  allMimeTypes ()

Protected Methods

• void  loadInternal ( QDataStream& )
• void  init ( KDesktopFile * )

Protected Static Methods

• static void  errorMissingMimeType ( const QString& _type )
• static void  buildDefaultType ()
• static void  checkEssentialMimeTypes ()

Protected Members

• static bool s_bChecked
• QStringList m_lstPatterns
• static Ptr s_pDefaultType

Constructor.

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

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

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

The stream must already be positionned at the correct offset

[virtual]

[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.

[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 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:

_group	The icon group where the icon is going to be used.
_force_size	Override globallly configured icon size.
_state	The icon state, one of: KIcon::DefaultState, KIcon::ActiveState or KIcon::DisabledState.
_path	Output parameter to get the full path. Seldom needed.

[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:

_url	URL for the file.
_group	The icon group where the icon is going to be used.
_force_size	Override globallly configured icon size.
_state	The icon state, one of: KIcon::DefaultState, KIcon::ActiveState or KIcon::DisabledState.
_path	Output parameter to get the full path. Seldom needed.

[static]

Convenience method to find the pixmap for a URL

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

[const]

Returns: The desriptive comment associated with the MIME type.

Reimplemented from KServiceType.

[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.

[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]

Retrieve the list of patterns associated with the MIME Type.

[virtual]

Load the mimetype from a stream.

Reimplemented from KServiceType.

[virtual]

Save the mimetype to a stream.

Reimplemented from KServiceType.

[const virtual]

Reimplemented from KServiceType.

[const virtual]

Reimplemented from KServiceType.

[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 * !

[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:

_url	Is the right most URL with a filesystem protocol. It is up to you to find out about that if you have a nested URL. For example "http://localhost/mist.gz#gzip:/decompress" would have to pass the "http://..." URL part, while "file:/tmp/x.tar#tar:/src/test.gz#gzip:/decompress" would have to pass the "tar:/..." part of the URL, since gzip is a filter protocol and not a filesystem protocol.
_fast_mode	If set to true no disk access is allowed to find out the mimetype. The result may be suboptimal, but it is fast.

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

[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.

[protected]

[protected]

Reimplemented from KServiceType.

[protected static]

Signal a missing mime type

[protected static]

This function makes sure that the default mime type exists.

[protected static]

This function makes sure that vital mime types are installed.

[protected]

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

[protected]

[protected]