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.
121 lines
4.2 KiB
121 lines
4.2 KiB
/* part of a mime multi-part message |
|
* Author: Stefan Taferner <taferner@alpin.or.at> |
|
*/ |
|
#ifndef kmmsgpart_h |
|
#define kmmsgpart_h |
|
|
|
#include <mimelib/string.h> |
|
#include <qstring.h> |
|
|
|
|
|
class KMMessagePart |
|
{ |
|
public: |
|
static QString encodeBase64(const QString& aStr); |
|
|
|
KMMessagePart(); |
|
virtual ~KMMessagePart(); |
|
|
|
/** Get or set the message body */ |
|
QString body(void) const; |
|
void setBody(const QString &aStr); |
|
|
|
/** Returns body as decoded string. Assumes that content-transfer-encoding |
|
contains the correct encoding. This routine is meant for binary data. |
|
No trailing 0 is appended. */ |
|
virtual QByteArray bodyDecodedBinary(void) const; |
|
|
|
/** Returns body as decoded string. Assumes that content-transfer-encoding |
|
contains the correct encoding. This routine is meant for binary data. |
|
No trailing 0 is appended. */ |
|
virtual QCString bodyDecoded(void) const; |
|
|
|
/** Sets body, encoded according to the content-transfer-encoding. |
|
BEWARE: The entire aStr is used including trailing 0 of text strings! */ |
|
virtual void setBodyEncodedBinary(const QByteArray& aStr); |
|
|
|
/** Sets body, encoded according to the content-transfer-encoding. |
|
This one is for text strings, the trailing 0 is not used. */ |
|
virtual void setBodyEncoded(const QCString& aStr); |
|
|
|
/** Returns decoded length of body. */ |
|
virtual int size(void) const; |
|
|
|
/** Get or set name parameter */ |
|
QString name(void) const; |
|
void setName(const QString& aStr); |
|
|
|
/** Get or set the 'Content-Type' header field |
|
The member functions that involve enumerated types (ints) |
|
will work only for well-known types or subtypes. */ |
|
QString typeStr(void) const; |
|
int type(void) const; |
|
void setTypeStr(const QString &aStr); |
|
void setType(int aType); |
|
// Subtype |
|
QString subtypeStr(void) const; |
|
int subtype(void) const; |
|
void setSubtypeStr(const QString &aStr); |
|
void setSubtype(int aSubtype); |
|
|
|
/** Set the 'Content-Type' by mime-magic from the contents of the body. |
|
If autoDecode is TRUE the decoded body will be used for mime type |
|
determination (this does not change the body itself). */ |
|
void magicSetType(bool autoDecode=TRUE); |
|
|
|
/** Tries to find a good icon for the 'Content-Type' by scanning |
|
the installed mimelnk files. Returns the found icon. If no matching |
|
icon is found, the one for application/octet-stream is returned. */ |
|
QString iconName(const QString &mimeType = QString::null) const; |
|
|
|
/** Get or set the 'Content-Transfer-Encoding' header field |
|
The member functions that involve enumerated types (ints) |
|
will work only for well-known encodings. */ |
|
QString contentTransferEncodingStr(void) const; |
|
int contentTransferEncoding(void) const; |
|
void setContentTransferEncodingStr(const QString &aStr); |
|
void setContentTransferEncoding(int aCte); |
|
|
|
/** Cte is short for ContentTransferEncoding. |
|
These functions are an alternative to the ones with longer names. */ |
|
QString cteStr(void) const { return contentTransferEncodingStr(); } |
|
int cte(void) const { return contentTransferEncoding(); } |
|
void setCteStr(const QString& aStr) { setContentTransferEncodingStr(aStr); } |
|
void setCte(int aCte) { setContentTransferEncoding(aCte); } |
|
|
|
|
|
// Get or set the 'Content-Description' header field |
|
QString contentDescription() const; |
|
void setContentDescription(const QString &aStr); |
|
|
|
// Get or set the 'Content-Disposition' header field |
|
QString contentDisposition() const; |
|
void setContentDisposition(const QString &aStr); |
|
|
|
/** Get the message part charset.*/ |
|
virtual QString charset(void) const; |
|
|
|
/** Set the message part charset. */ |
|
virtual void setCharset(const QString &aStr); |
|
|
|
/** Returns name of filename part of 'Content-Disposition' header field, |
|
if present. */ |
|
QString fileName(void) const; |
|
|
|
protected: |
|
QString mType; |
|
QString mSubtype; |
|
QString mCte; |
|
QString mContentDescription; |
|
QString mContentDisposition; |
|
QByteArray mBody; // keep it null terminated since some callers |
|
// misuse it as a QCString. Really the callers |
|
// should be fixed like in kmreaderwin.cpp. |
|
// mBody should not be QCString since it can be binary. |
|
QString mName; |
|
QString mCharset; |
|
int mBodySize; |
|
}; |
|
|
|
|
|
#endif /*kmmsgpart_h*/
|
|
|