1 // Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
2 // All rights reserved.
3 // This component and the accompanying materials are made available
4 // under the terms of "Eclipse Public License v1.0"
5 // which accompanies this distribution, and is available
6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
8 // Initial Contributors:
9 // Nokia Corporation - initial contribution.
16 #ifndef TREGIONEXTEND_H_
17 #define TREGIONEXTEND_H_
21 class TRegionExtend : public TRegion
23 //Note that this class is generally only good for regions with dimensions less than 45000x45000
24 //as integers are used to hold the final total area, and would overflow.
25 //In debug build, panic TRegionExtend x003 is raised, where x indicates a code-point
26 // when any rectangle in the region exceeds 32k
29 //Do not construct instances of this class, use the Cast() methods to convert existing region instances
31 TRegionExtend(const TRegionExtend&);
33 //Please use TRegionExtend::Cast() calls to extend existing TRegion objects
34 static TRegionExtend& Cast(TRegion& aSrc) { return (TRegionExtend&) aSrc; }
35 static TRegionExtend* Cast(TRegion* aSrc) { return (TRegionExtend*) aSrc; }
36 static const TRegionExtend& Cast(const TRegion& aSrc) { return (const TRegionExtend&) aSrc; }
37 static const TRegionExtend* Cast(const TRegion* aSrc) { return (const TRegionExtend*) aSrc; }
40 using TRegion::RectangleListW;
46 EDiffers= 0x0003, //Added and/or subtracted
48 EErrorRegion= 0x0008 //This code is returned if one of the input regions is flagged as invalid
51 /** Avoids the use of a temp region by performing area calc on the fly.
52 * If both regions are empty then EOverlapNoIntersect only is returned.
53 * Limitation: this method is only good for regions with less than 2 billion units of area!
54 * @param aTarget target region for difference
56 TOverlapFlags TestDifference(const TRegion& aTarget)const;
58 /** Further avoids the use of a temp region by performing area calc on the fly.
59 * If both regions are empty then EOverlapNoIntersect only is returned.
60 * Limitation: this method is only good for regions with less than 2 billion units of area!
61 * @param aTarget target region for difference
62 * @param aOffset origin offset transformation from this to target region
64 TOverlapFlags TestDifference(const TRegion& aTarget,TPoint aOffset )const;
66 /** Avoids the use of a temp region by performing area calc on the fly.
67 * If region and rect both empty then EOverlapNoIntersect only is returned.
68 * Limitation: this method is only good for regions and rects with less than 2 billion units of area!
70 TOverlapFlags TestDifference(const TRect&)const;
72 /** Intended as an internal method to test for the overlap of two rectangles.
75 static TOverlapFlags TestDifference(const TRect&,const TRect&);
77 /** Returns total area of the region
78 * Limitation: this method is only good for regions with less than 2 billion units of area!
86 #endif /*TREGIONEXTEND_H_*/