camerauis/cameraxui/cxengine/tsrc/unit/system_include/thumbnailmanager_qt.h
changeset 19 d9aefe59d544
child 37 64817133cd1d
equal deleted inserted replaced
3:8b2d6d0384b0 19:d9aefe59d544
       
     1 /*
       
     2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
       
     3 * All rights reserved.
       
     4 * This component and the accompanying materials are made available
       
     5 * under the terms of "Eclipse Public License v1.0"
       
     6 * which accompanies this distribution, and is available
       
     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
       
     8 *
       
     9 * Initial Contributors:
       
    10 * Nokia Corporation - initial contribution.
       
    11 *
       
    12 * Contributors:
       
    13 *
       
    14 * Description: copy of normally used "system" file for thumbnailmanager for qt
       
    15 *
       
    16 */
       
    17 
       
    18 #ifndef THUMBNAILMANAGER_QT_H
       
    19 #define THUMBNAILMANAGER_QT_H
       
    20 
       
    21 #include <qobject>
       
    22 #include <QPixmap.h>
       
    23 #include <QStringList>
       
    24 
       
    25 
       
    26 class  ThumbnailManager : public QObject
       
    27     {
       
    28     Q_OBJECT
       
    29 
       
    30 public:
       
    31 
       
    32     /**
       
    33      * Constructor
       
    34      * 
       
    35      * @param parentPtr parent
       
    36      */    
       
    37     ThumbnailManager( QObject* parentPtr = NULL );
       
    38 
       
    39     /**
       
    40      * Destructor
       
    41      */
       
    42     virtual ~ThumbnailManager();
       
    43 
       
    44     /**
       
    45      * Get a thumbnail for an object file. If a thumbnail already exists, it
       
    46      * is loaded and if a thumbnail does not exist, it is created
       
    47      * transparently. If thumbnail loadinf fails thumbnailReady signal is emited 
       
    48      * with null pixmap and error code.
       
    49      *
       
    50      * @param fileName      Source object or file
       
    51      * @param clientData    Pointer to arbitrary client data.
       
    52      *                      This pointer is not used by the API for
       
    53      *                      anything other than returning it in the
       
    54      *                      ThumbnailReady signal.
       
    55      * @param priority      Priority for this operation
       
    56      * @return              Thumbnail request ID or -1 if request failed. This can be used to
       
    57      *                      cancel the request or change priority.
       
    58      *                      The ID is specific to this tnm
       
    59      *                      instance and may not be shared with other
       
    60      *                      instances.
       
    61      */
       
    62     int getThumbnail(const QString& fileName, void * clientData = NULL, 
       
    63             int priority = 0);
       
    64 
       
    65     /**
       
    66      * Cancel a thumbnail operation.
       
    67      *
       
    68      * @param id      Request ID for the operation to be cancelled.
       
    69      * @return         true if cancelling was successful.
       
    70      */
       
    71     bool cancelRequest(int id);
       
    72 
       
    73    
       
    74 signals:  
       
    75     /**
       
    76      * Final thumbnail bitmap generation or loading is complete.
       
    77      *
       
    78      * @param pixmap     An object representing the resulting thumbnail.
       
    79      * @param clientData Client data
       
    80      * @param id         Request ID for the operation
       
    81      * @param errorCode  error code
       
    82      */
       
    83     void thumbnailReady( QPixmap , void * , int , int );    
       
    84 
       
    85 private:
       
    86     int mCurrentThumbnailId;
       
    87     QList<int> mThumbnailManagerIds;
       
    88 };
       
    89 
       
    90 #endif // THUMBNAILMANAGER_QT