epoc32/include/msvstd.inl
author William Roberts <williamr@symbian.org>
Tue, 16 Mar 2010 16:12:26 +0000
branchSymbian2
changeset 2 2fe1408b6811
parent 0 061f57f2323e
permissions -rw-r--r--
Final list of Symbian^2 public API header files
     1 // Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).
     2 // All rights reserved.
     3 // This component and the accompanying materials are made available
     4 // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
     5 // which accompanies this distribution, and is available
     6 // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
     7 //
     8 // Initial Contributors:
     9 // Nokia Corporation - initial contribution.
    10 //
    11 // Contributors:
    12 //
    13 // Description:
    14 //
    15 
    16 inline TMsvId TMsvEntry::Id() const
    17 /** Gets the value of the entry ID.
    18 
    19 @return The value of the entry ID */
    20 	{
    21 	return iId;
    22 	}
    23 
    24 inline void TMsvEntry::SetId(TMsvId aId)
    25 	{
    26 	iId = aId;
    27 	}
    28 
    29 inline TMsvId TMsvEntry::Parent() const
    30 /** Gets the value of the parent ID.
    31 
    32 @return The value of the parent ID */
    33 	{
    34 	return iParentId;
    35 	}
    36 
    37 inline void TMsvEntry::SetParent(TMsvId aParentId)
    38 	{
    39 	iParentId = aParentId;
    40 	}
    41 
    42 inline TBool TMsvEntry::Complete () const
    43 /** Gets the value of the message complete flag.
    44 
    45 Note that for email download without size limits, the complete flag will only
    46 be set to true once all the parts of the message (body text and attachments)
    47 have been downloaded.
    48 
    49 @return The value of the message complete flag */
    50 	{
    51 	return !(iData&KMsvEntryNotCompleteFlag);
    52 	}
    53 
    54 inline void TMsvEntry::SetComplete(TBool aComplete)
    55 /** Sets the message complete flag.
    56 
    57 Note that for email download without size limits, the complete flag will only
    58 be set to true once all the parts of the message (body text and attachments)
    59 have been downloaded.
    60 
    61 @param aComplete Value for the message complete flag */
    62 	{
    63 	iData = (iData & ~KMsvEntryNotCompleteFlag) | ((!aComplete)?KMsvEntryNotCompleteFlag:KMsvEntryClearFlag);
    64 	}
    65 
    66 inline TBool TMsvEntry::New() const
    67 /** Gets the value of the new message flag.
    68 
    69 @return The value of the new message flag */
    70 	{
    71 	return iData&KMsvEntryNewFlag;
    72 	}
    73 
    74 inline void TMsvEntry::SetNew(TBool aNew)
    75 /** Sets the message new flag.
    76 
    77 @param aNew Value for the message new flag */
    78 	{
    79 	iData = (iData & ~KMsvEntryNewFlag) | (aNew?KMsvEntryNewFlag:KMsvEntryClearFlag);
    80 	}
    81 
    82 inline TBool TMsvEntry::Unread() const
    83 /** Gets the value of the message unread flag.
    84 
    85 @return The value of the message unread flag */
    86 	{
    87 	return iData&KMsvEntryUnreadFlag;
    88 	}
    89 
    90 inline void TMsvEntry::SetUnread(TBool aUnread)
    91 /** Sets the message unread flag.
    92 	
    93 @param aUnread Value for the message unread flag */
    94 	{
    95 	iData = (iData & ~KMsvEntryUnreadFlag) | (aUnread?KMsvEntryUnreadFlag:KMsvEntryClearFlag);
    96 	}
    97 
    98 inline TBool TMsvEntry::Failed() const
    99 /** Gets the value of the message send failed flag.
   100 
   101 @return The value of the message send failed flag */
   102 	{
   103 	return iData&KMsvEntryFailedFlag;
   104 	}
   105 
   106 inline void TMsvEntry::SetFailed(TBool aFailed)
   107 /** Sets the message send failed flag.
   108 
   109 @param aFailed Value for the message send failed flag */
   110 	{
   111 	iData = (iData & ~KMsvEntryFailedFlag) | (aFailed?KMsvEntryFailedFlag:KMsvEntryClearFlag);
   112 	}
   113 
   114 inline TBool TMsvEntry::Operation() const
   115 /** Gets the value of the disconnected operation queued flag.
   116 
   117 @return The value of the disconnected operation queued flag */
   118 	{
   119 	return iData&KMsvEntryOperationFlag;
   120 	}
   121 
   122 inline void TMsvEntry::SetOperation(TBool aOperation)
   123 /** Sets the disconnected operation queued flag.
   124 
   125 @param aOperation Value for the disconnected operation queued flag */
   126 	{
   127 	iData = (iData & ~KMsvEntryOperationFlag) | (aOperation?KMsvEntryOperationFlag:KMsvEntryClearFlag);
   128 	}
   129 
   130 inline TBool TMsvEntry::Owner() const
   131 /** Gets the value of the owner flag.
   132 
   133 @return The value of the owner flag */
   134 	{
   135 	return iData&KMsvEntryOwnerFlag;
   136 	}
   137 
   138 inline void TMsvEntry::SetOwner(TBool aOwner)
   139 	{
   140 	iData = (iData & ~KMsvEntryOwnerFlag) | (aOwner?KMsvEntryOwnerFlag:KMsvEntryClearFlag);
   141 	}
   142 
   143 inline TBool TMsvEntry::Attachment() const
   144 /** Gets the value of the attachment flag.
   145 
   146 @return The value of the attachment flag */
   147 	{
   148 	return iData&KMsvEntryAttachmentFlag;
   149 	}
   150 
   151 inline void TMsvEntry::SetAttachment(TBool aAttachmentFlag)
   152 /** Sets the attachment flag.
   153 
   154 @param aAttachmentFlag Value for the attachment flag */
   155 	{
   156 	iData = (iData & ~KMsvEntryAttachmentFlag) | (aAttachmentFlag?KMsvEntryAttachmentFlag:KMsvEntryClearFlag);
   157 	}
   158 
   159 inline TBool TMsvEntry::Visible() const
   160 /** Gets the value of the entry visible flag.
   161 
   162 @return The value of the entry visible flag */
   163 	{
   164 	return !((iData&KMsvEntryInvisibleFlag) || (iData&KMsvEntryPendingDeleteFlag));
   165 	}
   166 
   167 inline void TMsvEntry::SetVisible(TBool aVisble)
   168 /** Sets the entry visible flag.
   169 	
   170 @param aVisble Value for the entry visible flag */
   171 	{
   172 	iData = (iData & ~KMsvEntryInvisibleFlag) | ((!aVisble)?KMsvEntryInvisibleFlag:KMsvEntryClearFlag);
   173 	}
   174 
   175 inline TBool TMsvEntry::MultipleRecipients() const
   176 /** Gets the value of the multiple recipients flag.
   177 
   178 @return The value of the multiple recipients flag */
   179 	{
   180 	return iData&KMsvEntryMultipleRecipientFlag;
   181 	}
   182 
   183 inline void TMsvEntry::SetMultipleRecipients(TBool aMultipleRecipient)
   184 /** Sets the multiple recipients flag.
   185 	
   186 @param aMultipleRecipient Value for the multiple recipients flag */
   187 	{
   188 	iData = (iData & ~KMsvEntryMultipleRecipientFlag) | (aMultipleRecipient?KMsvEntryMultipleRecipientFlag:KMsvEntryClearFlag);
   189 	}
   190 
   191 inline TBool TMsvEntry::ReadOnly() const
   192 /** Gets the value of the read-only flag.
   193 
   194 @return The value of the read-only flag */
   195 	{
   196 	return iData&KMsvEntryReadOnlyFlag;
   197 	}
   198 
   199 inline void TMsvEntry::SetReadOnly(TBool aReadOnly)
   200 /** Sets the read-only flag.
   201 
   202 @param aReadOnly Value for the read-only flag */
   203 	{
   204 	iData = (iData & ~KMsvEntryReadOnlyFlag) | (aReadOnly?KMsvEntryReadOnlyFlag:KMsvEntryClearFlag);
   205 	}
   206 
   207 inline TBool TMsvEntry::Deleted() const
   208 /** Gets the value of the deleted flag.
   209 
   210 @return The value of the deleted flag */
   211 	{
   212 	return iData&KMsvEntryDeletedFlag;
   213 	}
   214 
   215 inline void TMsvEntry::SetDeleted(TBool aDeletedFlag)
   216 	{
   217 	iData = (iData & ~KMsvEntryDeletedFlag) | (aDeletedFlag?KMsvEntryDeletedFlag:KMsvEntryClearFlag);
   218 	}
   219 
   220 inline TBool TMsvEntry::StandardFolder() const
   221 /** Gets the value of the standard folder flag.
   222 
   223 @return The value of the standard folder flag */
   224 	{
   225 	return iData&KMsvEntryStandardFolderFlag;
   226 	}
   227 
   228 inline void TMsvEntry::SetStandardFolder(TBool aStandardFolder)
   229 	{
   230 	iData = (iData & ~KMsvEntryStandardFolderFlag) | (aStandardFolder?KMsvEntryStandardFolderFlag:KMsvEntryClearFlag);
   231 	}
   232 
   233 inline TBool TMsvEntry::Connected() const
   234 /** Gets the value of the remote server connection flag.
   235 
   236 @return The value of the remote server connection flag */
   237 	{
   238 	return iData&KMsvEntryConnectedFlag;
   239 	}
   240 
   241 inline void TMsvEntry::SetConnected(TBool aConnected)
   242 /** Sets the remote server connection flag.
   243 
   244 @param aConnected Value for the remote server connection flag */
   245 	{
   246 	iData = (iData & ~KMsvEntryConnectedFlag) | (aConnected?KMsvEntryConnectedFlag:KMsvEntryClearFlag);
   247 	}
   248 
   249 inline TBool TMsvEntry::InPreparation() const
   250 /** Gets the value of the in preparation flag.
   251 
   252 @return The value of the in preparation flag */
   253 	{
   254 	return iData&KMsvEntryInPreparationFlag;
   255 	}
   256 
   257 inline void TMsvEntry::SetInPreparation(TBool aInPreparation)
   258 /** Sets the in-preparation flag.
   259 
   260 @param aInPreparation Value for the in-preparation flag */
   261 	{
   262 	iData = (iData & ~KMsvEntryInPreparationFlag) | (aInPreparation?KMsvEntryInPreparationFlag:KMsvEntryClearFlag);
   263 	}
   264 
   265 inline TInt TMsvEntry::PcSyncCount() const
   266 /** Gets the value of the PC synchronisation field.
   267 
   268 @return The value of the PC synchronisation field */
   269 	{
   270 	return iPcSyncCount;
   271 	}
   272 
   273 inline void TMsvEntry::IncPcSyncCount()
   274 /** Increments the PC synchronisation field. */
   275 	{
   276 	iPcSyncCount++;
   277 	}
   278 
   279 inline void TMsvEntry::DecPcSyncCount()
   280 /** Decrements the PC synchronisation field. */
   281 	{
   282 	iPcSyncCount--;
   283 	}
   284 
   285 inline TUint TMsvEntry::PersistedFlags() const
   286 	{
   287 	return iData&KMsvEntryPersistedFlags;
   288 	}
   289 
   290 inline TUint TMsvEntry::TemporaryFlags() const
   291 	{
   292 	return iData&KMsvEntryTemporaryFlags;
   293 	}
   294 
   295 inline TBool TMsvEntry::OffPeak() const
   296 /** Gets the off-peak flag.
   297 
   298 @return The value of the off-peak flag */
   299 	{
   300 	return iData & KMsvOffPeakFlag;
   301 	}
   302 
   303 inline void TMsvEntry::SetOffPeak(TBool aOffPeak)
   304 /** Sets the off-peak flag.
   305 
   306 @param aOffPeak Value for off-peak flag. */
   307 	{
   308 	iData = (iData & ~KMsvOffPeakFlag) | (aOffPeak ? KMsvOffPeakFlag : KMsvEntryClearFlag);
   309 	}
   310 
   311 inline TBool TMsvEntry::Scheduled() const
   312 /** Gets the scheduled flag.
   313 
   314 @return The value of the scheduled flag */
   315 	{
   316 	return iData & KMsvScheduledFlag;
   317 	}
   318 
   319 inline void TMsvEntry::SetScheduled(TBool aScheduled)
   320 /** Sets the scheduled flag.
   321 
   322 @param aScheduled Value for the scheduled flag. */
   323 	{
   324 	iData = (iData & ~KMsvScheduledFlag) | (aScheduled ? KMsvScheduledFlag : KMsvEntryClearFlag);
   325 	}
   326 	
   327 inline TUint TMsvEntry::SendingState() const
   328 /** Gets the sending state.
   329  
   330 @return The sending state */
   331 	{
   332 	return (iData & KMsvSendingStateFlags) >> KMsvSendingStateShift;
   333 	}
   334 	 
   335 inline void TMsvEntry::SetSendingState(TUint aSendingState)
   336 /** Sets the sending state.
   337   
   338 @param aSendingState The sending state. This must be a value between 0x00 
   339 and KMsvSendStateMax. */
   340 	{
   341 	__ASSERT_DEBUG(aSendingState <= KMsvSendStateMax, User::Invariant());
   342 	iData = iData & ~KMsvSendingStateFlags | aSendingState << KMsvSendingStateShift;
   343 	}
   344 
   345 inline void TMsvEntry::SetPendingDelete(TBool aPendingDelete)
   346 	{
   347 	iData = (iData & ~KMsvEntryPendingDeleteFlag) | (aPendingDelete ? KMsvEntryPendingDeleteFlag : KMsvEntryClearFlag);
   348 	}
   349 
   350 inline TBool TMsvEntry::PendingDelete() const
   351 	{
   352 	return iData & KMsvEntryPendingDeleteFlag;
   353 	}
   354 	
   355 
   356 inline void TMsvEntry::SetDeleteProtected(TBool aDeleteProtected)
   357 	{
   358 	/** temporary variable used to mask the anonymous global enum.		*/
   359 	TInt temp = KMsvEntryDeleteProtected;
   360 /** Sets the delete protected state */
   361 	iMtmData1 = (iMtmData1 & ~KMsvEntryDeleteProtected ) | (aDeleteProtected ? temp : KMsvEntryClearFlag);
   362 	}
   363 
   364 inline TBool TMsvEntry::DeleteProtected() const
   365 	{
   366 /** returns the delete protected state */
   367 	return iMtmData1 & KMsvEntryDeleteProtected;
   368 	}
   369 	
   370 inline void TMsvEntry::SetForwarded(TBool aForwarded)
   371 	{
   372 	/** temporary variable used to mask the anonymous global enum.		*/
   373 	TInt temp = KMsvEntryForwarded ;
   374 /** Sets the forwarded state */
   375 	iMtmData1 = (iMtmData1 & ~KMsvEntryForwarded) | (aForwarded ? temp : KMsvEntryClearFlag);
   376 	}
   377 
   378 inline TBool TMsvEntry::Forwarded() const
   379 	{
   380 /** returns the forwarded state */
   381 	return iMtmData1 & KMsvEntryForwarded;
   382 	}
   383 
   384 inline void TMsvEntry::SetLocallyDeleted(TBool aLocallyDeleted)
   385 	{
   386 	/** temporary variable used to mask the anonymous global enum.		*/
   387 	TInt temp = KMsvEntryLocallyDeleted ;
   388 /** Sets the locally deleted state */
   389 	iMtmData1 = (iMtmData1 & ~KMsvEntryLocallyDeleted) | (aLocallyDeleted ? temp : KMsvEntryClearFlag);
   390 	}
   391 
   392 inline TBool TMsvEntry::LocallyDeleted() const
   393 	{
   394 /** returns the locally deleted state  */
   395 	return iMtmData1 & KMsvEntryLocallyDeleted;
   396 	}	
   397 
   398 //**********************************
   399 // TMsvSelectionOrdering
   400 //**********************************
   401 
   402 inline TBool TMsvSelectionOrdering::GroupByType() const
   403 /** Gets the group-by-entry-type flag.
   404 
   405 @return Group-by-entry-type flag */
   406 	{
   407 	return iGrouping&KMsvGroupByType;
   408 	}
   409 
   410 inline TBool TMsvSelectionOrdering::GroupStandardFolders() const
   411 /** Gets the group-by-standard-folders flag.
   412 
   413 @return Group-by-standard-folders flag */
   414 	{
   415 	return iGrouping&KMsvStandardFolders;
   416 	}
   417 
   418 inline TBool TMsvSelectionOrdering::GroupByPriority() const
   419 /** Gets the group-by-priority flag.
   420 
   421 @return Group-by-priority flag */
   422 	{
   423 	return iGrouping&KMsvGroupByPriority;
   424 	}
   425 
   426 inline TBool TMsvSelectionOrdering::GroupByMtm() const
   427 /** Gets the group-by-MTM flag.
   428 
   429 @return Group-by-MTM flag */
   430 	{
   431 	return iGrouping&KMsvGroupByMtm;
   432 	}
   433 
   434 inline TBool TMsvSelectionOrdering::ShowInvisibleEntries() const
   435 /** Gets the show-invisible-entries flag. Entries whose entry visible flag index 
   436 field is not set are included in the ordered list only if this is set. 
   437 
   438 @return Show-invisible-entries flag */
   439 	{
   440 	return iGrouping&KMsvInvisibleFlag;
   441 	}
   442 
   443 inline void TMsvSelectionOrdering::SetGroupByType(TBool aFlag)
   444 	{
   445 	iGrouping = (iGrouping & ~KMsvGroupByStandardFolders) | ((aFlag)?KMsvGroupByType:0);
   446 	}
   447 
   448 inline void TMsvSelectionOrdering::SetGroupStandardFolders(TBool aFlag)
   449 	{
   450 	iGrouping = (iGrouping & ~KMsvStandardFolders) | ((aFlag)?KMsvGroupByStandardFolders:0);
   451 	}
   452 
   453 inline void TMsvSelectionOrdering::SetGroupByPriority(TBool aFlag)
   454 	{
   455 	iGrouping = (iGrouping & ~KMsvGroupByPriority) | ((aFlag)?KMsvGroupByPriority:0);
   456 	}
   457 
   458 inline void TMsvSelectionOrdering::SetGroupByMtm(TBool aFlag)
   459 	{
   460 	iGrouping = (iGrouping & ~KMsvGroupByMtm) | ((aFlag)?KMsvGroupByMtm:0);
   461 	}
   462 
   463 inline void TMsvSelectionOrdering::SetShowInvisibleEntries(TBool aFlag)
   464 	{
   465 	iGrouping = (iGrouping & ~KMsvInvisibleFlag) | ((aFlag)?KMsvInvisibleFlag:0);
   466 	}
   467 
   468 inline TMsvSorting TMsvSelectionOrdering::Sorting() const
   469 /** Gets the sorting order of entries within groups.
   470 
   471 @return Sorting order. */
   472 	{
   473 	return iSortType;
   474 	}
   475 
   476 inline void TMsvSelectionOrdering::SetSorting(TMsvSorting aSortType)
   477 	{
   478 	iSortType=aSortType;
   479 	}
   480 
   481 inline TBool TMsvSelectionOrdering::GroupingOn() const
   482 /** Tests whether any grouping option has been set.
   483 
   484 @return ETrue if one or more grouping options have been set, else EFalse */
   485 	{
   486 	return iGrouping&KMsvAllGroupingFlags;
   487 	}
   488 
   489 //**********************************
   490 // CMsvEntryFilter
   491 //**********************************
   492 
   493 inline TMsvId CMsvEntryFilter::Service() const
   494 /** Gets the service ID set for the filter.
   495 
   496 @return Service ID set for the filter */
   497 	{
   498 	return iServiceId;
   499 	}
   500 
   501 inline void CMsvEntryFilter::SetService(TMsvId aServiceId)
   502 /** Sets the service ID for the filter.
   503 
   504 @param aServiceId Service ID for the filter */
   505 	{
   506 	iServiceId = aServiceId;
   507 	}
   508 
   509 inline TUid CMsvEntryFilter::Mtm() const
   510 /** Gets the MTM UID set for the filter.
   511 
   512 @return MTM UID set for the filter */
   513 	{
   514 	return iMtm;
   515 	}
   516 
   517 inline void CMsvEntryFilter::SetMtm(TUid aMtm)
   518 /** Sets the MTM UID for the filter.
   519 
   520 @param aMtm MTM UID for the filter */
   521 	{
   522 	iMtm = aMtm;
   523 	}
   524 
   525 inline TUid CMsvEntryFilter::Type() const
   526 /** Gets the entry type set for the filter.
   527 
   528 @return Entry type set for the filter */
   529 	{
   530 	return iType;
   531 	}
   532 
   533 inline void CMsvEntryFilter::SetType(TUid aType)
   534 /** Sets the entry type for the filter.
   535 
   536 @param aType Entry type for the filter */
   537 	{
   538 	iType = aType;
   539 	}
   540 
   541 inline const TTime& CMsvEntryFilter::LastChangeDate() const
   542 /** Gets the last change date set for the filter.
   543 
   544 @return Last change date set for the filter */
   545 	{
   546 	return iLastChange;
   547 	}
   548 
   549 inline void CMsvEntryFilter::SetLastChangeDate(const TTime& aLastChange)
   550 /** Sets the last date change for the filter.
   551 
   552 This is used to retrieve entries that have changed since a particular date.
   553 
   554 @param aLastChange Last date change for the filter, specified in Universal 
   555 Time (GMT) */
   556 	{
   557 	iLastChange = aLastChange;
   558 	}
   559 
   560 inline const TMsvSelectionOrdering& CMsvEntryFilter::Order() const
   561 /** Gets the selection ordering set for the filter.
   562 
   563 @return Selection ordering set for the filter */
   564 	{
   565 	return iOrdering;
   566 	}
   567 
   568 inline void CMsvEntryFilter::SetOrder(const TMsvSelectionOrdering& aOrder)
   569 /** Sets the sort ordering for the filter.
   570 
   571 @param aOrder Selection ordering for the filter */
   572 	{
   573 	iOrdering = aOrder;
   574 	}
   575 
   576 inline TUid CMsvEntryFilter::SortMtm() const
   577 /** Gets the sorting by MTM for the filter.
   578 
   579 @return Sorting by MTM for the filter */
   580 	{
   581 	return iSortMtm;
   582 	}
   583 
   584 inline void CMsvEntryFilter::SetSortMtm(TUid aSortMtm)
   585 /** Sets the sorting by MTM for the filter.
   586 
   587 @param aSortMtm Sorting by MTM for the filter */
   588 	{
   589 	iSortMtm = aSortMtm;
   590 	}