\section{KFile\-Meta\-Info Class Reference}
\label{classKFileMetaInfo}\index{KFileMetaInfo@{KFileMetaInfo}}
This is the class for objects that hold meta information about a file. Meta Information about a file.  


{\tt \#include $<$kfilemetainfo.h$>$}

\subsection*{Public Types}
\begin{CompactItemize}
\item 
typedef {\bf KFile\-Mime\-Type\-Info::Hint} {\bf Hint}\label{classKFileMetaInfo_w0}

\item 
typedef {\bf KFile\-Mime\-Type\-Info::Unit} {\bf Unit}\label{classKFileMetaInfo_w1}

\item 
typedef {\bf KFile\-Mime\-Type\-Info::Attributes} {\bf Attributes}\label{classKFileMetaInfo_w2}

\item 
enum {\bf What} \{ \par
{\bf Fastest} =  0x1, 
{\bf Dont\-Care} =  0x2, 
{\bf Technical\-Info} =  0x4, 
{\bf Content\-Info} =  0x8, 
\par
{\bf Extened\-Attr} =  0x10, 
{\bf Thumbnail} =  0x20, 
{\bf Preferred} =  0x40, 
{\bf Everything} =  0xffff
 \}
\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KFile\-Meta\-Info} (const {\bf QString} \&path, const {\bf QString} \&mime\-Type=QString::null, uint what=Fastest)
\item 
{\bf KFile\-Meta\-Info} (const {\bf KURL} \&url, const {\bf QString} \&mime\-Type=QString::null, uint what=Fastest)
\item 
{\bf KFile\-Meta\-Info} ()
\item 
{\bf KFile\-Meta\-Info} (const {\bf KFile\-Meta\-Info} \&original)
\item 
const {\bf KFile\-Meta\-Info} \& {\bf operator=} (const {\bf KFile\-Meta\-Info} \&info)
\item 
{\bf QString\-List} {\bf groups} () const 
\item 
{\bf QString\-List} {\bf supported\-Groups} () const 
\item 
{\bf QString\-List} {\bf preferred\-Groups} () const 
\item 
{\bf QString\-List} {\bf preferred\-Keys} () const 
\item 
{\bf QString\-List} {\bf supported\-Keys} () const 
\item 
{\bf QString\-List} {\bf editable\-Groups} () const 
\item 
{\bf KFile\-Meta\-Info\-Item} {\bf item} (const {\bf QString} \&key) const 
\item 
{\bf KFile\-Meta\-Info\-Item} {\bf item} (const KFile\-Meta\-Info\-Item::Hint hint) const 
\item 
{\bf KFile\-Meta\-Info\-Item} {\bf save\-Item} (const {\bf QString} \&key, const {\bf QString} \&preferred\-Group=QString::null, bool create\-Group=true)
\item 
{\bf KFile\-Meta\-Info\-Group} {\bf group} (const {\bf QString} \&key) const 
\item 
{\bf KFile\-Meta\-Info\-Group} {\bf operator[$\,$]} (const {\bf QString} \&key) const 
\item 
bool {\bf add\-Group} (const {\bf QString} \&name)
\item 
bool {\bf remove\-Group} (const {\bf QString} \&name)
\item 
{\bf QString\-List} {\bf removed\-Groups} ()
\item 
bool {\bf apply\-Changes} ()
\item 
bool {\bf contains} (const {\bf QString} \&key) const 
\item 
bool {\bf contains\-Group} (const {\bf QString} \&key) const 
\item 
const {\bf QVariant} {\bf value} (const {\bf QString} \&key) const \label{classKFileMetaInfo_a23}

\item 
bool {\bf is\-Valid} () const 
\item 
bool {\bf is\-Empty} () const 
\item 
{\bf QString} {\bf mime\-Type} () const 
\item 
{\bf QString} {\bf path} () const 
\item 
{\bf KURL} {\bf url} () const 
\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
{\bf KFile\-Meta\-Info\-Group} {\bf append\-Group} (const {\bf QString} \&name)\label{classKFileMetaInfo_b0}

\item 
{\bf KFile\-Plugin} $\ast$const {\bf plugin} () const 
\item 
void {\bf ref} ()\label{classKFileMetaInfo_b2}

\item 
void {\bf deref} ()\label{classKFileMetaInfo_b3}

\end{CompactItemize}
\subsection*{Protected Attributes}
\begin{CompactItemize}
\item 
Data $\ast$ {\bf d}\label{classKFileMetaInfo_p0}

\end{CompactItemize}
\subsection*{Friends}
\begin{CompactItemize}
\item 
class {\bf KFile\-Plugin}\label{classKFileMetaInfo_n0}

\item 
KIO\_\-EXPORT friend {\bf QData\-Stream} \& {\bf operator$>$$>$} ({\bf QData\-Stream} \&s, {\bf KFile\-Meta\-Info} \&)\label{classKFileMetaInfo_n1}

\item 
KIO\_\-EXPORT friend {\bf QData\-Stream} \& {\bf operator$<$$<$} ({\bf QData\-Stream} \&s, const {\bf KFile\-Meta\-Info} \&)\label{classKFileMetaInfo_n2}

\end{CompactItemize}


\subsection{Detailed Description}
This is the class for objects that hold meta information about a file. Meta Information about a file. 

The information is kept in form of a system of key/value pairs. See also {\bf KFile\-Meta\-Info\-Item}{\rm (p.\,\pageref{classKFileMetaInfoItem})}. This information is retrieved from the file through a plugin system, and this class is the main interface to it. If you want to write your own plugin, have a look at {\bf KFile\-Plugin}{\rm (p.\,\pageref{classKFilePlugin})}. There are basically two different kinds of meta information: Fixed ones that the plugin knows about (e.g. an mp3 id3v1 tag has a well defined fixed list of fields), and variable keys that exist in mimetypes that support their own key/value system (comments in png files are of this type). Almost every file has fixed keys, but some also have variable keys.

The groups and the What enum are not yet supported, but already added to the interface so that adding support doesn't break compatibility. 



Definition at line 887 of file kfilemetainfo.h.

\subsection{Member Enumeration Documentation}
\index{KFileMetaInfo@{KFile\-Meta\-Info}!What@{What}}
\index{What@{What}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KFile\-Meta\-Info::What}}\label{classKFileMetaInfo_w11}


This is used to specify what a KFile\-Meta\-Info object should read, so you can specify if you want to read \char`\"{}expensive\char`\"{} items or not. 

\begin{Desc}
\item[Enumeration values: ]\par
\begin{description}
\index{Fastest@{Fastest}!KFileMetaInfo@{KFileMetaInfo}}\index{KFileMetaInfo@{KFileMetaInfo}!Fastest@{Fastest}}\item[{\em 
Fastest\label{classKFileMetaInfo_w11w3}
}]do the fastest possible read and omit all items that might need a significantly longer time than the others \index{DontCare@{DontCare}!KFileMetaInfo@{KFileMetaInfo}}\index{KFileMetaInfo@{KFileMetaInfo}!DontCare@{DontCare}}\item[{\em 
Dont\-Care\label{classKFileMetaInfo_w11w4}
}]let the plugin decide what to read \index{TechnicalInfo@{TechnicalInfo}!KFileMetaInfo@{KFileMetaInfo}}\index{KFileMetaInfo@{KFileMetaInfo}!TechnicalInfo@{TechnicalInfo}}\item[{\em 
Technical\-Info\label{classKFileMetaInfo_w11w5}
}]extract technical details about the file, like e.g 

play time, resolution or a compressioni type \index{ContentInfo@{ContentInfo}!KFileMetaInfo@{KFileMetaInfo}}\index{KFileMetaInfo@{KFileMetaInfo}!ContentInfo@{ContentInfo}}\item[{\em 
Content\-Info\label{classKFileMetaInfo_w11w6}
}]read information about the content of the file, like comments or id3 tags \index{ExtenedAttr@{ExtenedAttr}!KFileMetaInfo@{KFileMetaInfo}}\index{KFileMetaInfo@{KFileMetaInfo}!ExtenedAttr@{ExtenedAttr}}\item[{\em 
Extened\-Attr\label{classKFileMetaInfo_w11w7}
}]read filesystem based extended attributes if they are supported for the filesystem \index{Thumbnail@{Thumbnail}!KFileMetaInfo@{KFileMetaInfo}}\index{KFileMetaInfo@{KFileMetaInfo}!Thumbnail@{Thumbnail}}\item[{\em 
Thumbnail\label{classKFileMetaInfo_w11w8}
}]only read the file's thumbnail, if it contains one \index{Preferred@{Preferred}!KFileMetaInfo@{KFileMetaInfo}}\index{KFileMetaInfo@{KFileMetaInfo}!Preferred@{Preferred}}\item[{\em 
Preferred\label{classKFileMetaInfo_w11w9}
}]get at least the preferred items \index{Everything@{Everything}!KFileMetaInfo@{KFileMetaInfo}}\index{KFileMetaInfo@{KFileMetaInfo}!Everything@{Everything}}\item[{\em 
Everything\label{classKFileMetaInfo_w11w10}
}]read everything, even if it might take a while \end{description}
\end{Desc}



Definition at line 899 of file kfilemetainfo.h.

\subsection{Constructor \& Destructor Documentation}
\index{KFileMetaInfo@{KFile\-Meta\-Info}!KFileMetaInfo@{KFileMetaInfo}}
\index{KFileMetaInfo@{KFileMetaInfo}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KFile\-Meta\-Info::KFile\-Meta\-Info (const {\bf QString} \& {\em path}, const {\bf QString} \& {\em mime\-Type} = {\tt QString::null}, uint {\em what} = {\tt Fastest})}\label{classKFileMetaInfo_a0}


The constructor. 

creating a KFile\-Meta\-Info item through this will autoload the plugin belonging to the mimetype and try to get meta information about the specified file.

If no info is available, you'll get an empty (not invalid) object. You can test for it with the {\bf is\-Empty()}{\rm (p.\,\pageref{classKFileMetaInfo_a25})} method.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em path}]The file name. This must be the path to a local file. \item[{\em mime\-Type}]The name of the file's mimetype. If ommited, the mimetype is autodetected \item[{\em what}]one or more of the What enum values. It gives some hint to the plugin what information is desired. The plugin may still return more items.\end{description}
\end{Desc}
\begin{Desc}
\item[Note:]This version will {\bf only} work for {\bf local} ({\tt file:/}) files. \end{Desc}


Definition at line 297 of file kfilemetainfo.cpp.

References mime\-Type(), path(), and KURL::set\-Path().\index{KFileMetaInfo@{KFile\-Meta\-Info}!KFileMetaInfo@{KFileMetaInfo}}
\index{KFileMetaInfo@{KFileMetaInfo}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KFile\-Meta\-Info::KFile\-Meta\-Info (const {\bf KURL} \& {\em url}, const {\bf QString} \& {\em mime\-Type} = {\tt QString::null}, uint {\em what} = {\tt Fastest})}\label{classKFileMetaInfo_a1}


Another constructor. 

Similar to the above, but takes a URL so that meta-data may be retrieved over other protocols (ftp, etc.) 

Definition at line 306 of file kfilemetainfo.cpp.

References mime\-Type(), and url().\index{KFileMetaInfo@{KFile\-Meta\-Info}!KFileMetaInfo@{KFileMetaInfo}}
\index{KFileMetaInfo@{KFileMetaInfo}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KFile\-Meta\-Info::KFile\-Meta\-Info ()}\label{classKFileMetaInfo_a2}


Default constructor. 

This will create an invalid object (see {\bf is\-Valid()}{\rm (p.\,\pageref{classKFileMetaInfo_a24})}. 

Definition at line 351 of file kfilemetainfo.cpp.\index{KFileMetaInfo@{KFile\-Meta\-Info}!KFileMetaInfo@{KFileMetaInfo}}
\index{KFileMetaInfo@{KFileMetaInfo}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KFile\-Meta\-Info::KFile\-Meta\-Info (const {\bf KFile\-Meta\-Info} \& {\em original})}\label{classKFileMetaInfo_a3}


Copy constructor. 

This creates a copy of the original object, but that copy will point to the same data, so if you change the original, the copy will be changed, too. After all, they are referring to the same file. 

Definition at line 344 of file kfilemetainfo.cpp.

\subsection{Member Function Documentation}
\index{KFileMetaInfo@{KFile\-Meta\-Info}!operator=@{operator=}}
\index{operator=@{operator=}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf KFile\-Meta\-Info} \& KFile\-Meta\-Info::operator= (const {\bf KFile\-Meta\-Info} \& {\em info})}\label{classKFileMetaInfo_a5}


The assignment operator, so you can do e.g.: 

\footnotesize\begin{verbatim}    KFileMetaInfo info;
    if (something) info = KFileMetaInfo("/the/file");
\end{verbatim}
\normalsize
. 

This will create a shared copy of the object. The actual data is automatically deleted if all copies go out of scope. 

Definition at line 500 of file kfilemetainfo.cpp.

References d.\index{KFileMetaInfo@{KFile\-Meta\-Info}!groups@{groups}}
\index{groups@{groups}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info::groups () const}\label{classKFileMetaInfo_a6}


Returns a list of all groups. 

\begin{Desc}
\item[Returns:]the keys of the groups that the file has. \end{Desc}


Definition at line 373 of file kfilemetainfo.cpp.

Referenced by contains(), contains\-Group(), item(), preferred\-Groups(), and save\-Item().\index{KFileMetaInfo@{KFile\-Meta\-Info}!supportedGroups@{supportedGroups}}
\index{supportedGroups@{supportedGroups}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info::supported\-Groups () const}\label{classKFileMetaInfo_a7}


Returns a list of all supported groups. 

\begin{Desc}
\item[Returns:]the supported keys of the groups that the file has. \end{Desc}


Definition at line 361 of file kfilemetainfo.cpp.

References is\-Valid().

Referenced by editable\-Groups().\index{KFileMetaInfo@{KFile\-Meta\-Info}!preferredGroups@{preferredGroups}}
\index{preferredGroups@{preferredGroups}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info::preferred\-Groups () const}\label{classKFileMetaInfo_a8}


Returns a list of the preferred groups. 

\begin{Desc}
\item[Returns:]the keys of the preferred groups that the file has. \end{Desc}


Definition at line 398 of file kfilemetainfo.cpp.

References group(), groups(), and is\-Valid().

Referenced by item(), preferred\-Keys(), and save\-Item().\index{KFileMetaInfo@{KFile\-Meta\-Info}!preferredKeys@{preferredKeys}}
\index{preferredKeys@{preferredKeys}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info::preferred\-Keys () const}\label{classKFileMetaInfo_a9}


Returns a list of all preferred keys. 

\begin{Desc}
\item[Returns:]a list of all preferred keys. \end{Desc}


Definition at line 424 of file kfilemetainfo.cpp.

References preferred\-Groups().

Referenced by KFile\-Item::get\-Tool\-Tip\-Text().\index{KFileMetaInfo@{KFile\-Meta\-Info}!supportedKeys@{supportedKeys}}
\index{supportedKeys@{supportedKeys}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info::supported\-Keys () const}\label{classKFileMetaInfo_a10}


Returns a list of supported keys. 

\begin{Desc}
\item[Returns:]a list of supported keys \end{Desc}


Definition at line 367 of file kfilemetainfo.cpp.

References is\-Valid().\index{KFileMetaInfo@{KFile\-Meta\-Info}!editableGroups@{editableGroups}}
\index{editableGroups@{editableGroups}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info::editable\-Groups () const}\label{classKFileMetaInfo_a11}


Returns the list of groups that you can add or remove from the file. 

\begin{Desc}
\item[Returns:]the groups can be added or removed \end{Desc}


Definition at line 383 of file kfilemetainfo.cpp.

References KFile\-Mime\-Type\-Info::Group\-Info::attributes(), and supported\-Groups().\index{KFileMetaInfo@{KFile\-Meta\-Info}!item@{item}}
\index{item@{item}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KFile\-Meta\-Info\-Item} KFile\-Meta\-Info::item (const {\bf QString} \& {\em key}) const}\label{classKFileMetaInfo_a12}


Returns the {\bf KFile\-Meta\-Info\-Item}{\rm (p.\,\pageref{classKFileMetaInfoItem})} with the given {\tt key}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em key}]the key of the item \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the item. Invalid if there is no item with the given {\tt key}. \end{Desc}


Definition at line 598 of file kfilemetainfo.cpp.

References groups(), KFile\-Meta\-Info\-Item::is\-Valid(), and preferred\-Groups().

Referenced by KFile\-Item::get\-Tool\-Tip\-Text(), and save\-Item().\index{KFileMetaInfo@{KFile\-Meta\-Info}!item@{item}}
\index{item@{item}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KFile\-Meta\-Info\-Item} KFile\-Meta\-Info::item (const KFile\-Meta\-Info\-Item::Hint {\em hint}) const}\label{classKFileMetaInfo_a13}


Returns the {\bf KFile\-Meta\-Info\-Item}{\rm (p.\,\pageref{classKFileMetaInfoItem})} with the given {\tt hint}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em hint}]the hint of the item \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the item. Invalid if there is no item with the given {\tt hint}. \end{Desc}


Definition at line 609 of file kfilemetainfo.cpp.

References groups(), KFile\-Meta\-Info\-Item::is\-Valid(), and preferred\-Groups().\index{KFileMetaInfo@{KFile\-Meta\-Info}!saveItem@{saveItem}}
\index{saveItem@{saveItem}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KFile\-Meta\-Info\-Item} KFile\-Meta\-Info::save\-Item (const {\bf QString} \& {\em key}, const {\bf QString} \& {\em preferred\-Group} = {\tt QString::null}, bool {\em create\-Group} = {\tt true})}\label{classKFileMetaInfo_a14}


Saves the item with the given {\tt key}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em key}]the key of the item \item[{\em preferred\-Group}]the preferred group, or QString::null \item[{\em create\-Group}]true to create the group if necessary \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the saved item \end{Desc}


Definition at line 621 of file kfilemetainfo.cpp.

References add\-Group(), KFile\-Meta\-Info\-Group::add\-Item(), QMap\-Iterator::data(), group(), groups(), KFile\-Meta\-Info\-Item::is\-Valid(), is\-Valid(), item(), preferred\-Groups(), and KFile\-Mime\-Type\-Info::Group\-Info::supported\-Keys().\index{KFileMetaInfo@{KFile\-Meta\-Info}!group@{group}}
\index{group@{group}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KFile\-Meta\-Info\-Group} KFile\-Meta\-Info::group (const {\bf QString} \& {\em key}) const}\label{classKFileMetaInfo_a15}


Returns the {\bf KFile\-Meta\-Info\-Group}{\rm (p.\,\pageref{classKFileMetaInfoGroup})} with the given {\tt key}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em key}]the key of the item \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the group. Invalid if there is no group with the given {\tt key}. \end{Desc}


Definition at line 437 of file kfilemetainfo.cpp.

References QMap\-Iterator::data().

Referenced by add\-Group(), preferred\-Groups(), and save\-Item().\index{KFileMetaInfo@{KFile\-Meta\-Info}!operator[]@{operator[]}}
\index{operator[]@{operator[]}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KFile\-Meta\-Info\-Group} KFile\-Meta\-Info::operator[$\,$] (const {\bf QString} \& {\em key}) const\hspace{0.3cm}{\tt  [inline]}}\label{classKFileMetaInfo_a16}


Returns the {\bf KFile\-Meta\-Info\-Group}{\rm (p.\,\pageref{classKFileMetaInfoGroup})} with the given {\tt key}. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em key}]the key of the item \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the group. Invalid if there is no group with the given {\tt key}. \end{Desc}


Definition at line 1058 of file kfilemetainfo.h.\index{KFileMetaInfo@{KFile\-Meta\-Info}!addGroup@{addGroup}}
\index{addGroup@{addGroup}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info::add\-Group (const {\bf QString} \& {\em name})}\label{classKFileMetaInfo_a17}


Try to add the specified group. 

This will only succeed if it is in the list of {\bf editable\-Groups()}{\rm (p.\,\pageref{classKFileMetaInfo_a11})}. \begin{Desc}
\item[Note:]that all non-variable items that belong to this group are automatically added as empty item. \end{Desc}
\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em name}]the name of the group to add \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]true if successful, false if not \end{Desc}


Definition at line 446 of file kfilemetainfo.cpp.

References KFile\-Meta\-Info\-Group::append\-Item(), KFile\-Mime\-Type\-Info::Item\-Info::attributes(), group(), is\-Valid(), KFile\-Mime\-Type\-Info::Group\-Info::item\-Info(), KFile\-Mime\-Type\-Info::Item\-Info::key(), KFile\-Meta\-Info\-Group::set\-Added(), and KFile\-Mime\-Type\-Info::Group\-Info::supported\-Keys().

Referenced by save\-Item().\index{KFileMetaInfo@{KFile\-Meta\-Info}!removeGroup@{removeGroup}}
\index{removeGroup@{removeGroup}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info::remove\-Group (const {\bf QString} \& {\em name})}\label{classKFileMetaInfo_a18}


Remove the specified group. 

This will only succeed if it is in the list of {\bf editable\-Groups()}{\rm (p.\,\pageref{classKFileMetaInfo_a11})}. Beware that this also removes all the items in that group, so always ask the user before removing it! \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em name}]the name of the group to remove \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]true if successful, false if not \end{Desc}


Definition at line 483 of file kfilemetainfo.cpp.\index{KFileMetaInfo@{KFile\-Meta\-Info}!removedGroups@{removedGroups}}
\index{removedGroups@{removedGroups}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info::removed\-Groups ()}\label{classKFileMetaInfo_a19}


Returns a list of removed groups. 

\begin{Desc}
\item[Returns:]a list of removed groups. \end{Desc}


Definition at line 495 of file kfilemetainfo.cpp.\index{KFileMetaInfo@{KFile\-Meta\-Info}!applyChanges@{applyChanges}}
\index{applyChanges@{applyChanges}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info::apply\-Changes ()}\label{classKFileMetaInfo_a20}


This method writes all pending changes of the meta info back to the file. 

If any items are marked as removed, they are really removed from the list. The info object as well as all items are updated. \begin{Desc}
\item[Returns:]true if successful, false if not \end{Desc}


Definition at line 528 of file kfilemetainfo.cpp.

References QMap\-Const\-Iterator::data(), kd\-Debug(), plugin(), and KFile\-Plugin::write\-Info().\index{KFileMetaInfo@{KFile\-Meta\-Info}!contains@{contains}}
\index{contains@{contains}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info::contains (const {\bf QString} \& {\em key}) const}\label{classKFileMetaInfo_a21}


Checks whether an item with the given {\tt key} exists. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em key}]the key to check \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]whether an item for this {\tt key} exists. \end{Desc}


Definition at line 582 of file kfilemetainfo.cpp.

References KFile\-Meta\-Info\-Group::contains(), and groups().\index{KFileMetaInfo@{KFile\-Meta\-Info}!containsGroup@{containsGroup}}
\index{containsGroup@{containsGroup}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info::contains\-Group (const {\bf QString} \& {\em key}) const}\label{classKFileMetaInfo_a22}


Checks whether a group with the given {\tt key} exists. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em key}]the key to check \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]whether a group with this name exists. \end{Desc}


Definition at line 593 of file kfilemetainfo.cpp.

References groups().\index{KFileMetaInfo@{KFile\-Meta\-Info}!isValid@{isValid}}
\index{isValid@{isValid}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info::is\-Valid () const}\label{classKFileMetaInfo_a24}


Returns true if the item is valid, i.e. 

if actually represents the info about a file, false if the object is uninitialized. \begin{Desc}
\item[Returns:]true if valid, false otherwise \end{Desc}


Definition at line 513 of file kfilemetainfo.cpp.

Referenced by add\-Group(), KFile\-Item::get\-Tool\-Tip\-Text(), KFile\-Item::meta\-Info(), mime\-Type(), plugin(), preferred\-Groups(), save\-Item(), supported\-Groups(), and supported\-Keys().\index{KFileMetaInfo@{KFile\-Meta\-Info}!isEmpty@{isEmpty}}
\index{isEmpty@{isEmpty}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info::is\-Empty () const}\label{classKFileMetaInfo_a25}


Returns false if the object contains data, true if it's empty. 

You'll get an empty object if no plugin for the file could be found. \begin{Desc}
\item[Returns:]true if empty, false otherwise \end{Desc}


Definition at line 519 of file kfilemetainfo.cpp.

Referenced by KFile\-Item::get\-Tool\-Tip\-Text().\index{KFileMetaInfo@{KFile\-Meta\-Info}!mimeType@{mimeType}}
\index{mimeType@{mimeType}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KFile\-Meta\-Info::mime\-Type () const}\label{classKFileMetaInfo_a26}


Returns the mime type of file. 

\begin{Desc}
\item[Returns:]the file's mime type \end{Desc}


Definition at line 576 of file kfilemetainfo.cpp.

References is\-Valid().

Referenced by KFile\-Meta\-Info().\index{KFileMetaInfo@{KFile\-Meta\-Info}!path@{path}}
\index{path@{path}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KFile\-Meta\-Info::path () const}\label{classKFileMetaInfo_a27}


Returns the path of file - or QString::null if file is non-local. 

\begin{Desc}
\item[Returns:]the file's path - or QString::null if file is non-local \end{Desc}


Definition at line 718 of file kfilemetainfo.cpp.

Referenced by KFile\-Meta\-Info().\index{KFileMetaInfo@{KFile\-Meta\-Info}!url@{url}}
\index{url@{url}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KURL} KFile\-Meta\-Info::url () const}\label{classKFileMetaInfo_a28}


Returns the url of file. 

\begin{Desc}
\item[Returns:]the file's url \end{Desc}


Definition at line 723 of file kfilemetainfo.cpp.

References KURL::url().

Referenced by KFile\-Meta\-Info().\index{KFileMetaInfo@{KFile\-Meta\-Info}!plugin@{plugin}}
\index{plugin@{plugin}!KFileMetaInfo@{KFile\-Meta\-Info}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KFile\-Plugin} $\ast$const KFile\-Meta\-Info::plugin () const\hspace{0.3cm}{\tt  [protected]}}\label{classKFileMetaInfo_b1}


\begin{Desc}
\item[Returns:]a pointer to the plugin that belogs to this object's mimetype. It will be auto-loaded if it's currently not loaded \end{Desc}


Definition at line 569 of file kfilemetainfo.cpp.

References is\-Valid().

Referenced by apply\-Changes().

The documentation for this class was generated from the following files:\begin{CompactItemize}
\item 
kfilemetainfo.h\item 
kfilemetainfo.cpp\end{CompactItemize}
