kdecore Library API Documentation

kstdaccel.cpp

00001 /* This file is part of the KDE libraries 00002 Copyright (C) 1997 Stefan Taferner (taferner@alpin.or.at) 00003 Copyright (C) 2000 Nicolas Hadacek (haadcek@kde.org) 00004 Copyright (C) 2001,2002 Ellis Whitehead (ellis@kde.org) 00005 00006 This library is free software; you can redistribute it and/or 00007 modify it under the terms of the GNU Library General Public 00008 License version 2 as published by the Free Software Foundation. 00009 00010 This library is distributed in the hope that it will be useful, 00011 but WITHOUT ANY WARRANTY; without even the implied warranty of 00012 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 00013 Library General Public License for more details. 00014 00015 You should have received a copy of the GNU Library General Public License 00016 along with this library; see the file COPYING.LIB. If not, write to 00017 the Free Software Foundation, Inc., 59 Temple Place - Suite 330, 00018 Boston, MA 02111-1307, USA. 00019 */ 00020 #define __KSTDACCEL_CPP_ 1 00021 00022 #include "kstdaccel.h" 00023 00024 #include "kaccelaction.h" 00025 #include "kaccelbase.h" 00026 #include <kconfig.h> 00027 #include <kdebug.h> 00028 #include <kglobal.h> 00029 #include <klocale.h> 00030 #include <kshortcut.h> 00031 #include <kshortcutlist.h> 00032 00033 namespace KStdAccel 00034 { 00035 00036 struct KStdAccelInfo 00037 { 00038 StdAccel id; 00039 const char* psName; 00040 const char* psDesc; 00041 int cutDefault, cutDefault4, cutDefault3B, cutDefault4B; 00042 KShortcut cut; 00043 bool bInitialized; 00044 }; 00045 00046 static KStdAccelInfo g_infoStdAccel[] = 00047 { 00048 {AccelNone, "Group:File", I18N_NOOP("File"), 0, 0, 0, 0, KShortcut(), false }, 00049 { Open, I18N_NOOP("Open"), 0, Qt::CTRL+Qt::Key_O, 0, 0, 0, KShortcut(), false }, 00050 { New, I18N_NOOP("New"), 0, Qt::CTRL+Qt::Key_N, 0, 0, 0, KShortcut(), false }, 00051 { Close, I18N_NOOP("Close"), 0, Qt::CTRL+Qt::Key_W, Qt::CTRL+Qt::Key_Escape, 0, Qt::CTRL+Qt::Key_W, KShortcut(), false }, 00052 { Save, I18N_NOOP("Save"), 0, Qt::CTRL+Qt::Key_S, 0, 0, 0, KShortcut(), false }, 00053 { Print, I18N_NOOP("Print"), 0, Qt::CTRL+Qt::Key_P, 0, 0, 0, KShortcut(), false }, 00054 { Quit, I18N_NOOP("Quit"), 0, Qt::CTRL+Qt::Key_Q, 0, 0, 0, KShortcut(), false }, 00055 {AccelNone, "Group:Edit", I18N_NOOP("Edit"), 0, 0, 0, 0, KShortcut(), false }, 00056 { Undo, I18N_NOOP("Undo"), 0, Qt::CTRL+Qt::Key_Z, 0, 0, 0, KShortcut(), false }, 00057 { Redo, I18N_NOOP("Redo"), 0, Qt::CTRL+Qt::SHIFT+Qt::Key_Z, 0, 0, 0, KShortcut(), false }, 00058 { Cut, I18N_NOOP("Cut"), 0, Qt::CTRL+Qt::Key_X, 0, Qt::SHIFT+Qt::Key_Delete, 0, KShortcut(), false }, 00059 { Copy, I18N_NOOP("Copy"), 0, Qt::CTRL+Qt::Key_C, 0, Qt::CTRL+Qt::Key_Insert, 0, KShortcut(), false }, 00060 { Paste, I18N_NOOP("Paste"), 0, Qt::CTRL+Qt::Key_V, 0, Qt::SHIFT+Qt::Key_Insert, 0, KShortcut(), false }, 00061 { SelectAll, "SelectAll", I18N_NOOP("Select All"), Qt::CTRL+Qt::Key_A, 0, 0, 0, KShortcut(), false }, 00062 { Deselect, I18N_NOOP("Deselect"), 0, Qt::CTRL+Qt::SHIFT+Qt::Key_A, 0, 0, 0, KShortcut(), false }, 00063 { DeleteWordBack, "DeleteWordBack", I18N_NOOP("Delete Word Backwards"), Qt::CTRL+Qt::Key_Backspace, 0, 0, 0, KShortcut(), false }, 00064 { DeleteWordForward, "DeleteWordForward", I18N_NOOP("Delete Word Forward"), Qt::CTRL+Qt::Key_Delete, 0, 0, 0, KShortcut(), false }, 00065 { Find, I18N_NOOP("Find"), 0, Qt::CTRL+Qt::Key_F, 0, 0, 0, KShortcut(), false }, 00066 { FindNext, "FindNext", I18N_NOOP("Find Next"), Qt::Key_F3, 0, 0, 0, KShortcut(), false }, 00067 { FindPrev, "FindPrev", I18N_NOOP("Find Prev"), Qt::SHIFT+Qt::Key_F3, 0, 0, 0, KShortcut(), false }, 00068 { Replace, I18N_NOOP("Replace"), 0, Qt::CTRL+Qt::Key_R, 0, 0, 0, KShortcut(), false }, 00069 {AccelNone, "Group:Navigation", I18N_NOOP("Navigation"), 0, 0, 0, 0, KShortcut(), false }, 00070 { Home, I18N_NOOP("Home"), 0, Qt::CTRL+Qt::Key_Home, 0, 0, 0, KShortcut(), false }, 00071 { End, I18N_NOOP("End"), 0, Qt::CTRL+Qt::Key_End, 0, 0, 0, KShortcut(), false }, 00072 { BeginningOfLine, "BeginningOfLine", I18N_NOOP("Beginning of Line"), Qt::Key_Home, 0, 0, 0, KShortcut(), false}, 00073 { EndOfLine, "EndOfLine", I18N_NOOP("End of Line"), Qt::Key_End, 0, 0, 0, KShortcut(), false}, 00074 { Prior, I18N_NOOP("Prior"), 0, Qt::Key_Prior, 0, 0, 0, KShortcut(), false }, 00075 { Next, I18N_NOOP("Next"), 0, Qt::Key_Next, 0, 0, 0, KShortcut(), false }, 00076 { GotoLine, "GotoLine", I18N_NOOP("Go to Line"), Qt::CTRL+Qt::Key_G, 0, 0, 0, KShortcut(), false }, 00077 { AddBookmark, "AddBookmark", I18N_NOOP("Add Bookmark"), Qt::CTRL+Qt::Key_B, 0, 0, 0, KShortcut(), false }, 00078 { ZoomIn, "ZoomIn", I18N_NOOP("Zoom In"), Qt::CTRL+Qt::Key_Plus, 0, 0, 0, KShortcut(), false }, 00079 { ZoomOut, "ZoomOut", I18N_NOOP("Zoom Out"), Qt::CTRL+Qt::Key_Minus, 0, 0, 0, KShortcut(), false }, 00080 { Up, I18N_NOOP("Up"), 0, Qt::ALT+Qt::Key_Up, 0, 0, 0, KShortcut(), false }, 00081 { Back, I18N_NOOP("Back"), 0, Qt::ALT+Qt::Key_Left, 0, 0, 0, KShortcut(), false }, 00082 { Forward, I18N_NOOP("Forward"), 0, Qt::ALT+Qt::Key_Right, 0, 0, 0, KShortcut(), false }, 00083 { Reload, I18N_NOOP("Reload"), 0, Qt::Key_F5, 0, 0, 0, KShortcut(), false }, 00084 { PopupMenuContext, "PopupMenuContext", I18N_NOOP("Popup Menu Context"), Qt::Key_Menu, 0, 0, 0, KShortcut(), false }, 00085 { ShowMenubar, "ShowMenubar", I18N_NOOP("Show Menu Bar"), Qt::CTRL+Qt::Key_M, 0, 0, 0, KShortcut(), false }, 00086 { BackwardWord, "BackwardWord", I18N_NOOP("Backward Word"), Qt::CTRL+Qt::Key_Left, 0, 0, 0, KShortcut(), false }, 00087 { ForwardWord, "ForwardWord", I18N_NOOP("Forward Word"), Qt::CTRL+Qt::Key_Right, 0, 0, 0, KShortcut(), false }, 00088 { TabNext, I18N_NOOP("Activate Next Tab"), 0, Qt::CTRL+Qt::Key_Period, 0, Qt::CTRL+Qt::Key_BracketRight, 0, KShortcut(), false }, 00089 { TabPrev, I18N_NOOP("Activate Previous Tab"), 0, Qt::CTRL+Qt::Key_Comma, 0, Qt::CTRL+Qt::Key_BracketLeft, 0, KShortcut(), false }, 00090 { FullScreen, "FullScreen", I18N_NOOP("Full Screen Mode"), Qt::CTRL+Qt::SHIFT+Qt::Key_F, 0, 0, 0, KShortcut(), false }, 00091 {AccelNone, "Group:Help", I18N_NOOP("Help"), 0, 0, 0, 0, KShortcut(), false }, 00092 { Help, I18N_NOOP("Help"), 0, Qt::Key_F1, 0, 0, 0, KShortcut(), false }, 00093 { WhatsThis, "WhatsThis", I18N_NOOP("What's This"), Qt::SHIFT+Qt::Key_F1, 0, 0, 0, KShortcut(), false }, 00094 {AccelNone, "Group:TextCompletion", I18N_NOOP("Text Completion"), 0, 0, 0, 0, KShortcut(), false }, 00095 { TextCompletion, "TextCompletion", I18N_NOOP("Text Completion"), Qt::CTRL+Qt::Key_E, 0, 0, 0, KShortcut(), false }, 00096 { PrevCompletion, "PrevCompletion", I18N_NOOP("Previous Completion Match"), Qt::CTRL+Qt::Key_Up, 0, 0, 0, KShortcut(), false }, 00097 { NextCompletion, "NextCompletion", I18N_NOOP("Next Completion Match"), Qt::CTRL+Qt::Key_Down, 0, 0, 0, KShortcut(), false }, 00098 { SubstringCompletion, "SubstringCompletion", I18N_NOOP("Substring Completion"), Qt::CTRL+Qt::Key_T, 0, 0, 0, KShortcut(), false }, 00099 { RotateUp, "RotateUp", I18N_NOOP("Previous Item in List"), Qt::Key_Up, 0, 0, 0, KShortcut(), false }, 00100 { RotateDown, "RotateDown", I18N_NOOP("Next Item in List"), Qt::Key_Down, 0, 0, 0, KShortcut(), false }, 00101 { AccelNone, 0, 0, 0, 0, 0, 0, KShortcut(), false } 00102 }; 00103 00104 static KStdAccelInfo* infoPtr( StdAccel id ) 00105 { 00106 if( id != AccelNone ) { 00107 // Linear search. Changing the data structure doesn't seem possible 00108 // (since we need groups for the config stuff), but maybe a little 00109 // additional hashtable wouldn't hurt. 00110 for( uint i = 0; g_infoStdAccel[i].psName != 0; i++ ) { 00111 if( g_infoStdAccel[i].id == id ) 00112 return &g_infoStdAccel[i]; 00113 } 00114 } 00115 return 0; 00116 } 00117 00118 static void initialize( StdAccel id ) 00119 { 00120 KConfigGroupSaver saver( KGlobal::config(), "Shortcuts" ); 00121 KStdAccelInfo* pInfo = infoPtr( id ); 00122 00123 if( !pInfo ) { 00124 kdWarning(125) << "KStdAccel: id not found!" << endl; // -- ellis 00125 return; 00126 } 00127 00128 if( saver.config()->hasKey( pInfo->psName ) ) { 00129 QString s = saver.config()->readEntry( pInfo->psName ); 00130 if( s != "none" ) 00131 pInfo->cut.init( s ); 00132 else 00133 pInfo->cut.clear(); 00134 } else 00135 pInfo->cut = shortcutDefault( id ); 00136 pInfo->bInitialized = true; 00137 } 00138 00139 QString name( StdAccel id ) 00140 { 00141 KStdAccelInfo* pInfo = infoPtr( id ); 00142 if( !pInfo ) 00143 return QString::null; 00144 return pInfo->psName; 00145 } 00146 00147 QString label( StdAccel id ) 00148 { 00149 KStdAccelInfo* pInfo = infoPtr( id ); 00150 if( !pInfo ) 00151 return QString::null; 00152 return i18n((pInfo->psDesc) ? pInfo->psDesc : pInfo->psName); 00153 } 00154 00155 // TODO: Add psWhatsThis entry to KStdAccelInfo 00156 QString whatsThis( StdAccel /*id*/ ) 00157 { 00158 // KStdAccelInfo* pInfo = infoPtr( id ); 00159 // if( pInfo && pInfo->psWhatsThis ) 00160 // return i18n(pInfo->psWhatsThis); 00161 // else 00162 return QString::null; 00163 } 00164 00165 const KShortcut& shortcut( StdAccel id ) 00166 { 00167 KStdAccelInfo* pInfo = infoPtr( id ); 00168 if( !pInfo ) 00169 return KShortcut::null(); 00170 00171 if( !pInfo->bInitialized ) 00172 initialize( id ); 00173 00174 return pInfo->cut; 00175 } 00176 00177 StdAccel findStdAccel( const KKeySequence& seq ) 00178 { 00179 if( !seq.isNull() ) { 00180 for( uint i = 0; g_infoStdAccel[i].psName != 0; i++ ) { 00181 StdAccel id = g_infoStdAccel[i].id; 00182 if( id != AccelNone ) { 00183 if( !g_infoStdAccel[i].bInitialized ) 00184 initialize( id ); 00185 if( g_infoStdAccel[i].cut.contains( seq ) ) 00186 return id; 00187 } 00188 } 00189 } 00190 return AccelNone; 00191 } 00192 00193 KShortcut shortcutDefault( StdAccel id ) 00194 { 00195 return (KAccelAction::useFourModifierKeys()) 00196 ? shortcutDefault4(id) : shortcutDefault3(id); 00197 } 00198 00199 KShortcut shortcutDefault3( StdAccel id ) 00200 { 00201 KShortcut cut; 00202 00203 KStdAccelInfo* pInfo = infoPtr( id ); 00204 if( pInfo ) { 00205 if( pInfo->cutDefault ) 00206 cut.init( pInfo->cutDefault ); 00207 // FIXME: if there is no cutDefault, then this we be made the primary 00208 // instead of alternate shortcut. 00209 if( pInfo->cutDefault3B ) 00210 cut.append( KKey(pInfo->cutDefault3B) ); 00211 } 00212 00213 return cut; 00214 } 00215 00216 KShortcut shortcutDefault4( StdAccel id ) 00217 { 00218 KShortcut cut; 00219 00220 KStdAccelInfo* pInfo = infoPtr( id ); 00221 if( pInfo ) { 00222 KStdAccelInfo& info = *pInfo; 00223 KKeySequence key2; 00224 00225 cut.init( (info.cutDefault4) ? 00226 QKeySequence(info.cutDefault) : QKeySequence(info.cutDefault4) ); 00227 00228 if( info.cutDefault4B ) 00229 key2.init( QKeySequence(info.cutDefault4B) ); 00230 else if( info.cutDefault3B ) 00231 key2.init( QKeySequence(info.cutDefault3B) ); 00232 00233 if( key2.count() ) 00234 cut.append( key2 ); 00235 } 00236 00237 return cut; 00238 } 00239 00240 #if 0 // unused 00241 void createAccelActions( KAccelActions& actions ) 00242 { 00243 actions.clear(); 00244 00245 for( uint i = 0; g_infoStdAccel[i].psName != 0; i++ ) { 00246 StdAccel id = g_infoStdAccel[i].id; 00247 KStdAccelInfo* pInfo = &g_infoStdAccel[i]; 00248 00249 if( id != AccelNone ) { 00250 actions.insert( pInfo->psName, 00251 i18n((pInfo->psDesc) ? pInfo->psDesc : pInfo->psName), 00252 QString::null, // pInfo->psWhatsThis, 00253 shortcutDefault3(id), 00254 shortcutDefault4(id) ); 00255 } else 00256 actions.insert( pInfo->psName, i18n(pInfo->psDesc) ); 00257 } 00258 } 00259 #endif 00260 00261 const KShortcut& open() { return shortcut( Open ); } 00262 const KShortcut& openNew() { return shortcut( New ); } 00263 const KShortcut& close() { return shortcut( Close ); } 00264 const KShortcut& save() { return shortcut( Save ); } 00265 const KShortcut& print() { return shortcut( Print ); } 00266 const KShortcut& quit() { return shortcut( Quit ); } 00267 const KShortcut& cut() { return shortcut( Cut ); } 00268 const KShortcut& copy() { return shortcut( Copy ); } 00269 const KShortcut& paste() { return shortcut( Paste ); } 00270 const KShortcut& deleteWordBack() { return shortcut( DeleteWordBack ); } 00271 const KShortcut& deleteWordForward() { return shortcut( DeleteWordForward ); } 00272 const KShortcut& undo() { return shortcut( Undo ); } 00273 const KShortcut& redo() { return shortcut( Redo ); } 00274 const KShortcut& find() { return shortcut( Find ); } 00275 const KShortcut& findNext() { return shortcut( FindNext ); } 00276 const KShortcut& findPrev() { return shortcut( FindPrev ); } 00277 const KShortcut& replace() { return shortcut( Replace ); } 00278 const KShortcut& home() { return shortcut( Home ); } 00279 const KShortcut& end() { return shortcut( End ); } 00280 const KShortcut& beginningOfLine() { return shortcut( BeginningOfLine ); } 00281 const KShortcut& endOfLine() { return shortcut( EndOfLine ); } 00282 const KShortcut& prior() { return shortcut( Prior ); } 00283 const KShortcut& next() { return shortcut( Next ); } 00284 const KShortcut& backwardWord() { return shortcut( BackwardWord ); } 00285 const KShortcut& forwardWord() { return shortcut( ForwardWord ); } 00286 const KShortcut& gotoLine() { return shortcut( GotoLine ); } 00287 const KShortcut& addBookmark() { return shortcut( AddBookmark ); } 00288 const KShortcut& tabNext() { return shortcut( TabNext ); } 00289 const KShortcut& tabPrev() { return shortcut( TabPrev ); } 00290 const KShortcut& fullScreen() { return shortcut( FullScreen ); } 00291 const KShortcut& zoomIn() { return shortcut( ZoomIn ); } 00292 const KShortcut& zoomOut() { return shortcut( ZoomOut ); } 00293 const KShortcut& help() { return shortcut( Help ); } 00294 const KShortcut& completion() { return shortcut( TextCompletion ); } 00295 const KShortcut& prevCompletion() { return shortcut( PrevCompletion ); } 00296 const KShortcut& nextCompletion() { return shortcut( NextCompletion ); } 00297 const KShortcut& rotateUp() { return shortcut( RotateUp ); } 00298 const KShortcut& rotateDown() { return shortcut( RotateDown ); } 00299 const KShortcut& substringCompletion() { return shortcut( SubstringCompletion ); } 00300 const KShortcut& popupMenuContext() { return shortcut( PopupMenuContext ); } 00301 const KShortcut& whatsThis() { return shortcut( WhatsThis ); } 00302 const KShortcut& reload() { return shortcut( Reload ); } 00303 const KShortcut& selectAll() { return shortcut( SelectAll ); } 00304 const KShortcut& up() { return shortcut( Up ); } 00305 const KShortcut& back() { return shortcut( Back ); } 00306 const KShortcut& forward() { return shortcut( Forward ); } 00307 const KShortcut& showMenubar() { return shortcut( ShowMenubar ); } 00308 00309 //--------------------------------------------------------------------- 00310 // ShortcutList 00311 //--------------------------------------------------------------------- 00312 00313 ShortcutList::ShortcutList() 00314 { } 00315 00316 ShortcutList::~ShortcutList() 00317 { } 00318 00319 uint ShortcutList::count() const 00320 { 00321 static uint g_nAccels = 0; 00322 if( g_nAccels == 0 ) { 00323 for( ; g_infoStdAccel[g_nAccels].psName != 0; g_nAccels++ ) 00324 ; 00325 } 00326 return g_nAccels; 00327 } 00328 00329 QString ShortcutList::name( uint i ) const 00330 { return g_infoStdAccel[i].psName; } 00331 00332 QString ShortcutList::label( uint i ) const 00333 { return i18n((g_infoStdAccel[i].psDesc) ? g_infoStdAccel[i].psDesc : g_infoStdAccel[i].psName); } 00334 00335 QString ShortcutList::whatsThis( uint ) const 00336 { return QString::null; } 00337 00338 const KShortcut& ShortcutList::shortcut( uint i ) const 00339 { 00340 if( !g_infoStdAccel[i].bInitialized ) 00341 initialize( g_infoStdAccel[i].id ); 00342 return g_infoStdAccel[i].cut; 00343 } 00344 00345 const KShortcut& ShortcutList::shortcutDefault( uint i ) const 00346 { 00347 static KShortcut cut; 00348 cut = KStdAccel::shortcutDefault( g_infoStdAccel[i].id ); 00349 return cut; 00350 } 00351 00352 bool ShortcutList::isConfigurable( uint i ) const 00353 { return (g_infoStdAccel[i].id != AccelNone); } 00354 00355 bool ShortcutList::setShortcut( uint i, const KShortcut& cut ) 00356 { g_infoStdAccel[i].cut = cut; return true; } 00357 00358 QVariant ShortcutList::getOther( Other, uint ) const 00359 { return QVariant(); } 00360 00361 bool ShortcutList::setOther( Other, uint, QVariant ) 00362 { return false; } 00363 00364 bool ShortcutList::save() const 00365 { 00366 return writeSettings( QString::null, 0, false, true ); 00367 } 00368 00369 QString action(StdAccel id) 00370 { return name(id); } 00371 QString description(StdAccel id) 00372 { return label(id); } 00373 int key(StdAccel id) 00374 { return shortcut(id).keyCodeQt(); } 00375 int defaultKey(StdAccel id) 00376 { return shortcutDefault(id).keyCodeQt(); } 00377 00378 bool isEqual(const QKeyEvent* ev, int keyQt) 00379 { 00380 KKey key1( ev ), key2( keyQt ); 00381 return key1 == key2; 00382 } 00383 00384 } 00385 00386 #undef __KSTDACCEL_CPP_
KDE Logo
This file is part of the documentation for kdecore Library Version 3.3.0.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Wed Sep 29 09:40:09 2004 by doxygen 1.3.8 written by Dimitri van Heesch, © 1997-2003