mmuifw_plat/alf_widgetmodel_api/inc/alf/alfflowlayoutmanager.h
branchRCL_3
changeset 26 0e9bb658ef58
parent 0 e83bab7cf002
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mmuifw_plat/alf_widgetmodel_api/inc/alf/alfflowlayoutmanager.h	Wed Sep 01 12:23:18 2010 +0100
@@ -0,0 +1,108 @@
+/*
+* Copyright (c) 2007 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:  flow layoutmanager.
+*
+*/
+
+
+#ifndef ALFFLOWLAYOUTMANAGER
+#define ALFFLOWLAYOUTMANAGER
+
+#include <alf/alflayout.h>
+#include <osn/osndefines.h>
+#include <osn/osntypes.h>
+#include <memory>
+#include <alf/alflayoutmanager.h>
+
+using std::auto_ptr;
+
+namespace Alf
+    {
+class AlfFlowLayoutPolicyImpl;
+class AlfFlowLayoutPreferencesImpl;
+
+/** @class AlfFlowLayoutManager alfflowlayoutmanager.h "alf/alfflowlayoutmanager.h"
+ * Flow layout manager positions children next to each other either horizontally or
+ * vertically. The manager sizes the children by using the preferred sizes of the
+ * children. @see IAlfLayoutPreferences::getPreferredSize()  
+ *
+ *
+ * Flow layout manager takes system wide layout mirroring into consideration. 
+ * In western locales the visuals are layed out from left to right whereas
+ * in arabic locale for instance the visuals are layed out from right to left.
+ * Mirroring is considered only when the flow is horizontal. The layout manager
+ * will always lay its children from top to bottom.
+ *
+ * @interfaces IAlfLayoutManager, IAlfLayoutPreferences
+ * @lib alfwidgetmodel.lib
+ * @since S60 ?S60_version
+ * @status Draft
+ */
+ 
+class AlfFlowLayoutManager : public AlfLayoutManager
+    {
+public:
+    friend class AlfFlowLayoutPolicyImpl;
+    friend class AlfFlowLayoutPreferencesImpl;
+public:
+
+    /**
+     * layout manager constructor
+     *
+	 * @exception std::bad_alloc     
+     * @param aLayoutType type of layout used by this manager.
+     */
+    OSN_IMPORT AlfFlowLayoutManager();
+        
+    /**
+     * virtual destructor
+     */
+    OSN_IMPORT virtual ~AlfFlowLayoutManager();
+    
+public:
+    //from AlfLayoutManager
+    
+    /**
+     * from AlfLayoutManager
+     * Notifies the layout manager, that the child control's layout
+     * must be updated.
+     * 
+     * @param aControl control, which size has changed.
+     */
+    OSN_IMPORT virtual void updateChildLayout(CAlfWidgetControl* aControl);
+    
+public:
+// from base class IAlfInterfaceBase
+    
+    /**
+     * Interface getter. 
+     * @see IAlfInterfaceBase::MakeInterface
+     *
+     * @since S60 ?S60_version
+     * @param aType The type id of the queried interface.
+     * @return The queried interface, or NULL if the interface is not
+     *         supported or available.
+     */    
+    OSN_IMPORT virtual IAlfInterfaceBase* makeInterface( const IfId& aType );
+protected:
+    
+private: // data
+
+    auto_ptr<AlfFlowLayoutPolicyImpl> mData;
+    auto_ptr<AlfFlowLayoutPreferencesImpl> mPrefImpl;
+    };
+
+    } // namespace Alf
+
+#endif // ALFFLOWLAYOUTMANAGER