.TH "KAuthIcon" 3 "28 Jan 2004" "kdeui Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KAuthIcon \- This is the base class from which different authorization icon widget which actually do something should be derived. ABC for authorization icon widgets.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kauthicon.h>\fP
.PP
Inherits \fBQWidget\fP.
.PP
Inherited by \fBKRootPermsIcon\fP, and \fBKWritePermsIcon\fP.
.PP
.SS "Public Slots"

.in +1c
.ti -1c
.RI "virtual void \fBupdateStatus\fP ()=0"
.br
.RI "\fIRe-implement this method if you want the icon to update itself when something external has changed (i.e. \fP"
.in -1c
.SS "Signals"

.in +1c
.ti -1c
.RI "void \fBauthChanged\fP (bool authorized)"
.br
.RI "\fIthis signal is emitted when authorization has changed from its previous state. \fP"
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKAuthIcon\fP (\fBQWidget\fP *parent=0, const  char *name=0)"
.br
.RI "\fIConstructor. \fP"
.ti -1c
.RI "virtual \fBQSize\fP \fBsizeHint\fP () const "
.br
.ti -1c
.RI "virtual bool \fBstatus\fP () const =0"
.br
.RI "\fIreturn the status of whatever is being monitored. \fP"
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "virtual void \fBvirtual_hook\fP (int id, void *data)"
.br
.in -1c
.SS "Protected Attributes"

.in +1c
.ti -1c
.RI "\fBQHBoxLayout\fP * \fBlayout\fP"
.br
.ti -1c
.RI "\fBQLabel\fP * \fBlockBox\fP"
.br
.ti -1c
.RI "\fBQLabel\fP * \fBlockLabel\fP"
.br
.ti -1c
.RI "\fBQPixmap\fP \fBlockPM\fP"
.br
.ti -1c
.RI "\fBQPixmap\fP \fBopenLockPM\fP"
.br
.ti -1c
.RI "\fBQString\fP \fBlockText\fP"
.br
.ti -1c
.RI "\fBQString\fP \fBopenLockText\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
This is the base class from which different authorization icon widget which actually do something should be derived. ABC for authorization icon widgets. 

You can use these widgets to show that the user has (or doesn't have) the ability to do something, and why that is.
.PP
One of the most useful things you can do with this is connect \fBauthChanged\fP(bool) to \fBsetEnabled\fP(bool) for a widget to turn it on and off depending on the status of whatever it is you are monitoring.
.PP
\fBSee also:\fP
.RS 4
\fBKRootPermsIcon\fP, \fBKWritePermsIcon\fP 
.RE
.PP
\fBAuthor:\fP
.RS 4
Preston Brown <pbrown@kde.org> 
.RE
.PP

.PP
Definition at line 44 of file kauthicon.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KAuthIcon::KAuthIcon (\fBQWidget\fP * parent = 0, const char * name = 0)"
.PP
Constructor. Definition at line 94 of file kauthicon.cpp.
.PP
References KStdAccel::name(), QWidget::resize(), QLabel::setAlignment(), QLabel::setPixmap(), QLabel::setText(), and QWidget::sizeHint().
.SH "Member Function Documentation"
.PP 
.SS "virtual bool KAuthIcon::status () const\fC [pure virtual]\fP"
.PP
return the status of whatever is being monitored. Implemented in \fBKRootPermsIcon\fP, and \fBKWritePermsIcon\fP.
.SS "virtual void KAuthIcon::updateStatus ()\fC [pure virtual, slot]\fP"
.PP
Re-implement this method if you want the icon to update itself when something external has changed (i.e. a file on disk, uid/gid). Implemented in \fBKRootPermsIcon\fP, and \fBKWritePermsIcon\fP.
.SS "void KAuthIcon::authChanged (bool authorized)\fC [signal]\fP"
.PP
this signal is emitted when authorization has changed from its previous state. \fBParameters:\fP
.RS 4
\fIauthorized\fP will be true if the type of authorization described by the icon is true, otherwise it will be false. 
.RE
.PP
Referenced by KWritePermsIcon::updateStatus(), and KRootPermsIcon::updateStatus().

.SH "Author"
.PP 
Generated automatically by Doxygen for kdeui Library from the source code.
