class KFileMetaInfoGroup

# class KFileMetaInfoGroup | This is one group of meta information items about a file (see KFileMetaInfo). More...
Definition | `#include <kfilemetainfo.h>`
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

#### Public Methods

- KFileMetaInfoGroup ( const QString& name, const KFileMimeTypeInfo* info )
- KFileMetaInfoGroup ( const KFileMetaInfoGroup& original )
- const KFileMetaInfoGroup& operator= (const KFileMetaInfoGroup& info )
- KFileMetaInfoGroup ()
- ~KFileMetaInfoGroup ()
- bool isValid () const
- bool isEmpty () const
- bool isModified () const
- KFileMetaInfoItem operator[] ( const QString& key ) const
- KFileMetaInfoItem item ( const QString& key ) const
- KFileMetaInfoItem item ( uint hint ) const
- const QVariant value ( const QString& key ) const
- QStringList supportedKeys () const
- bool supportsVariableKeys () const
- bool contains ( const QString& key ) const
- QStringList keys () const
- QStringList preferredKeys () const
- KFileMetaInfoItem addItem ( const QString& key )
- bool removeItem (const QString& key)
- QStringList removedItems ()
- QString name () const
- uint attributes () const

#### Public Members

- Forward Data

#### Protected Methods

- void setAdded ()
- KFileMetaInfoItem appendItem ( const QString& key, const QVariant& value)
- void ref ()
- void deref ()

#### Protected Members

- Data* d

## Detailed Description

This is one group of meta information items about a file (see KFileMetaInfo).

KFileMetaInfoGroup ( const QString& name, const KFileMimeTypeInfo* info ) | ### KFileMetaInfoGroup

You usually don't need to use this constructor yourself. Let KFileMetaInfo do it for you.

KFileMetaInfoGroup ( const KFileMetaInfoGroup& original ) | ### KFileMetaInfoGroup

Copy onstructor

const KFileMetaInfoGroup& operator= (const KFileMetaInfoGroup& info ) | ### operator=

The assignment operator, so you can do:

        KFileMetaInfoGroup group = info.group("Technical");

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

KFileMetaInfoGroup () | ### KFileMetaInfoGroup

Default constructor. This creates an "invalid" item

~KFileMetaInfoGroup () | ### ~KFileMetaInfoGroup

bool isValid () | ### isValid

[const]

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 KFileMetaInfoGroup::item() didn't find your requested item)

bool isEmpty () | ### isEmpty

[const]

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?)

bool isModified () | ### isModified

[const]

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

Returns: true if an item was added or removed from the group, otherwise false.

KFileMetaInfoItem operator[] ( const QString& key ) | ### operator[]

[const]

operator for convenience. It does the same as item(), but you cannot specify a group to search in

KFileMetaInfoItem item ( const QString& key ) | ### item

[const]

This method searches for the specified item.

Returns: the specified item if found, an invalid item, if not

KFileMetaInfoItem item ( uint hint ) | ### item

[const]

Returns: the item with the specified hint

const QVariant value ( const QString& key ) | ### value

[const]

Convenience function. Returns the value of the specified key. It does the same as item(key).value()

QStringList supportedKeys () | ### supportedKeys

[const]

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 KFileMetaInfo about variable keys

Returns: the list of keys supported for this mimetype

bool supportsVariableKeys () | ### supportsVariableKeys

[const]

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

bool contains ( const QString& key ) | ### contains

[const]

Returns: whether an item for this key exists.

QStringList keys () | ### keys

[const]

Returns: a list of all keys in the order they were inserted.

QStringList preferredKeys () | ### preferredKeys

[const]

Returns: a list of all keys in preference order.

KFileMetaInfoItem addItem ( const QString& key ) | ### addItem

add an item to the info. This is only possible if the specified key is in the supportedKeys list and not yet defined or if the group supports variable keys.

bool removeItem (const QString& key) | ### removeItem

remove this item from the meta info of the file. You cannot query KFileMetaInfo for a removed object, but you can query for a list of removed items with removedItems() if you need to. If you re-add it, its value will be cleared

QStringList removedItems () | ### removedItems

QString name () | ### name

[const]

uint attributes () | ### attributes

[const]

void setAdded () | ### setAdded

[protected]

KFileMetaInfoItem appendItem ( const QString& key, const QVariant& value) | ### appendItem

[protected]

Data* d | ### d

[protected]

void ref () | ### ref

[protected]

void deref () | ### deref

[protected]

Generated by: root on macppc.ports.openbsd.org on Sat Sep 6 10:36:57 2003, using kdoc 2.0a54.