\section{KFile\-Meta\-Info\-Group Class Reference}
\label{classKFileMetaInfoGroup}\index{KFileMetaInfoGroup@{KFileMetaInfoGroup}}
This is one group of meta information items about a file (see {\bf KFile\-Meta\-Info}{\rm (p.\,\pageref{classKFileMetaInfo})}). A group of meta information items about a file.  


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

\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
class {\bf KFile\-Meta\-Info\-Group} (const {\bf QString} \&name, const {\bf KFile\-Mime\-Type\-Info} $\ast$info)\label{classKFileMetaInfoGroup_a0}

\item 
{\bf KFile\-Meta\-Info\-Group} (const {\bf KFile\-Meta\-Info\-Group} \&original)
\item 
const {\bf KFile\-Meta\-Info\-Group} \& {\bf operator=} (const {\bf KFile\-Meta\-Info\-Group} \&info)
\item 
{\bf KFile\-Meta\-Info\-Group} ()
\item 
bool {\bf is\-Valid} () const 
\item 
bool {\bf is\-Empty} () const 
\item 
bool {\bf is\-Modified} () const 
\item 
{\bf KFile\-Meta\-Info\-Item} {\bf operator[$\,$]} (const {\bf QString} \&key) const 
\item 
{\bf KFile\-Meta\-Info\-Item} {\bf item} (const {\bf QString} \&key) const 
\item 
{\bf KFile\-Meta\-Info\-Item} {\bf item} (uint hint) const 
\item 
const {\bf QVariant} {\bf value} (const {\bf QString} \&key) const 
\item 
{\bf QString\-List} {\bf supported\-Keys} () const 
\item 
bool {\bf supports\-Variable\-Keys} () const 
\item 
bool {\bf contains} (const {\bf QString} \&key) const 
\item 
{\bf QString\-List} {\bf keys} () const 
\item 
{\bf QString\-List} {\bf preferred\-Keys} () const 
\item 
{\bf KFile\-Meta\-Info\-Item} {\bf add\-Item} (const {\bf QString} \&key)
\item 
bool {\bf remove\-Item} (const {\bf QString} \&key)
\item 
{\bf QString\-List} {\bf removed\-Items} ()
\item 
{\bf QString} {\bf name} () const 
\item 
{\bf QString} {\bf translated\-Name} () const 
\item 
uint {\bf attributes} () const 
\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
void {\bf set\-Added} ()\label{classKFileMetaInfoGroup_b0}

\item 
{\bf KFile\-Meta\-Info\-Item} {\bf append\-Item} (const {\bf QString} \&key, const {\bf QVariant} \&value)\label{classKFileMetaInfoGroup_b1}

\item 
void {\bf ref} ()\label{classKFileMetaInfoGroup_b2}

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

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

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

\item 
class {\bf KFile\-Meta\-Info}\label{classKFileMetaInfoGroup_n1}

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

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

\end{CompactItemize}


\subsection{Detailed Description}
This is one group of meta information items about a file (see {\bf KFile\-Meta\-Info}{\rm (p.\,\pageref{classKFileMetaInfo})}). A group of meta information items about a file. 



Definition at line 664 of file kfilemetainfo.h.

\subsection{Constructor \& Destructor Documentation}
\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!KFileMetaInfoGroup@{KFileMetaInfoGroup}}
\index{KFileMetaInfoGroup@{KFileMetaInfoGroup}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KFile\-Meta\-Info\-Group::KFile\-Meta\-Info\-Group (const {\bf KFile\-Meta\-Info\-Group} \& {\em original})}\label{classKFileMetaInfoGroup_a1}


Copy constructor. 



Definition at line 1168 of file kfilemetainfo.cpp.\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!KFileMetaInfoGroup@{KFileMetaInfoGroup}}
\index{KFileMetaInfoGroup@{KFileMetaInfoGroup}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KFile\-Meta\-Info\-Group::KFile\-Meta\-Info\-Group ()}\label{classKFileMetaInfoGroup_a3}


Default constructor. 

This creates an \char`\"{}invalid\char`\"{} item \begin{Desc}
\item[Since:]3.1 \end{Desc}


Definition at line 1175 of file kfilemetainfo.cpp.

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


The assignment operator, so you can do: 

\footnotesize\begin{verbatim}    KFileMetaInfoGroup group = info.group("Technical");
\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 1185 of file kfilemetainfo.cpp.

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


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

if it contains data, false if it's invalid (created with the default constructor and not been assigned anything), or if {\bf KFile\-Meta\-Info\-Group::item()}{\rm (p.\,\pageref{classKFileMetaInfoGroup_a9})} didn't find your requested item). \begin{Desc}
\item[Returns:]true if valid, false if invalid \end{Desc}


Definition at line 1198 of file kfilemetainfo.cpp.

Referenced by add\-Item(), attributes(), preferred\-Keys(), remove\-Item(), supported\-Keys(), supports\-Variable\-Keys(), and translated\-Name().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!isEmpty@{isEmpty}}
\index{isEmpty@{isEmpty}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info\-Group::is\-Empty () const}\label{classKFileMetaInfoGroup_a6}


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

An empty group is a group with no items (amazing, isn't it?). \begin{Desc}
\item[Returns:]true if empty, false otherwise \end{Desc}


Definition at line 1204 of file kfilemetainfo.cpp.\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!isModified@{isModified}}
\index{isModified@{isModified}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info\-Group::is\-Modified () const}\label{classKFileMetaInfoGroup_a7}


Returns true if an item as added or removed from the group. 

\begin{Desc}
\item[Returns:]true if an item was added or removed from the group, otherwise false. \end{Desc}
\begin{Desc}
\item[Since:]3.1 \end{Desc}


Definition at line 1314 of file kfilemetainfo.cpp.\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!operator[]@{operator[]}}
\index{operator[]@{operator[]}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KFile\-Meta\-Info\-Item} KFile\-Meta\-Info\-Group::operator[$\,$] (const {\bf QString} \& {\em key}) const\hspace{0.3cm}{\tt  [inline]}}\label{classKFileMetaInfoGroup_a8}


Operator for convenience. 

It does the same as {\bf item()}{\rm (p.\,\pageref{classKFileMetaInfoGroup_a9})}, but you cannot specify a group to search in 

Definition at line 733 of file kfilemetainfo.h.\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!item@{item}}
\index{item@{item}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KFile\-Meta\-Info\-Item} KFile\-Meta\-Info\-Group::item (const {\bf QString} \& {\em key}) const}\label{classKFileMetaInfoGroup_a9}


This method searches for the specified item. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em key}]the key of the item to search \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the specified item if found, an invalid item, if not \end{Desc}


Definition at line 1278 of file kfilemetainfo.cpp.

References QMap\-Iterator::data().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!item@{item}}
\index{item@{item}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KFile\-Meta\-Info\-Item} KFile\-Meta\-Info\-Group::item (uint {\em hint}) const}\label{classKFileMetaInfoGroup_a10}


Returns the item 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 with the specified {\tt hint} \end{Desc}


Definition at line 1287 of file kfilemetainfo.cpp.

References QMap\-Iterator::data().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!value@{value}}
\index{value@{value}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf QVariant} KFile\-Meta\-Info\-Group::value (const {\bf QString} \& {\em key}) const\hspace{0.3cm}{\tt  [inline]}}\label{classKFileMetaInfoGroup_a11}


Convenience function. 

Returns the value of the specified key. It does the same as item(key).{\bf value()}{\rm (p.\,\pageref{classKFileMetaInfoGroup_a11})}. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em key}]the key of the item to search \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the value with the given key \end{Desc}


Definition at line 757 of file kfilemetainfo.h.

References KFile\-Meta\-Info\-Item::value().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!supportedKeys@{supportedKeys}}
\index{supportedKeys@{supportedKeys}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info\-Group::supported\-Keys () const}\label{classKFileMetaInfoGroup_a12}


Use this method to get a list of keys in the specified group that the plugin knows about. 

No variable keys. For a group that doesn't support variable keys, all keys that this group may have are returned. For a group that does support them, the non-variable ones are returned. See {\bf KFile\-Meta\-Info}{\rm (p.\,\pageref{classKFileMetaInfo})} about variable keys

\begin{Desc}
\item[Returns:]the list of keys supported for this mimetype \end{Desc}


Definition at line 1261 of file kfilemetainfo.cpp.

References is\-Valid().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!supportsVariableKeys@{supportsVariableKeys}}
\index{supportsVariableKeys@{supportsVariableKeys}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info\-Group::supports\-Variable\-Keys () const}\label{classKFileMetaInfoGroup_a13}


Returns true if this group supports adding or removing arbitrary keys, false if not. 

\begin{Desc}
\item[Returns:]true is variable keys are supported, false otherwise \end{Desc}


Definition at line 1267 of file kfilemetainfo.cpp.

References is\-Valid().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!contains@{contains}}
\index{contains@{contains}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KFile\-Meta\-Info\-Group::contains (const {\bf QString} \& {\em key}) const}\label{classKFileMetaInfoGroup_a14}


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

\begin{Desc}
\item[Returns:]true if an item for this {\tt key} exists. \end{Desc}


Definition at line 1273 of file kfilemetainfo.cpp.

Referenced by KFile\-Meta\-Info::contains().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!keys@{keys}}
\index{keys@{keys}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info\-Group::keys () const}\label{classKFileMetaInfoGroup_a15}


Returns a list of all keys. 

\begin{Desc}
\item[Returns:]a list of all keys in the order they were inserted. \end{Desc}


Definition at line 1237 of file kfilemetainfo.cpp.

References QMap\-Const\-Iterator::data(), kd\-Warning(), and QMap\-Const\-Iterator::key().

Referenced by preferred\-Keys().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!preferredKeys@{preferredKeys}}
\index{preferredKeys@{preferredKeys}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info\-Group::preferred\-Keys () const}\label{classKFileMetaInfoGroup_a16}


Returns a list of all keys in preference order. 

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


Definition at line 1209 of file kfilemetainfo.cpp.

References is\-Valid(), keys(), and preferred\-Keys().

Referenced by preferred\-Keys().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!addItem@{addItem}}
\index{addItem@{addItem}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KFile\-Meta\-Info\-Item} KFile\-Meta\-Info\-Group::add\-Item (const {\bf QString} \& {\em key})}\label{classKFileMetaInfoGroup_a17}


Add an item to the info. 

This is only possible if the specified {\tt key} is in the supported\-Keys list and not yet defined or if the group supports variable keys. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em key}]the key of the item \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the {\bf KFile\-Meta\-Info\-Item}{\rm (p.\,\pageref{classKFileMetaInfoItem})} for the given {\tt key} \end{Desc}


Definition at line 1340 of file kfilemetainfo.cpp.

References QMap\-Iterator::data(), is\-Valid(), KFile\-Mime\-Type\-Info::Item\-Info::is\-Variable\-Item(), KFile\-Mime\-Type\-Info::Group\-Info::item\-Info(), KFile\-Meta\-Info\-Item::set\-Added(), and KFile\-Mime\-Type\-Info::Group\-Info::variable\-Item\-Info().

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


Remove this item from the meta info of the file. 

You cannot query {\bf KFile\-Meta\-Info}{\rm (p.\,\pageref{classKFileMetaInfo})} for a removed object, but you can query for a list of removed items with {\bf removed\-Items()}{\rm (p.\,\pageref{classKFileMetaInfoGroup_a19})} if you need to. If you re-add it, its value will be cleared. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em key}]the key of the removed item \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]true if successful, false otherwise \end{Desc}


Definition at line 1374 of file kfilemetainfo.cpp.

References is\-Valid(), and kd\-Debug().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!removedItems@{removedItems}}
\index{removedItems@{removedItems}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString\-List} KFile\-Meta\-Info\-Group::removed\-Items ()}\label{classKFileMetaInfoGroup_a19}


Returns a list of all removed items. 

\begin{Desc}
\item[Returns:]a list of all removed items \end{Desc}


Definition at line 1402 of file kfilemetainfo.cpp.\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!name@{name}}
\index{name@{name}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KFile\-Meta\-Info\-Group::name () const}\label{classKFileMetaInfoGroup_a20}


The name of this group. 

\begin{Desc}
\item[Returns:]the name of this group \end{Desc}


Definition at line 1298 of file kfilemetainfo.cpp.\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!translatedName@{translatedName}}
\index{translatedName@{translatedName}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KFile\-Meta\-Info\-Group::translated\-Name () const}\label{classKFileMetaInfoGroup_a21}


The translated name of this group. 

\begin{Desc}
\item[Returns:]the translated name of this group \end{Desc}
\begin{Desc}
\item[Since:]3.2 \end{Desc}


Definition at line 1255 of file kfilemetainfo.cpp.

References is\-Valid().\index{KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}!attributes@{attributes}}
\index{attributes@{attributes}!KFileMetaInfoGroup@{KFile\-Meta\-Info\-Group}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}uint KFile\-Meta\-Info\-Group::attributes () const}\label{classKFileMetaInfoGroup_a22}


Returns the attributes of this item. 

\begin{Desc}
\item[Returns:]the attributes \end{Desc}


Definition at line 1303 of file kfilemetainfo.cpp.

References is\-Valid().

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