• Skip to content
  • Skip to link menu
KDE 4.4 API Reference
  • KDE API Reference
  • KDE-PIM Libraries
  • Sitemap
  • Contact Us
 

KTNEF Library

KTnef::KTNEFWriter

KTnef::KTNEFWriter Class Reference

Manages the writing of TNEF attachments. More...

#include <ktnefwriter.h>

List of all members.

Public Types

enum  AlarmAction { Display }
enum  MessageType {
  Appointment, MeetingCancelled, MeetingRequest, MeetingNo,
  MeetingYes, MeetingTent
}
enum  Method {
  PublishNew, Obsolete, RequestNew, RequestUpdate,
  Unknown
}
enum  PartStat {
  NeedsAction, Accepted, Declined, Tentative,
  Delegated, Completed, InProcess
}
enum  Priority { High = 2, Normal = 3, Low = 1 }
enum  Role { ReqParticipant, OptParticipant, NonParticipant, Chair }

Public Member Functions

 KTNEFWriter ()
 ~KTNEFWriter ()
void addAttendee (const QString &name, Role role, PartStat partstat, bool rsvp, const QString &email)
void addProperty (int tag, int type, const QVariant &value)
void clearAttendees ()
void setAlarm (const QString &description, AlarmAction action, const QDateTime &wakeBefore)
void setCategories (const QStringList &categories)
void setDescription (const QString &description)
void setDtEnd (const QDateTime &dtEnd)
void setDtStamp (const QDateTime &dtStamp)
void setDtStart (const QDateTime &dtStart)
void setLocation (const QString &location)
void setMessageType (MessageType methodType)
void setMethod (Method method)
void setOrganizer (const QString &organizer)
void setPriority (Priority priority)
void setSender (const QString &name, const QString &email)
void setSummary (const QString &summary)
void setUID (const QString &uid)
bool writeFile (QDataStream &stream) const
bool writeFile (QIODevice &file) const
bool writeProperty (QDataStream &stream, int &bytes, int tag) const

Detailed Description

Manages the writing of TNEF attachments.

Definition at line 49 of file ktnefwriter.h.


Member Enumeration Documentation

enum KTnef::KTNEFWriter::AlarmAction

The different alarm actions.

Enumerator:
Display 

Display the alarm.

Definition at line 110 of file ktnefwriter.h.

enum KTnef::KTNEFWriter::MessageType

The different types of messages.

Enumerator:
Appointment 

Appointment.

MeetingCancelled 

The meeting is cancelled.

MeetingRequest 

Meeting request.

MeetingNo 

Negative response to a meeting request.

MeetingYes 

Affirmative response to a meeting request.

MeetingTent 

Tentative affirmative to a meeting request.

Definition at line 55 of file ktnefwriter.h.

enum KTnef::KTNEFWriter::Method

The different types of message statuses.

Enumerator:
PublishNew 

Publish new.

Obsolete 

Replace the message.

RequestNew 

Request a new message.

RequestUpdate 

Request an update.

Unknown 

Unknown.

Definition at line 67 of file ktnefwriter.h.

enum KTnef::KTNEFWriter::PartStat

The different types of participant statuses.

Enumerator:
NeedsAction 

No information about the task/invitation received.

Accepted 

Accepted the task/invitation.

Declined 

Declined the task/invitation.

Tentative 

Tentatively accepted the task/invitation.

Delegated 

Delegated the task to another.

Completed 

Completed the task.

InProcess 

Work on the task is in-progress.

Definition at line 88 of file ktnefwriter.h.

enum KTnef::KTNEFWriter::Priority

The different priorities.

Enumerator:
High 

High priority task.

Normal 

Normal priority task.

Low 

Low priority task.

Definition at line 101 of file ktnefwriter.h.

enum KTnef::KTNEFWriter::Role

The different types of meeting roles.

Enumerator:
ReqParticipant 

Required participant.

OptParticipant 

Optional participant.

NonParticipant 

Non-participant.

Chair 

Meeting chairperson.

Definition at line 78 of file ktnefwriter.h.


Constructor & Destructor Documentation

KTNEFWriter::KTNEFWriter (  ) 

Constructs a TNEF writer object.

Private class that helps to provide binary compatibility between releases.

For internal use only.

Definition at line 62 of file ktnefwriter.cpp.

KTNEFWriter::~KTNEFWriter (  ) 

Destroys the TNEF writer object.

Definition at line 79 of file ktnefwriter.cpp.


Member Function Documentation

void KTNEFWriter::addAttendee ( const QString &  name,
Role  role,
PartStat  partstat,
bool  rsvp,
const QString &  email 
)

Adds a meeting participant (attendee).

Parameters:
name is the name of the attendee
role is the Role of the attendee
partstat is the status PartStat of the attendee
rsvp is true if the attendee will attend the meeting; else false
email is the email address of the attendee

Definition at line 435 of file ktnefwriter.cpp.

void KTNEFWriter::addProperty ( int  tag,
int  type,
const QVariant &  value 
)

Adds a TNEF property.

Parameters:
tag is the TNEF tag
type is the property type
value is the property value

Definition at line 84 of file ktnefwriter.cpp.

void KTNEFWriter::clearAttendees (  ) 

Clears the attendees list.

Definition at line 430 of file ktnefwriter.cpp.

void KTNEFWriter::setAlarm ( const QString &  description,
AlarmAction  action,
const QDateTime &  wakeBefore 
)

Sets the alarm.

Parameters:
description is the alarm description
action is the alaram AlarmAction
wakeBefore is the alarm Date/Time

Definition at line 522 of file ktnefwriter.cpp.

void KTNEFWriter::setCategories ( const QStringList &  categories  ) 

Sets the category list to categories.

Parameters:
categories is the list categories.

Definition at line 496 of file ktnefwriter.cpp.

void KTNEFWriter::setDescription ( const QString &  description  ) 

Sets the description to description.

Parameters:
description is the description.

Definition at line 502 of file ktnefwriter.cpp.

void KTNEFWriter::setDtEnd ( const QDateTime &  dtEnd  ) 

Sets the Ending Date and Time to dtEnd.

Parameters:
dtEnd is the ending date/time.

Definition at line 472 of file ktnefwriter.cpp.

void KTNEFWriter::setDtStamp ( const QDateTime &  dtStamp  ) 

Sets the timestamp to dtStamp.

Parameters:
dtStamp is the timestamp.

Definition at line 490 of file ktnefwriter.cpp.

void KTNEFWriter::setDtStart ( const QDateTime &  dtStart  ) 

Sets the Starting Date and Time to dtStart.

Parameters:
dtStart is the starting date/time.

Definition at line 466 of file ktnefwriter.cpp.

void KTNEFWriter::setLocation ( const QString &  location  ) 

Sets the Location to location.

Parameters:
location is the location.

Definition at line 478 of file ktnefwriter.cpp.

void KTNEFWriter::setMessageType ( MessageType  methodType  ) 

Sets the MessageType to methodType.

Parameters:
methodType is the MessageType.

Definition at line 386 of file ktnefwriter.cpp.

void KTNEFWriter::setMethod ( Method  method  ) 

Sets the Method to method.

Parameters:
method is the Method.

Definition at line 425 of file ktnefwriter.cpp.

void KTNEFWriter::setOrganizer ( const QString &  organizer  ) 

Sets the name of the organizer to organizer.

The organizer is any string identifier; it could be the name of a person, or the application that sent the invitation, for example.

Parameters:
organizer is the organizer identifier.

Definition at line 448 of file ktnefwriter.cpp.

void KTNEFWriter::setPriority ( Priority  priority  ) 

Sets the priority to priority.

Parameters:
priority is the Priority.

Definition at line 516 of file ktnefwriter.cpp.

void KTNEFWriter::setSender ( const QString &  name,
const QString &  email 
)

Sets the sender's name and email address.

Parameters:
name is the sender's name.
email is the sender's email address.

Definition at line 370 of file ktnefwriter.cpp.

void KTNEFWriter::setSummary ( const QString &  summary  ) 

Sets the summary to summary.

Parameters:
summary is the summary.

Definition at line 508 of file ktnefwriter.cpp.

void KTNEFWriter::setUID ( const QString &  uid  ) 

Sets the UID to uid.

Parameters:
uid is the UID.

Definition at line 483 of file ktnefwriter.cpp.

bool KTNEFWriter::writeFile ( QDataStream &  stream  )  const

Writes the attachment to the QDataStream specified by stream.

Parameters:
stream is the QDataStream to write.
Returns:
true if the write was successful; otherwise false.

Definition at line 339 of file ktnefwriter.cpp.

bool KTNEFWriter::writeFile ( QIODevice &  file  )  const

Writes the attachment to the QIODevice specified by file.

Parameters:
file is the QIODevice to write.
Returns:
true if the write was successful; otherwise false.

Definition at line 329 of file ktnefwriter.cpp.

bool KTNEFWriter::writeProperty ( QDataStream &  stream,
int &  bytes,
int  tag 
) const

Writes a TNEF property to the QDataStream specified by stream.

A TNEF property has a 1 byte type (LVL_MESSAGE or LVL_ATTACHMENT), a 4 byte type/tag, a 4 byte length, the data and finally the checksum.

The checksum is a 16 byte int with all bytes in the data added.

Parameters:
stream is the QDataStream to write
bytes is a pointer to an int type that will contain the number of bytes written to the stream
tag is the TNEF tag
Returns:
false if an invalid TNEF tag was specified by tag or if there are no properties to write; else true.

Definition at line 125 of file ktnefwriter.cpp.


The documentation for this class was generated from the following files:
  • ktnefwriter.h
  • ktnefwriter.cpp

KTNEF Library

Skip menu "KTNEF Library"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

KDE-PIM Libraries

Skip menu "KDE-PIM Libraries"
  • akonadi
  •   contact
  •   kmime
  • kabc
  • kblog
  • kcal
  • kholidays
  • kimap
  • kioslave
  •   imap4
  •   mbox
  •   nntp
  • kldap
  • kmime
  • kontactinterface
  • kpimidentities
  • kpimtextedit
  •   richtextbuilders
  • kpimutils
  • kresources
  • ktnef
  • kxmlrpcclient
  • mailtransport
  • microblog
  • qgpgme
  • syndication
  •   atom
  •   rdf
  •   rss2
Generated for KDE-PIM Libraries by doxygen 1.6.2-20100208
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal