|
Nokia N97 SDK Example Applications Guide |
#include <ViewTemplate.h>
Inheritance diagram for CViewTemplate< T >:

CViewTemplate sets context specific options menu for view's MSK by giving the menubar resource id to CViewTemplate::NewL(). Setting is done with CEikMenuBar::SetContextMenuTitleResourceId() function call, which is required for the MSK functionality. If menu is not given, MSK does not have menu.
This template class requires that container class implements following functions :
| T | container class used by this view |
Definition at line 47 of file ViewTemplate.h.
Public Member Functions |
|
| virtual | ~CViewTemplate () |
| TUid | Id () const |
| void | HandleCommandL (TInt aCommand) |
| void | DoActivateL (const TVwsViewId &aPrevViewId, TUid aCustomMessageId, const TDesC8 &aCustomMessage) |
| void | DoDeactivate () |
| void | DynInitMenuPaneL (TInt aResourceId, CEikMenuPane *aMenuPane) |
| void | HandleSizeChange (TInt aType) |
| void | MenuItemToDimm (TInt aMenuItemId) |
Static Public Member Functions |
|
| static CViewTemplate * | NewL (TInt aViewResource, TInt aMenubarResource, TUid aViewId) |
| static CViewTemplate * | NewLC (TInt aViewResource, TInt aMenubarResource, TUid aViewId) |
Private Member Functions |
|
| void | ConstructL (TInt aViewResource) |
| CViewTemplate (TUid aViewId, TInt aMenubarResource) | |
Private Attributes |
|
| T * | iContainer |
| TUid | iIdentifier |
| TInt | iMenubarResource |
| TInt | iItemToDimm |
|
|||||||||
|
Virtual Destructor. Definition at line 189 of file ViewTemplate.h. References CViewTemplate< T >::iContainer. 00190 { 00191 if( iContainer ) 00192 delete iContainer; 00193 }
|
|
||||||||||||||||
|
C++ default constructor.
Definition at line 177 of file ViewTemplate.h. 00178 : 00179 iIdentifier( aViewId ), 00180 iMenubarResource( aMenubarResource ), 00181 iItemToDimm( 0 ) 00182 { 00183 }
|
|
||||||||||||||||||||
|
Two-phased constructor.
Definition at line 200 of file ViewTemplate.h. References CViewTemplate< T >::NewLC(). Referenced by CListboxAppUi::ConstructL(). 00202 { 00203 CViewTemplate<T>* self = CViewTemplate<T>::NewLC( aViewResource, 00204 aMenubarResource, aViewId ); 00205 CleanupStack::Pop( self ); 00206 return self; 00207 }
|
|
||||||||||||||||||||
|
Two-phased constructor.
Definition at line 214 of file ViewTemplate.h. Referenced by CViewTemplate< T >::NewL(). 00216 { 00217 CViewTemplate<T>* self = new ( ELeave ) CViewTemplate<T>( aViewId, 00218 aMenubarResource ); 00219 CleanupStack::PushL( self ); 00220 self->ConstructL( aViewResource ); 00221 return self; 00222 }
|
|
|||||||||
|
Definition at line 239 of file ViewTemplate.h. References CViewTemplate< T >::iIdentifier. 00240 { 00241 return iIdentifier; 00242 }
|
|
||||||||||
|
HandleCommandL From CAknView, takes care of command handling.
Definition at line 291 of file ViewTemplate.h. References CViewTemplate< T >::iContainer. 00292 { 00293 switch( aCommand ) 00294 { 00295 case EListboxCommandAddItem: 00296 iContainer->AddItemL(); 00297 break; 00298 case EListboxCommandRemoveItem: 00299 iContainer->RemoveItemL(); 00300 break; 00301 default: 00302 AppUi()->HandleCommandL( aCommand ); 00303 } 00304 }
|
|
||||||||||||||||||||
|
From CAknExView, activate an AknView.
Definition at line 249 of file ViewTemplate.h. References CViewTemplate< T >::iContainer, and CViewTemplate< T >::iMenubarResource. 00253 { 00254 iContainer = new ( ELeave ) T(); 00255 iContainer->SetMopParent( this ); 00256 iContainer->ConstructL( ClientRect() ); 00257 00258 00259 if( iMenubarResource > 0 ) 00260 { 00261 CEikMenuBar* menuBar = MenuBar(); 00262 menuBar->SetContextMenuTitleResourceId( iMenubarResource ); 00263 } 00264 00265 AppUi()->AddToStackL( *this, iContainer ); 00266 00267 iContainer->MakeVisible( ETrue ); 00268 }
|
|
|||||||||
|
From AknView, deactivate an AknView Remove the container class instance from the App UI's stack and deletes the instance Definition at line 275 of file ViewTemplate.h. References CViewTemplate< T >::iContainer. 00276 { 00277 if ( iContainer ) 00278 { 00279 // Remove container form controllStack 00280 AppUi()->RemoveFromStack( iContainer ); 00281 delete iContainer; 00282 iContainer = NULL; 00283 } 00284 }
|
|
||||||||||||||||
|
From MEikMenuObserver, DynInitMenuPaneL. This function is called by the EIKON framework just before it displays a menu pane.
Definition at line 344 of file ViewTemplate.h. References CViewTemplate< T >::iItemToDimm. 00346 { 00347 // Hide user selected menu item 00348 TInt index; 00349 if( aMenuPane->MenuItemExists (iItemToDimm, index) ) 00350 { 00351 aMenuPane->SetItemDimmed( iItemToDimm, ETrue ); 00352 } 00353 00354 // From options menu and MSK menu we remove always "Remove item" item 00355 // if there is no items to remove 00356 if( aMenuPane->MenuItemExists (EListboxCommandRemoveItem, index) ) 00357 { 00358 // Hide "Remove item" menu item if listbox does not contain any items 00359 if( iContainer->ItemCount() < 1 ) 00360 aMenuPane->SetItemDimmed( EListboxCommandRemoveItem, ETrue ); 00361 } 00362 }
|
|
||||||||||
|
Called by HandleResourceChangeL() from CListboxAppUi when layout is changed.
Definition at line 312 of file ViewTemplate.h. References CViewTemplate< T >::iContainer. Referenced by CListboxAppUi::HandleResourceChangeL(). 00313 { 00314 if( iContainer ) 00315 { 00316 iContainer->HandleResourceChange( aType ); 00317 00318 if( aType==KEikDynamicLayoutVariantSwitch ) 00319 { 00320 TRect rect; 00321 AknLayoutUtils::LayoutMetricsRect(AknLayoutUtils::EMainPane, rect); 00322 iContainer->SetRect(rect); 00323 } 00324 } 00325 }
|
|
||||||||||
|
With this function is possible to dimm selected menuitem from options menu or from its submenus.
Definition at line 333 of file ViewTemplate.h. References CViewTemplate< T >::iItemToDimm. Referenced by CListboxAppUi::ConstructL(). 00334 { 00335 iItemToDimm = aMenuItemId; 00336 }
|
|
||||||||||
|
2nd phase constructor. Definition at line 229 of file ViewTemplate.h.
|
|
|||||
|
Container for this view. Owned. Definition at line 154 of file ViewTemplate.h. Referenced by CViewTemplate< T >::DoActivateL(), CViewTemplate< T >::DoDeactivate(), CViewTemplate< T >::HandleCommandL(), CViewTemplate< T >::HandleSizeChange(), and CViewTemplate< T >::~CViewTemplate(). |
|
|||||
|
View Identifier Definition at line 159 of file ViewTemplate.h. Referenced by CViewTemplate< T >::Id(). |
|
|||||
|
MSK menubar resource ID Definition at line 164 of file ViewTemplate.h. Referenced by CViewTemplate< T >::DoActivateL(). |
|
|||||
|
Identifier for dimmed menu item Definition at line 169 of file ViewTemplate.h. Referenced by CViewTemplate< T >::DynInitMenuPaneL(), and CViewTemplate< T >::MenuItemToDimm(). |
|
© Nokia 2009 |