sftemplateswizard/com.nokia.s60tools.symbianfoundationtemplates/templates/t_class_header_template.h
author dpodwall
Tue, 12 Jan 2010 13:17:53 -0600
changeset 0 61163b28edca
permissions -rw-r--r--
initial EPL conversion
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     1
/*
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     2
* ============================================================================
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     3
*  Name        : ?filename.h
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     4
*  Part of     : ?Subsystem_name / ?Module_name
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     5
*  Description : ?Description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     6
*  Version     : %version: %
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     7
*
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     8
*  Copyright © ?year-?year ?Company_copyright.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
     9
*  All rights reserved.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    10
*  This component and the accompanying materials are made available
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    11
*  under the terms of the License "?License"
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    12
*  which accompanies this distribution, and is available
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    13
*  at the URL "?LicenseUrl".
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    14
*
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    15
*  Initial Contributors:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    16
*  ?Company_name - initial contribution.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    17
*
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    18
*  Contributors:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    19
*  ?Company_name
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    20
* ============================================================================
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    21
* Template version: 4.2
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    22
*/
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    23
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    24
*** INSTRUCTIONS TO THE TEMPLATE USER:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    25
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    26
*** This template follows the Symbian Foundation coding conventions.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    27
*** Remove all unneeded declarations and definitions before checking 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    28
*** the file in!  Also remove the template's usage instructions, that is, 
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    29
*** everything that begins with "***".
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    30
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    31
*** The copyright years should be < the year of the file's creation >
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    32
*** - < the year of the file's latest update >.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    33
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    34
*** Words that begin with "?" are for you to replace with your own
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    35
*** identifiers, filenames, or comments.  ?IMPORT_C means either the
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    36
*** IMPORT_C visibility directive, or nothing, depending on whether
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    37
*** the function is to be exported or not.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    38
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    39
*** To support building on Linux, use only forward slashes in include
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    40
*** directives.  Also, all filenames and pathnames must be completely
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    41
*** in lowercase.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    42
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    43
*** Indent four spaces per step, using spaces, not tabs, to display
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    44
*** the code consistently across different editors.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    45
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    46
*** A T class differs from a C class only in the respect that it owns no
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    47
*** heap-allocated (dynamic) memory, and thus needs no explicit destructor.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    48
*** A T class may be instantiated either on the heap or on the stack.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    49
*** You must ensure that a T class is fully constructed before use.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    50
*** A T class will derive from zero or one other T classes.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    51
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    52
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    53
#ifndef ?T_CLASSNAME_H
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    54
#define ?T_CLASSNAME_H
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    55
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    56
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    57
*** system include files go here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    58
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    59
#include <?include_file>
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    60
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    61
*** user include files go here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    62
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    63
#include "?include_file"
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    64
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    65
*** forward declarations go here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    66
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    67
class ?forward_classname;
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    68
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    69
*** external data types go here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    70
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    71
/**  ?description */
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    72
extern ?data_type;
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    73
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    74
*** constants go here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    75
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    76
const ?type ?constant_var = ?constant;
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    77
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    78
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    79
*** the class declaration goes here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    80
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    81
/**
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    82
 *  ?one_line_short_description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    83
 *
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    84
 *  ?more_complete_description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    85
 *
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    86
 *  @code
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    87
 *   ?good_class_usage_example(s)
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    88
 *  @endcode
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    89
 *
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    90
 *  @lib ?library
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    91
 *  @since S60 ?S60_version *** for example, S60 v3.0
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    92
 */
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    93
class ?classname : public ?base_class_list
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    94
    {
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    95
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    96
*** friend classes go here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    97
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    98
    friend class ?class1;
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
    99
    friend class ?class2;
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   100
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   101
public:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   102
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   103
*** data types go here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   104
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   105
    /**  ?description */
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   106
    enum ?declaration
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   107
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   108
    /**  ?description */
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   109
    typedef ?declaration
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   110
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   111
*** C++ constructors go here, starting with the default constructor.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   112
*** No destructor is needed.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   113
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   114
    ?classname();
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   115
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   116
    /**
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   117
     * Constructor.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   118
     *
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   119
     * @since S60 ?S60_version
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   120
     * @param ?arg1 ?description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   121
     * @param ?arg2 ?description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   122
     * @return ?description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   123
     */
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   124
    ?classname( ?type1 ?arg1, ?type2 ?arg2 );
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   125
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   126
*** member functions go here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   127
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   128
    /**
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   129
     * ?description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   130
     *
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   131
     * @since S60 ?S60_version
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   132
     * @param ?arg1 ?description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   133
     * @param ?arg2 ?description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   134
     * @return ?description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   135
     */
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   136
    ?IMPORT_C ?type ?member_function( ?type1 ?arg1, ?type2 ?arg2 );
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   137
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   138
// from base class ?base_class1
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   139
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   140
*** declarations of functions derived from base_class1 are grouped
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   141
*** together here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   142
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   143
    /**
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   144
     * From ?base_class1.
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   145
     * ?description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   146
     *
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   147
     * @since S60 ?S60_version
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   148
     * @param ?arg1 ?description
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   149
     */
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   150
    ?IMPORT_C ?type ?member_function( ?type ?arg1 );
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   151
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   152
// from base class ?base_class2
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   153
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   154
*** function declarations as above
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   155
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   156
protected:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   157
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   158
*** function declarations as above
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   159
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   160
// from base class ?base_class2
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   161
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   162
*** function declarations as above
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   163
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   164
// from base class ?base_class3
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   165
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   166
*** function declarations as above
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   167
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   168
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   169
private:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   170
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   171
*** private, non-derived functions go here; function declarations as above
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   172
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   173
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   174
*** avoid the use of public or protected data; data should nearly
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   175
*** always be accessed through getter and setter functions
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   176
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   177
private: // data
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   178
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   179
    /**
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   180
     * ?description_of_member
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   181
     */
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   182
    ?type ?member_name;
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   183
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   184
    };
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   185
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   186
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   187
*** put the inline functions, if any, in a file included here:
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   188
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   189
#include "?include_file.inl"
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   190
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   191
61163b28edca initial EPL conversion
dpodwall
parents:
diff changeset
   192
#endif // ?T_CLASSNAME_H