You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
167 lines
4.4 KiB
167 lines
4.4 KiB
#ifndef _KPILOT_PILOTTODOENTRY_H
|
|
#define _KPILOT_PILOTTODOENTRY_H
|
|
/* pilotTodoEntry.h -*- C++ -*- KPilot
|
|
**
|
|
** Copyright (C) 1998-2001 by Dan Pilone
|
|
** Copyright (C) 2003-2004 Reinhold Kainhofer <reinhold@kainhofer.com>
|
|
**
|
|
** This is a wrapper around the pilot-link Memo structure. It is
|
|
** the interpreted form of a Pilot database record.
|
|
*/
|
|
|
|
/*
|
|
** This program is free software; you can redistribute it and/or modify
|
|
** it under the terms of the GNU Lesser General Public License as published by
|
|
** the Free Software Foundation; either version 2.1 of the License, or
|
|
** (at your option) any later version.
|
|
**
|
|
** 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 Lesser General Public License for more details.
|
|
**
|
|
** You should have received a copy of the GNU Lesser General Public License
|
|
** along with this program in a file called COPYING; if not, write to
|
|
** the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
|
** MA 02110-1301, USA.
|
|
*/
|
|
|
|
/*
|
|
** Bug reports and questions can be sent to kde-pim@kde.org
|
|
*/
|
|
|
|
#include <time.h>
|
|
|
|
#include <pi-macros.h>
|
|
#include <pi-todo.h>
|
|
|
|
#include <qnamespace.h>
|
|
#include <qstring.h>
|
|
|
|
#include "pilotRecord.h"
|
|
#include "pilotAppInfo.h"
|
|
|
|
/** @file This file defines structures wrapped around the ToDo database
|
|
* on the Pilot, based on pilot-link's ToDo stuff.
|
|
*/
|
|
|
|
/** A decoded ToDo item. */
|
|
class KDE_EXPORT PilotTodoEntry : public PilotRecordBase
|
|
{
|
|
public:
|
|
/** Create an empty ToDo item. All attributes are 0. */
|
|
PilotTodoEntry();
|
|
|
|
/**
|
|
* Constructor. Create a ToDo item and fill it with data from the
|
|
* uninterpreted record @p rec. The record may be NULL, in which
|
|
* case the todo is empty and its category and ID are zero, as in
|
|
* the constructor above.
|
|
*/
|
|
PilotTodoEntry(PilotRecord * rec);
|
|
|
|
/** Copy an existing ToDo item. */
|
|
PilotTodoEntry(const PilotTodoEntry &e);
|
|
|
|
/** Delete a ToDo item. */
|
|
~PilotTodoEntry()
|
|
{
|
|
free_ToDo(&fTodoInfo);
|
|
}
|
|
|
|
/** Return a string for the ToDo item. If @param richText is true, then
|
|
* use qt style markup to make the string clearer when displayed.
|
|
*/
|
|
QString getTextRepresentation(Qt::TextFormat richText);
|
|
|
|
/** Assign an existing ToDo item to this one. */
|
|
PilotTodoEntry& operator=(const PilotTodoEntry &e);
|
|
|
|
/** Accessor for the Due Date of the ToDo item. */
|
|
struct tm getDueDate() const { return fTodoInfo.due; }
|
|
|
|
/** Set the Due Date for the ToDo item. */
|
|
void setDueDate(struct tm& d)
|
|
{
|
|
fTodoInfo.due = d;
|
|
}
|
|
|
|
/** Return the indefinite status of the ToDo (? that is, whether it
|
|
* had a Due Date that is relevant or not). Return values are 0
|
|
* (not indefinite) or non-0.
|
|
*/
|
|
int getIndefinite() const
|
|
{
|
|
return fTodoInfo.indefinite;
|
|
}
|
|
|
|
/** Set whether the ToDo is indefinite or not. */
|
|
void setIndefinite(int i)
|
|
{
|
|
fTodoInfo.indefinite = i;
|
|
}
|
|
|
|
/** Return the priority of the ToDo item. The priority ranges
|
|
* from 1-5 on the handheld, so this needs to be mapped (perhaps)
|
|
* onto KOrganizer's priority levels.
|
|
*/
|
|
int getPriority() const
|
|
{
|
|
return fTodoInfo.priority;
|
|
}
|
|
|
|
/** Set the priority of the ToDo. */
|
|
void setPriority(int p)
|
|
{
|
|
fTodoInfo.priority = p;
|
|
}
|
|
|
|
/** Return whether the ToDo is complete (done, finished) or not. */
|
|
int getComplete() const
|
|
{
|
|
return fTodoInfo.complete;
|
|
}
|
|
|
|
/** Set whether the ToDo is done. */
|
|
void setComplete(int c)
|
|
{
|
|
fTodoInfo.complete = c;
|
|
}
|
|
|
|
/** Get the ToDo item's description (which is the title shown on
|
|
* the handheld, and the item's Title in KDE). This uses the default codec.
|
|
*/
|
|
QString getDescription() const;
|
|
/** Set the ToDo item's description. */
|
|
void setDescription(const QString &);
|
|
|
|
/** Get the ToDo item's note (the longer text, not immediately accessible
|
|
* on the handheld). This uses the default codec.
|
|
*/
|
|
QString getNote() const;
|
|
|
|
/** Set the ToDo item's note. */
|
|
void setNote(const QString ¬e);
|
|
|
|
/** Returns the label for the category this ToDo item is in. */
|
|
QString getCategoryLabel() const;
|
|
|
|
PilotRecord *pack() const;
|
|
|
|
protected:
|
|
const char *getDescriptionP() const { return fTodoInfo.description; } ;
|
|
void setDescriptionP(const char *, int len=-1) ;
|
|
const char *getNoteP() const { return fTodoInfo.note; } ;
|
|
void setNoteP(const char *, int len=-1) ;
|
|
|
|
private:
|
|
struct ToDo fTodoInfo;
|
|
unsigned int fDescriptionSize, fNoteSize;
|
|
};
|
|
|
|
typedef PilotAppInfo<ToDoAppInfo,unpack_ToDoAppInfo, pack_ToDoAppInfo> PilotToDoInfo;
|
|
|
|
|
|
#endif
|
|
|