MessageComposer::ComposerViewBase Class Reference

#include <composerviewbase.h>

Inheritance diagram for MessageComposer::ComposerViewBase:

Public Types
enum	Confirmation { LetUserConfirm , NoConfirmationNeeded }
enum	FailedType { Sending , AutoSave }
enum	MissingAttachment { NoMissingAttachmentFound , FoundMissingAttachmentAndSending , FoundMissingAttachmentAndAddedAttachment , FoundMissingAttachmentAndCancel }

Signals
void	disableHtml (MessageComposer::ComposerViewBase::Confirmation)
void	enableHtml ()
void	failed (const QString &errorMessage, MessageComposer::ComposerViewBase::FailedType type=Sending)
void	modified (bool isModified)
void	sentSuccessfully (Akonadi::Item::Id id)
void	tooManyRecipient (bool)

Public Slots
void	autoSaveMessage ()
void	identityChanged (const KIdentityManagementCore::Identity &ident, const KIdentityManagementCore::Identity &oldIdent, bool msgCleared=false)

Public Member Functions
	ComposerViewBase (QObject *parent=nullptr, QWidget *widget=nullptr)
void	addAttachment (const QString &name, const QString &filename, const QString &charset, const QByteArray &data, const QByteArray &mimeType)
void	addAttachment (const QUrl &url, const QString &comment, bool sync)
void	addAttachmentPart (KMime::Content *part)
MessageComposer::AttachmentControllerBase *	attachmentController ()
MessageComposer::AttachmentModel *	attachmentModel ()
bool	autocryptEnabled () const
QString	bcc () const
QString	cc () const
ComposerViewBase::MissingAttachment	checkForMissingAttachments (const QStringList &attachmentKeywords)
void	cleanupAutoSave ()
void	clearFollowUp ()
const KIdentityManagementCore::Identity &	currentIdentity () const
Sonnet::DictionaryComboBox *	dictionary () const
MessageComposer::RichTextComposerNg *	editor () const
std::shared_ptr< Kleo::ExpiryChecker >	expiryChecker ()
Akonadi::CollectionComboBox *	fccCombo () const
void	fillComposer (MessageComposer::Composer *composer)
Akonadi::Collection	followUpCollection () const
QDate	followUpDate () const
QString	from () const
bool	hasMissingAttachments (const QStringList &attachmentKeywords)
KIdentityManagementWidgets::IdentityCombo *	identityCombo ()
KIdentityManagementCore::IdentityManager *	identityManager ()
bool	isComposing () const
KMime::Message::Ptr	msg () const
MessageComposer::RecipientsEditor *	recipientsEditor ()
QString	replyTo () const
bool	requestDeleveryConfirmation () const
void	saveMailSettings ()
void	send (MessageComposer::MessageSender::SendMethod method, MessageComposer::MessageSender::SaveIn saveIn, bool checkMailDispatcher=true)
SendLaterInfo *	sendLaterInfo () const
void	setAttachmentController (MessageComposer::AttachmentControllerBase *controller)
void	setAttachmentModel (MessageComposer::AttachmentModel *model)
void	setAutoSaveFileName (const QString &fileName)
void	setAutoSaveInterval (int interval)
void	setCharsets (const QList< QByteArray > &charsets)
void	setCryptoOptions (bool sign, bool encrypt, Kleo::CryptoMessageFormat format, bool neverEncryptDrafts=false)
void	setCustomHeader (const QMap< QByteArray, QString > &customHeader)
void	setDictionary (Sonnet::DictionaryComboBox *dictionary)
void	setEditor (MessageComposer::RichTextComposerNg *editor)
void	setFcc (const Akonadi::Collection &id)
void	setFccCombo (Akonadi::CollectionComboBox *fcc)
void	setFollowUpCollection (const Akonadi::Collection &followUpCollection)
void	setFollowUpDate (const QDate &followUpDate)
void	setFrom (const QString &from)
void	setIdentityCombo (KIdentityManagementWidgets::IdentityCombo *identCombo)
void	setIdentityManager (KIdentityManagementCore::IdentityManager *identMan)
void	setMDNRequested (bool mdnRequested)
void	setMessage (const KMime::Message::Ptr &newMsg, bool allowDecryption)
void	setParentWidgetForGui (QWidget *)
void	setRecipientsEditor (MessageComposer::RecipientsEditor *recEditor)
void	setRequestDeleveryConfirmation (bool requestDeleveryConfirmation)
void	setSendLaterInfo (SendLaterInfo *info)
void	setSignatureController (MessageComposer::SignatureController *sigController)
void	setSubject (const QString &subject)
void	setTransportCombo (MailTransport::TransportComboBox *transpCombo)
void	setUrgent (bool urgent)
MessageComposer::SignatureController *	signatureController ()
QString	subject () const
QString	to () const
MailTransport::TransportComboBox *	transportComboBox () const
void	updateAutoSave ()
void	updateTemplate (const KMime::Message::Ptr &msg)
Public Member Functions inherited from QObject
	QObject (QObject *parent)
QBindable< QString >	bindableObjectName ()
bool	blockSignals (bool block)
const QObjectList &	children () const const
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const
void	deleteLater ()
void	destroyed (QObject *obj)
bool	disconnect (const char *signal, const QObject *receiver, const char *method) const const
bool	disconnect (const QObject *receiver, const char *method) const const
void	dumpObjectInfo () const const
void	dumpObjectTree () const const
QList< QByteArray >	dynamicPropertyNames () const const
virtual bool	event (QEvent *e)
virtual bool	eventFilter (QObject *watched, QEvent *event)
T	findChild (const QString &name, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QString &name, Qt::FindChildOptions options) const const
QList< T >	findChildren (Qt::FindChildOptions options) const const
bool	inherits (const char *className) const const
void	installEventFilter (QObject *filterObj)
bool	isQuickItemType () const const
bool	isWidgetType () const const
bool	isWindowType () const const
void	killTimer (int id)
virtual const QMetaObject *	metaObject () const const
void	moveToThread (QThread *targetThread)
QString	objectName () const const
void	objectNameChanged (const QString &objectName)
QObject *	parent () const const
QVariant	property (const char *name) const const
	Q_CLASSINFO (Name, Value)
	Q_EMIT Q_EMIT
	Q_ENUM (...)
	Q_ENUM_NS (...)
	Q_ENUMS (...)
	Q_FLAG (...)
	Q_FLAG_NS (...)
	Q_FLAGS (...)
	Q_GADGET Q_GADGET
	Q_GADGET_EXPORT (EXPORT_MACRO)
	Q_INTERFACES (...)
	Q_INVOKABLE Q_INVOKABLE
	Q_MOC_INCLUDE Q_MOC_INCLUDE
	Q_NAMESPACE Q_NAMESPACE
	Q_NAMESPACE_EXPORT (EXPORT_MACRO)
	Q_OBJECT Q_OBJECT
	Q_PROPERTY (...)
	Q_REVISION Q_REVISION
	Q_SET_OBJECT_NAME (Object)
	Q_SIGNAL Q_SIGNAL
	Q_SIGNALS Q_SIGNALS
	Q_SLOT Q_SLOT
	Q_SLOTS Q_SLOTS
T	qobject_cast (const QObject *object)
T	qobject_cast (QObject *object)
	QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
void	removeEventFilter (QObject *obj)
void	setObjectName (const QString &name)
void	setObjectName (QAnyStringView name)
void	setParent (QObject *parent)
bool	setProperty (const char *name, const QVariant &value)
bool	setProperty (const char *name, QVariant &&value)
bool	signalsBlocked () const const
int	startTimer (int interval, Qt::TimerType timerType)
int	startTimer (std::chrono::milliseconds interval, Qt::TimerType timerType)
QThread *	thread () const const

Additional Inherited Members
Properties inherited from QObject
	objectName
Static Public Member Functions inherited from QObject
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
bool	disconnect (const QMetaObject::Connection &connection)
bool	disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
bool	disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
bool	disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)
QString	tr (const char *sourceText, const char *disambiguation, int n)
Public Attributes inherited from QObject
typedef	QObjectList
Protected Member Functions inherited from QObject
virtual void	childEvent (QChildEvent *event)
virtual void	connectNotify (const QMetaMethod &signal)
virtual void	customEvent (QEvent *event)
virtual void	disconnectNotify (const QMetaMethod &signal)
bool	isSignalConnected (const QMetaMethod &signal) const const
int	receivers (const char *signal) const const
QObject *	sender () const const
int	senderSignalIndex () const const
virtual void	timerEvent (QTimerEvent *event)

Detailed Description

The ComposerViewBase class.

Definition at line 72 of file composerviewbase.h.

Member Enumeration Documentation

Confirmation

enum MessageComposer::ComposerViewBase::Confirmation

Definition at line 79 of file composerviewbase.h.

FailedType

enum MessageComposer::ComposerViewBase::FailedType

Definition at line 90 of file composerviewbase.h.

MissingAttachment

enum MessageComposer::ComposerViewBase::MissingAttachment

Definition at line 83 of file composerviewbase.h.

Constructor & Destructor Documentation

ComposerViewBase()

ComposerViewBase::ComposerViewBase ( QObject * parent = nullptr, QWidget * widget = nullptr )

explicit

Definition at line 84 of file composerviewbase.cpp.

Member Function Documentation

addAttachment() [1/2]

void ComposerViewBase::addAttachment	(	const QString &	name,
		const QString &	filename,
		const QString &	charset,
		const QByteArray &	data,
		const QByteArray &	mimeType )

Definition at line 1509 of file composerviewbase.cpp.

addAttachment() [2/2]

void ComposerViewBase::addAttachment	(	const QUrl &	url,
		const QString &	comment,
		bool	sync )

Add the given attachment to the message.

Definition at line 1498 of file composerviewbase.cpp.

addAttachmentPart()

void ComposerViewBase::addAttachmentPart

(

KMime::Content *

part

)

Definition at line 1524 of file composerviewbase.cpp.

attachmentController()

MessageComposer::AttachmentControllerBase * ComposerViewBase::attachmentController

(

)

Definition at line 1636 of file composerviewbase.cpp.

attachmentModel()

MessageComposer::AttachmentModel * ComposerViewBase::attachmentModel

(

)

Definition at line 1646 of file composerviewbase.cpp.

autocryptEnabled()

bool ComposerViewBase::autocryptEnabled

(

)

const

Definition at line 1621 of file composerviewbase.cpp.

autoSaveMessage

void ComposerViewBase::autoSaveMessage ( )

slot

Save the message.

Definition at line 1271 of file composerviewbase.cpp.

bcc()

QString ComposerViewBase::bcc

(

)

const

Definition at line 1590 of file composerviewbase.cpp.

cc()

QString ComposerViewBase::cc

(

)

const

Definition at line 1581 of file composerviewbase.cpp.

checkForMissingAttachments()

ComposerViewBase::MissingAttachment ComposerViewBase::checkForMissingAttachments

(

const QStringList &

attachmentKeywords

)

Check if the mail has references to attachments, but no attachments are added to it.

If missing attachments are found, a dialog to add new attachments is shown.

Parameters

attachmentKeywords

a list with the keywords that indicate an attachment should be present

Returns

NoMissingAttachmentFound, if there is attachment in email FoundMissingAttachmentAndCancelSending, if mail might miss attachment but sending FoundMissingAttachmentAndAddedAttachment, if mail might miss attachment and we added an attachment FoundMissingAttachmentAndCancel, if mail might miss attachment and cancel sending

Definition at line 1899 of file composerviewbase.cpp.

cleanupAutoSave()

void ComposerViewBase::cleanupAutoSave

(

)

Stop autosaving and delete the autosaved message.

Definition at line 1244 of file composerviewbase.cpp.

clearFollowUp()

void ComposerViewBase::clearFollowUp

(

)

Definition at line 306 of file composerviewbase.cpp.

currentIdentity()

const KIdentityManagementCore::Identity & ComposerViewBase::currentIdentity

(

)

const

Definition at line 1616 of file composerviewbase.cpp.

dictionary()

Sonnet::DictionaryComboBox * ComposerViewBase::dictionary

(

)

const

Definition at line 1216 of file composerviewbase.cpp.

disableHtml

void MessageComposer::ComposerViewBase::disableHtml ( MessageComposer::ComposerViewBase::Confirmation )

signal

Enabling or disabling HTML in the editor is affected by various client options, so when that would otherwise happen, hand it off to the client to enact it for real.

editor()

MessageComposer::RichTextComposerNg * ComposerViewBase::editor

(

)

const

Definition at line 1749 of file composerviewbase.cpp.

expiryChecker()

std::shared_ptr< Kleo::ExpiryChecker > ComposerViewBase::expiryChecker

(

)

Definition at line 2258 of file composerviewbase.cpp.

failed

void MessageComposer::ComposerViewBase::failed ( const QString & errorMessage, MessageComposer::ComposerViewBase::FailedType type = Sending )

signal

Message sending failed with given error message.

fccCombo()

Akonadi::CollectionComboBox * ComposerViewBase::fccCombo

(

)

const

Definition at line 1803 of file composerviewbase.cpp.

fillComposer()

void ComposerViewBase::fillComposer

(

MessageComposer::Composer *

composer

)

Definition at line 1556 of file composerviewbase.cpp.

followUpCollection()

Akonadi::Collection ComposerViewBase::followUpCollection

(

)

const

Definition at line 1196 of file composerviewbase.cpp.

followUpDate()

QDate ComposerViewBase::followUpDate

(

)

const

Definition at line 1206 of file composerviewbase.cpp.

from()

QString ComposerViewBase::from

(

)

const

Definition at line 1598 of file composerviewbase.cpp.

hasMissingAttachments()

bool ComposerViewBase::hasMissingAttachments

(

const QStringList &

attachmentKeywords

)

Definition at line 1887 of file composerviewbase.cpp.

identityChanged

void ComposerViewBase::identityChanged ( const KIdentityManagementCore::Identity & ident, const KIdentityManagementCore::Identity & oldIdent, bool msgCleared = false )

slot

Definition at line 1722 of file composerviewbase.cpp.

identityCombo()

KIdentityManagementWidgets::IdentityCombo * ComposerViewBase::identityCombo

(

)

Definition at line 1676 of file composerviewbase.cpp.

identityManager()

KIdentityManagementCore::IdentityManager * ComposerViewBase::identityManager

(

)

Definition at line 1769 of file composerviewbase.cpp.

isComposing()

bool ComposerViewBase::isComposing

(

)

const

Returns true if there is at least one composer job running.

Definition at line 98 of file composerviewbase.cpp.

modified

void MessageComposer::ComposerViewBase::modified ( bool isModified )

signal

The composer was modified.

This can happen behind the users' back when, for example, and autosaved message was recovered.

msg()

KMime::Message::Ptr ComposerViewBase::msg

(

)

const

Definition at line 2253 of file composerviewbase.cpp.

recipientsEditor()

MessageComposer::RecipientsEditor * ComposerViewBase::recipientsEditor

(

)

Definition at line 1656 of file composerviewbase.cpp.

replyTo()

QString ComposerViewBase::replyTo

(

)

const

Definition at line 1603 of file composerviewbase.cpp.

requestDeleveryConfirmation()

bool ComposerViewBase::requestDeleveryConfirmation

(

)

const

Definition at line 2243 of file composerviewbase.cpp.

saveMailSettings()

void ComposerViewBase::saveMailSettings

(

)

Definition at line 258 of file composerviewbase.cpp.

send()

void ComposerViewBase::send	(	MessageComposer::MessageSender::SendMethod	method,
		MessageComposer::MessageSender::SaveIn	saveIn,
		bool	checkMailDispatcher = true )

Send the message with the specified method, saving it in the specified folder.

Definition at line 312 of file composerviewbase.cpp.

sendLaterInfo()

SendLaterInfo * ComposerViewBase::sendLaterInfo

(

)

const

Definition at line 2215 of file composerviewbase.cpp.

sentSuccessfully

void MessageComposer::ComposerViewBase::sentSuccessfully ( Akonadi::Item::Id id )

signal

Message sending completed successfully.

setAttachmentController()

void ComposerViewBase::setAttachmentController

(

MessageComposer::AttachmentControllerBase *

controller

)

Definition at line 1631 of file composerviewbase.cpp.

setAttachmentModel()

void ComposerViewBase::setAttachmentModel

(

MessageComposer::AttachmentModel *

model

)

The following are for setting the various options and widgets in the composer.

Definition at line 1641 of file composerviewbase.cpp.

setAutoSaveFileName()

void ComposerViewBase::setAutoSaveFileName

(

const QString &

fileName

)

Sets the filename to use when autosaving something.

This is used when the client recovers the autosave files: It calls this method, so that the composer uses the same filename again. That way, the recovered autosave file is properly cleaned up in cleanupAutoSave():

Definition at line 1294 of file composerviewbase.cpp.

setAutoSaveInterval()

void ComposerViewBase::setAutoSaveInterval

(

int

interval

)

Definition at line 1822 of file composerviewbase.cpp.

setCharsets()

void ComposerViewBase::setCharsets

(

const QList< QByteArray > &

charsets

)

Definition at line 1835 of file composerviewbase.cpp.

setCryptoOptions()

void ComposerViewBase::setCryptoOptions	(	bool	sign,
		bool	encrypt,
		Kleo::CryptoMessageFormat	format,
		bool	neverEncryptDrafts = false )

The following are various settings the user can modify when composing a message.

If they are not set, the default values will be used.

Definition at line 1827 of file composerviewbase.cpp.

setCustomHeader()

void ComposerViewBase::setCustomHeader

(

const QMap< QByteArray, QString > &

customHeader

)

Definition at line 369 of file composerviewbase.cpp.

setDictionary()

void ComposerViewBase::setDictionary

(

Sonnet::DictionaryComboBox *

dictionary

)

Definition at line 1221 of file composerviewbase.cpp.

setEditor()

void ComposerViewBase::setEditor

(

MessageComposer::RichTextComposerNg *

editor

)

Definition at line 1743 of file composerviewbase.cpp.

setFcc()

void ComposerViewBase::setFcc

(

const Akonadi::Collection &

id

)

Definition at line 1774 of file composerviewbase.cpp.

setFccCombo()

void ComposerViewBase::setFccCombo

(

Akonadi::CollectionComboBox *

fcc

)

Definition at line 1798 of file composerviewbase.cpp.

setFollowUpCollection()

void ComposerViewBase::setFollowUpCollection

(

const Akonadi::Collection &

followUpCollection

)

Definition at line 1201 of file composerviewbase.cpp.

setFollowUpDate()

void ComposerViewBase::setFollowUpDate

(

const QDate &

followUpDate

)

Definition at line 1211 of file composerviewbase.cpp.

setFrom()

void ComposerViewBase::setFrom

(

const QString &

from

)

Widgets for editing differ in client classes, so values are set before sending.

Definition at line 1808 of file composerviewbase.cpp.

setIdentityCombo()

void ComposerViewBase::setIdentityCombo

(

KIdentityManagementWidgets::IdentityCombo *

identCombo

)

Definition at line 1671 of file composerviewbase.cpp.

setIdentityManager()

void ComposerViewBase::setIdentityManager

(

KIdentityManagementCore::IdentityManager *

identMan

)

Definition at line 1764 of file composerviewbase.cpp.

setMDNRequested()

void ComposerViewBase::setMDNRequested

(

bool

mdnRequested

)

Definition at line 1840 of file composerviewbase.cpp.

setMessage()

void ComposerViewBase::setMessage	(	const KMime::Message::Ptr &	newMsg,
		bool	allowDecryption )

Set the message to be opened in the composer window, and set the internal data structures to keep track of it.

Definition at line 103 of file composerviewbase.cpp.

setParentWidgetForGui()

void ComposerViewBase::setParentWidgetForGui

(

QWidget *

w

)

Definition at line 1626 of file composerviewbase.cpp.

setRecipientsEditor()

void ComposerViewBase::setRecipientsEditor

(

MessageComposer::RecipientsEditor *

recEditor

)

Definition at line 1651 of file composerviewbase.cpp.

setRequestDeleveryConfirmation()

void ComposerViewBase::setRequestDeleveryConfirmation

(

bool

requestDeleveryConfirmation

)

Definition at line 2248 of file composerviewbase.cpp.

setSendLaterInfo()

void ComposerViewBase::setSendLaterInfo

(

SendLaterInfo *

info

)

Definition at line 2210 of file composerviewbase.cpp.

setSignatureController()

void ComposerViewBase::setSignatureController

(

MessageComposer::SignatureController *

sigController

)

Definition at line 1661 of file composerviewbase.cpp.

setSubject()

void ComposerViewBase::setSubject

(

const QString &

subject

)

Definition at line 1813 of file composerviewbase.cpp.

setTransportCombo()

void ComposerViewBase::setTransportCombo

(

MailTransport::TransportComboBox *

transpCombo

)

Definition at line 1754 of file composerviewbase.cpp.

setUrgent()

void ComposerViewBase::setUrgent

(

bool

urgent

)

Definition at line 1845 of file composerviewbase.cpp.

signatureController()

MessageComposer::SignatureController * ComposerViewBase::signatureController

(

)

Definition at line 1666 of file composerviewbase.cpp.

subject()

QString ComposerViewBase::subject

(

)

const

Definition at line 1611 of file composerviewbase.cpp.

to()

QString ComposerViewBase::to

(

)

const

Header fields in recipients editor.

Definition at line 1572 of file composerviewbase.cpp.

transportComboBox()

MailTransport::TransportComboBox * ComposerViewBase::transportComboBox

(

)

const

Definition at line 1759 of file composerviewbase.cpp.

updateAutoSave()

void ComposerViewBase::updateAutoSave

(

)

Enables/disables autosaving depending on the value of the autosave interval.

Definition at line 1226 of file composerviewbase.cpp.

updateTemplate()

void ComposerViewBase::updateTemplate

(

const KMime::Message::Ptr &

msg

)

Definition at line 232 of file composerviewbase.cpp.

---

The documentation for this class was generated from the following files:

• composerviewbase.h
• composerviewbase.cpp