<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">
<head>
<title>kdeui: kaction.cpp Source File (kdeui)</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' />
<meta name="trademark" content="KDE e.V." />
<meta name="description" content="K Desktop Environment Homepage, KDE.org" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="robots" content="all" />
<link rel="shortcut icon" href="../../favicon.ico" />
<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />
</head>
<body>
<div id="nav_header_top" align="right">
<a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>
<a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a>
<span class="doNotDisplay">::</span>
<div id="nav_header_title" align="left">KDE API Reference</div>
</div>
<div id="nav_header_bottom" align="right">
<span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
<div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../..">API Reference</a>
/ <a href=".">kdeui</a>
</div>
</div>
<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td valign="top" class="menuheader" height="0"></td>
<td id="contentcolumn" valign="top" rowspan="2" >
<div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
<a name="content"></a>
<!-- Generated by Doxygen 1.7.4 -->
<div class="header">
<div class="headertitle">
<div class="title">kaction.cpp</div> </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* This file is part of the KDE libraries</span>
<a name="l00002"></a>00002 <span class="comment"> Copyright (C) 1999 Reginald Stadlbauer <reggie@kde.org></span>
<a name="l00003"></a>00003 <span class="comment"> (C) 1999 Simon Hausmann <hausmann@kde.org></span>
<a name="l00004"></a>00004 <span class="comment"> (C) 2000 Nicolas Hadacek <haadcek@kde.org></span>
<a name="l00005"></a>00005 <span class="comment"> (C) 2000 Kurt Granroth <granroth@kde.org></span>
<a name="l00006"></a>00006 <span class="comment"> (C) 2000 Michael Koch <koch@kde.org></span>
<a name="l00007"></a>00007 <span class="comment"> (C) 2001 Holger Freyther <freyther@kde.org></span>
<a name="l00008"></a>00008 <span class="comment"> (C) 2002 Ellis Whitehead <ellis@kde.org></span>
<a name="l00009"></a>00009 <span class="comment"> (C) 2002 Joseph Wenninger <jowenn@kde.org></span>
<a name="l00010"></a>00010 <span class="comment"></span>
<a name="l00011"></a>00011 <span class="comment"> This library is free software; you can redistribute it and/or</span>
<a name="l00012"></a>00012 <span class="comment"> modify it under the terms of the GNU Library General Public</span>
<a name="l00013"></a>00013 <span class="comment"> License version 2 as published by the Free Software Foundation.</span>
<a name="l00014"></a>00014 <span class="comment"></span>
<a name="l00015"></a>00015 <span class="comment"> This library is distributed in the hope that it will be useful,</span>
<a name="l00016"></a>00016 <span class="comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00017"></a>00017 <span class="comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span>
<a name="l00018"></a>00018 <span class="comment"> Library General Public License for more details.</span>
<a name="l00019"></a>00019 <span class="comment"></span>
<a name="l00020"></a>00020 <span class="comment"> You should have received a copy of the GNU Library General Public License</span>
<a name="l00021"></a>00021 <span class="comment"> along with this library; see the file COPYING.LIB. If not, write to</span>
<a name="l00022"></a>00022 <span class="comment"> the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span>
<a name="l00023"></a>00023 <span class="comment"> Boston, MA 02110-1301, USA.</span>
<a name="l00024"></a>00024 <span class="comment">*/</span>
<a name="l00025"></a>00025
<a name="l00026"></a>00026 <span class="preprocessor">#include "kaction.h"</span>
<a name="l00027"></a>00027
<a name="l00028"></a>00028 <span class="preprocessor">#include <assert.h></span>
<a name="l00029"></a>00029
<a name="l00030"></a>00030 <span class="preprocessor">#include <qtooltip.h></span>
<a name="l00031"></a>00031 <span class="preprocessor">#include <qwhatsthis.h></span>
<a name="l00032"></a>00032
<a name="l00033"></a>00033 <span class="preprocessor">#include <kaccel.h></span>
<a name="l00034"></a>00034 <span class="preprocessor">#include <kaccelbase.h></span>
<a name="l00035"></a>00035 <span class="preprocessor">#include <kaccelprivate.h></span>
<a name="l00036"></a>00036 <span class="preprocessor">#include <kapplication.h></span>
<a name="l00037"></a>00037 <span class="preprocessor">#include <kdebug.h></span>
<a name="l00038"></a>00038 <span class="preprocessor">#include <kguiitem.h></span>
<a name="l00039"></a>00039 <span class="preprocessor">#include <kmainwindow.h></span>
<a name="l00040"></a>00040 <span class="preprocessor">#include <kmenubar.h></span>
<a name="l00041"></a>00041 <span class="preprocessor">#include <kpopupmenu.h></span>
<a name="l00042"></a>00042 <span class="preprocessor">#include <ktoolbar.h></span>
<a name="l00043"></a>00043 <span class="preprocessor">#include <ktoolbarbutton.h></span>
<a name="l00044"></a>00044
<a name="l00066"></a><a class="code" href="classKAction.html#a5e04bf3d65cf5640377d63c85eaa4c2e">00066</a> <span class="keywordtype">int</span> <a class="code" href="classKAction.html#a5e04bf3d65cf5640377d63c85eaa4c2e" title="How it works.">KAction::getToolButtonID</a>()
<a name="l00067"></a>00067 {
<a name="l00068"></a>00068 <span class="keyword">static</span> <span class="keywordtype">int</span> toolbutton_no = -2;
<a name="l00069"></a>00069 <span class="keywordflow">return</span> toolbutton_no--;
<a name="l00070"></a>00070 }
<a name="l00071"></a>00071
<a name="l00072"></a>00072 <span class="comment">//---------------------------------------------------------------------</span>
<a name="l00073"></a>00073 <span class="comment">// KAction::KActionPrivate</span>
<a name="l00074"></a>00074 <span class="comment">//---------------------------------------------------------------------</span>
<a name="l00075"></a>00075
<a name="l00076"></a>00076 <span class="keyword">class </span>KAction::KActionPrivate : <span class="keyword">public</span> <a class="code" href="classKGuiItem.html" title="An abstract class for GUI data such as ToolTip and Icon.">KGuiItem</a>
<a name="l00077"></a>00077 {
<a name="l00078"></a>00078 <span class="keyword">public</span>:
<a name="l00079"></a>00079 KActionPrivate() : <a class="code" href="classKGuiItem.html" title="An abstract class for GUI data such as ToolTip and Icon.">KGuiItem</a>()
<a name="l00080"></a>00080 {
<a name="l00081"></a>00081 m_kaccel = 0;
<a name="l00082"></a>00082 m_configurable = <span class="keyword">true</span>;
<a name="l00083"></a>00083 }
<a name="l00084"></a>00084
<a name="l00085"></a>00085 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html">KAccel</a> *m_kaccel;
<a name="l00086"></a>00086 <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*></a> m_kaccelList;
<a name="l00087"></a>00087
<a name="l00088"></a>00088 <a class="codeRef" href="qstring.html">QString</a> m_groupText;
<a name="l00089"></a>00089 <a class="codeRef" href="qstring.html">QString</a> m_group;
<a name="l00090"></a>00090
<a name="l00091"></a>00091 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a> m_cut;
<a name="l00092"></a>00092 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a> m_cutDefault;
<a name="l00093"></a>00093
<a name="l00094"></a>00094 <span class="keywordtype">bool</span> m_configurable;
<a name="l00095"></a>00095
<a name="l00096"></a>00096 <span class="keyword">struct </span>Container
<a name="l00097"></a>00097 {
<a name="l00098"></a>00098 Container() { m_container = 0; m_representative = 0; m_id = 0; }
<a name="l00099"></a>00099 Container( <span class="keyword">const</span> Container& s ) { m_container = s.m_container;
<a name="l00100"></a>00100 m_id = s.m_id; m_representative = s.m_representative; }
<a name="l00101"></a>00101 <a class="codeRef" href="qwidget.html">QWidget</a>* m_container;
<a name="l00102"></a>00102 <span class="keywordtype">int</span> m_id;
<a name="l00103"></a>00103 <a class="codeRef" href="qwidget.html">QWidget</a>* m_representative;
<a name="l00104"></a>00104 };
<a name="l00105"></a>00105
<a name="l00106"></a>00106 <a class="codeRef" href="qvaluelist.html">QValueList<Container></a> m_containers;
<a name="l00107"></a>00107 };
<a name="l00108"></a>00108
<a name="l00109"></a>00109 <span class="comment">//---------------------------------------------------------------------</span>
<a name="l00110"></a>00110 <span class="comment">// KAction</span>
<a name="l00111"></a>00111 <span class="comment">//---------------------------------------------------------------------</span>
<a name="l00112"></a>00112
<a name="l00113"></a><a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900">00113</a> <a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text, <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00114"></a>00114 <span class="keyword">const</span> <a class="codeRef" href="qobject.html">QObject</a>* receiver, <span class="keyword">const</span> <span class="keywordtype">char</span>* slot,
<a name="l00115"></a>00115 <a class="code" href="classKActionCollection.html" title="A managed set of KAction objects.">KActionCollection</a>* parent, <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00116"></a>00116 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00117"></a>00117 {
<a name="l00118"></a>00118 initPrivate( text, cut, receiver, slot );
<a name="l00119"></a>00119 }
<a name="l00120"></a>00120
<a name="l00121"></a><a class="code" href="classKAction.html#af32d01ea3f1b3fab18fd579d9beecedd">00121</a> <a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& sIconName, <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00122"></a>00122 <span class="keyword">const</span> <a class="codeRef" href="qobject.html">QObject</a>* receiver, <span class="keyword">const</span> <span class="keywordtype">char</span>* slot,
<a name="l00123"></a>00123 <a class="code" href="classKActionCollection.html" title="A managed set of KAction objects.">KActionCollection</a>* parent, <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00124"></a>00124 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00125"></a>00125 {
<a name="l00126"></a>00126 initPrivate( text, cut, receiver, slot );
<a name="l00127"></a>00127 d->setIconName( sIconName );
<a name="l00128"></a>00128 }
<a name="l00129"></a>00129
<a name="l00130"></a><a class="code" href="classKAction.html#a8011a537c2420448b428a400a987eda5">00130</a> <a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text, <span class="keyword">const</span> <a class="codeRef" href="qiconset.html">QIconSet</a>& pix, <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00131"></a>00131 <span class="keyword">const</span> <a class="codeRef" href="qobject.html">QObject</a>* receiver, <span class="keyword">const</span> <span class="keywordtype">char</span>* slot,
<a name="l00132"></a>00132 <a class="code" href="classKActionCollection.html" title="A managed set of KAction objects.">KActionCollection</a>* parent, <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00133"></a>00133 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00134"></a>00134 {
<a name="l00135"></a>00135 initPrivate( text, cut, receiver, slot );
<a name="l00136"></a>00136 d->setIconSet( pix );
<a name="l00137"></a>00137 }
<a name="l00138"></a>00138
<a name="l00139"></a><a class="code" href="classKAction.html#a792051492587281b157bbc44a79ffb68">00139</a> <a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <span class="keyword">const</span> <a class="code" href="classKGuiItem.html" title="An abstract class for GUI data such as ToolTip and Icon.">KGuiItem</a>& item, <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00140"></a>00140 <span class="keyword">const</span> <a class="codeRef" href="qobject.html">QObject</a>* receiver, <span class="keyword">const</span> <span class="keywordtype">char</span>* slot,
<a name="l00141"></a>00141 <a class="code" href="classKActionCollection.html" title="A managed set of KAction objects.">KActionCollection</a>* parent, <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00142"></a>00142 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00143"></a>00143 {
<a name="l00144"></a>00144 initPrivate( item.text(), cut, receiver, slot );
<a name="l00145"></a>00145 <span class="keywordflow">if</span>( item.<a class="code" href="classKGuiItem.html#a8929d731f3a9d72a7032ead2b9bc576f" title="returns whether an icon is defined, doesn't tell if it really exists">hasIcon</a>() )
<a name="l00146"></a>00146 setIcon( item.iconName() );
<a name="l00147"></a>00147 <a class="code" href="classKAction.html#a84c0291e128d194a8a6937382b6a439b" title="Sets the tooltip text for the action.">setToolTip</a>( item.toolTip() );
<a name="l00148"></a>00148 <a class="code" href="classKAction.html#aeb00a953ae18ffa86b96eed96339211b" title="Sets the What's this text for the action.">setWhatsThis</a>( item.whatsThis() );
<a name="l00149"></a>00149 }
<a name="l00150"></a>00150
<a name="l00151"></a>00151 <span class="preprocessor">#ifndef KDE_NO_COMPAT // KDE 4: remove</span>
<a name="l00152"></a><a class="code" href="classKAction.html#a2fb9c1ee6fef67071bd6d794bf1b3dd9">00152</a> <span class="preprocessor"></span><a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text, <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00153"></a>00153 <a class="codeRef" href="qobject.html">QObject</a>* parent, <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00154"></a>00154 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00155"></a>00155 {
<a name="l00156"></a>00156 initPrivate( text, cut, 0, 0 );
<a name="l00157"></a>00157 }
<a name="l00158"></a>00158
<a name="l00159"></a><a class="code" href="classKAction.html#a061f186c21c98d3761e7c2e93b66bd6c">00159</a> <a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text, <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00160"></a>00160 <span class="keyword">const</span> <a class="codeRef" href="qobject.html">QObject</a>* receiver,
<a name="l00161"></a>00161 <span class="keyword">const</span> <span class="keywordtype">char</span>* slot, <a class="codeRef" href="qobject.html">QObject</a>* parent, <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00162"></a>00162 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00163"></a>00163 {
<a name="l00164"></a>00164 initPrivate( text, cut, receiver, slot );
<a name="l00165"></a>00165 }
<a name="l00166"></a>00166
<a name="l00167"></a><a class="code" href="classKAction.html#a48840d14f39332c2310819f5e97e99fb">00167</a> <a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text, <span class="keyword">const</span> <a class="codeRef" href="qiconset.html">QIconSet</a>& pix,
<a name="l00168"></a>00168 <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00169"></a>00169 <a class="codeRef" href="qobject.html">QObject</a>* parent, <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00170"></a>00170 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00171"></a>00171 {
<a name="l00172"></a>00172 initPrivate( text, cut, 0, 0 );
<a name="l00173"></a>00173 <a class="code" href="classKAction.html#a551fe3b9d41c658b5e488bea94b01890" title="Sets the QIconSet from which the icons used to display this action will be chosen.">setIconSet</a>( pix );
<a name="l00174"></a>00174 }
<a name="l00175"></a>00175
<a name="l00176"></a><a class="code" href="classKAction.html#a052576b840e38af929cfb286cabbb616">00176</a> <a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& pix,
<a name="l00177"></a>00177 <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00178"></a>00178 <a class="codeRef" href="qobject.html">QObject</a>* parent, <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00179"></a>00179 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00180"></a>00180 {
<a name="l00181"></a>00181 initPrivate( text, cut, 0, 0 );
<a name="l00182"></a>00182 d->setIconName( pix );
<a name="l00183"></a>00183 }
<a name="l00184"></a>00184
<a name="l00185"></a><a class="code" href="classKAction.html#a22bda880b8a837a2c3cc147671111a16">00185</a> <a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text, <span class="keyword">const</span> <a class="codeRef" href="qiconset.html">QIconSet</a>& pix,
<a name="l00186"></a>00186 <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00187"></a>00187 <span class="keyword">const</span> <a class="codeRef" href="qobject.html">QObject</a>* receiver, <span class="keyword">const</span> <span class="keywordtype">char</span>* slot, <a class="codeRef" href="qobject.html">QObject</a>* parent,
<a name="l00188"></a>00188 <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00189"></a>00189 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00190"></a>00190 {
<a name="l00191"></a>00191 initPrivate( text, cut, receiver, slot );
<a name="l00192"></a>00192 <a class="code" href="classKAction.html#a551fe3b9d41c658b5e488bea94b01890" title="Sets the QIconSet from which the icons used to display this action will be chosen.">setIconSet</a>( pix );
<a name="l00193"></a>00193 }
<a name="l00194"></a>00194
<a name="l00195"></a><a class="code" href="classKAction.html#a61087cc0cbe5b1489de701bcf7da4e14">00195</a> <a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text, <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& pix,
<a name="l00196"></a>00196 <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00197"></a>00197 <span class="keyword">const</span> <a class="codeRef" href="qobject.html">QObject</a>* receiver, <span class="keyword">const</span> <span class="keywordtype">char</span>* slot, <a class="codeRef" href="qobject.html">QObject</a>* parent,
<a name="l00198"></a>00198 <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00199"></a>00199 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00200"></a>00200 {
<a name="l00201"></a>00201 initPrivate( text, cut, receiver, slot );
<a name="l00202"></a>00202 d->setIconName(pix);
<a name="l00203"></a>00203 }
<a name="l00204"></a>00204
<a name="l00205"></a><a class="code" href="classKAction.html#a7c9a2c16ab076365ef683a4dab14e640">00205</a> <a class="code" href="classKAction.html#a834fe83d25938eacb91f7def4e36a900" title="Constructs an action with text, potential keyboard shortcut, and a SLOT to call when this action is i...">KAction::KAction</a>( <a class="codeRef" href="qobject.html">QObject</a>* parent, <span class="keyword">const</span> <span class="keywordtype">char</span>* name )
<a name="l00206"></a>00206 : <a class="codeRef" href="qobject.html">QObject</a>( parent, name ), d(new KActionPrivate)
<a name="l00207"></a>00207 {
<a name="l00208"></a>00208 initPrivate( QString::null, <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>(), 0, 0 );
<a name="l00209"></a>00209 }
<a name="l00210"></a>00210 <span class="preprocessor">#endif // KDE 4: remove end</span>
<a name="l00211"></a>00211 <span class="preprocessor"></span>
<a name="l00212"></a><a class="code" href="classKAction.html#ae4f02a2c8c904c4c038a335b774ff2b4">00212</a> <a class="code" href="classKAction.html#ae4f02a2c8c904c4c038a335b774ff2b4" title="Standard destructor.">KAction::~KAction</a>()
<a name="l00213"></a>00213 {
<a name="l00214"></a>00214 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <span class="stringliteral">"KAction::~KAction( this = \""</span> << <a class="codeRef" href="qobject.html#name">name</a>() << <span class="stringliteral">"\" )"</span> << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>; <span class="comment">// -- ellis</span>
<a name="l00215"></a>00215 <span class="preprocessor">#ifndef KDE_NO_COMPAT</span>
<a name="l00216"></a>00216 <span class="preprocessor"></span> <span class="keywordflow">if</span> (d->m_kaccel)
<a name="l00217"></a>00217 <a class="code" href="classKAction.html#a010b828aa2b02e40159a750be32ae26f">unplugAccel</a>();
<a name="l00218"></a>00218 <span class="preprocessor">#endif</span>
<a name="l00219"></a>00219 <span class="preprocessor"></span>
<a name="l00220"></a>00220 <span class="comment">// If actionCollection hasn't already been destructed,</span>
<a name="l00221"></a>00221 <span class="keywordflow">if</span> ( m_parentCollection ) {
<a name="l00222"></a>00222 m_parentCollection-><a class="code" href="classKActionCollection.html#ac765904543ffe51e115038671ce464b2" title="Removes an action from the collection.">take</a>( <span class="keyword">this</span> );
<a name="l00223"></a>00223
<a name="l00224"></a>00224 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*></a> & accelList = d->m_kaccelList;
<a name="l00225"></a>00225 <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::const_iterator</a> itr = accelList.<a class="codeRef" href="qvaluelist.html#constBegin">constBegin</a>();
<a name="l00226"></a>00226 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::const_iterator</a> itrEnd = accelList.<a class="codeRef" href="qvaluelist.html#constEnd">constEnd</a>();
<a name="l00227"></a>00227
<a name="l00228"></a>00228 <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> namePtr = <a class="codeRef" href="qobject.html#name">name</a>();
<a name="l00229"></a>00229 <span class="keywordflow">for</span> (; itr != itrEnd; ++itr )
<a name="l00230"></a>00230 (*itr)->remove(namePtr);
<a name="l00231"></a>00231
<a name="l00232"></a>00232 }
<a name="l00233"></a>00233
<a name="l00234"></a>00234 <span class="comment">// Do not call unplugAll from here, as tempting as it sounds.</span>
<a name="l00235"></a>00235 <span class="comment">// KAction is designed around the idea that you need to plug</span>
<a name="l00236"></a>00236 <span class="comment">// _and_ to unplug it "manually". Unplugging leads to an important</span>
<a name="l00237"></a>00237 <span class="comment">// slowdown when e.g. closing the window, in which case we simply</span>
<a name="l00238"></a>00238 <span class="comment">// want to destroy everything asap, not to remove actions one by one</span>
<a name="l00239"></a>00239 <span class="comment">// from the GUI.</span>
<a name="l00240"></a>00240
<a name="l00241"></a>00241 <span class="keyword">delete</span> d;
<a name="l00242"></a>00242 }
<a name="l00243"></a>00243
<a name="l00244"></a>00244 <span class="keywordtype">void</span> KAction::initPrivate( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text, <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut,
<a name="l00245"></a>00245 <span class="keyword">const</span> <a class="codeRef" href="qobject.html">QObject</a>* receiver, <span class="keyword">const</span> <span class="keywordtype">char</span>* slot )
<a name="l00246"></a>00246 {
<a name="l00247"></a>00247 d->m_cutDefault = cut;
<a name="l00248"></a>00248
<a name="l00249"></a>00249 m_parentCollection = <span class="keyword">dynamic_cast<</span><a class="code" href="classKActionCollection.html" title="A managed set of KAction objects.">KActionCollection</a> *<span class="keyword">></span>( <a class="codeRef" href="qobject.html#parent">parent</a>() );
<a name="l00250"></a>00250 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <span class="stringliteral">"KAction::initPrivate(): this = "</span> << <span class="keyword">this</span> << <span class="stringliteral">" name = \""</span> << <a class="codeRef" href="qobject.html#name">name</a>() << <span class="stringliteral">"\" cut = "</span> << cut.<a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html#ae7c00b6fc73604481109d099e5a0c8eb">toStringInternal</a>() << <span class="stringliteral">" m_parentCollection = "</span> << m_parentCollection << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00251"></a>00251 <span class="keywordflow">if</span> ( m_parentCollection )
<a name="l00252"></a>00252 m_parentCollection-><a class="code" href="classKActionCollection.html#a0bdee62c242cf5dbc7b4472e43cac2e5" title="Add an action to the collection.">insert</a>( <span class="keyword">this</span> );
<a name="l00253"></a>00253
<a name="l00254"></a>00254 <span class="keywordflow">if</span> ( receiver && slot )
<a name="l00255"></a>00255 <a class="codeRef" href="qobject.html#connect">connect</a>( <span class="keyword">this</span>, SIGNAL( <a class="code" href="classKAction.html#ae5e6b06d6e0f8c8efacd51a541833ee0" title="Emitted when this action is activated.">activated</a>() ), receiver, slot );
<a name="l00256"></a>00256
<a name="l00257"></a>00257 <span class="keywordflow">if</span>( !cut.<a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html#ad491bec09bcf2e1f90be7be0b8f1bb5b">isNull</a>() && !qstrcmp( <a class="codeRef" href="qobject.html#name">name</a>(), <span class="stringliteral">"unnamed"</span> ) )
<a name="l00258"></a>00258 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga9acd682001598171edf8ecb104fdad2b">kdWarning</a>(129) << <span class="stringliteral">"KAction::initPrivate(): trying to assign a shortcut ("</span> << cut.<a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html#ae7c00b6fc73604481109d099e5a0c8eb">toStringInternal</a>() << <span class="stringliteral">") to an unnamed action."</span> << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00259"></a>00259 d->setText( text );
<a name="l00260"></a>00260 initShortcut( cut );
<a name="l00261"></a>00261 }
<a name="l00262"></a>00262
<a name="l00263"></a><a class="code" href="classKAction.html#ad52dd35bd2e68ea711d5bef21da49432">00263</a> <span class="keywordtype">bool</span> <a class="code" href="classKAction.html#ad52dd35bd2e68ea711d5bef21da49432" title="returns whether the action is plugged into any container widget or not.">KAction::isPlugged</a>()<span class="keyword"> const</span>
<a name="l00264"></a>00264 <span class="keyword"></span>{
<a name="l00265"></a>00265 <span class="keywordflow">return</span> (!d->m_containers.empty()) || d->m_kaccel;
<a name="l00266"></a>00266 }
<a name="l00267"></a>00267
<a name="l00268"></a><a class="code" href="classKAction.html#a1195a65af37f5879e8a288df64c1e664">00268</a> <span class="keywordtype">bool</span> <a class="code" href="classKAction.html#ad52dd35bd2e68ea711d5bef21da49432" title="returns whether the action is plugged into any container widget or not.">KAction::isPlugged</a>( <span class="keyword">const</span> <a class="codeRef" href="qwidget.html">QWidget</a> *container )<span class="keyword"> const</span>
<a name="l00269"></a>00269 <span class="keyword"></span>{
<a name="l00270"></a>00270 <span class="keywordflow">return</span> findContainer( container ) > -1;
<a name="l00271"></a>00271 }
<a name="l00272"></a>00272
<a name="l00273"></a><a class="code" href="classKAction.html#a44715ddce22b3d5974ef574aa1d5b7da">00273</a> <span class="keywordtype">bool</span> <a class="code" href="classKAction.html#ad52dd35bd2e68ea711d5bef21da49432" title="returns whether the action is plugged into any container widget or not.">KAction::isPlugged</a>( <span class="keyword">const</span> <a class="codeRef" href="qwidget.html">QWidget</a> *container, <span class="keywordtype">int</span> <span class="keywordtype">id</span> )<span class="keyword"> const</span>
<a name="l00274"></a>00274 <span class="keyword"></span>{
<a name="l00275"></a>00275 <span class="keywordtype">int</span> i = findContainer( container );
<a name="l00276"></a>00276 <span class="keywordflow">return</span> ( i > -1 && itemId( i ) == <span class="keywordtype">id</span> );
<a name="l00277"></a>00277 }
<a name="l00278"></a>00278
<a name="l00279"></a><a class="code" href="classKAction.html#a608d757cebe5be500718aea1c10d90ac">00279</a> <span class="keywordtype">bool</span> <a class="code" href="classKAction.html#ad52dd35bd2e68ea711d5bef21da49432" title="returns whether the action is plugged into any container widget or not.">KAction::isPlugged</a>( <span class="keyword">const</span> <a class="codeRef" href="qwidget.html">QWidget</a> *container, <span class="keyword">const</span> <a class="codeRef" href="qwidget.html">QWidget</a> *_representative )<span class="keyword"> const</span>
<a name="l00280"></a>00280 <span class="keyword"></span>{
<a name="l00281"></a>00281 <span class="keywordtype">int</span> i = findContainer( container );
<a name="l00282"></a>00282 <span class="keywordflow">return</span> ( i > -1 && representative( i ) == _representative );
<a name="l00283"></a>00283 }
<a name="l00284"></a>00284
<a name="l00285"></a>00285
<a name="l00286"></a>00286 <span class="comment">/*</span>
<a name="l00287"></a>00287 <span class="comment">Three actionCollection conditions:</span>
<a name="l00288"></a>00288 <span class="comment"> 1) Scope is known on creation and KAccel object is created (e.g. KMainWindow)</span>
<a name="l00289"></a>00289 <span class="comment"> 2) Scope is unknown and no KAccel object is available (e.g. KXMLGUIClient)</span>
<a name="l00290"></a>00290 <span class="comment"> a) addClient() will be called on object</span>
<a name="l00291"></a>00291 <span class="comment"> b) we just want to add the actions to another KXMLGUIClient object</span>
<a name="l00292"></a>00292 <span class="comment"></span>
<a name="l00293"></a>00293 <span class="comment">The question is how to do we incorporate #2b into the XMLGUI framework?</span>
<a name="l00294"></a>00294 <span class="comment"></span>
<a name="l00295"></a>00295 <span class="comment"></span>
<a name="l00296"></a>00296 <span class="comment">We have a KCommandHistory object with undo and redo actions in a passed actionCollection</span>
<a name="l00297"></a>00297 <span class="comment">We have a KoDoc object which holds a KCommandHistory object and the actionCollection</span>
<a name="l00298"></a>00298 <span class="comment">We have two KoView objects which both point to the same KoDoc object</span>
<a name="l00299"></a>00299 <span class="comment">Undo and Redo should be available in both KoView objects, and</span>
<a name="l00300"></a>00300 <span class="comment"> calling the undo->setEnabled() should affect both KoViews</span>
<a name="l00301"></a>00301 <span class="comment"></span>
<a name="l00302"></a>00302 <span class="comment">When addClient is called, it needs to be able to find the undo and redo actions</span>
<a name="l00303"></a>00303 <span class="comment">When it calls plug() on them, they need to be inserted into the KAccel object of the appropriate KoView</span>
<a name="l00304"></a>00304 <span class="comment"></span>
<a name="l00305"></a>00305 <span class="comment">In this case, the actionCollection belongs to KoDoc and we need to let it know that its shortcuts</span>
<a name="l00306"></a>00306 <span class="comment">have the same scope as the KoView actionCollection</span>
<a name="l00307"></a>00307 <span class="comment"></span>
<a name="l00308"></a>00308 <span class="comment">KXMLGUIClient::addSubActionCollection</span>
<a name="l00309"></a>00309 <span class="comment"></span>
<a name="l00310"></a>00310 <span class="comment">Document:</span>
<a name="l00311"></a>00311 <span class="comment"> create document actions</span>
<a name="l00312"></a>00312 <span class="comment"></span>
<a name="l00313"></a>00313 <span class="comment">View</span>
<a name="l00314"></a>00314 <span class="comment"> create view actions</span>
<a name="l00315"></a>00315 <span class="comment"> add document actionCollection as sub-collection</span>
<a name="l00316"></a>00316 <span class="comment"></span>
<a name="l00317"></a>00317 <span class="comment">A parentCollection is created</span>
<a name="l00318"></a>00318 <span class="comment">Scenario 1: parentCollection has a focus widget set (e.g. via KMainWindow)</span>
<a name="l00319"></a>00319 <span class="comment"> A KAccel object is created in the parentCollection</span>
<a name="l00320"></a>00320 <span class="comment"> A KAction is created with parent=parentCollection</span>
<a name="l00321"></a>00321 <span class="comment"> The shortcut is inserted into this actionCollection</span>
<a name="l00322"></a>00322 <span class="comment"> Scenario 1a: xml isn't used</span>
<a name="l00323"></a>00323 <span class="comment"> done</span>
<a name="l00324"></a>00324 <span class="comment"> Scenario 1b: KXMLGUIBuilder::addClient() called</span>
<a name="l00325"></a>00325 <span class="comment"> setWidget is called -- ignore</span>
<a name="l00326"></a>00326 <span class="comment"> shortcuts are set</span>
<a name="l00327"></a>00327 <span class="comment">Scenario 2: parentCollection has no focus widget (e.g., KParts)</span>
<a name="l00328"></a>00328 <span class="comment"> A KAction is created with parent=parentCollection</span>
<a name="l00329"></a>00329 <span class="comment"> Scenario 2a: xml isn't used</span>
<a name="l00330"></a>00330 <span class="comment"> no shortcuts</span>
<a name="l00331"></a>00331 <span class="comment"> Scenario 2b: KXMLGUIBuilder::addClient() called</span>
<a name="l00332"></a>00332 <span class="comment"> setWidget is called</span>
<a name="l00333"></a>00333 <span class="comment"> shortcuts are inserted into current KAccel</span>
<a name="l00334"></a>00334 <span class="comment"> shortcuts are set in all other KAccels, if the action is present in the other KAccels</span>
<a name="l00335"></a>00335 <span class="comment">*/</span>
<a name="l00336"></a>00336
<a name="l00337"></a>00337 <span class="comment">/*</span>
<a name="l00338"></a>00338 <span class="comment">shortcut may be set:</span>
<a name="l00339"></a>00339 <span class="comment"> - on construction</span>
<a name="l00340"></a>00340 <span class="comment"> - on plug</span>
<a name="l00341"></a>00341 <span class="comment"> - on reading XML</span>
<a name="l00342"></a>00342 <span class="comment"> - on plugAccel (deprecated)</span>
<a name="l00343"></a>00343 <span class="comment"></span>
<a name="l00344"></a>00344 <span class="comment">On Construction: [via initShortcut()]</span>
<a name="l00345"></a>00345 <span class="comment"> insert into KAccel of m_parentCollection,</span>
<a name="l00346"></a>00346 <span class="comment"> if kaccel() && isAutoConnectShortcuts() exists</span>
<a name="l00347"></a>00347 <span class="comment"></span>
<a name="l00348"></a>00348 <span class="comment">On Plug: [via plug() -> plugShortcut()]</span>
<a name="l00349"></a>00349 <span class="comment"> insert into KAccel of m_parentCollection, if exists and not already inserted into</span>
<a name="l00350"></a>00350 <span class="comment"></span>
<a name="l00351"></a>00351 <span class="comment">On Read XML: [via setShortcut()]</span>
<a name="l00352"></a>00352 <span class="comment"> set in all current KAccels</span>
<a name="l00353"></a>00353 <span class="comment"> insert into KAccel of m_parentCollection, if exists and not already inserted into</span>
<a name="l00354"></a>00354 <span class="comment">*/</span>
<a name="l00355"></a>00355
<a name="l00356"></a>00356 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html">KAccel</a>* KAction::kaccelCurrent()
<a name="l00357"></a>00357 {
<a name="l00358"></a>00358 <span class="keywordflow">if</span>( m_parentCollection && m_parentCollection-><a class="code" href="classKActionCollection.html#a7394a81d4140ac6558c0718a175d28ed">builderKAccel</a>() )
<a name="l00359"></a>00359 <span class="keywordflow">return</span> m_parentCollection-><a class="code" href="classKActionCollection.html#a7394a81d4140ac6558c0718a175d28ed">builderKAccel</a>();
<a name="l00360"></a>00360 <span class="keywordflow">else</span> <span class="keywordflow">if</span>( m_parentCollection && m_parentCollection-><a class="code" href="classKActionCollection.html#a2a2470a20d065fb4c0b36a44c55297b9" title="Returns the KAccel object of the most recently set widget.">kaccel</a>() )
<a name="l00361"></a>00361 <span class="keywordflow">return</span> m_parentCollection-><a class="code" href="classKActionCollection.html#a2a2470a20d065fb4c0b36a44c55297b9" title="Returns the KAccel object of the most recently set widget.">kaccel</a>();
<a name="l00362"></a>00362 <span class="keywordflow">else</span>
<a name="l00363"></a>00363 <span class="keywordflow">return</span> 0L;
<a name="l00364"></a>00364 }
<a name="l00365"></a>00365
<a name="l00366"></a>00366 <span class="comment">// Only to be called from initPrivate()</span>
<a name="l00367"></a>00367 <span class="keywordtype">bool</span> KAction::initShortcut( <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut )
<a name="l00368"></a>00368 {
<a name="l00369"></a>00369 d->m_cut = cut;
<a name="l00370"></a>00370
<a name="l00371"></a>00371 <span class="comment">// Only insert action into KAccel if it has a valid name,</span>
<a name="l00372"></a>00372 <span class="keywordflow">if</span>( qstrcmp( <a class="codeRef" href="qobject.html#name">name</a>(), <span class="stringliteral">"unnamed"</span> ) &&
<a name="l00373"></a>00373 m_parentCollection &&
<a name="l00374"></a>00374 m_parentCollection-><a class="code" href="classKActionCollection.html#ae98c8cddba74ae32701ef6ba00e5269d" title="This indicates whether new actions which are created in this collection have their keyboard shortcuts...">isAutoConnectShortcuts</a>() &&
<a name="l00375"></a>00375 m_parentCollection-><a class="code" href="classKActionCollection.html#a2a2470a20d065fb4c0b36a44c55297b9" title="Returns the KAccel object of the most recently set widget.">kaccel</a>() )
<a name="l00376"></a>00376 {
<a name="l00377"></a>00377 insertKAccel( m_parentCollection-><a class="code" href="classKActionCollection.html#a2a2470a20d065fb4c0b36a44c55297b9" title="Returns the KAccel object of the most recently set widget.">kaccel</a>() );
<a name="l00378"></a>00378 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00379"></a>00379 }
<a name="l00380"></a>00380 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00381"></a>00381 }
<a name="l00382"></a>00382
<a name="l00383"></a>00383 <span class="comment">// Only to be called from plug()</span>
<a name="l00384"></a>00384 <span class="keywordtype">void</span> KAction::plugShortcut()
<a name="l00385"></a>00385 {
<a name="l00386"></a>00386 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html">KAccel</a>* <span class="keyword">const</span> kaccel = kaccelCurrent();
<a name="l00387"></a>00387
<a name="l00388"></a>00388 <span class="comment">//kdDebug(129) << "KAction::plugShortcut(): this = " << this << " kaccel() = " << (m_parentCollection ? m_parentCollection->kaccel() : 0) << endl;</span>
<a name="l00389"></a>00389 <span class="keywordflow">if</span>( kaccel && qstrcmp( <a class="codeRef" href="qobject.html#name">name</a>(), <span class="stringliteral">"unnamed"</span> ) ) {
<a name="l00390"></a>00390 <span class="comment">// Check if already plugged into current KAccel object</span>
<a name="l00391"></a>00391 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*></a> & accelList = d->m_kaccelList;
<a name="l00392"></a>00392 <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::const_iterator</a> itr = accelList.<a class="codeRef" href="qvaluelist.html#constBegin">constBegin</a>();
<a name="l00393"></a>00393 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::const_iterator</a> itrEnd = accelList.<a class="codeRef" href="qvaluelist.html#constEnd">constEnd</a>();
<a name="l00394"></a>00394
<a name="l00395"></a>00395 <span class="keywordflow">for</span>( ; itr != itrEnd; ++itr) {
<a name="l00396"></a>00396 <span class="keywordflow">if</span>( (*itr) == kaccel )
<a name="l00397"></a>00397 <span class="keywordflow">return</span>;
<a name="l00398"></a>00398 }
<a name="l00399"></a>00399
<a name="l00400"></a>00400 insertKAccel( kaccel );
<a name="l00401"></a>00401 }
<a name="l00402"></a>00402 }
<a name="l00403"></a>00403
<a name="l00404"></a><a class="code" href="classKAction.html#abf0c9e98f1686c4117e79184bdc646a2">00404</a> <span class="keywordtype">bool</span> <a class="code" href="classKAction.html#abf0c9e98f1686c4117e79184bdc646a2" title="Sets the keyboard shortcut associated with this action.">KAction::setShortcut</a>( <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& cut )
<a name="l00405"></a>00405 {
<a name="l00406"></a>00406 <span class="keywordtype">bool</span> bChanged = (d->m_cut != cut);
<a name="l00407"></a>00407 d->m_cut = cut;
<a name="l00408"></a>00408
<a name="l00409"></a>00409 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html">KAccel</a>* <span class="keyword">const</span> kaccel = kaccelCurrent();
<a name="l00410"></a>00410 <span class="keywordtype">bool</span> bInsertRequired = <span class="keyword">true</span>;
<a name="l00411"></a>00411 <span class="comment">// Apply new shortcut to all existing KAccel objects</span>
<a name="l00412"></a>00412
<a name="l00413"></a>00413 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*></a> & accelList = d->m_kaccelList;
<a name="l00414"></a>00414 <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::const_iterator</a> itr = accelList.<a class="codeRef" href="qvaluelist.html#constBegin">constBegin</a>();
<a name="l00415"></a>00415 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::const_iterator</a> itrEnd = accelList.<a class="codeRef" href="qvaluelist.html#constEnd">constEnd</a>();
<a name="l00416"></a>00416
<a name="l00417"></a>00417 <span class="keywordflow">for</span>( ; itr != itrEnd; ++itr) {
<a name="l00418"></a>00418 <span class="comment">// Check whether shortcut has already been plugged into</span>
<a name="l00419"></a>00419 <span class="comment">// the current kaccel object.</span>
<a name="l00420"></a>00420 <span class="keywordflow">if</span>( (*itr) == kaccel )
<a name="l00421"></a>00421 bInsertRequired = <span class="keyword">false</span>;
<a name="l00422"></a>00422 <span class="keywordflow">if</span>( bChanged )
<a name="l00423"></a>00423 updateKAccelShortcut( *itr );
<a name="l00424"></a>00424 }
<a name="l00425"></a>00425
<a name="l00426"></a>00426 <span class="comment">// Only insert action into KAccel if it has a valid name,</span>
<a name="l00427"></a>00427 <span class="keywordflow">if</span>( kaccel && bInsertRequired && qstrcmp( <a class="codeRef" href="qobject.html#name">name</a>(), <span class="stringliteral">"unnamed"</span> ) )
<a name="l00428"></a>00428 insertKAccel( kaccel );
<a name="l00429"></a>00429
<a name="l00430"></a>00430 <span class="keywordflow">if</span>( bChanged ) {
<a name="l00431"></a>00431 <span class="preprocessor">#ifndef KDE_NO_COMPAT // KDE 4: remove</span>
<a name="l00432"></a>00432 <span class="preprocessor"></span> <span class="keywordflow">if</span> ( d->m_kaccel )
<a name="l00433"></a>00433 d->m_kaccel->setShortcut( <a class="codeRef" href="qobject.html#name">name</a>(), cut );
<a name="l00434"></a>00434 <span class="preprocessor">#endif // KDE 4: remove end</span>
<a name="l00435"></a>00435 <span class="preprocessor"></span> <span class="keywordtype">int</span> len = containerCount();
<a name="l00436"></a>00436 <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i = 0; i < len; ++i )
<a name="l00437"></a>00437 updateShortcut( i );
<a name="l00438"></a>00438 }
<a name="l00439"></a>00439 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00440"></a>00440 }
<a name="l00441"></a>00441
<a name="l00442"></a>00442 <span class="keywordtype">bool</span> KAction::updateKAccelShortcut( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html">KAccel</a>* kaccel )
<a name="l00443"></a>00443 {
<a name="l00444"></a>00444 <span class="comment">// Check if action is permitted</span>
<a name="l00445"></a>00445 <span class="keywordflow">if</span> (kapp && !kapp->authorizeKAction(<a class="codeRef" href="qobject.html#name">name</a>()))
<a name="l00446"></a>00446 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00447"></a>00447
<a name="l00448"></a>00448 <span class="keywordtype">bool</span> b = <span class="keyword">true</span>;
<a name="l00449"></a>00449
<a name="l00450"></a>00450 <span class="keywordflow">if</span> ( !kaccel-><a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html#af9758f1ac607f58e799bb4bb4cdd3bbb">actions</a>().actionPtr( <a class="codeRef" href="qobject.html#name">name</a>() ) ) {
<a name="l00451"></a>00451 <span class="keywordflow">if</span>(!d->m_cut.isNull() ) {
<a name="l00452"></a>00452 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <span class="stringliteral">"Inserting "</span> << <a class="codeRef" href="qobject.html#name">name</a>() << <span class="stringliteral">", "</span> << d->text() << <span class="stringliteral">", "</span> << d->plainText() << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00453"></a>00453 b = kaccel-><a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html#a7cc1168941f5a2570afd5ab7e650edef">insert</a>( <a class="codeRef" href="qobject.html#name">name</a>(), d->plainText(), QString::null,
<a name="l00454"></a>00454 d->m_cut,
<a name="l00455"></a>00455 <span class="keyword">this</span>, SLOT(slotActivated()),
<a name="l00456"></a>00456 <a class="code" href="classKAction.html#adbb500142f1d8f941d64c3ed678aab5e" title="Returns true if this action's shortcut is configurable.">isShortcutConfigurable</a>(), <a class="code" href="classKAction.html#af03a9a21291e740cde5465b660b22042" title="Returns true if this action is enabled.">isEnabled</a>() );
<a name="l00457"></a>00457 }
<a name="l00458"></a>00458 }
<a name="l00459"></a>00459 <span class="keywordflow">else</span>
<a name="l00460"></a>00460 b = kaccel-><a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html#aabc06b8140e3eb2a2298763d1fe95963">setShortcut</a>( <a class="codeRef" href="qobject.html#name">name</a>(), d->m_cut );
<a name="l00461"></a>00461
<a name="l00462"></a>00462 <span class="keywordflow">return</span> b;
<a name="l00463"></a>00463 }
<a name="l00464"></a>00464
<a name="l00465"></a>00465 <span class="keywordtype">void</span> KAction::insertKAccel( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html">KAccel</a>* kaccel )
<a name="l00466"></a>00466 {
<a name="l00467"></a>00467 <span class="comment">//kdDebug(129) << "KAction::insertKAccel( " << kaccel << " ): this = " << this << endl;</span>
<a name="l00468"></a>00468 <span class="keywordflow">if</span> ( !kaccel-><a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html#af9758f1ac607f58e799bb4bb4cdd3bbb">actions</a>().actionPtr( <a class="codeRef" href="qobject.html#name">name</a>() ) ) {
<a name="l00469"></a>00469 <span class="keywordflow">if</span>( updateKAccelShortcut( kaccel ) ) {
<a name="l00470"></a>00470 d->m_kaccelList.append( kaccel );
<a name="l00471"></a>00471 <a class="codeRef" href="qobject.html#connect">connect</a>( kaccel, SIGNAL(<a class="codeRef" href="qobject.html#destroyed">destroyed</a>()), <span class="keyword">this</span>, SLOT(slotDestroyed()) );
<a name="l00472"></a>00472 }
<a name="l00473"></a>00473 }
<a name="l00474"></a>00474 <span class="keywordflow">else</span>
<a name="l00475"></a>00475 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga9acd682001598171edf8ecb104fdad2b">kdWarning</a>(129) << <span class="stringliteral">"KAction::insertKAccel( kaccel = "</span> << kaccel << <span class="stringliteral">" ): KAccel object already contains an action name \""</span> << <a class="codeRef" href="qobject.html#name">name</a>() << <span class="stringliteral">"\""</span> << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>; <span class="comment">// -- ellis</span>
<a name="l00476"></a>00476 }
<a name="l00477"></a>00477
<a name="l00478"></a>00478 <span class="keywordtype">void</span> KAction::removeKAccel( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html">KAccel</a>* kaccel )
<a name="l00479"></a>00479 {
<a name="l00480"></a>00480 <span class="comment">//kdDebug(129) << "KAction::removeKAccel( " << i << " ): this = " << this << endl;</span>
<a name="l00481"></a>00481 <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*></a> & accelList = d->m_kaccelList;
<a name="l00482"></a>00482 <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::iterator</a> itr = accelList.<a class="codeRef" href="qvaluelist.html#begin">begin</a>();
<a name="l00483"></a>00483 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::iterator</a> itrEnd = accelList.<a class="codeRef" href="qvaluelist.html#end">end</a>();
<a name="l00484"></a>00484
<a name="l00485"></a>00485 <span class="keywordflow">for</span>( ; itr != itrEnd; ++itr) {
<a name="l00486"></a>00486 <span class="keywordflow">if</span>( (*itr) == kaccel ) {
<a name="l00487"></a>00487 kaccel-><a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html#ad6789539f17043a4a4d8e52ffbbea66b">remove</a>( <a class="codeRef" href="qobject.html#name">name</a>() );
<a name="l00488"></a>00488 accelList.<a class="codeRef" href="qvaluelist.html#remove">remove</a>( itr );
<a name="l00489"></a>00489 <a class="codeRef" href="qobject.html#disconnect">disconnect</a>( kaccel, SIGNAL(<a class="codeRef" href="qobject.html#destroyed">destroyed</a>()), <span class="keyword">this</span>, SLOT(slotDestroyed()) );
<a name="l00490"></a>00490 <span class="keywordflow">break</span>;
<a name="l00491"></a>00491 }
<a name="l00492"></a>00492 }
<a name="l00493"></a>00493 }
<a name="l00494"></a>00494
<a name="l00495"></a>00495 <span class="preprocessor">#ifndef KDE_NO_COMPAT</span>
<a name="l00496"></a>00496 <span class="preprocessor"></span><span class="comment">// KDE 4: remove</span>
<a name="l00497"></a><a class="code" href="classKAction.html#a585768f4dae039bd022fb839e389b534">00497</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#a585768f4dae039bd022fb839e389b534">KAction::setAccel</a>( <span class="keywordtype">int</span> keyQt )
<a name="l00498"></a>00498 {
<a name="l00499"></a>00499 <a class="code" href="classKAction.html#abf0c9e98f1686c4117e79184bdc646a2" title="Sets the keyboard shortcut associated with this action.">setShortcut</a>( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>(keyQt) );
<a name="l00500"></a>00500 }
<a name="l00501"></a>00501 <span class="preprocessor">#endif // KDE 4: remove end</span>
<a name="l00502"></a>00502 <span class="preprocessor"></span>
<a name="l00503"></a>00503 <span class="keywordtype">void</span> KAction::updateShortcut( <span class="keywordtype">int</span> i )
<a name="l00504"></a>00504 {
<a name="l00505"></a>00505 <span class="keywordtype">int</span> <span class="keywordtype">id</span> = itemId( i );
<a name="l00506"></a>00506
<a name="l00507"></a>00507 <a class="codeRef" href="qwidget.html">QWidget</a>* w = container( i );
<a name="l00508"></a>00508 <span class="keywordflow">if</span> ( ::qt_cast<QPopupMenu *>( w ) ) {
<a name="l00509"></a>00509 <a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>* menu = <span class="keyword">static_cast<</span><a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>*<span class="keyword">></span>(w);
<a name="l00510"></a>00510 updateShortcut( menu, <span class="keywordtype">id</span> );
<a name="l00511"></a>00511 }
<a name="l00512"></a>00512 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<QMenuBar *>( w ) )
<a name="l00513"></a>00513 <span class="keyword">static_cast<</span><a class="codeRef" href="qmenubar.html">QMenuBar</a>*<span class="keyword">></span>(w)-><a class="code" href="classKAction.html#a585768f4dae039bd022fb839e389b534">setAccel</a>( d->m_cut.keyCodeQt(), id );
<a name="l00514"></a>00514 }
<a name="l00515"></a>00515
<a name="l00516"></a>00516 <span class="keywordtype">void</span> KAction::updateShortcut( <a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>* menu, <span class="keywordtype">int</span> <span class="keywordtype">id</span> )
<a name="l00517"></a>00517 {
<a name="l00518"></a>00518 <span class="comment">//kdDebug(129) << "KAction::updateShortcut(): this = " << this << " d->m_kaccelList.count() = " << d->m_kaccelList.count() << endl;</span>
<a name="l00519"></a>00519 <span class="comment">// If the action has a KAccel object,</span>
<a name="l00520"></a>00520 <span class="comment">// show the string representation of its shortcut.</span>
<a name="l00521"></a>00521 <span class="keywordflow">if</span> ( d->m_kaccel || d->m_kaccelList.count() ) {
<a name="l00522"></a>00522 <a class="codeRef" href="qstring.html">QString</a> s = menu-><a class="codeRef" href="qpopupmenu.html#text">text</a>( <span class="keywordtype">id</span> );
<a name="l00523"></a>00523 <span class="keywordtype">int</span> i = s.<a class="codeRef" href="qstring.html#find">find</a>( <span class="charliteral">'\t'</span> );
<a name="l00524"></a>00524 <span class="keywordflow">if</span> ( i >= 0 )
<a name="l00525"></a>00525 s.<a class="codeRef" href="qstring.html#replace">replace</a>( i+1, s.<a class="codeRef" href="qstring.html#length">length</a>()-i, d->m_cut.seq(0).toString() );
<a name="l00526"></a>00526 <span class="keywordflow">else</span>
<a name="l00527"></a>00527 s += <span class="stringliteral">"\t"</span> + d->m_cut.seq(0).toString();
<a name="l00528"></a>00528
<a name="l00529"></a>00529 menu-><a class="codeRef" href="qpopupmenu.html#changeItem">changeItem</a>( <span class="keywordtype">id</span>, s );
<a name="l00530"></a>00530 }
<a name="l00531"></a>00531 <span class="comment">// Otherwise insert the shortcut itself into the popup menu.</span>
<a name="l00532"></a>00532 <span class="keywordflow">else</span> {
<a name="l00533"></a>00533 <span class="comment">// This is a fall-hack in case the KAction is missing a proper parent collection.</span>
<a name="l00534"></a>00534 <span class="comment">// It should be removed eventually. --ellis</span>
<a name="l00535"></a>00535 menu-><a class="codeRef" href="qpopupmenu.html#setAccel">setAccel</a>( d->m_cut.keyCodeQt(), id );
<a name="l00536"></a>00536 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <span class="stringliteral">"KAction::updateShortcut(): name = \""</span> << <a class="codeRef" href="qobject.html#name">name</a>() << <span class="stringliteral">"\", cut = "</span> << d->m_cut.toStringInternal() << <span class="stringliteral">"; No KAccel, probably missing a parent collection."</span> << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00537"></a>00537 }
<a name="l00538"></a>00538 }
<a name="l00539"></a>00539
<a name="l00540"></a>00540 <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& <a class="code" href="classKAction.html#ad5b4fd8ad71a8dc8d24604b9a1ea2bcd" title="Get the keyboard shortcut associated with this action.">KAction::shortcut</a>()<span class="keyword"> const</span>
<a name="l00541"></a>00541 <span class="keyword"></span>{
<a name="l00542"></a>00542 <span class="keywordflow">return</span> d->m_cut;
<a name="l00543"></a>00543 }
<a name="l00544"></a>00544
<a name="l00545"></a><a class="code" href="classKAction.html#a31b96d989770a448ec16426115bcf72a">00545</a> <span class="keyword">const</span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>& <a class="code" href="classKAction.html#a31b96d989770a448ec16426115bcf72a" title="Get the default shortcut for this action.">KAction::shortcutDefault</a>()<span class="keyword"> const</span>
<a name="l00546"></a>00546 <span class="keyword"></span>{
<a name="l00547"></a>00547 <span class="keywordflow">return</span> d->m_cutDefault;
<a name="l00548"></a>00548 }
<a name="l00549"></a>00549
<a name="l00550"></a>00550 <a class="codeRef" href="qstring.html">QString</a> KAction::shortcutText()<span class="keyword"> const</span>
<a name="l00551"></a>00551 <span class="keyword"></span>{
<a name="l00552"></a>00552 <span class="keywordflow">return</span> d->m_cut.toStringInternal();
<a name="l00553"></a>00553 }
<a name="l00554"></a>00554
<a name="l00555"></a>00555 <span class="keywordtype">void</span> KAction::setShortcutText( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& s )
<a name="l00556"></a>00556 {
<a name="l00557"></a>00557 <a class="code" href="classKAction.html#abf0c9e98f1686c4117e79184bdc646a2" title="Sets the keyboard shortcut associated with this action.">setShortcut</a>( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>(s) );
<a name="l00558"></a>00558 }
<a name="l00559"></a>00559
<a name="l00560"></a>00560 <span class="preprocessor">#ifndef KDE_NO_COMPAT // Remove in KDE 4</span>
<a name="l00561"></a><a class="code" href="classKAction.html#ad1b6d26314075bd19556de0f154cee85">00561</a> <span class="preprocessor"></span><span class="keywordtype">int</span> <a class="code" href="classKAction.html#ad1b6d26314075bd19556de0f154cee85">KAction::accel</a>()<span class="keyword"> const</span>
<a name="l00562"></a>00562 <span class="keyword"></span>{
<a name="l00563"></a>00563 <span class="keywordflow">return</span> d->m_cut.keyCodeQt();
<a name="l00564"></a>00564 }
<a name="l00565"></a>00565 <span class="preprocessor">#endif</span>
<a name="l00566"></a>00566 <span class="preprocessor"></span>
<a name="l00567"></a>00567 <span class="keywordtype">void</span> KAction::setGroup( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& grp )
<a name="l00568"></a>00568 {
<a name="l00569"></a>00569 d->m_group = grp;
<a name="l00570"></a>00570
<a name="l00571"></a>00571 <span class="keywordtype">int</span> len = containerCount();
<a name="l00572"></a>00572 <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i = 0; i < len; ++i )
<a name="l00573"></a>00573 updateGroup( i );
<a name="l00574"></a>00574 }
<a name="l00575"></a>00575
<a name="l00576"></a>00576 <span class="keywordtype">void</span> KAction::updateGroup( <span class="keywordtype">int</span> )
<a name="l00577"></a>00577 {
<a name="l00578"></a>00578 <span class="comment">// DO SOMETHING</span>
<a name="l00579"></a>00579 }
<a name="l00580"></a>00580
<a name="l00581"></a>00581 <a class="codeRef" href="qstring.html">QString</a> KAction::group()<span class="keyword"> const</span>
<a name="l00582"></a>00582 <span class="keyword"></span>{
<a name="l00583"></a>00583 <span class="keywordflow">return</span> d->m_group;
<a name="l00584"></a>00584 }
<a name="l00585"></a>00585
<a name="l00586"></a><a class="code" href="classKAction.html#af03a9a21291e740cde5465b660b22042">00586</a> <span class="keywordtype">bool</span> <a class="code" href="classKAction.html#af03a9a21291e740cde5465b660b22042" title="Returns true if this action is enabled.">KAction::isEnabled</a>()<span class="keyword"> const</span>
<a name="l00587"></a>00587 <span class="keyword"></span>{
<a name="l00588"></a>00588 <span class="keywordflow">return</span> d->isEnabled();
<a name="l00589"></a>00589 }
<a name="l00590"></a>00590
<a name="l00591"></a><a class="code" href="classKAction.html#adbb500142f1d8f941d64c3ed678aab5e">00591</a> <span class="keywordtype">bool</span> <a class="code" href="classKAction.html#adbb500142f1d8f941d64c3ed678aab5e" title="Returns true if this action's shortcut is configurable.">KAction::isShortcutConfigurable</a>()<span class="keyword"> const</span>
<a name="l00592"></a>00592 <span class="keyword"></span>{
<a name="l00593"></a>00593 <span class="keywordflow">return</span> d->m_configurable;
<a name="l00594"></a>00594 }
<a name="l00595"></a>00595
<a name="l00596"></a><a class="code" href="classKAction.html#a84c0291e128d194a8a6937382b6a439b">00596</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#a84c0291e128d194a8a6937382b6a439b" title="Sets the tooltip text for the action.">KAction::setToolTip</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& tt )
<a name="l00597"></a>00597 {
<a name="l00598"></a>00598 d->setToolTip( tt );
<a name="l00599"></a>00599
<a name="l00600"></a>00600 <span class="keywordtype">int</span> len = containerCount();
<a name="l00601"></a>00601 <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i = 0; i < len; ++i )
<a name="l00602"></a>00602 updateToolTip( i );
<a name="l00603"></a>00603 }
<a name="l00604"></a>00604
<a name="l00605"></a>00605 <span class="keywordtype">void</span> KAction::updateToolTip( <span class="keywordtype">int</span> i )
<a name="l00606"></a>00606 {
<a name="l00607"></a>00607 <a class="codeRef" href="qwidget.html">QWidget</a> *w = container( i );
<a name="l00608"></a>00608
<a name="l00609"></a>00609 <span class="keywordflow">if</span> ( ::qt_cast<KToolBar *>( w ) )
<a name="l00610"></a>00610 <a class="codeRef" href="qtooltip.html#add">QToolTip::add</a>( static_cast<KToolBar*>(w)->getWidget( itemId( i ) ), d->toolTip() );
<a name="l00611"></a>00611 }
<a name="l00612"></a>00612
<a name="l00613"></a>00613 <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKAction.html#a0c5167d54042773929dfb134ed1b3df9" title="Get the tooltip text for the action.">KAction::toolTip</a>()<span class="keyword"> const</span>
<a name="l00614"></a>00614 <span class="keyword"></span>{
<a name="l00615"></a>00615 <span class="keywordflow">return</span> d->toolTip();
<a name="l00616"></a>00616 }
<a name="l00617"></a>00617
<a name="l00618"></a><a class="code" href="classKAction.html#a6aee71f8be93189171b2578759980751">00618</a> <span class="keywordtype">int</span> <a class="code" href="classKAction.html#a6aee71f8be93189171b2578759980751" title=""Plug" or insert this action into a given widget.">KAction::plug</a>( <a class="codeRef" href="qwidget.html">QWidget</a> *w, <span class="keywordtype">int</span> index )
<a name="l00619"></a>00619 {
<a name="l00620"></a>00620 <span class="comment">//kdDebug(129) << "KAction::plug( " << w << ", " << index << " )" << endl;</span>
<a name="l00621"></a>00621 <span class="keywordflow">if</span> (!w ) {
<a name="l00622"></a>00622 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga9acd682001598171edf8ecb104fdad2b">kdWarning</a>(129) << <span class="stringliteral">"KAction::plug called with 0 argument\n"</span>;
<a name="l00623"></a>00623 <span class="keywordflow">return</span> -1;
<a name="l00624"></a>00624 }
<a name="l00625"></a>00625
<a name="l00626"></a>00626 <span class="comment">// Ellis: print warning if there is a shortcut, but no KAccel available (often due to no widget available in the actioncollection)</span>
<a name="l00627"></a>00627 <span class="comment">// David: Well, it doesn't matter much, things still work (e.g. Undo in koffice) via QAccel.</span>
<a name="l00628"></a>00628 <span class="comment">// We should probably re-enable the warning for things that only KAccel can do, though - e.g. WIN key (mapped to Meta).</span>
<a name="l00629"></a>00629 <span class="preprocessor">#if 0 //ndef NDEBUG</span>
<a name="l00630"></a>00630 <span class="preprocessor"></span> <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html">KAccel</a>* kaccel = kaccelCurrent();
<a name="l00631"></a>00631 <span class="keywordflow">if</span>( !d->m_cut.isNull() && !kaccel ) {
<a name="l00632"></a>00632 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <span class="stringliteral">"KAction::plug(): has no KAccel object; this = "</span> << <span class="keyword">this</span> << <span class="stringliteral">" name = "</span> << <a class="codeRef" href="qobject.html#name">name</a>() << <span class="stringliteral">" parentCollection = "</span> << m_parentCollection << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>; <span class="comment">// ellis</span>
<a name="l00633"></a>00633 }
<a name="l00634"></a>00634 <span class="preprocessor">#endif</span>
<a name="l00635"></a>00635 <span class="preprocessor"></span>
<a name="l00636"></a>00636 <span class="comment">// Check if action is permitted</span>
<a name="l00637"></a>00637 <span class="keywordflow">if</span> (kapp && !kapp->authorizeKAction(<a class="codeRef" href="qobject.html#name">name</a>()))
<a name="l00638"></a>00638 <span class="keywordflow">return</span> -1;
<a name="l00639"></a>00639
<a name="l00640"></a>00640 plugShortcut();
<a name="l00641"></a>00641
<a name="l00642"></a>00642 <span class="keywordflow">if</span> ( ::qt_cast<QPopupMenu *>( w ) )
<a name="l00643"></a>00643 {
<a name="l00644"></a>00644 <a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>* menu = <span class="keyword">static_cast<</span><a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>*<span class="keyword">></span>( w );
<a name="l00645"></a>00645 <span class="keywordtype">int</span> id;
<a name="l00646"></a>00646 <span class="comment">// Don't insert shortcut into menu if it's already in a KAccel object.</span>
<a name="l00647"></a>00647 <span class="keywordtype">int</span> keyQt = (d->m_kaccelList.count() || d->m_kaccel) ? 0 : d->m_cut.keyCodeQt();
<a name="l00648"></a>00648
<a name="l00649"></a>00649 <span class="keywordflow">if</span> ( d->hasIcon() )
<a name="l00650"></a>00650 {
<a name="l00651"></a>00651 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKInstance.html">KInstance</a> *instance;
<a name="l00652"></a>00652 <span class="keywordflow">if</span> ( m_parentCollection )
<a name="l00653"></a>00653 instance = m_parentCollection-><a class="code" href="classKActionCollection.html#a8674c82faaf5c726b60e74279b3c76f7" title="The instance with which this class is associated.">instance</a>();
<a name="l00654"></a>00654 <span class="keywordflow">else</span>
<a name="l00655"></a>00655 instance = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a7005487680376266c61372ea7ff3c080">KGlobal::instance</a>();
<a name="l00656"></a>00656 <span class="keywordtype">id</span> = menu-><a class="codeRef" href="qpopupmenu.html#insertItem">insertItem</a>( d->iconSet( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKIcon.html#a20145b9c0aecf124fadc35cd30c18f82a2dddf01e0cfa645258c58da4244adb55">KIcon::Small</a>, 0, instance ), d->text(), <span class="keyword">this</span>,<span class="comment">//dsweet</span>
<a name="l00657"></a>00657 SLOT( <a class="code" href="classKAction.html#a5962236de12399cb5702b68762957df7">slotPopupActivated</a>() ), keyQt,
<a name="l00658"></a>00658 -1, index );
<a name="l00659"></a>00659 }
<a name="l00660"></a>00660 <span class="keywordflow">else</span>
<a name="l00661"></a>00661 <span class="keywordtype">id</span> = menu-><a class="codeRef" href="qpopupmenu.html#insertItem">insertItem</a>( d->text(), <span class="keyword">this</span>,
<a name="l00662"></a>00662 SLOT( <a class="code" href="classKAction.html#a5962236de12399cb5702b68762957df7">slotPopupActivated</a>() ),
<a name="l00663"></a>00663 keyQt, -1, index );
<a name="l00664"></a>00664
<a name="l00665"></a>00665 <span class="comment">// If the shortcut is already in a KAccel object, then</span>
<a name="l00666"></a>00666 <span class="comment">// we need to set the menu item's shortcut text.</span>
<a name="l00667"></a>00667 <span class="keywordflow">if</span> ( d->m_kaccelList.count() || d->m_kaccel )
<a name="l00668"></a>00668 updateShortcut( menu, <span class="keywordtype">id</span> );
<a name="l00669"></a>00669
<a name="l00670"></a>00670 <span class="comment">// call setItemEnabled only if the item really should be disabled,</span>
<a name="l00671"></a>00671 <span class="comment">// because that method is slow and the item is per default enabled</span>
<a name="l00672"></a>00672 <span class="keywordflow">if</span> ( !d->isEnabled() )
<a name="l00673"></a>00673 menu-><a class="codeRef" href="qpopupmenu.html#setItemEnabled">setItemEnabled</a>( <span class="keywordtype">id</span>, <span class="keyword">false</span> );
<a name="l00674"></a>00674
<a name="l00675"></a>00675 <span class="keywordflow">if</span> ( !d->whatsThis().isEmpty() )
<a name="l00676"></a>00676 menu-><a class="codeRef" href="qpopupmenu.html#setWhatsThis">setWhatsThis</a>( <span class="keywordtype">id</span>, whatsThisWithIcon() );
<a name="l00677"></a>00677
<a name="l00678"></a>00678 addContainer( menu, <span class="keywordtype">id</span> );
<a name="l00679"></a>00679 <a class="codeRef" href="qobject.html#connect">connect</a>( menu, SIGNAL( <a class="codeRef" href="qobject.html#destroyed">destroyed</a>() ), <span class="keyword">this</span>, SLOT( slotDestroyed() ) );
<a name="l00680"></a>00680
<a name="l00681"></a>00681 <span class="keywordflow">if</span> ( m_parentCollection )
<a name="l00682"></a>00682 m_parentCollection-><a class="code" href="classKActionCollection.html#af93b8b710983a362ba22a165af730eaf" title="Call this function if you want to receive a signal whenever a KAction is highlighted in a menu or a t...">connectHighlight</a>( menu, <span class="keyword">this</span> );
<a name="l00683"></a>00683
<a name="l00684"></a>00684 <span class="keywordflow">return</span> d->m_containers.count() - 1;
<a name="l00685"></a>00685 }
<a name="l00686"></a>00686 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<KToolBar *>( w ) )
<a name="l00687"></a>00687 {
<a name="l00688"></a>00688 <a class="code" href="classKToolBar.html" title="Floatable toolbar with auto resize.">KToolBar</a> *bar = <span class="keyword">static_cast<</span><a class="code" href="classKToolBar.html" title="Floatable toolbar with auto resize.">KToolBar</a> *<span class="keyword">></span>( w );
<a name="l00689"></a>00689
<a name="l00690"></a>00690 <span class="keywordtype">int</span> id_ = <a class="code" href="classKAction.html#a5e04bf3d65cf5640377d63c85eaa4c2e" title="How it works.">getToolButtonID</a>();
<a name="l00691"></a>00691 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKInstance.html">KInstance</a> *instance;
<a name="l00692"></a>00692 <span class="keywordflow">if</span> ( m_parentCollection )
<a name="l00693"></a>00693 instance = m_parentCollection-><a class="code" href="classKActionCollection.html#a8674c82faaf5c726b60e74279b3c76f7" title="The instance with which this class is associated.">instance</a>();
<a name="l00694"></a>00694 <span class="keywordflow">else</span>
<a name="l00695"></a>00695 instance = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKGlobal.html#a7005487680376266c61372ea7ff3c080">KGlobal::instance</a>();
<a name="l00696"></a>00696
<a name="l00697"></a>00697 <span class="keywordflow">if</span> ( icon().isEmpty() && !<a class="code" href="classKAction.html#add12cbbcf8e3aa05876cce3d965b4b15" title="Remove in KDE4.">iconSet</a>().pixmap().isNull() ) <span class="comment">// old code using QIconSet directly</span>
<a name="l00698"></a>00698 {
<a name="l00699"></a>00699 bar-><a class="code" href="classKToolBar.html#a72e18642288ea976523a43b7ef057969" title="Insert a button (a KToolBarButton) with a pixmap.">insertButton</a>( <a class="code" href="classKAction.html#add12cbbcf8e3aa05876cce3d965b4b15" title="Remove in KDE4.">iconSet</a>().pixmap(), id_, SIGNAL( buttonClicked(<span class="keywordtype">int</span>, Qt::ButtonState) ), <span class="keyword">this</span>,
<a name="l00700"></a>00700 SLOT( <a class="code" href="classKAction.html#a18e94dc703cf9b11f6951064978abd20">slotButtonClicked</a>(<span class="keywordtype">int</span>, Qt::ButtonState) ),
<a name="l00701"></a>00701 d->isEnabled(), d->plainText(), index );
<a name="l00702"></a>00702 }
<a name="l00703"></a>00703 <span class="keywordflow">else</span>
<a name="l00704"></a>00704 {
<a name="l00705"></a>00705 <a class="codeRef" href="qstring.html">QString</a> icon = d->iconName();
<a name="l00706"></a>00706 <span class="keywordflow">if</span> ( icon.<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() )
<a name="l00707"></a>00707 icon = <span class="stringliteral">"unknown"</span>;
<a name="l00708"></a>00708 bar-><a class="code" href="classKToolBar.html#a72e18642288ea976523a43b7ef057969" title="Insert a button (a KToolBarButton) with a pixmap.">insertButton</a>( icon, id_, SIGNAL( buttonClicked(<span class="keywordtype">int</span>, Qt::ButtonState) ), <span class="keyword">this</span>,
<a name="l00709"></a>00709 SLOT( <a class="code" href="classKAction.html#a18e94dc703cf9b11f6951064978abd20">slotButtonClicked</a>(<span class="keywordtype">int</span>, Qt::ButtonState) ),
<a name="l00710"></a>00710 d->isEnabled(), d->plainText(), index, instance );
<a name="l00711"></a>00711 }
<a name="l00712"></a>00712
<a name="l00713"></a>00713 <a class="code" href="classKToolBarButton.html" title="A toolbar button.">KToolBarButton</a>* ktb = bar-><a class="code" href="classKToolBar.html#a90fd62b99961c80154b48feaa1a28413" title="Returns a pointer to KToolBarButton.">getButton</a>(id_);
<a name="l00714"></a>00714 ktb->setName( <a class="codeRef" href="qcstring.html">QCString</a>(<span class="stringliteral">"toolbutton_"</span>)+<a class="codeRef" href="qobject.html#name">name</a>() );
<a name="l00715"></a>00715
<a name="l00716"></a>00716 <span class="keywordflow">if</span> ( !d->whatsThis().isEmpty() )
<a name="l00717"></a>00717 <a class="codeRef" href="qwhatsthis.html#add">QWhatsThis::add</a>( bar-><a class="code" href="classKToolBar.html#a90fd62b99961c80154b48feaa1a28413" title="Returns a pointer to KToolBarButton.">getButton</a>(id_), whatsThisWithIcon() );
<a name="l00718"></a>00718
<a name="l00719"></a>00719 <span class="keywordflow">if</span> ( !d->toolTip().isEmpty() )
<a name="l00720"></a>00720 <a class="codeRef" href="qtooltip.html#add">QToolTip::add</a>( bar-><a class="code" href="classKToolBar.html#a90fd62b99961c80154b48feaa1a28413" title="Returns a pointer to KToolBarButton.">getButton</a>(id_), d->toolTip() );
<a name="l00721"></a>00721
<a name="l00722"></a>00722 addContainer( bar, id_ );
<a name="l00723"></a>00723
<a name="l00724"></a>00724 <a class="codeRef" href="qobject.html#connect">connect</a>( bar, SIGNAL( <a class="codeRef" href="qobject.html#destroyed">destroyed</a>() ), <span class="keyword">this</span>, SLOT( slotDestroyed() ) );
<a name="l00725"></a>00725
<a name="l00726"></a>00726 <span class="keywordflow">if</span> ( m_parentCollection )
<a name="l00727"></a>00727 m_parentCollection-><a class="code" href="classKActionCollection.html#af93b8b710983a362ba22a165af730eaf" title="Call this function if you want to receive a signal whenever a KAction is highlighted in a menu or a t...">connectHighlight</a>( bar, <span class="keyword">this</span> );
<a name="l00728"></a>00728
<a name="l00729"></a>00729 <span class="keywordflow">return</span> containerCount() - 1;
<a name="l00730"></a>00730 }
<a name="l00731"></a>00731
<a name="l00732"></a>00732 <span class="keywordflow">return</span> -1;
<a name="l00733"></a>00733 }
<a name="l00734"></a>00734
<a name="l00735"></a><a class="code" href="classKAction.html#accac212cc07184ac4f8ba2cabdba6396">00735</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#accac212cc07184ac4f8ba2cabdba6396" title=""Unplug" or remove this action from a given widget.">KAction::unplug</a>( <a class="codeRef" href="qwidget.html">QWidget</a> *w )
<a name="l00736"></a>00736 {
<a name="l00737"></a>00737 <span class="keywordtype">int</span> i = findContainer( w );
<a name="l00738"></a>00738 <span class="keywordflow">if</span> ( i == -1 )
<a name="l00739"></a>00739 <span class="keywordflow">return</span>;
<a name="l00740"></a>00740 <span class="keywordtype">int</span> <span class="keywordtype">id</span> = itemId( i );
<a name="l00741"></a>00741
<a name="l00742"></a>00742 <span class="keywordflow">if</span> ( ::qt_cast<QPopupMenu *>( w ) )
<a name="l00743"></a>00743 {
<a name="l00744"></a>00744 <a class="codeRef" href="qpopupmenu.html">QPopupMenu</a> *menu = <span class="keyword">static_cast<</span><a class="codeRef" href="qpopupmenu.html">QPopupMenu</a> *<span class="keyword">></span>( w );
<a name="l00745"></a>00745 menu-><a class="codeRef" href="qpopupmenu.html#removeItem">removeItem</a>( <span class="keywordtype">id</span> );
<a name="l00746"></a>00746 }
<a name="l00747"></a>00747 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<KToolBar *>( w ) )
<a name="l00748"></a>00748 {
<a name="l00749"></a>00749 <a class="code" href="classKToolBar.html" title="Floatable toolbar with auto resize.">KToolBar</a> *bar = <span class="keyword">static_cast<</span><a class="code" href="classKToolBar.html" title="Floatable toolbar with auto resize.">KToolBar</a> *<span class="keyword">></span>( w );
<a name="l00750"></a>00750 bar-><a class="code" href="classKToolBar.html#ae4892bc680e3f6c01510d21f178bbc5d" title="Remove item id.">removeItemDelayed</a>( <span class="keywordtype">id</span> );
<a name="l00751"></a>00751 }
<a name="l00752"></a>00752 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<QMenuBar *>( w ) )
<a name="l00753"></a>00753 {
<a name="l00754"></a>00754 <a class="codeRef" href="qmenubar.html">QMenuBar</a> *bar = <span class="keyword">static_cast<</span><a class="codeRef" href="qmenubar.html">QMenuBar</a> *<span class="keyword">></span>( w );
<a name="l00755"></a>00755 bar-><a class="codeRef" href="qmenubar.html#removeItem">removeItem</a>( <span class="keywordtype">id</span> );
<a name="l00756"></a>00756 }
<a name="l00757"></a>00757
<a name="l00758"></a>00758 removeContainer( i );
<a name="l00759"></a>00759 <span class="keywordflow">if</span> ( m_parentCollection )
<a name="l00760"></a>00760 m_parentCollection-><a class="code" href="classKActionCollection.html#a659f1dcfc01c246dba8358ebea27a6ca" title="Disconnect highlight notifications for a particular pair of contianer and action.">disconnectHighlight</a>( w, <span class="keyword">this</span> );
<a name="l00761"></a>00761 }
<a name="l00762"></a>00762
<a name="l00763"></a><a class="code" href="classKAction.html#ab084d1c1c51574f2f519438831b704e6">00763</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#ab084d1c1c51574f2f519438831b704e6">KAction::plugAccel</a>(<a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html">KAccel</a> *kacc, <span class="keywordtype">bool</span> configurable)
<a name="l00764"></a>00764 {
<a name="l00765"></a>00765 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga9acd682001598171edf8ecb104fdad2b">kdWarning</a>(129) << <span class="stringliteral">"KAction::plugAccel(): call to deprecated action."</span> << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00766"></a>00766 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga1e1407eff58c499f923c325618ead40b">kdBacktrace</a>() << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00767"></a>00767 <span class="comment">//kdDebug(129) << "KAction::plugAccel( kacc = " << kacc << " ): name \"" << name() << "\"" << endl;</span>
<a name="l00768"></a>00768 <span class="keywordflow">if</span> ( d->m_kaccel )
<a name="l00769"></a>00769 <a class="code" href="classKAction.html#a010b828aa2b02e40159a750be32ae26f">unplugAccel</a>();
<a name="l00770"></a>00770
<a name="l00771"></a>00771 <span class="comment">// If the parent collection's accel ptr isn't set yet</span>
<a name="l00772"></a>00772 <span class="comment">//if ( m_parentCollection && !m_parentCollection->accel() )</span>
<a name="l00773"></a>00773 <span class="comment">// m_parentCollection->setAccel( kacc );</span>
<a name="l00774"></a>00774
<a name="l00775"></a>00775 <span class="comment">// We can only plug this action into the given KAccel object</span>
<a name="l00776"></a>00776 <span class="comment">// if it does not already contain an action with the same name.</span>
<a name="l00777"></a>00777 <span class="keywordflow">if</span> ( !kacc-><a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKAccel.html#af9758f1ac607f58e799bb4bb4cdd3bbb">actions</a>().actionPtr(<a class="codeRef" href="qobject.html#name">name</a>()) )
<a name="l00778"></a>00778 {
<a name="l00779"></a>00779 d->m_kaccel = kacc;
<a name="l00780"></a>00780 d->m_kaccel->insert(<a class="codeRef" href="qobject.html#name">name</a>(), d->plainText(), QString::null,
<a name="l00781"></a>00781 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKShortcut.html">KShortcut</a>(d->m_cut),
<a name="l00782"></a>00782 <span class="keyword">this</span>, SLOT(slotActivated()),
<a name="l00783"></a>00783 configurable, <a class="code" href="classKAction.html#af03a9a21291e740cde5465b660b22042" title="Returns true if this action is enabled.">isEnabled</a>());
<a name="l00784"></a>00784 <a class="codeRef" href="qobject.html#connect">connect</a>(d->m_kaccel, SIGNAL(<a class="codeRef" href="qobject.html#destroyed">destroyed</a>()), <span class="keyword">this</span>, SLOT(slotDestroyed()));
<a name="l00785"></a>00785 <span class="comment">//connect(d->m_kaccel, SIGNAL(keycodeChanged()), this, SLOT(slotKeycodeChanged()));</span>
<a name="l00786"></a>00786 }
<a name="l00787"></a>00787 <span class="keywordflow">else</span>
<a name="l00788"></a>00788 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga9acd682001598171edf8ecb104fdad2b">kdWarning</a>(129) << <span class="stringliteral">"KAction::plugAccel( kacc = "</span> << kacc << <span class="stringliteral">" ): KAccel object already contains an action name \""</span> << <a class="codeRef" href="qobject.html#name">name</a>() << <span class="stringliteral">"\""</span> << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>; <span class="comment">// -- ellis</span>
<a name="l00789"></a>00789 }
<a name="l00790"></a>00790
<a name="l00791"></a><a class="code" href="classKAction.html#a010b828aa2b02e40159a750be32ae26f">00791</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#a010b828aa2b02e40159a750be32ae26f">KAction::unplugAccel</a>()
<a name="l00792"></a>00792 {
<a name="l00793"></a>00793 <span class="comment">//kdDebug(129) << "KAction::unplugAccel() " << this << " " << name() << endl;</span>
<a name="l00794"></a>00794 <span class="keywordflow">if</span> ( d->m_kaccel )
<a name="l00795"></a>00795 {
<a name="l00796"></a>00796 d->m_kaccel->remove(<a class="codeRef" href="qobject.html#name">name</a>());
<a name="l00797"></a>00797 d->m_kaccel = 0;
<a name="l00798"></a>00798 }
<a name="l00799"></a>00799 }
<a name="l00800"></a>00800
<a name="l00801"></a>00801 <span class="keywordtype">void</span> KAction::plugMainWindowAccel( <a class="codeRef" href="qwidget.html">QWidget</a> *w )
<a name="l00802"></a>00802 {
<a name="l00803"></a>00803 <span class="comment">// Note: topLevelWidget() stops too early, we can't use it.</span>
<a name="l00804"></a>00804 <a class="codeRef" href="qwidget.html">QWidget</a> * tl = w;
<a name="l00805"></a>00805 <a class="codeRef" href="qwidget.html">QWidget</a> * n;
<a name="l00806"></a>00806 <span class="keywordflow">while</span> ( !tl-><a class="codeRef" href="qwidget.html#isDialog">isDialog</a>() && ( n = tl-><a class="codeRef" href="qwidget.html#parentWidget">parentWidget</a>() ) ) <span class="comment">// lookup parent and store</span>
<a name="l00807"></a>00807 tl = n;
<a name="l00808"></a>00808
<a name="l00809"></a>00809 <a class="code" href="classKMainWindow.html" title="KDE top level main window">KMainWindow</a> * mw = <span class="keyword">dynamic_cast<</span><a class="code" href="classKMainWindow.html" title="KDE top level main window">KMainWindow</a> *<span class="keyword">></span>(tl); <span class="comment">// try to see if it's a kmainwindow</span>
<a name="l00810"></a>00810 <span class="keywordflow">if</span> (mw)
<a name="l00811"></a>00811 <a class="code" href="classKAction.html#ab084d1c1c51574f2f519438831b704e6">plugAccel</a>( mw-><a class="code" href="classKMainWindow.html#ab79ee56f66b53bd28d899e571859b9c9">accel</a>() );
<a name="l00812"></a>00812 <span class="keywordflow">else</span>
<a name="l00813"></a>00813 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <span class="stringliteral">"KAction::plugMainWindowAccel: Toplevel widget isn't a KMainWindow, can't plug accel. "</span> << tl << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l00814"></a>00814 }
<a name="l00815"></a>00815
<a name="l00816"></a><a class="code" href="classKAction.html#a8a4bba333f349bed600f4d3fd9104510">00816</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#a8a4bba333f349bed600f4d3fd9104510" title="Enables or disables this action.">KAction::setEnabled</a>(<span class="keywordtype">bool</span> enable)
<a name="l00817"></a>00817 {
<a name="l00818"></a>00818 <span class="comment">//kdDebug(129) << "KAction::setEnabled( " << enable << " ): this = " << this << " d->m_kaccelList.count() = " << d->m_kaccelList.count() << endl;</span>
<a name="l00819"></a>00819 <span class="keywordflow">if</span> ( enable == d->isEnabled() )
<a name="l00820"></a>00820 <span class="keywordflow">return</span>;
<a name="l00821"></a>00821
<a name="l00822"></a>00822 <span class="preprocessor">#ifndef KDE_NO_COMPAT</span>
<a name="l00823"></a>00823 <span class="preprocessor"></span> <span class="comment">// KDE 4: remove</span>
<a name="l00824"></a>00824 <span class="keywordflow">if</span> (d->m_kaccel)
<a name="l00825"></a>00825 d->m_kaccel->setEnabled(<a class="codeRef" href="qobject.html#name">name</a>(), enable);
<a name="l00826"></a>00826 <span class="preprocessor">#endif // KDE 4: remove end</span>
<a name="l00827"></a>00827 <span class="preprocessor"></span>
<a name="l00828"></a>00828 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*></a> & accelList = d->m_kaccelList;
<a name="l00829"></a>00829 <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::const_iterator</a> itr = accelList.<a class="codeRef" href="qvaluelist.html#constBegin">constBegin</a>();
<a name="l00830"></a>00830 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::const_iterator</a> itrEnd = accelList.<a class="codeRef" href="qvaluelist.html#constEnd">constEnd</a>();
<a name="l00831"></a>00831
<a name="l00832"></a>00832 <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> namePtr = <a class="codeRef" href="qobject.html#name">name</a>();
<a name="l00833"></a>00833
<a name="l00834"></a>00834 <span class="keywordflow">for</span> ( ; itr != itrEnd; ++itr )
<a name="l00835"></a>00835 (*itr)->setEnabled( namePtr, enable );
<a name="l00836"></a>00836
<a name="l00837"></a>00837 d->setEnabled( enable );
<a name="l00838"></a>00838
<a name="l00839"></a>00839 <span class="keywordtype">int</span> len = containerCount();
<a name="l00840"></a>00840 <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i = 0; i < len; ++i )
<a name="l00841"></a>00841 updateEnabled( i );
<a name="l00842"></a>00842
<a name="l00843"></a>00843 emit enabled( d->isEnabled() );
<a name="l00844"></a>00844 }
<a name="l00845"></a>00845
<a name="l00846"></a>00846 <span class="keywordtype">void</span> KAction::updateEnabled( <span class="keywordtype">int</span> i )
<a name="l00847"></a>00847 {
<a name="l00848"></a>00848 <a class="codeRef" href="qwidget.html">QWidget</a> *w = container( i );
<a name="l00849"></a>00849
<a name="l00850"></a>00850 <span class="keywordflow">if</span> ( ::qt_cast<QPopupMenu *>( w ) )
<a name="l00851"></a>00851 <span class="keyword">static_cast<</span><a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>*<span class="keyword">></span>(w)->setItemEnabled( itemId( i ), d->isEnabled() );
<a name="l00852"></a>00852 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<QMenuBar *>( w ) )
<a name="l00853"></a>00853 static_cast<QMenuBar*>(w)-><a class="codeRef" href="qpopupmenu.html#setItemEnabled">setItemEnabled</a>( itemId( i ), d->isEnabled() );
<a name="l00854"></a>00854 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<KToolBar *>( w ) )
<a name="l00855"></a>00855 static_cast<KToolBar*>(w)->setItemEnabled( itemId( i ), d->isEnabled() );
<a name="l00856"></a>00856 }
<a name="l00857"></a>00857
<a name="l00858"></a><a class="code" href="classKAction.html#acb84392c5069bbf2a11fe0ca415f5625">00858</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#acb84392c5069bbf2a11fe0ca415f5625" title="Indicate whether the user may configure the action's shortcut.">KAction::setShortcutConfigurable</a>( <span class="keywordtype">bool</span> b )
<a name="l00859"></a>00859 {
<a name="l00860"></a>00860 d->m_configurable = b;
<a name="l00861"></a>00861 }
<a name="l00862"></a>00862
<a name="l00863"></a><a class="code" href="classKAction.html#a9a8b52a97b6c436abdb9238329a9af21">00863</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#a9a8b52a97b6c436abdb9238329a9af21" title="Sets the text associated with this action.">KAction::setText</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text )
<a name="l00864"></a>00864 {
<a name="l00865"></a>00865 <span class="preprocessor">#ifndef KDE_NO_COMPAT</span>
<a name="l00866"></a>00866 <span class="preprocessor"></span> <span class="comment">// KDE 4: remove</span>
<a name="l00867"></a>00867 <span class="keywordflow">if</span> (d->m_kaccel) {
<a name="l00868"></a>00868 KAccelAction* pAction = d->m_kaccel->actions().actionPtr(<a class="codeRef" href="qobject.html#name">name</a>());
<a name="l00869"></a>00869 <span class="keywordflow">if</span> (pAction)
<a name="l00870"></a>00870 pAction->setLabel( text );
<a name="l00871"></a>00871 }
<a name="l00872"></a>00872 <span class="preprocessor">#endif // KDE 4: remove end</span>
<a name="l00873"></a>00873 <span class="preprocessor"></span> <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*></a> & accelList = d->m_kaccelList;
<a name="l00874"></a>00874 <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::const_iterator</a> itr = accelList.<a class="codeRef" href="qvaluelist.html#constBegin">constBegin</a>();
<a name="l00875"></a>00875 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::const_iterator</a> itrEnd = accelList.<a class="codeRef" href="qvaluelist.html#constEnd">constEnd</a>();
<a name="l00876"></a>00876
<a name="l00877"></a>00877 <span class="keyword">const</span> <span class="keywordtype">char</span> * <span class="keyword">const</span> namePtr = <a class="codeRef" href="qobject.html#name">name</a>();
<a name="l00878"></a>00878
<a name="l00879"></a>00879 <span class="keywordflow">for</span>( ; itr != itrEnd; ++itr ) {
<a name="l00880"></a>00880 KAccelAction* <span class="keyword">const</span> pAction = (*itr)->actions().actionPtr(namePtr);
<a name="l00881"></a>00881 <span class="keywordflow">if</span> (pAction)
<a name="l00882"></a>00882 pAction->setLabel( text );
<a name="l00883"></a>00883 }
<a name="l00884"></a>00884
<a name="l00885"></a>00885 d->setText( text );
<a name="l00886"></a>00886
<a name="l00887"></a>00887 <span class="keywordtype">int</span> len = containerCount();
<a name="l00888"></a>00888 <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i = 0; i < len; ++i )
<a name="l00889"></a>00889 updateText( i );
<a name="l00890"></a>00890 }
<a name="l00891"></a>00891
<a name="l00892"></a>00892 <span class="keywordtype">void</span> KAction::updateText( <span class="keywordtype">int</span> i )
<a name="l00893"></a>00893 {
<a name="l00894"></a>00894 <a class="codeRef" href="qwidget.html">QWidget</a> *w = container( i );
<a name="l00895"></a>00895
<a name="l00896"></a>00896 <span class="keywordflow">if</span> ( ::qt_cast<QPopupMenu *>( w ) ) {
<a name="l00897"></a>00897 <span class="keywordtype">int</span> <span class="keywordtype">id</span> = itemId( i );
<a name="l00898"></a>00898 <span class="keyword">static_cast<</span><a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>*<span class="keyword">></span>(w)->changeItem( <span class="keywordtype">id</span>, d->text() );
<a name="l00899"></a>00899 <span class="keywordflow">if</span> (!d->m_cut.isNull())
<a name="l00900"></a>00900 updateShortcut( static_cast<QPopupMenu*>(w), id );
<a name="l00901"></a>00901 }
<a name="l00902"></a>00902 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<QMenuBar *>( w ) )
<a name="l00903"></a>00903 static_cast<QMenuBar*>(w)->changeItem( itemId( i ), d->text() );
<a name="l00904"></a>00904 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<KToolBar *>( w ) )
<a name="l00905"></a>00905 {
<a name="l00906"></a>00906 <a class="codeRef" href="qwidget.html">QWidget</a> *button = <span class="keyword">static_cast<</span><a class="code" href="classKToolBar.html" title="Floatable toolbar with auto resize.">KToolBar</a> *<span class="keyword">></span>(w)->getWidget( itemId( i ) );
<a name="l00907"></a>00907 <span class="keywordflow">if</span> ( ::qt_cast<KToolBarButton *>( button ) )
<a name="l00908"></a>00908 static_cast<KToolBarButton *>(button)-><a class="code" href="classKToolBar.html#a3ed35ae2836a155ead5eb6780bb3510f" title="Assign a (translated) text to this toolbar.">setText</a>( d->plainText() );
<a name="l00909"></a>00909 }
<a name="l00910"></a>00910 }
<a name="l00911"></a>00911
<a name="l00912"></a>00912 <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKAction.html#a25ceafd446b8d333f19f8a7710b6d4fe" title="Get the text associated with this action.">KAction::text</a>()<span class="keyword"> const</span>
<a name="l00913"></a>00913 <span class="keyword"></span>{
<a name="l00914"></a>00914 <span class="keywordflow">return</span> d->text();
<a name="l00915"></a>00915 }
<a name="l00916"></a>00916
<a name="l00917"></a>00917 <a class="codeRef" href="qstring.html">QString</a> KAction::plainText()<span class="keyword"> const</span>
<a name="l00918"></a>00918 <span class="keyword"></span>{
<a name="l00919"></a>00919 <span class="keywordflow">return</span> d->plainText( );
<a name="l00920"></a>00920 }
<a name="l00921"></a>00921
<a name="l00922"></a>00922 <span class="keywordtype">void</span> KAction::setIcon( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a> &icon )
<a name="l00923"></a>00923 {
<a name="l00924"></a>00924 d->setIconName( icon );
<a name="l00925"></a>00925
<a name="l00926"></a>00926 <span class="comment">// now handle any toolbars</span>
<a name="l00927"></a>00927 <span class="keywordtype">int</span> len = containerCount();
<a name="l00928"></a>00928 <span class="keywordflow">for</span> ( <span class="keywordtype">int</span> i = 0; i < len; ++i )
<a name="l00929"></a>00929 updateIcon( i );
<a name="l00930"></a>00930 }
<a name="l00931"></a>00931
<a name="l00932"></a>00932 <span class="keywordtype">void</span> KAction::updateIcon( <span class="keywordtype">int</span> <span class="keywordtype">id</span> )
<a name="l00933"></a>00933 {
<a name="l00934"></a>00934 <a class="codeRef" href="qwidget.html">QWidget</a>* w = container( <span class="keywordtype">id</span> );
<a name="l00935"></a>00935
<a name="l00936"></a>00936 <span class="keywordflow">if</span> ( ::qt_cast<QPopupMenu *>( w ) ) {
<a name="l00937"></a>00937 <span class="keywordtype">int</span> itemId_ = itemId( <span class="keywordtype">id</span> );
<a name="l00938"></a>00938 <span class="keyword">static_cast<</span><a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>*<span class="keyword">></span>(w)->changeItem( itemId_, d->iconSet( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKIcon.html#a20145b9c0aecf124fadc35cd30c18f82a2dddf01e0cfa645258c58da4244adb55">KIcon::Small</a> ), d->text() );
<a name="l00939"></a>00939 <span class="keywordflow">if</span> (!d->m_cut.isNull())
<a name="l00940"></a>00940 updateShortcut( static_cast<QPopupMenu*>(w), itemId_ );
<a name="l00941"></a>00941 }
<a name="l00942"></a>00942 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<QMenuBar *>( w ) )
<a name="l00943"></a>00943 static_cast<QMenuBar*>(w)->changeItem( itemId( <span class="keywordtype">id</span> ), d->iconSet( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKIcon.html#a20145b9c0aecf124fadc35cd30c18f82a2dddf01e0cfa645258c58da4244adb55">KIcon::Small</a> ), d->text() );
<a name="l00944"></a>00944 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<KToolBar *>( w ) )
<a name="l00945"></a>00945 static_cast<KToolBar *>(w)->setButtonIcon( itemId( <span class="keywordtype">id</span> ), d->iconName() );
<a name="l00946"></a>00946 }
<a name="l00947"></a>00947
<a name="l00948"></a>00948 <a class="codeRef" href="qstring.html">QString</a> KAction::icon()<span class="keyword"> const</span>
<a name="l00949"></a>00949 <span class="keyword"></span>{
<a name="l00950"></a>00950 <span class="keywordflow">return</span> d->iconName( );
<a name="l00951"></a>00951 }
<a name="l00952"></a>00952
<a name="l00953"></a><a class="code" href="classKAction.html#a551fe3b9d41c658b5e488bea94b01890">00953</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#a551fe3b9d41c658b5e488bea94b01890" title="Sets the QIconSet from which the icons used to display this action will be chosen.">KAction::setIconSet</a>( <span class="keyword">const</span> <a class="codeRef" href="qiconset.html">QIconSet</a> &iconset )
<a name="l00954"></a>00954 {
<a name="l00955"></a>00955 d->setIconSet( iconset );
<a name="l00956"></a>00956
<a name="l00957"></a>00957 <span class="keywordtype">int</span> len = containerCount();
<a name="l00958"></a>00958 <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i = 0; i < len; ++i )
<a name="l00959"></a>00959 updateIconSet( i );
<a name="l00960"></a>00960 }
<a name="l00961"></a>00961
<a name="l00962"></a>00962
<a name="l00963"></a>00963 <span class="keywordtype">void</span> KAction::updateIconSet( <span class="keywordtype">int</span> <span class="keywordtype">id</span> )
<a name="l00964"></a>00964 {
<a name="l00965"></a>00965 <a class="codeRef" href="qwidget.html">QWidget</a> *w = container( <span class="keywordtype">id</span> );
<a name="l00966"></a>00966
<a name="l00967"></a>00967 <span class="keywordflow">if</span> ( ::qt_cast<QPopupMenu *>( w ) )
<a name="l00968"></a>00968 {
<a name="l00969"></a>00969 <span class="keywordtype">int</span> itemId_ = itemId( <span class="keywordtype">id</span> );
<a name="l00970"></a>00970 <span class="keyword">static_cast<</span><a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>*<span class="keyword">></span>(w)->changeItem( itemId_, d->iconSet(), d->text() );
<a name="l00971"></a>00971 <span class="keywordflow">if</span> (!d->m_cut.isNull())
<a name="l00972"></a>00972 updateShortcut( static_cast<QPopupMenu*>(w), itemId_ );
<a name="l00973"></a>00973 }
<a name="l00974"></a>00974 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<QMenuBar *>( w ) )
<a name="l00975"></a>00975 static_cast<QMenuBar*>(w)->changeItem( itemId( <span class="keywordtype">id</span> ), d->iconSet(), d->text() );
<a name="l00976"></a>00976 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( ::qt_cast<KToolBar *>( w ) )
<a name="l00977"></a>00977 {
<a name="l00978"></a>00978 <span class="keywordflow">if</span> ( icon().<a class="codeRef" href="qstring.html#isEmpty">isEmpty</a>() && d->hasIcon() ) <span class="comment">// only if there is no named icon ( scales better )</span>
<a name="l00979"></a>00979 static_cast<KToolBar *>(w)->setButtonIconSet( itemId( <span class="keywordtype">id</span> ), d->iconSet() );
<a name="l00980"></a>00980 <span class="keywordflow">else</span>
<a name="l00981"></a>00981 <span class="keyword">static_cast<</span><a class="code" href="classKToolBar.html" title="Floatable toolbar with auto resize.">KToolBar</a> *<span class="keyword">></span>(w)->setButtonIconSet( itemId( <span class="keywordtype">id</span> ), d->iconSet( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKIcon.html#a20145b9c0aecf124fadc35cd30c18f82a2dddf01e0cfa645258c58da4244adb55">KIcon::Small</a> ) );
<a name="l00982"></a>00982 }
<a name="l00983"></a>00983 }
<a name="l00984"></a>00984
<a name="l00985"></a><a class="code" href="classKAction.html#a6f4a507e80439cc034c55ec96e154d02">00985</a> <a class="codeRef" href="qiconset.html">QIconSet</a> <a class="code" href="classKAction.html#add12cbbcf8e3aa05876cce3d965b4b15" title="Remove in KDE4.">KAction::iconSet</a>( <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKIcon.html#a20145b9c0aecf124fadc35cd30c18f82">KIcon::Group</a> group, <span class="keywordtype">int</span> size )<span class="keyword"> const</span>
<a name="l00986"></a>00986 <span class="keyword"></span>{
<a name="l00987"></a>00987 <span class="keywordflow">return</span> d->iconSet( group, size );
<a name="l00988"></a>00988 }
<a name="l00989"></a>00989
<a name="l00990"></a>00990 <span class="keywordtype">bool</span> KAction::hasIcon()<span class="keyword"> const</span>
<a name="l00991"></a>00991 <span class="keyword"></span>{
<a name="l00992"></a>00992 <span class="keywordflow">return</span> d->hasIcon();
<a name="l00993"></a>00993 }
<a name="l00994"></a>00994
<a name="l00995"></a><a class="code" href="classKAction.html#aeb00a953ae18ffa86b96eed96339211b">00995</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#aeb00a953ae18ffa86b96eed96339211b" title="Sets the What's this text for the action.">KAction::setWhatsThis</a>( <span class="keyword">const</span> <a class="codeRef" href="qstring.html">QString</a>& text )
<a name="l00996"></a>00996 {
<a name="l00997"></a>00997 d->setWhatsThis( text );
<a name="l00998"></a>00998
<a name="l00999"></a>00999 <span class="keywordtype">int</span> len = containerCount();
<a name="l01000"></a>01000 <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i = 0; i < len; ++i )
<a name="l01001"></a>01001 updateWhatsThis( i );
<a name="l01002"></a>01002 }
<a name="l01003"></a>01003
<a name="l01004"></a>01004 <span class="keywordtype">void</span> KAction::updateWhatsThis( <span class="keywordtype">int</span> i )
<a name="l01005"></a>01005 {
<a name="l01006"></a>01006 <a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>* pm = popupMenu( i );
<a name="l01007"></a>01007 <span class="keywordflow">if</span> ( pm )
<a name="l01008"></a>01008 {
<a name="l01009"></a>01009 pm-><a class="codeRef" href="qpopupmenu.html#setWhatsThis">setWhatsThis</a>( itemId( i ), d->whatsThis() );
<a name="l01010"></a>01010 <span class="keywordflow">return</span>;
<a name="l01011"></a>01011 }
<a name="l01012"></a>01012
<a name="l01013"></a>01013 <a class="code" href="classKToolBar.html" title="Floatable toolbar with auto resize.">KToolBar</a> *tb = toolBar( i );
<a name="l01014"></a>01014 <span class="keywordflow">if</span> ( tb )
<a name="l01015"></a>01015 {
<a name="l01016"></a>01016 <a class="codeRef" href="qwidget.html">QWidget</a> *w = tb-><a class="code" href="classKToolBar.html#a90fd62b99961c80154b48feaa1a28413" title="Returns a pointer to KToolBarButton.">getButton</a>( itemId( i ) );
<a name="l01017"></a>01017 <a class="codeRef" href="qwhatsthis.html#remove">QWhatsThis::remove</a>( w );
<a name="l01018"></a>01018 <a class="codeRef" href="qwhatsthis.html#add">QWhatsThis::add</a>( w, d->whatsThis() );
<a name="l01019"></a>01019 <span class="keywordflow">return</span>;
<a name="l01020"></a>01020 }
<a name="l01021"></a>01021 }
<a name="l01022"></a>01022
<a name="l01023"></a>01023 <a class="codeRef" href="qstring.html">QString</a> <a class="code" href="classKAction.html#a04085cfb30e19375ebce98201dbf82ca" title="Get the What's this text for the action.">KAction::whatsThis</a>()<span class="keyword"> const</span>
<a name="l01024"></a>01024 <span class="keyword"></span>{
<a name="l01025"></a>01025 <span class="keywordflow">return</span> d->whatsThis();
<a name="l01026"></a>01026 }
<a name="l01027"></a>01027
<a name="l01028"></a>01028 <a class="codeRef" href="qstring.html">QString</a> KAction::whatsThisWithIcon()<span class="keyword"> const</span>
<a name="l01029"></a>01029 <span class="keyword"></span>{
<a name="l01030"></a>01030 <a class="codeRef" href="qstring.html">QString</a> text = <a class="code" href="classKAction.html#a04085cfb30e19375ebce98201dbf82ca" title="Get the What's this text for the action.">whatsThis</a>();
<a name="l01031"></a>01031 <span class="keywordflow">if</span> (!d->iconName().isEmpty())
<a name="l01032"></a>01032 <span class="keywordflow">return</span> <a class="codeRef" href="qstring.html#fromLatin1">QString::fromLatin1</a>(<span class="stringliteral">"<img source=\"small|%1\"> %2"</span>).arg(d->iconName() ).arg(text);
<a name="l01033"></a>01033 <span class="keywordflow">return</span> <a class="code" href="classKAction.html#a25ceafd446b8d333f19f8a7710b6d4fe" title="Get the text associated with this action.">text</a>;
<a name="l01034"></a>01034 }
<a name="l01035"></a>01035
<a name="l01036"></a>01036 <a class="codeRef" href="qwidget.html">QWidget</a>* KAction::container( <span class="keywordtype">int</span> index )<span class="keyword"> const</span>
<a name="l01037"></a>01037 <span class="keyword"></span>{
<a name="l01038"></a>01038 assert( index < containerCount() );
<a name="l01039"></a>01039 <span class="keywordflow">return</span> d->m_containers[ index ].m_container;
<a name="l01040"></a>01040 }
<a name="l01041"></a>01041
<a name="l01042"></a>01042 <a class="code" href="classKToolBar.html" title="Floatable toolbar with auto resize.">KToolBar</a>* KAction::toolBar( <span class="keywordtype">int</span> index )<span class="keyword"> const</span>
<a name="l01043"></a>01043 <span class="keyword"></span>{
<a name="l01044"></a>01044 <span class="keywordflow">return</span> <span class="keyword">dynamic_cast<</span><a class="code" href="classKToolBar.html" title="Floatable toolbar with auto resize.">KToolBar</a> *<span class="keyword">></span>( d->m_containers[ index ].m_container );
<a name="l01045"></a>01045 }
<a name="l01046"></a>01046
<a name="l01047"></a>01047 <a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>* KAction::popupMenu( <span class="keywordtype">int</span> index )<span class="keyword"> const</span>
<a name="l01048"></a>01048 <span class="keyword"></span>{
<a name="l01049"></a>01049 <span class="keywordflow">return</span> <span class="keyword">dynamic_cast<</span><a class="codeRef" href="qpopupmenu.html">QPopupMenu</a> *<span class="keyword">></span>( d->m_containers[ index ].m_container );
<a name="l01050"></a>01050 }
<a name="l01051"></a>01051
<a name="l01052"></a>01052 <a class="codeRef" href="qwidget.html">QWidget</a>* KAction::representative( <span class="keywordtype">int</span> index )<span class="keyword"> const</span>
<a name="l01053"></a>01053 <span class="keyword"></span>{
<a name="l01054"></a>01054 <span class="keywordflow">return</span> d->m_containers[ index ].m_representative;
<a name="l01055"></a>01055 }
<a name="l01056"></a>01056
<a name="l01057"></a>01057 <span class="keywordtype">int</span> KAction::itemId( <span class="keywordtype">int</span> index )<span class="keyword"> const</span>
<a name="l01058"></a>01058 <span class="keyword"></span>{
<a name="l01059"></a>01059 <span class="keywordflow">return</span> d->m_containers[ index ].m_id;
<a name="l01060"></a>01060 }
<a name="l01061"></a>01061
<a name="l01062"></a>01062 <span class="keywordtype">int</span> KAction::containerCount()<span class="keyword"> const</span>
<a name="l01063"></a>01063 <span class="keyword"></span>{
<a name="l01064"></a>01064 <span class="keywordflow">return</span> d->m_containers.count();
<a name="l01065"></a>01065 }
<a name="l01066"></a>01066
<a name="l01067"></a><a class="code" href="classKAction.html#ab4f5d7e04bd19a899bc6fb82660770e5">01067</a> uint <a class="code" href="classKAction.html#ab4f5d7e04bd19a899bc6fb82660770e5">KAction::kaccelCount</a>()<span class="keyword"> const</span>
<a name="l01068"></a>01068 <span class="keyword"></span>{
<a name="l01069"></a>01069 <span class="keywordflow">return</span> d->m_kaccelList.count();
<a name="l01070"></a>01070 }
<a name="l01071"></a>01071
<a name="l01072"></a>01072 <span class="keywordtype">void</span> KAction::addContainer( <a class="codeRef" href="qwidget.html">QWidget</a>* c, <span class="keywordtype">int</span> <span class="keywordtype">id</span> )
<a name="l01073"></a>01073 {
<a name="l01074"></a>01074 KActionPrivate::Container p;
<a name="l01075"></a>01075 p.m_container = c;
<a name="l01076"></a>01076 p.m_id = id;
<a name="l01077"></a>01077 d->m_containers.append( p );
<a name="l01078"></a>01078 }
<a name="l01079"></a>01079
<a name="l01080"></a>01080 <span class="keywordtype">void</span> KAction::addContainer( <a class="codeRef" href="qwidget.html">QWidget</a>* c, <a class="codeRef" href="qwidget.html">QWidget</a>* w )
<a name="l01081"></a>01081 {
<a name="l01082"></a>01082 KActionPrivate::Container p;
<a name="l01083"></a>01083 p.m_container = c;
<a name="l01084"></a>01084 p.m_representative = w;
<a name="l01085"></a>01085 d->m_containers.append( p );
<a name="l01086"></a>01086 }
<a name="l01087"></a>01087
<a name="l01088"></a><a class="code" href="classKAction.html#ab52d06e092759fb425ba24a11419dd74">01088</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#ab52d06e092759fb425ba24a11419dd74" title="Emulate user's interaction programmatically, by activating the action.">KAction::activate</a>()
<a name="l01089"></a>01089 {
<a name="l01090"></a>01090 emit <a class="code" href="classKAction.html#ae5e6b06d6e0f8c8efacd51a541833ee0" title="Emitted when this action is activated.">activated</a>( KAction::EmulatedActivation, Qt::NoButton );
<a name="l01091"></a>01091 slotActivated();
<a name="l01092"></a>01092 }
<a name="l01093"></a>01093
<a name="l01094"></a>01094 <span class="keywordtype">void</span> KAction::slotActivated()
<a name="l01095"></a>01095 {
<a name="l01096"></a>01096 <span class="keyword">const</span> <a class="codeRef" href="qobject.html">QObject</a> *senderObj = <a class="codeRef" href="qobject.html#sender">sender</a>();
<a name="l01097"></a>01097 <span class="keywordflow">if</span> ( senderObj )
<a name="l01098"></a>01098 {
<a name="l01099"></a>01099 <span class="keywordflow">if</span> ( ::qt_cast<KAccelPrivate *>( senderObj ) )
<a name="l01100"></a>01100 emit <a class="code" href="classKAction.html#ae5e6b06d6e0f8c8efacd51a541833ee0" title="Emitted when this action is activated.">activated</a>( KAction::AccelActivation, Qt::NoButton );
<a name="l01101"></a>01101 }
<a name="l01102"></a>01102 emit <a class="code" href="classKAction.html#ae5e6b06d6e0f8c8efacd51a541833ee0" title="Emitted when this action is activated.">activated</a>();
<a name="l01103"></a>01103 }
<a name="l01104"></a>01104
<a name="l01105"></a>01105 <span class="comment">// This catches signals emitted by KActions inserted into QPopupMenu</span>
<a name="l01106"></a>01106 <span class="comment">// We do crude things inside it, because we need to know which</span>
<a name="l01107"></a>01107 <span class="comment">// QPopupMenu emitted the signal. We need to be sure that it is</span>
<a name="l01108"></a>01108 <span class="comment">// only called by QPopupMenus, we plugged us in.</span>
<a name="l01109"></a><a class="code" href="classKAction.html#a5962236de12399cb5702b68762957df7">01109</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#a5962236de12399cb5702b68762957df7">KAction::slotPopupActivated</a>()
<a name="l01110"></a>01110 {
<a name="l01111"></a>01111 <span class="keywordflow">if</span>( ::qt_cast<QSignal *>(<a class="codeRef" href="qobject.html#sender">sender</a>()))
<a name="l01112"></a>01112 {
<a name="l01113"></a>01113 <span class="keywordtype">int</span> <span class="keywordtype">id</span> = <span class="keyword">dynamic_cast<</span><span class="keyword">const </span><a class="codeRef" href="qsignal.html">QSignal</a> *<span class="keyword">></span>(<a class="codeRef" href="qobject.html#sender">sender</a>())->value().toInt();
<a name="l01114"></a>01114 <span class="keywordtype">int</span> pos = findContainer(<span class="keywordtype">id</span>);
<a name="l01115"></a>01115 <span class="keywordflow">if</span>(pos != -1)
<a name="l01116"></a>01116 {
<a name="l01117"></a>01117 <a class="codeRef" href="qpopupmenu.html">QPopupMenu</a>* qpm = <span class="keyword">dynamic_cast<</span><a class="codeRef" href="qpopupmenu.html">QPopupMenu</a> *<span class="keyword">></span>( container(pos) );
<a name="l01118"></a>01118 <span class="keywordflow">if</span>(qpm)
<a name="l01119"></a>01119 {
<a name="l01120"></a>01120 <a class="code" href="classKPopupMenu.html" title="A menu with title items.">KPopupMenu</a>* kpm = <span class="keyword">dynamic_cast<</span><a class="code" href="classKPopupMenu.html" title="A menu with title items.">KPopupMenu</a> *<span class="keyword">></span>( qpm );
<a name="l01121"></a>01121 Qt::ButtonState state;
<a name="l01122"></a>01122 <span class="keywordflow">if</span> ( kpm ) <span class="comment">// KPopupMenu? Nice, it stores the state.</span>
<a name="l01123"></a>01123 state = kpm-><a class="code" href="classKPopupMenu.html#a478034151af289922ea488b6ab5f4071" title="Return the state of the mouse button and keyboard modifiers when the last menuitem was activated...">state</a>();
<a name="l01124"></a>01124 <span class="keywordflow">else</span> { <span class="comment">// just a QPopupMenu? We'll ask for the state now then (small race condition?)</span>
<a name="l01125"></a>01125 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <span class="stringliteral">"KAction::slotPopupActivated not a KPopupMenu -> using keyboardMouseState()"</span> << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l01126"></a>01126 state = <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/classKApplication.html#a11e847e6f91426160ce8d3a7ae73a9ca">KApplication::keyboardMouseState</a>();
<a name="l01127"></a>01127 }
<a name="l01128"></a>01128 emit <a class="code" href="classKAction.html#ae5e6b06d6e0f8c8efacd51a541833ee0" title="Emitted when this action is activated.">activated</a>( KAction::PopupMenuActivation, state );
<a name="l01129"></a>01129 slotActivated();
<a name="l01130"></a>01130 <span class="keywordflow">return</span>;
<a name="l01131"></a>01131 }
<a name="l01132"></a>01132 }
<a name="l01133"></a>01133 }
<a name="l01134"></a>01134
<a name="l01135"></a>01135 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga9acd682001598171edf8ecb104fdad2b">kdWarning</a>(129)<<<span class="stringliteral">"Don't connect KAction::slotPopupActivated() to anything, expect into QPopupMenus which are in containers. Use slotActivated instead."</span><<<a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l01136"></a>01136 emit <a class="code" href="classKAction.html#ae5e6b06d6e0f8c8efacd51a541833ee0" title="Emitted when this action is activated.">activated</a>( KAction::PopupMenuActivation, Qt::NoButton );
<a name="l01137"></a>01137 slotActivated();
<a name="l01138"></a>01138 }
<a name="l01139"></a>01139
<a name="l01140"></a><a class="code" href="classKAction.html#a18e94dc703cf9b11f6951064978abd20">01140</a> <span class="keywordtype">void</span> <a class="code" href="classKAction.html#a18e94dc703cf9b11f6951064978abd20">KAction::slotButtonClicked</a>( <span class="keywordtype">int</span>, Qt::ButtonState state )
<a name="l01141"></a>01141 {
<a name="l01142"></a>01142 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <span class="stringliteral">"slotButtonClicked() state="</span> << state << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l01143"></a>01143 emit <a class="code" href="classKAction.html#ae5e6b06d6e0f8c8efacd51a541833ee0" title="Emitted when this action is activated.">activated</a>( KAction::ToolBarActivation, state );
<a name="l01144"></a>01144
<a name="l01145"></a>01145 <span class="comment">// RightButton isn't really an activation</span>
<a name="l01146"></a>01146 <span class="keywordflow">if</span> ( ( state & LeftButton ) || ( state & MidButton ) )
<a name="l01147"></a>01147 slotActivated();
<a name="l01148"></a>01148 }
<a name="l01149"></a>01149
<a name="l01150"></a>01150
<a name="l01151"></a>01151 <span class="keywordtype">void</span> KAction::slotDestroyed()
<a name="l01152"></a>01152 {
<a name="l01153"></a>01153 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <span class="stringliteral">"KAction::slotDestroyed(): this = "</span> << <span class="keyword">this</span> << <span class="stringliteral">", name = \""</span> << <a class="codeRef" href="qobject.html#name">name</a>() << <span class="stringliteral">"\", sender = "</span> << <a class="codeRef" href="qobject.html#sender">sender</a>() << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>;
<a name="l01154"></a>01154 <span class="keyword">const</span> <a class="codeRef" href="qobject.html">QObject</a>* <span class="keyword">const</span> o = <a class="codeRef" href="qobject.html#sender">sender</a>();
<a name="l01155"></a>01155
<a name="l01156"></a>01156 <span class="preprocessor">#ifndef KDE_NO_COMPAT // KDE 4: remove</span>
<a name="l01157"></a>01157 <span class="preprocessor"></span> <span class="keywordflow">if</span> ( o == d->m_kaccel )
<a name="l01158"></a>01158 {
<a name="l01159"></a>01159 d->m_kaccel = 0;
<a name="l01160"></a>01160 <span class="keywordflow">return</span>;
<a name="l01161"></a>01161 }
<a name="l01162"></a>01162 <span class="preprocessor">#endif // KDE 4: remove end</span>
<a name="l01163"></a>01163 <span class="preprocessor"></span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*></a> & accelList = d->m_kaccelList;
<a name="l01164"></a>01164 <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::iterator</a> itr = accelList.<a class="codeRef" href="qvaluelist.html#begin">begin</a>();
<a name="l01165"></a>01165 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KAccel*>::iterator</a> itrEnd = accelList.<a class="codeRef" href="qvaluelist.html#end">end</a>();
<a name="l01166"></a>01166
<a name="l01167"></a>01167 <span class="keywordflow">for</span>( ; itr != itrEnd; ++itr)
<a name="l01168"></a>01168 {
<a name="l01169"></a>01169 <span class="keywordflow">if</span> ( o == *itr )
<a name="l01170"></a>01170 {
<a name="l01171"></a>01171 <a class="codeRef" href="qobject.html#disconnect">disconnect</a>( *itr, SIGNAL(<a class="codeRef" href="qobject.html#destroyed">destroyed</a>()), <span class="keyword">this</span>, SLOT(slotDestroyed()) );
<a name="l01172"></a>01172 accelList.<a class="codeRef" href="qvaluelist.html#remove">remove</a>(itr);
<a name="l01173"></a>01173 <span class="keywordflow">return</span>;
<a name="l01174"></a>01174 }
<a name="l01175"></a>01175 }
<a name="l01176"></a>01176
<a name="l01177"></a>01177 <span class="keywordtype">int</span> i;
<a name="l01178"></a>01178 <span class="keywordflow">do</span>
<a name="l01179"></a>01179 {
<a name="l01180"></a>01180 i = findContainer( static_cast<const QWidget*>( o ) );
<a name="l01181"></a>01181 <span class="keywordflow">if</span> ( i != -1 )
<a name="l01182"></a>01182 removeContainer( i );
<a name="l01183"></a>01183 } <span class="keywordflow">while</span> ( i != -1 );
<a name="l01184"></a>01184 }
<a name="l01185"></a>01185
<a name="l01186"></a>01186 <span class="keywordtype">int</span> KAction::findContainer( <span class="keyword">const</span> <a class="codeRef" href="qwidget.html">QWidget</a>* widget )<span class="keyword"> const</span>
<a name="l01187"></a>01187 <span class="keyword"></span>{
<a name="l01188"></a>01188 <span class="keywordtype">int</span> pos = 0;
<a name="l01189"></a>01189
<a name="l01190"></a>01190 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KActionPrivate::Container></a> & containers = d->m_containers;
<a name="l01191"></a>01191
<a name="l01192"></a>01192 <a class="codeRef" href="qvaluelist.html">QValueList<KActionPrivate::Container>::ConstIterator</a> it = containers.<a class="codeRef" href="qvaluelist.html#constBegin">constBegin</a>();
<a name="l01193"></a>01193 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KActionPrivate::Container>::ConstIterator</a> itEnd = containers.<a class="codeRef" href="qvaluelist.html#constEnd">constEnd</a>();
<a name="l01194"></a>01194
<a name="l01195"></a>01195 <span class="keywordflow">while</span>( it != itEnd )
<a name="l01196"></a>01196 {
<a name="l01197"></a>01197 <span class="keywordflow">if</span> ( (*it).m_representative == widget || (*it).m_container == widget )
<a name="l01198"></a>01198 <span class="keywordflow">return</span> pos;
<a name="l01199"></a>01199 ++it;
<a name="l01200"></a>01200 ++pos;
<a name="l01201"></a>01201 }
<a name="l01202"></a>01202
<a name="l01203"></a>01203 <span class="keywordflow">return</span> -1;
<a name="l01204"></a>01204 }
<a name="l01205"></a>01205
<a name="l01206"></a>01206 <span class="keywordtype">int</span> KAction::findContainer( <span class="keyword">const</span> <span class="keywordtype">int</span> <span class="keywordtype">id</span> )<span class="keyword"> const</span>
<a name="l01207"></a>01207 <span class="keyword"></span>{
<a name="l01208"></a>01208 <span class="keywordtype">int</span> pos = 0;
<a name="l01209"></a>01209
<a name="l01210"></a>01210 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KActionPrivate::Container></a> & containers = d->m_containers;
<a name="l01211"></a>01211
<a name="l01212"></a>01212 <a class="codeRef" href="qvaluelist.html">QValueList<KActionPrivate::Container>::ConstIterator</a> it = containers.<a class="codeRef" href="qvaluelist.html#constBegin">constBegin</a>();
<a name="l01213"></a>01213 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KActionPrivate::Container>::ConstIterator</a> itEnd = containers.<a class="codeRef" href="qvaluelist.html#constEnd">constEnd</a>();
<a name="l01214"></a>01214
<a name="l01215"></a>01215 <span class="keywordflow">while</span>( it != itEnd )
<a name="l01216"></a>01216 {
<a name="l01217"></a>01217 <span class="keywordflow">if</span> ( (*it).m_id == <span class="keywordtype">id</span> )
<a name="l01218"></a>01218 <span class="keywordflow">return</span> pos;
<a name="l01219"></a>01219 ++it;
<a name="l01220"></a>01220 ++pos;
<a name="l01221"></a>01221 }
<a name="l01222"></a>01222
<a name="l01223"></a>01223 <span class="keywordflow">return</span> -1;
<a name="l01224"></a>01224 }
<a name="l01225"></a>01225
<a name="l01226"></a>01226 <span class="keywordtype">void</span> KAction::removeContainer( <span class="keywordtype">int</span> index )
<a name="l01227"></a>01227 {
<a name="l01228"></a>01228 <span class="keywordtype">int</span> i = 0;
<a name="l01229"></a>01229
<a name="l01230"></a>01230 <a class="codeRef" href="qvaluelist.html">QValueList<KActionPrivate::Container></a> & containers = d->m_containers;
<a name="l01231"></a>01231
<a name="l01232"></a>01232 <a class="codeRef" href="qvaluelist.html">QValueList<KActionPrivate::Container>::Iterator</a> it = containers.<a class="codeRef" href="qvaluelist.html#begin">begin</a>();
<a name="l01233"></a>01233 <span class="keyword">const</span> <a class="codeRef" href="qvaluelist.html">QValueList<KActionPrivate::Container>::Iterator</a> itEnd = containers.<a class="codeRef" href="qvaluelist.html#end">end</a>();
<a name="l01234"></a>01234
<a name="l01235"></a>01235 <span class="keywordflow">while</span>( it != itEnd )
<a name="l01236"></a>01236 {
<a name="l01237"></a>01237 <span class="keywordflow">if</span> ( i == index )
<a name="l01238"></a>01238 {
<a name="l01239"></a>01239 containers.<a class="codeRef" href="qvaluelist.html#remove">remove</a>( it );
<a name="l01240"></a>01240 <span class="keywordflow">return</span>;
<a name="l01241"></a>01241 }
<a name="l01242"></a>01242 ++it;
<a name="l01243"></a>01243 ++i;
<a name="l01244"></a>01244 }
<a name="l01245"></a>01245 }
<a name="l01246"></a>01246
<a name="l01247"></a>01247 <span class="comment">// FIXME: Remove this (ellis)</span>
<a name="l01248"></a>01248 <span class="keywordtype">void</span> KAction::slotKeycodeChanged()
<a name="l01249"></a>01249 {
<a name="l01250"></a>01250 <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#gafbb9aa4a84d6c0563d46550454b9714b">kdDebug</a>(129) << <span class="stringliteral">"KAction::slotKeycodeChanged()"</span> << <a class="codeRef" doxygen="kdecore.tag:../../kdecore/html/" href="../../kdecore/html/group__kdebug.html#ga313d520ed8f8f6b46eeef22cfb3b082a">endl</a>; <span class="comment">// -- ellis</span>
<a name="l01251"></a>01251 KAccelAction* pAction = d->m_kaccel->actions().actionPtr(<a class="codeRef" href="qobject.html#name">name</a>());
<a name="l01252"></a>01252 <span class="keywordflow">if</span>( pAction )
<a name="l01253"></a>01253 <a class="code" href="classKAction.html#abf0c9e98f1686c4117e79184bdc646a2" title="Sets the keyboard shortcut associated with this action.">setShortcut</a>(pAction->shortcut());
<a name="l01254"></a>01254 }
<a name="l01255"></a>01255
<a name="l01256"></a>01256 <a class="code" href="classKActionCollection.html" title="A managed set of KAction objects.">KActionCollection</a> *KAction::parentCollection()<span class="keyword"> const</span>
<a name="l01257"></a>01257 <span class="keyword"></span>{
<a name="l01258"></a>01258 <span class="keywordflow">return</span> m_parentCollection;
<a name="l01259"></a>01259 }
<a name="l01260"></a>01260
<a name="l01261"></a>01261 <span class="keywordtype">void</span> KAction::unplugAll()
<a name="l01262"></a>01262 {
<a name="l01263"></a>01263 <span class="keywordflow">while</span> ( containerCount() != 0 )
<a name="l01264"></a>01264 <a class="code" href="classKAction.html#accac212cc07184ac4f8ba2cabdba6396" title=""Unplug" or remove this action from a given widget.">unplug</a>( container( 0 ) );
<a name="l01265"></a>01265 }
<a name="l01266"></a>01266
<a name="l01267"></a><a class="code" href="classKAction.html#aaf3239ecd9f606877ac9cfbaf1e90acd">01267</a> <span class="keyword">const</span> <a class="code" href="classKGuiItem.html" title="An abstract class for GUI data such as ToolTip and Icon.">KGuiItem</a>& <a class="code" href="classKAction.html#aaf3239ecd9f606877ac9cfbaf1e90acd" title="Return the underlying KGuiItem.">KAction::guiItem</a>()<span class="keyword"> const</span>
<a name="l01268"></a>01268 <span class="keyword"></span>{
<a name="l01269"></a>01269 <span class="keywordflow">return</span> *d;
<a name="l01270"></a>01270 }
<a name="l01271"></a>01271
<a name="l01272"></a>01272 <span class="keywordtype">void</span> KAction::virtual_hook( <span class="keywordtype">int</span>, <span class="keywordtype">void</span>* )
<a name="l01273"></a>01273 { <span class="comment">/*BASE::virtual_hook( id, data );*/</span> }
<a name="l01274"></a>01274
<a name="l01275"></a>01275 <span class="comment">/* vim: et sw=2 ts=2</span>
<a name="l01276"></a>01276 <span class="comment"> */</span>
<a name="l01277"></a>01277
<a name="l01278"></a>01278 <span class="preprocessor">#include "kaction.moc"</span>
</pre></div></div>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>kdeui</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
<option value="classKAboutApplication.html">kaboutapplication</option>, <option value="classKAboutContainer.html">kaboutcontainer</option>, <option value="classKAboutContainerBase.html">kaboutcontainerbase</option>, <option value="classKAboutContributor.html">kaboutcontributor</option>, <option value="classKAboutDialog.html">kaboutdialog</option>, <option value="classKAboutKDE.html">kaboutkde</option>, <option value="classKAboutWidget.html">kaboutwidget</option>, <option value="classKAccelGen_1_1Deref.html">kaccelgen::deref</option>, <option value="classKAccelGen_1_1Deref__Key.html">kaccelgen::deref__key</option>, <option value="classKAction.html">kaction</option>, <option value="classKActionCollection.html">kactioncollection</option>, <option value="classKActionMenu.html">kactionmenu</option>, <option value="classKActionSelector.html">kactionselector</option>, <option value="classKActiveLabel.html">kactivelabel</option>, <option value="classKAnimWidget.html">kanimwidget</option>, <option value="classKArrowButton.html">karrowbutton</option>, <option value="classKAuthIcon.html">kauthicon</option>, <option value="classKBugReport.html">kbugreport</option>, <option value="classKButtonBox.html">kbuttonbox</option>, <option value="classKCharSelect.html">kcharselect</option>, <option value="classKCharSelectTable.html">kcharselecttable</option>, <option value="classKCModule.html">kcmodule</option>, <option value="classKColor.html">kcolor</option>, <option value="classKColorButton.html">kcolorbutton</option>, <option value="classKColorCells.html">kcolorcells</option>, <option value="classKColorCombo.html">kcolorcombo</option>, <option value="classKColorDialog.html">kcolordialog</option>, <option value="classKColorDrag.html">kcolordrag</option>, <option value="classKColorPatch.html">kcolorpatch</option>, <option value="classKComboBox.html">kcombobox</option>, <option value="classKCommand.html">kcommand</option>, <option value="classKCommandHistory.html">kcommandhistory</option>, <option value="classKCompletionBox.html">kcompletionbox</option>, <option value="classKConfigDialog.html">kconfigdialog</option>, <option value="classKContextMenuManager.html">kcontextmenumanager</option>, <option value="classKCursor.html">kcursor</option>, <option value="classKCursorPrivate.html">kcursorprivate</option>, <option value="classKCursorPrivateAutoHideEventFilter.html">kcursorprivateautohideeventfilter</option>, <option value="classKDateInternalMonthPicker.html">kdateinternalmonthpicker</option>, <option value="classKDateInternalWeekSelector.html">kdateinternalweekselector</option>, <option value="classKDateInternalYearSelector.html">kdateinternalyearselector</option>, <option value="classKDatePicker.html">kdatepicker</option>, <option value="classKDateTable.html">kdatetable</option>, <option value="classKDateTimeWidget.html">kdatetimewidget</option>, <option value="classKDateValidator.html">kdatevalidator</option>, <option value="classKDateWidget.html">kdatewidget</option>, <option value="classKDCOPActionProxy.html">kdcopactionproxy</option>, <option value="classKDEPrivate_1_1ToolBarHandler.html">kdeprivate::toolbarhandler</option>, <option value="classKDialog.html">kdialog</option>, <option value="classKDialogBase.html">kdialogbase</option>, <option value="classKDialogBaseButton.html">kdialogbasebutton</option>, <option value="classKDialogBaseTile.html">kdialogbasetile</option>, <option value="classKDictSpellingHighlighter.html">kdictspellinghighlighter</option>, <option value="classKDockButton__Private.html">kdockbutton__private</option>, <option value="classKDockMainWindow.html">kdockmainwindow</option>, <option value="classKDockManager.html">kdockmanager</option>, <option value="classKDockSplitter.html">kdocksplitter</option>, <option value="classKDockTabGroup.html">kdocktabgroup</option>, <option value="classKDockWidget.html">kdockwidget</option>, <option value="classKDockWidgetAbstractHeader.html">kdockwidgetabstractheader</option>, <option value="classKDockWidgetAbstractHeaderDrag.html">kdockwidgetabstractheaderdrag</option>, <option value="classKDockWidgetHeader.html">kdockwidgetheader</option>, <option value="classKDockWidgetHeaderDrag.html">kdockwidgetheaderdrag</option>, <option value="classKDockWidgetPrivate.html">kdockwidgetprivate</option>, <option value="classKDockWindow.html">kdockwindow</option>, <option value="classKDoubleNumInput.html">kdoublenuminput</option>, <option value="classKDoubleSpinBox.html">kdoublespinbox</option>, <option value="classKDoubleValidator.html">kdoublevalidator</option>, <option value="classKDualColorButton.html">kdualcolorbutton</option>, <option value="classKEdit.html">kedit</option>, <option value="classKEditListBox.html">keditlistbox</option>, <option value="classKEditListBox_1_1CustomEditor.html">keditlistbox::customeditor</option>, <option value="classKEditToolbar.html">kedittoolbar</option>, <option value="classKEditToolbarWidget.html">kedittoolbarwidget</option>, <option value="classKFloatValidator.html">kfloatvalidator</option>, <option value="classKFontChooser.html">kfontchooser</option>, <option value="classKFontCombo.html">kfontcombo</option>, <option value="classKFontDialog.html">kfontdialog</option>, <option value="classKFontRequester.html">kfontrequester</option>, <option value="classKGradientSelector.html">kgradientselector</option>, <option value="classKGuiItem.html">kguiitem</option>, <option value="classKHelpMenu.html">khelpmenu</option>, <option value="classKHistoryCombo.html">khistorycombo</option>, <option value="classKHSSelector.html">khsselector</option>, <option value="classKIconView.html">kiconview</option>, <option value="classKIconViewItem.html">kiconviewitem</option>, <option value="classKIconViewSearchLine.html">kiconviewsearchline</option>, <option value="classKImageTrackLabel.html">kimagetracklabel</option>, <option value="classKInputDialog.html">kinputdialog</option>, <option value="classKIntNumInput.html">kintnuminput</option>, <option value="classKIntSpinBox.html">kintspinbox</option>, <option value="classKIntValidator.html">kintvalidator</option>, <option value="classKJanusWidget.html">kjanuswidget</option>, <option value="classKKeyButton.html">kkeybutton</option>, <option value="classKKeyChooser.html">kkeychooser</option>, <option value="classKKeyDialog.html">kkeydialog</option>, <option value="classKLanguageButton.html">klanguagebutton</option>, <option value="classKLed.html">kled</option>, <option value="classKLineEdit.html">klineedit</option>, <option value="classKLineEditDlg.html">klineeditdlg</option>, <option value="classKListAction.html">klistaction</option>, <option value="classKListBox.html">klistbox</option>, <option value="classKListView.html">klistview</option>, <option value="classKListViewItem.html">klistviewitem</option>, <option value="classKListViewLineEdit.html">klistviewlineedit</option>, <option value="classKListViewSearchLine.html">klistviewsearchline</option>, <option value="classKListViewSearchLineWidget.html">klistviewsearchlinewidget</option>, <option value="classKMacroCommand.html">kmacrocommand</option>, <option value="classKMainWindow.html">kmainwindow</option>, <option value="classKMainWindowInterface.html">kmainwindowinterface</option>, <option value="classKMenuBar.html">kmenubar</option>, <option value="classKMessageBox.html">kmessagebox</option>, <option value="classKMimeTypeValidator.html">kmimetypevalidator</option>, <option value="classKNamedCommand.html">knamedcommand</option>, <option value="classKNumInput.html">knuminput</option>, <option value="classKPaletteTable.html">kpalettetable</option>, <option value="classKPanelApplet.html">kpanelapplet</option>, <option value="classKPanelAppMenu.html">kpanelappmenu</option>, <option value="classKPanelExtension.html">kpanelextension</option>, <option value="classKPanelMenu.html">kpanelmenu</option>, <option value="classKPassivePopup.html">kpassivepopup</option>, <option value="classKPasswordDialog.html">kpassworddialog</option>, <option value="classKPasswordEdit.html">kpasswordedit</option>, <option value="classKPasteTextAction.html">kpastetextaction</option>, <option value="classKPixmapIO.html">kpixmapio</option>, <option value="classKPixmapRegionSelectorDialog.html">kpixmapregionselectordialog</option>, <option value="classKPixmapRegionSelectorWidget.html">kpixmapregionselectorwidget</option>, <option value="classKPopupFrame.html">kpopupframe</option>, <option value="classKPopupMenu.html">kpopupmenu</option>, <option value="classKPopupTitle.html">kpopuptitle</option>, <option value="classKProgress.html">kprogress</option>, <option value="classKProgressDialog.html">kprogressdialog</option>, <option value="classKPushButton.html">kpushbutton</option>, <option value="classKRadioAction.html">kradioaction</option>, <option value="classKRecentFilesAction.html">krecentfilesaction</option>, <option value="classKRestrictedLine.html">krestrictedline</option>, <option value="classKRootPermsIcon.html">krootpermsicon</option>, <option value="classKRootPixmap.html">krootpixmap</option>, <option value="classKRuler.html">kruler</option>, <option value="classKScrollView.html">kscrollview</option>, <option value="classKSelectAction.html">kselectaction</option>, <option value="classKSelector.html">kselector</option>, <option value="classKSeparator.html">kseparator</option>, <option value="classKShortcutDialog.html">kshortcutdialog</option>, <option value="classKSpell.html">kspell</option>, <option value="classKSpellConfig.html">kspellconfig</option>, <option value="classKSplashScreen.html">ksplashscreen</option>, <option value="classKSqueezedTextLabel.html">ksqueezedtextlabel</option>, <option value="classKStatusBar.html">kstatusbar</option>, <option value="classKStatusBarLabel.html">kstatusbarlabel</option>, <option value="classKStdGuiItem.html">kstdguiitem</option>, <option value="classKStringListValidator.html">kstringlistvalidator</option>, <option value="classKSwitchLanguageDialog.html">kswitchlanguagedialog</option>, <option value="classKSyntaxHighlighter.html">ksyntaxhighlighter</option>, <option value="classKSystemTray.html">ksystemtray</option>, <option value="classKTabBar.html">ktabbar</option>, <option value="classKTabCtl.html">ktabctl</option>, <option value="classKTabWidget.html">ktabwidget</option>, <option value="classKTextBrowser.html">ktextbrowser</option>, <option value="classKTextEdit.html">ktextedit</option>, <option value="classKTimeWidget.html">ktimewidget</option>, <option value="classKTimezoneWidget.html">ktimezonewidget</option>, <option value="classKTipDatabase.html">ktipdatabase</option>, <option value="classKTipDialog.html">ktipdialog</option>, <option value="classKToggleAction.html">ktoggleaction</option>, <option value="classKToggleFullScreenAction.html">ktogglefullscreenaction</option>, <option value="classKToggleToolBarAction.html">ktoggletoolbaraction</option>, <option value="classKToolBar.html">ktoolbar</option>, <option value="classKToolBarButton.html">ktoolbarbutton</option>, <option value="classKToolBarButtonList.html">ktoolbarbuttonlist</option>, <option value="classKToolBarLabelAction.html">ktoolbarlabelaction</option>, <option value="classKToolBarPopupAction.html">ktoolbarpopupaction</option>, <option value="classKToolBarRadioGroup.html">ktoolbarradiogroup</option>, <option value="classKURLLabel.html">kurllabel</option>, <option value="classKValueSelector.html">kvalueselector</option>, <option value="classKWidgetAction.html">kwidgetaction</option>, <option value="classKWindowInfo.html">kwindowinfo</option>, <option value="classKWizard.html">kwizard</option>, <option value="classKWordWrap.html">kwordwrap</option>, <option value="classKWritePermsIcon.html">kwritepermsicon</option>, <option value="classKXMLGUIBuilder.html">kxmlguibuilder</option>, <option value="classKXMLGUIClient.html">kxmlguiclient</option>, <option value="classKXMLGUIFactory.html">kxmlguifactory</option>, <option value="classKXYSelector.html">kxyselector</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../arts/html/index.html">arts</a></li><li><a href="../../dcop/html/index.html">dcop</a></li><li><a href="../../dnssd/html/index.html">dnssd</a></li><li><a href="../../interfaces/html/index.html">interfaces</a></li><li> <a href="../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li> <a href="../../interfaces/kimproxy/library/html/index.html">library</a></li><li> <a href="../../interfaces/kspeech/html/index.html">kspeech</a></li><li> <a href="../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kate/html/index.html">kate</a></li><li><a href="../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../kdecore/html/index.html">kdecore</a></li><li><a href="../../kded/html/index.html">kded</a></li><li><a href="../../kdefx/html/index.html">kdefx</a></li><li><a href="../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../kdesu/html/index.html">kdesu</a></li><li><a href="../../kdeui/html/index.html">kdeui</a></li><li><a href="../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../khtml/html/index.html">khtml</a></li><li><a href="../../kimgio/html/index.html">kimgio</a></li><li><a href="../../kinit/html/index.html">kinit</a></li><li><a href="../../kio/html/index.html">kio</a></li><li> <a href="../../kio/bookmarks/html/index.html">bookmarks</a></li><li> <a href="../../kio/httpfilter/html/index.html">httpfilter</a></li><li> <a href="../../kio/kfile/html/index.html">kfile</a></li><li> <a href="../../kio/kio/html/index.html">kio</a></li><li> <a href="../../kio/kioexec/html/index.html">kioexec</a></li><li> <a href="../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li> <a href="../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../kioslave/http/html/index.html">http</a></li><li><a href="../../kjs/html/index.html">kjs</a></li><li><a href="../../kmdi/html/index.html">kmdi</a></li><li> <a href="../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../kparts/html/index.html">kparts</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../kspell2/html/index.html">kspell2</a></li><li><a href="../../kunittest/html/index.html">kunittest</a></li><li><a href="../../kutils/html/index.html">kutils</a></li><li><a href="../../kwallet/html/index.html">kwallet</a></li><li><a href="../../libkmid/html/index.html">libkmid</a></li><li><a href="../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>
</td>
</tr>
</table>
<span class="doNotDisplay">
<a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
<a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
<a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>
<div style="height: 8px"></div>
<div id="footer">
<div id="footer_left">
Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a>
and
<a href="mailto:winter@kde.org">Allen Winter</a>.
<br/>
KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a>
</div>
<div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
