• Skip to content
  • Skip to link menu
KDE API Reference
  • KDE API Reference
  • kdenetwork API Reference
  • KDE Home
  • Contact Us
 

kopete/libkopete

  • Kopete
  • Password
Public Types | Public Slots | Public Member Functions | Static Public Member Functions | List of all members
Kopete::Password Class Reference

#include <kopetepassword.h>

Inheritance diagram for Kopete::Password:
Inheritance graph
[legend]

Public Types

enum  PasswordSource { FromConfigOrUser, FromUser }
 

Public Slots

void clear ()
 
void set (const QString &pass=QString())
 

Public Member Functions

 Password (const QString &configGroup, bool allowBlankPassword=false)
 
 Password (const Password &other)
 
 ~Password ()
 
bool allowBlankPassword ()
 
QString cachedValue ()
 
bool isWrong ()
 
Password & operator= (Password &other)
 
bool remembered ()
 
void request (QObject *receiver, const char *slot, const QPixmap &image, const QString &prompt, PasswordSource source=FromConfigOrUser)
 
void requestWithoutPrompt (QObject *receiver, const char *slot)
 
void setWrong (bool bWrong=true)
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
 QObject (QObject *parent, const char *name)
 
virtual  ~QObject ()
 
bool blockSignals (bool block)
 
QObject * child (const char *objName, const char *inheritsClass, bool recursiveSearch) const
 
const QObjectList & children () const
 
const char * className () const
 
bool connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
 
void deleteLater ()
 
void destroyed (QObject *obj)
 
bool disconnect (const QObject *receiver, const char *method)
 
bool disconnect (const char *signal, const QObject *receiver, const char *method)
 
void dumpObjectInfo ()
 
void dumpObjectTree ()
 
QList< QByteArray > dynamicPropertyNames () const
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
T findChild (const QString &name) const
 
QList< T > findChildren (const QRegExp &regExp) const
 
QList< T > findChildren (const QString &name) const
 
bool inherits (const char *className) const
 
void insertChild (QObject *object)
 
void installEventFilter (QObject *filterObj)
 
bool isA (const char *className) const
 
bool isWidgetType () const
 
void killTimer (int id)
 
virtual const QMetaObject * metaObject () const
 
void moveToThread (QThread *targetThread)
 
const char * name () const
 
const char * name (const char *defaultName) const
 
QString objectName () const
 
QObject * parent () const
 
QVariant property (const char *name) const
 
void removeChild (QObject *object)
 
void removeEventFilter (QObject *obj)
 
void setName (const char *name)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const char *name, const QVariant &value)
 
bool signalsBlocked () const
 
int startTimer (int interval)
 
QThread * thread () const
 

Static Public Member Functions

static int preferredImageSize ()
 
- Static Public Member Functions inherited from QObject
bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
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)
 
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 

Additional Inherited Members

- Protected Member Functions inherited from QObject
bool checkConnectArgs (const char *signal, const QObject *object, const char *method)
 
virtual void childEvent (QChildEvent *event)
 
virtual void connectNotify (const char *signal)
 
virtual void customEvent (QEvent *event)
 
virtual void disconnectNotify (const char *signal)
 
int receivers (const char *signal) const
 
QObject * sender () const
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *event)
 
- Static Protected Member Functions inherited from QObject
QByteArray normalizeSignalSlot (const char *signalSlot)
 
- Properties inherited from QObject
 objectName
 

Detailed Description

Author
Richard Smith kde@m.nosp@m.etaf.nosp@m.oo.co.nosp@m..uk

The Kopete::Password object is responsible for storing and retrieving a password for a plugin or account object.

If the KWallet is active, passwords will be stored in it, otherwise, they will be stored in the KConfig, in a slightly mangled form.

Definition at line 48 of file kopetepassword.h.

Member Enumeration Documentation

enum Kopete::Password::PasswordSource

Type of password request to perform: FromConfigOrUser : get the password from the config file, or from the user if no password in config.

FromUser : always ask the user for a password (ie, if last password was wrong or you know the password has changed).

Enumerator
FromConfigOrUser 
FromUser 

Definition at line 98 of file kopetepassword.h.

Constructor & Destructor Documentation

Kopete::Password::Password ( const QString &  configGroup,
bool  allowBlankPassword = false 
)
explicit

Create a new Kopete::Password object.

Parameters
configGroupThe configuration group to save passwords in.
allowBlankPasswordIf this password is allowed to be blank
nameThe name for this object

Definition at line 327 of file kopetepassword.cpp.

Kopete::Password::Password ( const Password &  other)

Create a shallow copy of this object.

Definition at line 333 of file kopetepassword.cpp.

Kopete::Password::~Password ( )

Definition at line 338 of file kopetepassword.cpp.

Member Function Documentation

bool Kopete::Password::allowBlankPassword ( )
Returns
true if you are allowed to have a blank password

Definition at line 395 of file kopetepassword.cpp.

QString Kopete::Password::cachedValue ( )

When a password request succeeds, the password is cached.

This function returns the cached password, if there is one, or QString() if there is not.

Definition at line 428 of file kopetepassword.cpp.

void Kopete::Password::clear ( )
slot

Unconditionally clears the stored password.

Definition at line 448 of file kopetepassword.cpp.

bool Kopete::Password::isWrong ( )

Returns whether the password currently stored by this object is known to be incorrect.

This flag gets reset whenever the user enters a new password, and is expected to be set by the user of this class if it is detected that the password the user entered is wrong.

Definition at line 400 of file kopetepassword.cpp.

Kopete::Password & Kopete::Password::operator= ( Password &  other)

Assignment operator for passwords: make this object represent a different password.

Definition at line 343 of file kopetepassword.cpp.

int Kopete::Password::preferredImageSize ( )
static

Returns the preferred size for images passed to the retrieve and request functions.

Definition at line 390 of file kopetepassword.cpp.

bool Kopete::Password::remembered ( )
Returns
true if the password is remembered, false otherwise.

If it returns false, calling request() will pop up an Enter Password window.

Definition at line 454 of file kopetepassword.cpp.

void Kopete::Password::request ( QObject *  receiver,
const char *  slot,
const QPixmap &  image,
const QString &  prompt,
PasswordSource  source = FromConfigOrUser 
)

Start an asynchronous call to get the password.

Causes a password entry dialog to appear if the password is not set. Triggers a provided slot when done, but not until after this function has returned (you don't need to worry about reentrancy or nested event loops).

Parameters
receiverThe object to notify when the password request finishes
slotThe slot on receiver to call at the end of the request. The signature of this function should be slot( const QString &password ). password will be the password if successful, or QString() if failed.
imageThe icon to display in the dialog when asking for the password
promptThe message to display to the user, asking for a password. Can be any Qt RichText string.
sourceThe source the password is taken from if a wrong or invalid password is entered or the password could not be found in the wallet

Definition at line 421 of file kopetepassword.cpp.

void Kopete::Password::requestWithoutPrompt ( QObject *  receiver,
const char *  slot 
)

Start an asynchronous password request without a prompt.

Starts an asynchronous password request. Does not pop up a password entry dialog if there is no password.

See also
request(QObject*,const char*,const QPixmap&,const QString&,bool,unsigned int) The password given to the provided slot will be NULL if no password could be retrieved for some reason, such as the user declining to open the wallet, or no password being found.

Definition at line 413 of file kopetepassword.cpp.

void Kopete::Password::set ( const QString &  pass = QString())
slot

Set the password for this account.

Parameters
passIf set to QString(), the password is forgotten unless you specified to allow blank passwords. Otherwise, sets the password to this value.

Note: this function is asynchronous; changes will not be instant.

Definition at line 433 of file kopetepassword.cpp.

void Kopete::Password::setWrong ( bool  bWrong = true)

Flag the password as being incorrect.

See also
isWrong

Definition at line 405 of file kopetepassword.cpp.


The documentation for this class was generated from the following files:
  • kopetepassword.h
  • kopetepassword.cpp
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Mon Jun 22 2020 13:29:20 by doxygen 1.8.7 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

kopete/libkopete

Skip menu "kopete/libkopete"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Related Pages

kdenetwork API Reference

Skip menu "kdenetwork API Reference"
  • kget
  • kopete
  •   kopete
  •   libkopete
  • krdc
  • krfb

Search



Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal