KCal::AttachmentHandler Namespace Reference

Functions

Attachmentfind (TQWidget *parent, const TQString &attachmentName, Incidence *incidence)
Attachmentfind (TQWidget *parent, const TQString &attachmentName, ScheduleMessage *message)
Attachmentfind (TQWidget *parent, const TQString &attachmentName, const TQString &uid)
bool view (TQWidget *parent, Attachment *attachment)
bool view (TQWidget *parent, const TQString &attachmentName, Incidence *incidence)
bool view (TQWidget *parent, const TQString &attachmentName, const TQString &uid)
bool view (TQWidget *parent, const TQString &attachmentName, ScheduleMessage *message)
bool saveAs (TQWidget *parent, Attachment *attachment)
bool saveAs (TQWidget *parent, const TQString &attachmentName, Incidence *incidence)
bool saveAs (TQWidget *parent, const TQString &attachmentName, const TQString &uid)
bool saveAs (TQWidget *parent, const TQString &attachmentName, ScheduleMessage *message)

Detailed Description

Provides methods to handle incidence attachments.

Includes functions to view and save attachments.


Function Documentation

Attachment * KCal::AttachmentHandler::find ( TQWidget *  parent,
const TQString &  attachmentName,
Incidence *  incidence 
)

Finds the attachment in the user's calendar, by attachmentName and incidence.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentNameis the name of the attachment
incidenceis a pointer to a valid Incidence object containing the attachment.
Returns:
a pointer to the Attachment object located; 0 if no such attachment could be found.

Definition at line 50 of file attachmenthandler.cpp.

Attachment * KCal::AttachmentHandler::find ( TQWidget *  parent,
const TQString &  attachmentName,
ScheduleMessage *  message 
)

Finds the attachment in the user's calendar, by attachmentName and a scheduler message; in other words, this function is intended to retrieve attachments from calendar invitations.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentNameis the name of the attachment
messageis a pointer to a valid ScheduleMessage object containing the attachment.
Returns:
a pointer to the Attachment object located; 0 if no such attachment could be found.

Definition at line 111 of file attachmenthandler.cpp.

Attachment * KCal::AttachmentHandler::find ( TQWidget *  parent,
const TQString &  attachmentName,
const TQString &  uid 
)

Finds the attachment in the user's calendar, by attachmentName and uid.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentNameis the name of the attachment
uidis a TQString containing a UID of the incidence containing the attachment.
Returns:
a pointer to the Attachment object located; 0 if no such attachment could be found.

Definition at line 89 of file attachmenthandler.cpp.

bool KCal::AttachmentHandler::saveAs ( TQWidget *  parent,
Attachment *  attachment 
)

Saves the specified attachment to a file of the user's choice.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentis a pointer to a valid Attachment object.
Returns:
true if the save operation was successful; false otherwise.

Definition at line 202 of file attachmenthandler.cpp.

bool KCal::AttachmentHandler::saveAs ( TQWidget *  parent,
const TQString &  attachmentName,
Incidence *  incidence 
)

Saves the specified attachment to a file of the user's choice.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentNameis the name of the attachment
incidenceis a pointer to a valid Incidence object containing the attachment.
Returns:
true if the attachment could be found and the save operation was successful; false otherwise.

Definition at line 240 of file attachmenthandler.cpp.

bool KCal::AttachmentHandler::saveAs ( TQWidget *  parent,
const TQString &  attachmentName,
const TQString &  uid 
)

Saves the specified attachment to a file of the user's choice.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentNameis the name of the attachment
uidis a TQString containing a UID of the incidence containing the attachment.
Returns:
true if the attachment could be found and the save operation was successful; false otherwise.

Definition at line 246 of file attachmenthandler.cpp.

bool KCal::AttachmentHandler::saveAs ( TQWidget *  parent,
const TQString &  attachmentName,
ScheduleMessage *  message 
)

Saves the specified attachment to a file of the user's choice.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentNameis the name of the attachment
messageis a pointer to a valid ScheduleMessage object containing the attachment.
Returns:
true if the attachment could be found and the save operation was successful; false otherwise.

Definition at line 251 of file attachmenthandler.cpp.

bool KCal::AttachmentHandler::view ( TQWidget *  parent,
Attachment *  attachment 
)

Launches a viewer on the specified attachment.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentis a pointer to a valid Attachment object.
Returns:
true if the viewer program successfully launched; false otherwise.

Definition at line 160 of file attachmenthandler.cpp.

bool KCal::AttachmentHandler::view ( TQWidget *  parent,
const TQString &  attachmentName,
Incidence *  incidence 
)

Launches a viewer on the specified attachment.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentNameis the name of the attachment
incidenceis a pointer to a valid Incidence object containing the attachment.
Returns:
true if the attachment could be found and the viewer program successfully launched; false otherwise.

Definition at line 186 of file attachmenthandler.cpp.

bool KCal::AttachmentHandler::view ( TQWidget *  parent,
const TQString &  attachmentName,
const TQString &  uid 
)

Launches a viewer on the specified attachment.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentNameis the name of the attachment
uidis a TQString containing a UID of the incidence containing the attachment.
Returns:
true if the attachment could be found and the viewer program successfully launched; false otherwise.

Definition at line 191 of file attachmenthandler.cpp.

bool KCal::AttachmentHandler::view ( TQWidget *  parent,
const TQString &  attachmentName,
ScheduleMessage *  message 
)

Launches a viewer on the specified attachment.

Parameters:
parentis the parent widget for the dialogs used in this function.
attachmentNameis the name of the attachment
messageis a pointer to a valid ScheduleMessage object containing the attachment.
Returns:
true if the attachment could be found and the viewer program successfully launched; false otherwise.

Definition at line 196 of file attachmenthandler.cpp.