![]() |
digiKam Developer Documentation
Professional Photo Management with the Power of Open Source
|
DItemInfo is a class to get item information from host application (Showfoto or digiKam) The interface is re-implemented in host and depend how item information must be retrieved (from a database or by file metadata). More...
Public Member Functions | |
DItemInfo (const DInfoInterface::DInfoMap &) | |
int | albumId () const |
double | altitude () const |
QString | aperture () const |
CaptionsMap | captions () const |
int | colorLabel () const |
QString | comment () const |
MetaEngine::AltLangMap | copyrightNotices () const |
MetaEngine::AltLangMap | copyrights () const |
QStringList | creators () const |
QString | credit () const |
QDateTime | dateTime () const |
QSize | dimensions () const |
QString | exposureTime () const |
qlonglong | fileSize () const |
QString | focalLength () const |
QString | focalLength35mm () const |
bool | hasGeolocationInfo () const |
DInfoInterface::DInfoMap | infoMap () const |
QStringList | keywords () const |
double | latitude () const |
QString | lens () const |
double | longitude () const |
QString | make () const |
QString | model () const |
QString | name () const |
int | orientation () const |
int | pickLabel () const |
int | rating () const |
QString | rights () const |
QString | sensitivity () const |
void | setCaptions (const CaptionsMap &) |
void | setColorLabel (int) |
void | setCopyrightNotices (const MetaEngine::AltLangMap &map) |
void | setCopyrights (const MetaEngine::AltLangMap &map) |
void | setOrientation (int) |
void | setPickLabel (int) |
void | setRating (int) |
void | setTitles (const CaptionsMap &) |
QString | source () const |
QStringList | tagsPath () const |
QString | title () const |
CaptionsMap | titles () const |
QString | videoCodec () const |
The easy way to use this container is given below:
// READ INFO FROM HOST ------------------------------------------—
QUrl itemUrl; // The item url that you want to retrieve information. DInfoInterface* hostIface; // The host application interface instance.
DInfoInterface::DInfoMap info = hostIface->itemInfo(itemUrl); // First stage is to get the information map from host application. DItemInfo item(info); // Second stage, is to create the DIntenInfo instance for this item by url. QString title = item.name(); // Now you can retrieve the title, QString description = item.comment(); // The comment, QDateTime time = item.dateTime(); // The time stamp, etc.
// WRITE INFO TO HOST -------------------------------------------—
QUrl itemUrl; // The item url that you want to retrieve information. DInfoInterface* hostIface; // The host application interface instance.
DItemInfo item; // Create the DIntenInfo instance for this item with an empty internal info map. item.setRating(3); // Store rating to internal info map. item.setColorLabel(1); // Store color label to internal info map. hostIface->setItemInfo(url, item.infoMap()); // Update item information to host using internal info map.