.TH "KAuthIcon" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdeui Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KAuthIcon \- A base class 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
.in -1c
.SS "Signals"

.in +1c
.ti -1c
.RI "void \fBauthChanged\fP (bool authorized)"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKAuthIcon\fP (\fBQWidget\fP *parent=0, const char *name=0)"
.br
.ti -1c
.RI "virtual \fBQSize\fP \fBsizeHint\fP () const "
.br
.ti -1c
.RI "virtual bool \fBstatus\fP () const =0"
.br
.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 
A base class for authorization icon widgets. 

This is the base class from which different authorization icon widget which actually do something should be derived. 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(bool)\fP to \fBsetEnabled(bool)\fP 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 47 of file kauthicon.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KAuthIcon::KAuthIcon (\fBQWidget\fP * parent = \fC0\fP, const char * name = \fC0\fP)"
.PP
Constructor. 
.PP
Definition at line 94 of file kauthicon.cpp.
.PP
References 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. 
.PP
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. 
.PP
a file on disk, uid/gid). 
.PP
Implemented in \fBKRootPermsIcon\fP, and \fBKWritePermsIcon\fP.
.PP
Referenced by KWritePermsIcon::setFileName().
.SS "void KAuthIcon::authChanged (bool authorized)\fC [signal]\fP"
.PP
this signal is emitted when authorization has changed from its previous state. 
.PP
\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

.PP
Referenced by KWritePermsIcon::updateStatus(), and KRootPermsIcon::updateStatus().

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