--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/phone_plat/telephony_bubble_extension_api/inc/telbubblecallimage.h Mon Jan 18 20:18:27 2010 +0200
@@ -0,0 +1,124 @@
+/*
+* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description: Extension control for displaying call image.
+*
+*/
+
+
+#ifndef TELBUBBLECALLIMAGE_H
+#define TELBUBBLECALLIMAGE_H
+
+#include <coecntrl.h>
+
+class CFbsBitmap;
+
+/**
+ * Extension control for displaying call image.
+ *
+ *
+ * @lib BMCustomization.lib
+ * @since S60 v5.0
+ */
+class CTelBubbleCallImage : public CCoeControl
+ {
+public:
+ /** Two phase constructor */
+ IMPORT_C static CTelBubbleCallImage* NewL();
+
+ /** destructor */
+ IMPORT_C virtual ~CTelBubbleCallImage();
+
+public:
+ /**
+ * Set call image. The bitmaps are set by Phone application,
+ * when it has created bitmaps from the call image.
+ * @param aImage Call image bitmap.
+ * @param aImageOwnership ETrue, if ownership is transferred.
+ * @param aMask Mask bitmap when exists.
+ * @param aMaskOwnership ETrue, if ownership is transferred.
+ */
+ IMPORT_C void SetImage( CFbsBitmap* aImage,
+ TBool aImageOwnership = EFalse,
+ CFbsBitmap* aMask = NULL,
+ TBool aMaskOwnership = EFalse );
+
+ /**
+ * Set image placing area. This is set by Phone application.
+ * @param aRect
+ */
+ IMPORT_C void SetImagePlacingArea( TRect& aRect );
+
+protected:
+ /**
+ * Called when image is changed.
+ */
+ IMPORT_C virtual void ImageChanged();
+
+ /**
+ * Returns pointer to image bitmap.
+ */
+ IMPORT_C const CFbsBitmap* Image() const;
+
+ /**
+ * Returns pointer to mask bitmap.
+ */
+ IMPORT_C const CFbsBitmap* Mask() const;
+
+ /**
+ * Returns ETrue if image covers this control entirely.
+ */
+ IMPORT_C TBool IsFullScreenImage() const;
+
+ /**
+ * Returns offset centering image to this control.
+ * For non fullscreen images this offset is relative
+ * to image placing area.
+ */
+ IMPORT_C const TPoint& Offset() const;
+
+ /**
+ * Returns source rect centering image to this control.
+ * For non-fullscreen images this offset is relative
+ * to image placing area.
+ */
+ IMPORT_C const TRect& SourceRect() const;
+
+ /**
+ * Returns image placing area. Can be used to position
+ * non-fullscreen sized images.
+ * @return Image placing area.
+ */
+ IMPORT_C const TRect& ImagePlacingArea() const;
+
+protected: // from CCoeControl
+ IMPORT_C virtual void Draw( const TRect& /*aRect*/ ) const;
+ IMPORT_C virtual void SizeChanged();
+
+protected:
+ IMPORT_C virtual void ConstructL();
+ IMPORT_C CTelBubbleCallImage();
+
+private:
+ TRect iSourceRect;
+ TPoint iOffset;
+ TRect iImagePlacingArea;
+ CFbsBitmap *iImage;
+ CFbsBitmap *iMask;
+ TBool iImageOwnership;
+ TBool iMaskOwnership;
+ };
+
+#endif // TELBUBBLECALLIMAGE_H
+
+// end of file