\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})}).  


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

\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\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)
\begin{CompactList}\small\item\em Copy onstructor. \item\end{CompactList}\item 
const  {\bf KFile\-Meta\-Info\-Group} \& {\bf operator=} (const  {\bf KFile\-Meta\-Info\-Group} \&info)
\begin{CompactList}\small\item\em The assignment operator, so you can do:. \item\end{CompactList}\item 
{\bf KFile\-Meta\-Info\-Group} ()
\begin{CompactList}\small\item\em Default constructor. \item\end{CompactList}\item 
bool {\bf is\-Valid} () const 
\item 
bool {\bf is\-Empty} () const 
\item 
bool {\bf is\-Modified} () const 
\begin{CompactList}\small\item\em Returns true if an item as added or removed from the group. \item\end{CompactList}\item 
{\bf KFile\-Meta\-Info\-Item} {\bf operator[$\,$]} (const  {\bf QString} \&key) const 
\begin{CompactList}\small\item\em operator for convenience. \item\end{CompactList}\item 
{\bf KFile\-Meta\-Info\-Item} {\bf item} (const  {\bf QString} \&key) const 
\begin{CompactList}\small\item\em This method searches for the specified item. \item\end{CompactList}\item 
{\bf KFile\-Meta\-Info\-Item} {\bf item} (uint hint) const 
\item 
const  {\bf QVariant} {\bf value} (const  {\bf QString} \&key) const 
\begin{CompactList}\small\item\em Convenience function. \item\end{CompactList}\item 
{\bf QString\-List} {\bf supported\-Keys} () const 
\begin{CompactList}\small\item\em Use this method to get a list of keys in the specified group that the plugin knows about. \item\end{CompactList}\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)
\begin{CompactList}\small\item\em add an item to the info. \item\end{CompactList}\item 
bool {\bf remove\-Item} (const  {\bf QString} \&key)
\begin{CompactList}\small\item\em remove this item from the meta info of the file. \item\end{CompactList}\item 
{\bf QString\-List} {\bf removed\-Items} ()\label{classKFileMetaInfoGroup_a19}

\item 
{\bf QString} {\bf name} () const \label{classKFileMetaInfoGroup_a20}

\item 
uint {\bf attributes} () const \label{classKFileMetaInfoGroup_a21}

\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 
{\bf QData\-Stream} \& {\bf operator$>$$>$} ({\bf QData\-Stream} \&s, {\bf KFile\-Meta\-Info\-Group} \&)\label{classKFileMetaInfoGroup_n2}

\item 
{\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})}). 



Definition at line 662 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 onstructor. 



Definition at line 1037 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 1044 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:. 

\small\begin{alltt}
    KFileMetaInfoGroup group = info.group("Technical");
 \end{alltt}\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 1054 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}


\begin{Desc}
\item[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) \end{Desc}


Definition at line 1067 of file kfilemetainfo.cpp.

Referenced by remove\-Item().\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}


\begin{Desc}
\item[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?) \end{Desc}


Definition at line 1073 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 1177 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 729 of file kfilemetainfo.h.

References item(), and KStd\-Accel::key().\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[Returns:]the specified item if found, an invalid item, if not \end{Desc}


Definition at line 1142 of file kfilemetainfo.cpp.

References QMap\-Iterator::data(), and KStd\-Accel::key().

Referenced by add\-Item(), operator[$\,$](), preferred\-Keys(), and value().\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}


\begin{Desc}
\item[Returns:]the item with the specified hint \end{Desc}


Definition at line 1151 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})} 

Definition at line 748 of file kfilemetainfo.h.

References item(), KStd\-Accel::key(), and 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 1127 of file kfilemetainfo.cpp.\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}


\begin{Desc}
\item[Returns:]true if this group supports adding or removing arbitrary keys, false if not. \end{Desc}


Definition at line 1132 of file kfilemetainfo.cpp.\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}


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


Definition at line 1137 of file kfilemetainfo.cpp.

References KStd\-Accel::key().

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}


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


Definition at line 1109 of file kfilemetainfo.cpp.

References QMap\-Const\-Iterator::data().

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}


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


Definition at line 1078 of file kfilemetainfo.cpp.

References KStd\-Accel::end(), item(), 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 key is in the supported\-Keys list and not yet defined or if the group supports variable keys. 

Definition at line 1202 of file kfilemetainfo.cpp.

References QMap\-Iterator::data(), KFile\-Mime\-Type\-Info::Item\-Info::is\-Variable\-Item(), item(), KFile\-Mime\-Type\-Info::Group\-Info::item\-Info(), KStd\-Accel::key(), KFile\-Meta\-Info\-Item::set\-Added(), and KFile\-Mime\-Type\-Info::Group\-Info::variable\-Item\-Info().\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 removed\-Items() if you need to. If you re-add it, its value will be cleared 

Definition at line 1235 of file kfilemetainfo.cpp.

References is\-Valid(), and KStd\-Accel::key().

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