From f78eb03afb8c9a380985d26286afc40b4c89b292 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Fri, 1 Feb 2013 15:15:35 -0600 Subject: Rename a number of classes to enhance compatibility with KDE4 --- doc/api/FutureTasks.dox | 2 +- doc/kde_app_devel/index.docbook | 24 +++++++++++------------ doc/kdearch/index.docbook | 38 ++++++++++++++++++------------------ doc/tdevelop/getting-started.docbook | 20 +++++++++---------- 4 files changed, 42 insertions(+), 42 deletions(-) (limited to 'doc') diff --git a/doc/api/FutureTasks.dox b/doc/api/FutureTasks.dox index c738a3f3..1d7f7f26 100644 --- a/doc/api/FutureTasks.dox +++ b/doc/api/FutureTasks.dox @@ -53,7 +53,7 @@ - Build tools Parts - Show .po files in project management - Custom actions for groups, targets and files for project managers: - - any menu item should be a KAction plugged into KPopupMenu, also we need to define shortcuts for any such action, + - any menu item should be a TDEAction plugged into TDEPopupMenu, also we need to define shortcuts for any such action, also we should make sure those actions are properly executed from a shortcut. - AutoProjectPart - Should be able to DND files from other targets / file list / konq to add to targets diff --git a/doc/kde_app_devel/index.docbook b/doc/kde_app_devel/index.docbook index f5af2265..c1ed3ba9 100644 --- a/doc/kde_app_devel/index.docbook +++ b/doc/kde_app_devel/index.docbook @@ -749,7 +749,7 @@ the compilation phase. -ansi -D_XOPEN_SOURCE=500 -D_BSD_SOURCE -Wcast-align -Wconversion -O2 -fno-exceptions -fno-check-new -c -o kscribble.o `test -f 'kscribble.cpp' || echo '/home/caleb/kscribble/src/'`kscribble.cpp 30 kscribble.cpp: In member function `void KScribble::setupActions()' -31 kscribble.cpp:107: warning: unused variable `KAction*custom' +31 kscribble.cpp:107: warning: unused variable `TDEAction*custom' 32 /usr/lib/qt/bin/moc /home/caleb/kscribble/src/kscribbleview.h -o kscribbleview.moc 33 source='kscribbleview.cpp' object='kscribbleview.o' libtool=no \ 34 depfile='.deps/kscribbleview.Po' tmpdepfile='.deps/kscribbleview.TPo' \ @@ -912,14 +912,14 @@ added some KDE methods that set program and author information for this applicat Let's have a look at the constructor and see how this instance is called 1 KScribble::KScribble() -2 : KMainWindow( 0, "KScribble" ), +2 : TDEMainWindow( 0, "KScribble" ), 3 m_view(new KScribbleView(this)), 4 m_printer(0) 5 { 6 // accept dnd 7 setAcceptDrops(true); 8 -9 // tell the KMainWindow that this is indeed the main widget +9 // tell the TDEMainWindow that this is indeed the main widget 10 setCentralWidget(m_view); 11 12 // then, setup our actions @@ -938,7 +938,7 @@ Let's have a look at the constructor and see how this instance is called -Notice that KScribble inherits the KMainWindow class - a +Notice that KScribble inherits the TDEMainWindow class - a commonly used base class for TDE applications. We initialize a class called KScribbleView as our central widget, create a KStatusBar via the statusBar() method (line 16), and connect some signals and slots together. @@ -1123,7 +1123,7 @@ The KDE libraries were invented to make designing applications for the K Desktop and capable of more functionality than what Qt alone is offering. The tdeui library offers: -KListView: a more powerful version of QListView +TDEListView: a more powerful version of QListView KIconView: a graphical viewer of icon files @@ -1164,9 +1164,9 @@ icons or provide quick access methods like combos to select values. How does it work? -Our application inherits the KMainWindow class, which automatically handles creating +Our application inherits the TDEMainWindow class, which automatically handles creating a menu bar and tool bars for us. In the KScribble::setupActions() method there is -a call to KMainWindow::createGUI(). This method loads a resource file, in this +a call to TDEMainWindow::createGUI(). This method loads a resource file, in this case kscribbleui.rc, to initialize menus at startup. Note that kscribbleui.rc is listed as one of the project files in the Automake Manager. Opening that file up reveals this: @@ -1192,7 +1192,7 @@ a large number of insertItem() methods which allow you menu bar. -KMainWindow's methods statusBar() and +TDEMainWindow's methods statusBar() and toolBar() will also provide you with applicable widgets. @@ -1202,7 +1202,7 @@ toolBar() will also provide you with applicable widgets. A very professional thing you should always add to your application are keyboard accelerators. Those are mainly used by experienced users that want to work fast with their applications and are willing to learn shortcuts. For this, the KDE libraries provide the class -KAction, which provides the keyboard accelerator keys and access to global configured +TDEAction, which provides the keyboard accelerator keys and access to global configured standard keyboard accelerators. @@ -1249,7 +1249,7 @@ Within the application, those are: Additionally, the application should provide means to access a HTML-based online manual directly using the standard help key F1. This context based help system is provided automatically through the -KMainWindow class, though as the author you must provide the content. +TDEMainWindow class, though as the author you must provide the content. As &tdevelop; also offers all types of help as well as the KDE framework generated by the @@ -1273,7 +1273,7 @@ as possible because toolbars can be configured to display their contents in vari either displaying the button, button with text on the right, button with text below, text only. This possibility should be made configurable by the user, but isn't a must-be. The text is shown as a tool-tip anyway and a toolbar usually consists of buttons and other widgets like lineedits and -combo boxes. For a complete reference, see the KToolBar class reference located +combo boxes. For a complete reference, see the TDEToolBar class reference located in the tdeui library. @@ -1291,7 +1291,7 @@ provided by Qt. An example of that would be: Extending the Statusbar -As the applications that inherit KMainWindow contain a statusbar as well, +As the applications that inherit TDEMainWindow contain a statusbar as well, it also offers a set of statusbar messages already for all menu and toolbar items. A statusbar help message is a short message that extends the meaning of a tool-tip or can be seen as a replacement for a tool-tip over menubar items and is (as the name suggests) displayed in the statusbar when the user diff --git a/doc/kdearch/index.docbook b/doc/kdearch/index.docbook index 53e7ff7a..7f035d77 100644 --- a/doc/kdearch/index.docbook +++ b/doc/kdearch/index.docbook @@ -285,13 +285,13 @@ throughout the desktop. -<ulink url="kdeapi:tdecore/KAccel">KAccel</ulink> +<ulink url="kdeapi:tdecore/TDEAccel">TDEAccel</ulink> Collection of keyboard shortcuts. -<ulink url="kdeapi:tdecore/KStdAccel">KStdAccel</ulink> +<ulink url="kdeapi:tdecore/TDEStdAccel">TDEStdAccel</ulink> Easy access to the common keyboard shortcut keys. @@ -401,25 +401,25 @@ Widgets - widget classes for list views, rules, color selection etc. -<ulink url="kdeapi:tdeui/KListView">KListView</ulink> +<ulink url="kdeapi:tdeui/TDEListView">TDEListView</ulink> A variant of QListView that honors KDE's system-wide settings. -<ulink url="kdeapi:tdeui/KListView">KListBox</ulink> +<ulink url="kdeapi:tdeui/TDEListView">TDEListBox</ulink> A variant of QListBox that honors KDE's system-wide settings. -<ulink url="kdeapi:tdeui/KListView">KIconView</ulink> +<ulink url="kdeapi:tdeui/TDEListView">KIconView</ulink> A variant of QIconView that honors KDE's system-wide settings. -<ulink url="kdeapi:tdeui/KListView">KLineEdit</ulink> +<ulink url="kdeapi:tdeui/TDEListView">KLineEdit</ulink> A variant of QLineEdit with completion support. @@ -431,7 +431,7 @@ A variant of QComboBox with completion support. -<ulink url="kdeapi:tdeui/KFontCombo">KFontCombo</ulink> +<ulink url="kdeapi:tdeui/TDEFontCombo">TDEFontCombo</ulink> A combo box for selecting fonts. @@ -506,7 +506,7 @@ A color selection dialog. -<ulink url="kdeapi:tdeui/KFontDialog">KFontDialog</ulink> +<ulink url="kdeapi:tdeui/TDEFontDialog">TDEFontDialog</ulink> A font selection dialog. @@ -574,13 +574,13 @@ Actions and XML GUI -<ulink url="kdeapi:tdeui/KAction">KAction</ulink> +<ulink url="kdeapi:tdeui/TDEAction">TDEAction</ulink> Abstraction for an action that can be plugged into menu bars and tool bars. -<ulink url="kdeapi:tdeui/KActionCollection">KActionCollection</ulink> +<ulink url="kdeapi:tdeui/TDEActionCollection">TDEActionCollection</ulink> A set of actions. @@ -1366,7 +1366,7 @@ come from many different plugins or parts. KDE's class for toplevel windows, -KMainWindow, +TDEMainWindow, inherits KXMLGUIClient and therefore supports XMLGUI out of the box. All actions created within it must @@ -1423,19 +1423,19 @@ The corresponding part of the setup in C++ is: KStdAction::zoomIn ( this, SLOT(slotZoomIn()), actionCollection() ); KStdAction::zoomOut ( this, SLOT(slotZoomOut()), actionCollection() ); KStdAction::zoom ( this, SLOT(slotZoom()), actionCollection() ); - new KAction ( i18n("&Half size"), ALT+Key_0, + new TDEAction ( i18n("&Half size"), ALT+Key_0, this, SLOT(slotHalfSize()), actionCollection(), "zoom50" ); - new KAction ( i18n("&Normal size"), ALT+Key_1, + new TDEAction ( i18n("&Normal size"), ALT+Key_1, this, SLOT(slotDoubleSize()), actionCollection(), "zoom100" ); - new KAction ( i18n("&Double size"), ALT+Key_2, + new TDEAction ( i18n("&Double size"), ALT+Key_2, this, SLOT(slotDoubleSize()), actionCollection(), "zoom200" ); - new KAction ( i18n("&Fill Screen"), ALT+Key_3, + new TDEAction ( i18n("&Fill Screen"), ALT+Key_3, this, SLOT(slotFillScreen()), actionCollection(), "zoomMaxpect" ); - new KAction ( i18n("Fullscreen &Mode"), CTRL+SHIFT+Key_F, + new TDEAction ( i18n("Fullscreen &Mode"), CTRL+SHIFT+Key_F, this, SLOT(slotFullScreen()), actionCollection(), "fullscreen" ); @@ -1623,7 +1623,7 @@ void MainWindow::updateOpenWithActions() unplugActionList("openwith"); openWithActions.clear(); for ( /* iterate over the relevant services */ ) { - KAction *action = new KAction( ...); + TDEAction *action = new TDEAction( ...); openWithActions.append(action); } plugActionList("openwith", openWithActions); @@ -1769,11 +1769,11 @@ QToolTip::add(w, i18n("This widget does something.")) If the menu bars and tool bars are created using the action pattern, the string used as tooltip is derived from the first argument -of the KAction constructor: +of the TDEAction constructor: -action = new KAction(i18n("&Delete"), "editdelete", +action = new TDEAction(i18n("&Delete"), "editdelete", SHIFT+Key_Delete, actionCollection(), "del") diff --git a/doc/tdevelop/getting-started.docbook b/doc/tdevelop/getting-started.docbook index 9a5937bd..a805f393 100644 --- a/doc/tdevelop/getting-started.docbook +++ b/doc/tdevelop/getting-started.docbook @@ -1426,18 +1426,18 @@ window find the following lines. Hello::Hello() - : KMainWindow( 0, "Hello" ) + : TDEMainWindow( 0, "Hello" ) { -Right click on KMainWindow. +Right click on TDEMainWindow. A menu will pop up. There select the Search in Documentation: -KMainWindow entry and release the mouse button. Now the +TDEMainWindow entry and release the mouse button. Now the Documentation tool view will open, showing the -KMainWindow entry as search item on the +TDEMainWindow entry as search item on the Search sub-page. And a short while after another editor window will open in the workspace area, showing the KDE API Reference page of -the KMainWindow class. +the TDEMainWindow class. This all will look like the following. (We deliberately opened the Documentation, Search page already to @@ -1454,11 +1454,11 @@ identifier. You might as well select Find Documentation: -KMainWindow. In this case the Finder sub-page +TDEMainWindow. In this case the Finder sub-page of the Documentation tool view will show up, usually providing a selection of pages containing the search term. (In our example this -will probably be the KMainWindow and -KMainWindowInterface classes. Select the one you are +will probably be the TDEMainWindow and +TDEMainWindowInterface classes. Select the one you are interested in and the corresponding documentation will be displayed in an editor window. @@ -1573,7 +1573,7 @@ Hello, and &tdevelop; will immediately open the front of this class definition: Hello::Hello() - : KMainWindow( 0, "Hello" ) + : TDEMainWindow( 0, "Hello" ) { @@ -2127,7 +2127,7 @@ comment marks will be recognized as well. hello.cpp example file Hello::Hello() - : KMainWindow( 0, "Hello" ) + : TDEMainWindow( 0, "Hello" ) { // set the shell's ui resource file // TODO check the user interface -- cgit v1.2.3