1 /*

     2 * Copyright (c) 2002-2004 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Heap-allocated pointer array which owns its objects

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef CXNPOINTERARRAYWITHOWNERSHIP_H

    21 #define CXNPOINTERARRAYWITHOWNERSHIP_H

    22 

    23 //  INCLUDES

    24 #include <e32base.h>

    25 

    26 // CONSTANTS

    27 //const ?type ?constant_var = ?constant;

    28 

    29 // MACROS

    30 //#define ?macro ?macro_def

    31 

    32 // DATA TYPES

    33 //enum ?declaration

    34 //typedef ?declaration

    35 //extern ?data_type;

    36 

    37 // FUNCTION PROTOTYPES

    38 //?type ?function_name(?arg_list);

    39 

    40 // FORWARD DECLARATIONS

    41 //class ?FORWARD_CLASSNAME;

    42 // CLASS DECLARATION

    43 

    44 /**

    45 *  Heap-allocated pointer array which owns its objects

    46 *  @since Series 60 3.1

    47 */

    48 class CXnPointerArrayWithOwnership : public CBase

    49     {

    50     public:  // Constructors and destructor

    51         

    52         /**

    53         * Two-phased constructor.

    54         */

    55         IMPORT_C static CXnPointerArrayWithOwnership* NewL();

    56 

    57         /**

    58         * Destructor.

    59         */

    60         virtual ~CXnPointerArrayWithOwnership();

    61         

    62     public: // New functions

    63         

    64         /**

    65         * Get the underlying container

    66         * @since Series 60 3.1

    67         * @return Underlying container

    68         */

    69 

    70         IMPORT_C RPointerArray<CBase>& Container();

    71 

    72     public: // Functions from base classes

    73 

    74         /**

    75         * From ?base_class ?member_description.

    76         * @since Series ?XX ?SeriesXX_version

    77         * @param ?arg1 ?description

    78         * @return ?description

    79         */

    80         //?type ?member_function( ?type ?arg1 );

    81         

    82     protected:  // New functions

    83         

    84         /**

    85         * ?member_description.

    86         * @since Series ?XX ?SeriesXX_version

    87         * @param ?arg1 ?description

    88         * @return ?description

    89         */

    90         //?type ?member_function( ?type ?arg1 );

    91 

    92 

    93     protected:  // Functions from base classes

    94         

    95         /**

    96         * From ?base_class ?member_description

    97         */

    98         //?type ?member_function();

    99 

   100     private:

   101 

   102         /**

   103         * C++ default constructor.

   104         */

   105         CXnPointerArrayWithOwnership();

   106 

   107         /**

   108         * 2nd phase constructor.

   109         */

   110         void ConstructL();

   111 

   112         // Prohibit copy constructor if not deriving from CBase.

   113         // ?classname( const ?classname& );

   114         // Prohibit assigment operator if not deriving from CBase.

   115         // ?classname& operator=( const ?classname& );

   116 

   117     public:     // Data

   118         // ?one_line_short_description_of_data

   119         //?data_declaration;

   120     

   121     protected:  // Data

   122         // ?one_line_short_description_of_data

   123         //?data_declaration;

   124 

   125     private:    // Data

   126         // ?one_line_short_description_of_data

   127         //?data_declaration;

   128         // Reserved pointer for future extension

   129         //TAny* iReserved;

   130         // Internal container

   131         RPointerArray<CBase> iContainer;

   132     public:     // Friend classes

   133         //?friend_class_declaration;

   134     protected:  // Friend classes

   135         //?friend_class_declaration;

   136     private:    // Friend classes

   137         //?friend_class_declaration;

   138 

   139     };

   140 

   141 #endif      // CXnPointerARRAYWITHOWNERSHIP_H

   142             

   143 // End of File