/*******************************************************************************
 * Copyright (c) 2005, 2010 Nokia Corporation and/or its subsidiary(-ies).
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Nokia Corporation - S60 implementation
 *******************************************************************************/


#ifndef SWTCONTROLHELPER_H
#define SWTCONTROLHELPER_H


#include <coedef.h>
#include <eiksbobs.h>
#include <w32std.h>
#include "eswtwidgetscore.h"


class CCoeControl;
class CEikScrollBarFrame;
class CSwtScrollBar;
class CWindowGc;


/**
 * SwtControlHelper
 * @lib eswt
 */
NONSHARABLE_CLASS(SwtControlHelper)
{
// Methods
public:
    /**
     * Copies a bitmap.
     * @param aBitmap The source bitmap for copy operation.
     * @param aTargetSize Optional target size if scaling is desired.
     * @return Pointer to the copy. Copy is owned by the caller.
     */
    static CFbsBitmap* GetCopyOfBitmapLC(const CFbsBitmap* aBitmap,
                                         const TSize& aTargetSize = TSize(-1, -1));

    /**
     * Copies a bitmap.
     * @param aBitmap The source bitmap for copy operation.
     * @param aTargetSize Optional target size if scaling is desired.
     * @return Pointer to the copy. Copy is owned by the caller.
     */
    static CFbsBitmap* GetCopyOfBitmapL(const CFbsBitmap* aBitmap,
                                        const TSize& aTargetSize = TSize(-1, -1));

    /**
     * Copies a bitmap inverting it in the case it's monochrome.
     * @param aBitmap The source bitmap for copy operation.
     * @param aTargetSize Optional target size if scaling is desired.
     * @return Pointer to the copy. Copy is owned by the caller.
     */
    static CFbsBitmap* GetInvertedCopyOfMonoBitmapLC(const CFbsBitmap* aBitmap,
            const TSize& aTargetSize = TSize(-1, -1));

    /**
     * Copies a bitmap inverting it in the case it's monochrome.
     * @param aBitmap The source bitmap for copy operation.
     * @param aTargetSize Optional target size if scaling is desired.
     * @return Pointer to the copy. Copy is owned by the caller.
     */
    static CFbsBitmap* GetInvertedCopyOfMonoBitmapL(const CFbsBitmap* aBitmap,
            const TSize& aTargetSize = TSize(-1, -1));

    /**
     * Retrieves the clipboard's text content.
     * It is up to the caller to free the descriptor by calling
     * CleanupStack::PopAndDestroy() if the descriptor's
     * pointer is not NULL.
     * @return A descriptor containing the clipboard's content.
     */
    static TPtr GetClipboardTextContentLC();

    /**
     * Returns size for a bitmap that is aspect ratio scaled to fit inside
     * aMaxDestSize if aSourceSize > aMaxDestSize
     * @param aSourceSize The source bitmap size.
     * @param aMaxDestSize Maximum size for the bitmap.
     * @return Resulting size. If any scaling was needed, it is done so
     *         that the aspect ratio does not change.
     */
    static TSize GetAspectRatioScaledBitmapSize(const TSize& aSourceSize,
            const TSize& aMaxDestSize);
};


#endif // SWTCONTROLHELPER_H