phonebookui/Phonebook2/inc/MPbk2ContactDetailsControl.h
changeset 0 e686773b3f54
equal deleted inserted replaced
-1:000000000000 0:e686773b3f54
       
     1 /*
       
     2 * Copyright (c) 2005-2007 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:  Phonebook 2 contact details control interface.
       
    15 *
       
    16 */
       
    17 
       
    18 
       
    19 #ifndef MPBK2CONTACTDETAILSCONTROL_H
       
    20 #define MPBK2CONTACTDETAILSCONTROL_H
       
    21 
       
    22 // INCLUDES
       
    23 #include <MPbk2ContactUiControl.h>
       
    24 #include <MPbk2ContactUiControl2.h>
       
    25 
       
    26 // FORWARD DECLARATIONS
       
    27 class MVPbkStoreContact;
       
    28 class MVPbkStoreContactField;
       
    29 class MPbk2ContactDetailsControlExt;
       
    30 
       
    31 // CLASS DECLARATION
       
    32 
       
    33 /**
       
    34  * Phonebook 2 contact details control interface.
       
    35  * Presents the fields of a contact as a list.
       
    36  */
       
    37 class MPbk2ContactDetailsControl : public MPbk2ContactUiControl,
       
    38                                    public MPbk2ContactUiControl2
       
    39     {
       
    40     public: // Interface
       
    41 
       
    42         /**
       
    43          * Updates this control to display the details of the given contact.
       
    44          * NOTE: This function does not redraw the control on the screen.
       
    45          * NOTE: This function is leave-safe; it quarantees that this
       
    46          * control's state does not change if this function leaves.
       
    47          *
       
    48          * @param aContact  The contact to display. This object takes
       
    49          *                  the ownership of the contact.
       
    50          */
       
    51         virtual void UpdateL(
       
    52                 MVPbkStoreContact* aContact ) = 0;
       
    53 
       
    54         /**
       
    55          * Returns the field count.
       
    56          *
       
    57          * @return  Field count.
       
    58          */
       
    59         virtual TInt FieldCount() const = 0;
       
    60 
       
    61         /**
       
    62          * Returns given field's position in the list.
       
    63          *
       
    64          * @param aField    The field whose position to inspect.
       
    65          * @return  Given field's position in the list.
       
    66          */
       
    67         virtual TInt FieldPos(
       
    68                 const MVPbkStoreContactField& aField ) const = 0;
       
    69 
       
    70         /**
       
    71          * Extension point.
       
    72          *
       
    73          * @return  Contact details control extension
       
    74          */
       
    75         virtual MPbk2ContactDetailsControlExt* ContactDetailsControlExt()
       
    76                 { return NULL; }
       
    77     };
       
    78 
       
    79 #endif // MPBK2CONTACTDETAILSCONTROL_H
       
    80 
       
    81 // End of File