Categories: Symbian C++ | Code Examples | Files/Data

This page was last modified 09:20, 1 July 2008.

From Forum Nokia Wiki

Knowledge Base Home

Overview

Certain file types are meant to be in certain directories. The Document Handler API is able to find the correct place for known file types, such as images or sound files. This snippet demonstrates how to copy content to predefined directories with CDocumentHandler.

This snippet can be self-signed.

MMP file

The following libraries are required:

LIBRARY  apmime.lib    // TDataType
LIBRARY  commonui.lib  // CDocumentHandler

Header file

#include <DocumentHandler.h>

private:  // Data
    CDocumentHandler* iDocHandler;

Source file

#include <DocumentHandler.h>

iDocHandler = CDocumentHandler::NewL(CEikonEnv::Static()->Process());

// Source file.
_LIT(KSrcFile, "C:\\Data\\Others\\picture.jpg");
// Destination file. File extension is obtained from the source file.
_LIT(KDestFile, "destination");
 
TDataType nullType; // Explicit MIME type not set
TInt ret = KErrNone;
// Copy the source to the destination. The Document Handler API recognizes that
// the file is an image and copies it to the Gallery (C:\Data\Images directory
// in S60 3rd Edition). The function call also displays a notification to the
// user after copying is done.
TRAPD(err, ret = iDocHandler->CopyL(KSrcFile, KDestFile, nullType,
    KEntryAttNormal));
 
if (err || ret)
    {
    // TODO: Error handling
    }
 
// Get and display the destination path
TFileName path;
iDocHandler->GetPath(path);
CAknInformationNote* note = new (ELeave)CAknInformationNote(ETrue);
note->ExecuteLD(path);

Postconditions

Source file C:\Data\Others\picture.jpg is copied into the Gallery as destination.jpg.