appointmentbuilder.h

来自「funambol window mobile客户端源代码」· C头文件 代码 · 共 100 行

/*
 * Funambol is a mobile platform developed by Funambol, Inc. 
 * Copyright (C) 2003 - 2007 Funambol, Inc.
 * 
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Affero General Public License version 3 as published by
 * the Free Software Foundation with the addition of the following permission
 * added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
 * WORK IN WHICH THE COPYRIGHT IS OWNED BY FUNAMBOL, FUNAMBOL DISCLAIMS THE
 * WARRANTY OF NON INFRINGEMENT  OF THIRD PARTY RIGHTS.
 * 
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 
 * details.
 * 
 * You should have received a copy of the GNU Affero General Public License
 * along with this program; if not, see http://www.gnu.org/licenses or write to
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 * MA 02110-1301 USA.
 * 
 * You can contact Funambol, Inc. headquarters at 643 Bair Island Road, Suite
 * 305, Redwood City, CA 94063, USA, or at email address [e-mail].
 * 
 * The interactive user interfaces in modified source and object code versions
 * of this program must display Appropriate Legal Notices, as required under
 * Section 5 of the GNU Affero General Public License version 3.
 * 
 * In accordance with Section 7(b) of the GNU Affero General Public License
 * version 3, these Appropriate Legal Notices must retain the display of the
 * "Powered by Funambol" logo. If the display of the logo is not reasonably
 * feasible for technical reasons, the Appropriate Legal Notices must display
 * the words "Powered by Funambol".
 */


#ifndef INCL_APPOINTMENT_BUILDER
#define INCL_APPOINTMENT_BUILDER

#include "pimstore.h"
#include "pim/Utils.h"
#include "pim/crc32.h"
#include "vocl/WinEvent.h"
#include "vocl/WinEventSIF.h"
#include "syncml/core/CTCap.h"
#include "syncml/core/Property.h"

#include <string>
using namespace std;


// Enumeration of appointment fields used by WM plugin.
// It's defined in AppointmentBuilder.cpp.
extern const wchar_t* appointmentFields[];


/**
 * Parses an appointment IItem using low level properties. 
 * It populates a WinEvent object.
 * @param pAppointment  the IItem appointment to parse 
 * @param isSif         true if we want to create a WinEventSIF object
 * @return              the WinEvent allocated and filled with properties from pAppointment
 */
WinItem* appointmentToWinEvent(IItem *pAppointment, bool isSif);

/**
 * Reads all properties from the given WinEvent, and populates the pAppointment IItem.
 * 1. if it's an UPDATED item, clear RecPattern -> delete recurrence + exceptions if any
 *    (use old-style IAppointment interface to use the utility ClearRecurrencePattern)
 * 2. set all normal props to IItem
 * 3. if recurring, set all rec props to IItem (append after normal props)
 * 4. save the IItem
 * 5. set all events exceptions if any (RDATEs become new events)
 *
 * @param winE          input WinEvent (or WinEventSIF) to read props from
 * @param pAppointment  IItem to set props and save in POutlook
 * @param path          path to write oidToReset file (for RDATEs exceptions)
 * @param oidToUpdate   the oid of appointment to update, MUST be 0 if it's a NEW item
 * @return              S_OK = 0 if operation succesfull, < 0 if errors
 */
HRESULT winEventToAppointment(WinEvent& winE, IItem *pAppointment, const wstring& path, long oidToUpdate);


BOOL normalizeAppointmentExceptions(IP_OUTLOOK_APP* polApp);


// -- These functions should be removed once the update from old CRC is no more necessary --
void populateAppointmentStringItem(wstring &appointmentStringItem, IAppointment *pAppointment, BOOL isCRC = FALSE);
long calculateAppointmentHash (IAppointment* pAppointment);
BOOL isAllDayEvent(DATE start, DATE end);
long calculateDayOfWeek(wchar_t* in);
bool isDayOfWeek(wchar_t* string);
long getWeekDay(DATE dt);
wchar_t* extractDayOfWeek(long l);
ArrayList* getAppointmentProperties();
ArrayList* getVCalendarProperties();
// -----------------------------------------------------------------------------------------


#endif  // #ifndef INCL_APPOINTMENT_BUILDER