inc/alf/alfreferencetovisual.h
branchRCL_3
changeset 19 4ea6f81c838a
parent 17 514d98f21c43
child 20 0e9bb658ef58
--- a/inc/alf/alfreferencetovisual.h	Mon Jun 21 16:15:51 2010 +0300
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,116 +0,0 @@
-/*
-* 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:  Visual class for alfred widget model.
-      This class queries the visual by name and ID.
-*
-*/
-
-
-#ifndef ALFREFERENCETOVISUAL_H
-#define ALFREFERENCETOVISUAL_H
-
-//INCLUDES
-#include <osn/osndefines.h>
-#include <osn/ustring.h>
-// FORWARD DECLARATIONS
-class CAlfControl;
-class CAlfVisual;
-
-
-using namespace osncore;
-
-namespace Alf
-    {
-class CAlfWidgetControl;
-
-/** @class AlfReferenceToVisual alfreferencetovisual.h "alf/alfreferencetovisual.h"
- * A class for finding a specific visual according to
- * the name of the visual, name of the parent element,
- * and the associated data ID. The number of visual
- * trees created by an element may depend on the data.
- * Therefore, the visual structure is not always known
- * beforehand. CAlfControl::FindElement() and MAlfElement::FindVisual
- * can be used to find elements and visuals even in dynamic
- * conditions.
- *
- *  @lib alfwidgetmodel.lib
- *  @since S60 ?S60_version
- *  @status Draft
- */
-class AlfReferenceToVisual
-    {
-public:
-
-    /**
-     * constructor.
-     *
-	 * @exception std::bad_alloc     
-     * @since S60 ?S60_version
-     * @param aElementName The name of the element that is responsible
-    *      for creating the visual.
-     * @param aVisualName The name of the visual.
-     * @param aUseDataID Deprecated and not used. The given data ID is always
-     * used when resolving the visual. Only if the visual is not found with
-     * the given data ID, then the data ID zero is tested for global visuals.
-     * @return New object.
-     */
-    OSN_IMPORT static AlfReferenceToVisual* create(
-        const char* aElementName,const char* aVisualName, bool aUseDataID);
-
-    /** Destructor. No derived classes, therefore not virtual. */
-    OSN_IMPORT ~AlfReferenceToVisual();
-
-
-    /**
-     * Find the referenced visual according to the given data ID.
-     *
-     * @exception osncore::AlfVisualException Thrown with the error code osncore::ECommonError\n 
-     *										  when some operation performed on visual fails.
-     * @since S60 ?S60_version
-     * @param aControl  The control containing the associated element.
-     * @param aDataID  The data ID used to create the visual. The caller
-     *      is responsible for determining what data ID
-     *      is related to this reference. If the visual is not found with
-     * the given data ID, then the data ID zero is tried for global visuals.
-     * @return The resolved visual.
-     */
-    OSN_IMPORT CAlfVisual* resolve(CAlfWidgetControl& aControl, unsigned int aDataID);
-
-    /**
-     * Finds the referenced visual according to given pointer to visual
-     *
-        * @since S60 ?S60_version
-        * @param aControl      The control containing the associated element.
-        * @param aSourceVisual  Pointer to visual that needs to be queried.
-        */
-    OSN_IMPORT CAlfVisual* resolve(CAlfWidgetControl &aControl, CAlfVisual* aSourceVisual);
-private:
-    /**
-     * constructor
-     */
-    AlfReferenceToVisual(const char* aElementName,const char* aVisualName, bool aUseDataID);
-
-private:
-    // The element name. Owned.
-    UString mElementName;
-    // The visual name. Owned.
-    UString mVisualName;
-    // The associated data ID.
-    bool mUseDataID;
-    };
-
-    } // namespace Alf
-
-#endif //ALFREFERENCETOVISUAL_H
-