.TH "KPasteTextAction" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdeui Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KPasteTextAction \- An action for pasting text from the clipboard.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kactionclasses.h>\fP
.PP
Inherits \fBKAction\fP.
.PP
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKPasteTextAction\fP (const \fBQString\fP &text, const \fBQString\fP &icon, const \fBKShortcut\fP &cut, const \fBQObject\fP *receiver, const char *slot, \fBQObject\fP *\fBparent\fP=0, const char *\fBname\fP=0)"
.br
.ti -1c
.RI "void \fBsetMixedMode\fP (bool mode)"
.br
.ti -1c
.RI "virtual int \fBplug\fP (\fBQWidget\fP *widget, int index=-1)"
.br
.in -1c
.SS "Protected Slots"

.in +1c
.ti -1c
.RI "void \fBmenuAboutToShow\fP ()"
.br
.ti -1c
.RI "void \fBmenuItemActivated\fP (int id)"
.br
.ti -1c
.RI "virtual void \fBslotActivated\fP ()"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "virtual void \fBvirtual_hook\fP (int id, void *data)"
.br
.in -1c
.SH "Detailed Description"
.PP 
An action for pasting text from the clipboard. 

It's useful for text handling applications as when plugged into a toolbar it provides a menu with the clipboard history if klipper is running. If clipper is not running, the menu has only one item: the current clipboard content.
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 1332 of file kactionclasses.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KPasteTextAction::KPasteTextAction (const \fBQString\fP & text, const \fBQString\fP & icon, const \fBKShortcut\fP & cut, const \fBQObject\fP * receiver, const char * slot, \fBQObject\fP * parent = \fC0\fP, const char * name = \fC0\fP)"
.PP
Create a KPasteTextAction, with a text, an icon, an accelerator, a slot connected to the action, parent and name. 
.PP
If you do not want or have a keyboard accelerator, set the \fCcut\fP param to 0.
.PP
\fBParameters:\fP
.RS 4
\fItext\fP The text that will be displayed. 
.br
\fIicon\fP The icon to display. 
.br
\fIcut\fP The corresponding keyboard accelerator (shortcut). 
.br
\fIreceiver\fP The SLOT's owner. 
.br
\fIslot\fP The SLOT to invoke to execute this action. 
.br
\fIparent\fP This action's parent. 
.br
\fIname\fP An internal name for this action. 
.RE
.PP

.PP
Definition at line 2146 of file kactionclasses.cpp.
.PP
References KAction::activated(), and QObject::connect().
.SH "Member Function Documentation"
.PP 
.SS "void KPasteTextAction::setMixedMode (bool mode)"
.PP
Controls the behavior of the clipboard history menu popup. 
.PP
\fBParameters:\fP
.RS 4
\fImode\fP If false and the clipboard contains a non-text object the popup menu with the clipboard history will appear immediately as the user clicks the toolbar action; if true, the action works like the standard paste action even if the current clipboard object is not text. Default value is true. 
.RE
.PP

.PP
Definition at line 2166 of file kactionclasses.cpp.
.SS "int KPasteTextAction::plug (\fBQWidget\fP * widget, int index = \fC-1\fP)\fC [virtual]\fP"
.PP
'Plug' or insert this action into a given widget. 
.PP
This will typically be a menu or a toolbar. From this point on, you will never need to directly manipulate the item in the menu or toolbar. You do all enabling/disabling/manipulation directly with your \fBKAction\fP object.
.PP
\fBParameters:\fP
.RS 4
\fIwidget\fP The GUI element to display this action 
.br
\fIindex\fP The position into which the action is plugged. If this is negative, the action is inserted at the end. 
.RE
.PP

.PP
Reimplemented from \fBKAction\fP.
.PP
Definition at line 2171 of file kactionclasses.cpp.
.PP
References QWhatsThis::add(), QObject::connect(), QObject::destroyed(), KToolBar::getButton(), KAction::getToolButtonID(), KToolBar::insertButton(), KGlobal::instance(), KActionCollection::instance(), KAction::isEnabled(), KAction::plug(), KToolBar::setDelayedPopup(), and KAction::whatsThis().

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