kdeui Library API Documentation

KPasteTextAction Class Reference

An action for pasting text from the clipboard. More...

#include <kactionclasses.h>

Inheritance diagram for KPasteTextAction:

KAction QObject List of all members.

Public Member Functions

 KPasteTextAction (const QString &text, const QString &icon, const KShortcut &cut, const QObject *receiver, const char *slot, QObject *parent=0, const char *name=0)
void setMixedMode (bool mode)
virtual int plug (QWidget *widget, int index=-1)

Protected Slots

void menuAboutToShow ()
void menuItemActivated (int id)
virtual void slotActivated ()

Protected Member Functions

virtual void virtual_hook (int id, void *data)

Detailed Description

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.

Since:
3.2

Definition at line 1328 of file kactionclasses.h.


Constructor & Destructor Documentation

KPasteTextAction::KPasteTextAction const QString text,
const QString icon,
const KShortcut cut,
const QObject receiver,
const char *  slot,
QObject parent = 0,
const char *  name = 0
 

Create a KPasteTextAction, with a text, an icon, an accelerator, a slot connected to the action, parent and name.

If you do not want or have a keyboard accelerator, set the cut param to 0.

Parameters:
text The text that will be displayed.
icon The icon to display.
cut The corresponding keyboard accelerator (shortcut).
receiver The SLOT's owner.
slot The SLOT to invoke to execute this action.
parent This action's parent.
name An internal name for this action.

Definition at line 2143 of file kactionclasses.cpp.


Member Function Documentation

void KPasteTextAction::setMixedMode bool  mode  ) 
 

Controls the behavior of the clipboard history menu popup.

Parameters:
mode 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.

Definition at line 2163 of file kactionclasses.cpp.

int KPasteTextAction::plug QWidget widget,
int  index = -1
[virtual]
 

"Plug" or insert this action into a given widget.

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 KAction object.

Parameters:
widget The GUI element to display this action
index The position into which the action is plugged. If this is negative, the action is inserted at the end.

Reimplemented from KAction.

Definition at line 2168 of file kactionclasses.cpp.

References KToolBar::getButton(), KAction::getToolButtonID(), KToolBar::insertButton(), KGlobal::instance(), KActionCollection::instance(), KAction::isEnabled(), KAction::plug(), KToolBar::setDelayedPopup(), and KAction::whatsThis().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdeui Library Version 3.3.0.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Sat Nov 27 13:43:38 2004 by doxygen 1.3.9.1 written by Dimitri van Heesch, © 1997-2003