author | zautrix <zautrix> | 2004-10-25 22:23:56 (UTC) |
---|---|---|
committer | zautrix <zautrix> | 2004-10-25 22:23:56 (UTC) |
commit | dbfa4de9416c28c5424eeee0f36f50de4cfae0ec (patch) (unidiff) | |
tree | 31fa0522ff7821f5b7e98123e16f12455eeb01c9 /microkde | |
parent | 03ca6830a9e6742b8873aee04d77b3e094b65d30 (diff) | |
download | kdepimpi-dbfa4de9416c28c5424eeee0f36f50de4cfae0ec.zip kdepimpi-dbfa4de9416c28c5424eeee0f36f50de4cfae0ec.tar.gz kdepimpi-dbfa4de9416c28c5424eeee0f36f50de4cfae0ec.tar.bz2 |
pwmpi windows management fixes
-rw-r--r-- | microkde/kdeui/kmainwindow.cpp | 1 | ||||
-rw-r--r-- | microkde/kdeui/kmainwindow.h | 5 |
2 files changed, 4 insertions, 2 deletions
diff --git a/microkde/kdeui/kmainwindow.cpp b/microkde/kdeui/kmainwindow.cpp index bd5a2cc..3ae4c87 100644 --- a/microkde/kdeui/kmainwindow.cpp +++ b/microkde/kdeui/kmainwindow.cpp | |||
@@ -175,256 +175,257 @@ void KMainWindow::initKMainWindow(const char *name) | |||
175 | d->autoSaveSettings = false; | 175 | d->autoSaveSettings = false; |
176 | d->autoSaveWindowSize = true; // for compatibility | 176 | d->autoSaveWindowSize = true; // for compatibility |
177 | //US d->kaccel = actionCollection()->kaccel(); | 177 | //US d->kaccel = actionCollection()->kaccel(); |
178 | d->toolBarHandler = 0; | 178 | d->toolBarHandler = 0; |
179 | d->settingsTimer = 0; | 179 | d->settingsTimer = 0; |
180 | d->showStatusBarAction = NULL; | 180 | d->showStatusBarAction = NULL; |
181 | /*US | 181 | /*US |
182 | if ((d->care_about_geometry == beeing_first)) { | 182 | if ((d->care_about_geometry == beeing_first)) { |
183 | beeing_first = false; | 183 | beeing_first = false; |
184 | if ( kapp->geometryArgument().isNull() ) // if there is no geometry, it doesn't mater | 184 | if ( kapp->geometryArgument().isNull() ) // if there is no geometry, it doesn't mater |
185 | d->care_about_geometry = false; | 185 | d->care_about_geometry = false; |
186 | else | 186 | else |
187 | parseGeometry(false); | 187 | parseGeometry(false); |
188 | } | 188 | } |
189 | */ | 189 | */ |
190 | d->care_about_geometry = false; | 190 | d->care_about_geometry = false; |
191 | 191 | ||
192 | //US setCaption( kapp->caption() ); | 192 | //US setCaption( kapp->caption() ); |
193 | // attach dcop interface | 193 | // attach dcop interface |
194 | //US d->m_interface = new KMainWindowInterface(this); | 194 | //US d->m_interface = new KMainWindowInterface(this); |
195 | 195 | ||
196 | //US if (!kapp->authorize("movable_toolbars")) | 196 | //US if (!kapp->authorize("movable_toolbars")) |
197 | //US setDockWindowsMovable(false); | 197 | //US setDockWindowsMovable(false); |
198 | } | 198 | } |
199 | 199 | ||
200 | KAction *KMainWindow::toolBarMenuAction() | 200 | KAction *KMainWindow::toolBarMenuAction() |
201 | { | 201 | { |
202 | if ( !d->toolBarHandler ) | 202 | if ( !d->toolBarHandler ) |
203 | return 0; | 203 | return 0; |
204 | 204 | ||
205 | return d->toolBarHandler->toolBarMenuAction(); | 205 | return d->toolBarHandler->toolBarMenuAction(); |
206 | } | 206 | } |
207 | 207 | ||
208 | bool KMainWindow::canBeRestored( int number ) | 208 | bool KMainWindow::canBeRestored( int number ) |
209 | { | 209 | { |
210 | /*US we do not have and want to save sessioninformation. Use info from the default | 210 | /*US we do not have and want to save sessioninformation. Use info from the default |
211 | application config. | 211 | application config. |
212 | */ | 212 | */ |
213 | //US if ( !kapp->isRestored() ) | 213 | //US if ( !kapp->isRestored() ) |
214 | //US return FALSE; | 214 | //US return FALSE; |
215 | //US KConfig *config = kapp->sessionConfig(); | 215 | //US KConfig *config = kapp->sessionConfig(); |
216 | KConfig *config = KGlobal::config(); | 216 | KConfig *config = KGlobal::config(); |
217 | if ( !config ) | 217 | if ( !config ) |
218 | return FALSE; | 218 | return FALSE; |
219 | config->setGroup( QString::fromLatin1("Number") ); | 219 | config->setGroup( QString::fromLatin1("Number") ); |
220 | int n = config->readNumEntry( QString::fromLatin1("NumberOfWindows") , 1 ); | 220 | int n = config->readNumEntry( QString::fromLatin1("NumberOfWindows") , 1 ); |
221 | return number >= 1 && number <= n; | 221 | return number >= 1 && number <= n; |
222 | 222 | ||
223 | } | 223 | } |
224 | 224 | ||
225 | const QString KMainWindow::classNameOfToplevel( int number ) | 225 | const QString KMainWindow::classNameOfToplevel( int number ) |
226 | { | 226 | { |
227 | /*US we do not have and want to save sessioninformation. Use info from the default | 227 | /*US we do not have and want to save sessioninformation. Use info from the default |
228 | application config. | 228 | application config. |
229 | */ | 229 | */ |
230 | //US if ( !kapp->isRestored() ) | 230 | //US if ( !kapp->isRestored() ) |
231 | //US return QString::null; | 231 | //US return QString::null; |
232 | //US KConfig *config = kapp->sessionConfig(); | 232 | //US KConfig *config = kapp->sessionConfig(); |
233 | KConfig *config = KGlobal::config(); | 233 | KConfig *config = KGlobal::config(); |
234 | if ( !config ) | 234 | if ( !config ) |
235 | return QString::null; | 235 | return QString::null; |
236 | QString s; | 236 | QString s; |
237 | s.setNum( number ); | 237 | s.setNum( number ); |
238 | s.prepend( QString::fromLatin1("WindowProperties") ); | 238 | s.prepend( QString::fromLatin1("WindowProperties") ); |
239 | config->setGroup( s ); | 239 | config->setGroup( s ); |
240 | if ( !config->hasKey( QString::fromLatin1("ClassName") ) ) | 240 | if ( !config->hasKey( QString::fromLatin1("ClassName") ) ) |
241 | return QString::null; | 241 | return QString::null; |
242 | else | 242 | else |
243 | return config->readEntry( QString::fromLatin1("ClassName") ); | 243 | return config->readEntry( QString::fromLatin1("ClassName") ); |
244 | } | 244 | } |
245 | 245 | ||
246 | bool KMainWindow::restore( int number, bool show ) | 246 | bool KMainWindow::restore( int number, bool show ) |
247 | { | 247 | { |
248 | /*US we do not have and want to save sessioninformation. Use info from the default | 248 | /*US we do not have and want to save sessioninformation. Use info from the default |
249 | application config. | 249 | application config. |
250 | */ | 250 | */ |
251 | if ( !canBeRestored( number ) ) | 251 | if ( !canBeRestored( number ) ) |
252 | return FALSE; | 252 | return FALSE; |
253 | //US KConfig *config = kapp->sessionConfig(); | 253 | //US KConfig *config = kapp->sessionConfig(); |
254 | KConfig *config = KGlobal::config(); | 254 | KConfig *config = KGlobal::config(); |
255 | 255 | ||
256 | if ( readPropertiesInternal( config, number ) ){ | 256 | if ( readPropertiesInternal( config, number ) ){ |
257 | if ( show ) | 257 | if ( show ) |
258 | KMainWindow::show(); | 258 | KMainWindow::show(); |
259 | return FALSE; | 259 | return FALSE; |
260 | } | 260 | } |
261 | return FALSE; | 261 | return FALSE; |
262 | 262 | ||
263 | } | 263 | } |
264 | 264 | ||
265 | void KMainWindow::setCaption( const QString &caption ) | 265 | void KMainWindow::setCaption( const QString &caption ) |
266 | { | 266 | { |
267 | //US setPlainCaption( kapp->makeStdCaption(caption) ); | 267 | //US setPlainCaption( kapp->makeStdCaption(caption) ); |
268 | setPlainCaption( caption ); | 268 | setPlainCaption( caption ); |
269 | } | 269 | } |
270 | 270 | ||
271 | void KMainWindow::setCaption( const QString &caption, bool modified ) | 271 | void KMainWindow::setCaption( const QString &caption, bool modified ) |
272 | { | 272 | { |
273 | //US setPlainCaption( kapp->makeStdCaption(caption, true, modified) ); | 273 | //US setPlainCaption( kapp->makeStdCaption(caption, true, modified) ); |
274 | setPlainCaption( caption + "modified:" ); | 274 | setPlainCaption( caption + "modified:" ); |
275 | } | 275 | } |
276 | 276 | ||
277 | void KMainWindow::setPlainCaption( const QString &caption ) | 277 | void KMainWindow::setPlainCaption( const QString &caption ) |
278 | { | 278 | { |
279 | QMainWindow::setCaption( caption ); | 279 | QMainWindow::setCaption( caption ); |
280 | #ifndef Q_WS_QWS | 280 | #ifndef Q_WS_QWS |
281 | //US the following is disabled for the embedded version | 281 | //US the following is disabled for the embedded version |
282 | //US NETWinInfo info( qt_xdisplay(), winId(), qt_xrootwin(), 0 ); | 282 | //US NETWinInfo info( qt_xdisplay(), winId(), qt_xrootwin(), 0 ); |
283 | //US info.setName( caption.utf8().data() ); | 283 | //US info.setName( caption.utf8().data() ); |
284 | #endif | 284 | #endif |
285 | } | 285 | } |
286 | 286 | ||
287 | void KMainWindow::slotStateChanged(const QString &newstate) | 287 | void KMainWindow::slotStateChanged(const QString &newstate) |
288 | { | 288 | { |
289 | stateChanged(newstate, KXMLGUIClient::StateNoReverse); | 289 | stateChanged(newstate, KXMLGUIClient::StateNoReverse); |
290 | } | 290 | } |
291 | 291 | ||
292 | /* | 292 | /* |
293 | * Get rid of this for KDE 4.0 | 293 | * Get rid of this for KDE 4.0 |
294 | */ | 294 | */ |
295 | void KMainWindow::slotStateChanged(const QString &newstate, | 295 | void KMainWindow::slotStateChanged(const QString &newstate, |
296 | KXMLGUIClient::ReverseStateChange reverse) | 296 | KXMLGUIClient::ReverseStateChange reverse) |
297 | { | 297 | { |
298 | stateChanged(newstate, reverse); | 298 | stateChanged(newstate, reverse); |
299 | } | 299 | } |
300 | 300 | ||
301 | void KMainWindow::closeEvent ( QCloseEvent *e ) | 301 | void KMainWindow::closeEvent ( QCloseEvent *e ) |
302 | { | 302 | { |
303 | //qDebug("MainWindow::closeEvent "); | ||
303 | // Save settings if auto-save is enabled, and settings have changed | 304 | // Save settings if auto-save is enabled, and settings have changed |
304 | if (d->settingsDirty && d->autoSaveSettings) | 305 | if (d->settingsDirty && d->autoSaveSettings) |
305 | saveAutoSaveSettings(); | 306 | saveAutoSaveSettings(); |
306 | 307 | ||
307 | if (queryClose()) { | 308 | if (queryClose()) { |
308 | e->accept(); | 309 | e->accept(); |
309 | 310 | ||
310 | int not_withdrawn = 0; | 311 | int not_withdrawn = 0; |
311 | /*US | 312 | /*US |
312 | QPtrListIterator<KMainWindow> it(*KMainWindow::memberList); | 313 | QPtrListIterator<KMainWindow> it(*KMainWindow::memberList); |
313 | for (it.toFirst(); it.current(); ++it){ | 314 | for (it.toFirst(); it.current(); ++it){ |
314 | if ( !it.current()->isHidden() && it.current()->isTopLevel() && it.current() != this ) | 315 | if ( !it.current()->isHidden() && it.current()->isTopLevel() && it.current() != this ) |
315 | not_withdrawn++; | 316 | not_withdrawn++; |
316 | } | 317 | } |
317 | */ | 318 | */ |
318 | if ( !no_query_exit && not_withdrawn <= 0 ) { // last window close accepted? | 319 | if ( !no_query_exit && not_withdrawn <= 0 ) { // last window close accepted? |
319 | /*US | 320 | /*US |
320 | if ( queryExit() && !kapp->sessionSaving()) { // Yes, Quit app? | 321 | if ( queryExit() && !kapp->sessionSaving()) { // Yes, Quit app? |
321 | // don't call queryExit() twice | 322 | // don't call queryExit() twice |
322 | disconnect(kapp, SIGNAL(shutDown()), this, SLOT(shuttingDown())); | 323 | disconnect(kapp, SIGNAL(shutDown()), this, SLOT(shuttingDown())); |
323 | kapp->deref(); // ...and quit aplication. | 324 | kapp->deref(); // ...and quit aplication. |
324 | } else { | 325 | } else { |
325 | // cancel closing, it's stupid to end up with no windows at all.... | 326 | // cancel closing, it's stupid to end up with no windows at all.... |
326 | e->ignore(); | 327 | e->ignore(); |
327 | } | 328 | } |
328 | */ | 329 | */ |
329 | //US we have no sessionmanagement. Simply close app. | 330 | //US we have no sessionmanagement. Simply close app. |
330 | if ( queryExit() ) { // Yes, Quit app? | 331 | if ( queryExit() ) { // Yes, Quit app? |
331 | qDebug("KMainWindow::closeEvent: Exit application ???"); | 332 | qDebug("KMainWindow::closeEvent: Exit application ???"); |
332 | // don't call queryExit() twice | 333 | // don't call queryExit() twice |
333 | //US disconnect(kapp, SIGNAL(shutDown()), this, SLOT(shuttingDown())); | 334 | //US disconnect(kapp, SIGNAL(shutDown()), this, SLOT(shuttingDown())); |
334 | } | 335 | } |
335 | 336 | ||
336 | } | 337 | } |
337 | } | 338 | } |
338 | } | 339 | } |
339 | 340 | ||
340 | bool KMainWindow::queryExit() | 341 | bool KMainWindow::queryExit() |
341 | { | 342 | { |
342 | return TRUE; | 343 | return TRUE; |
343 | } | 344 | } |
344 | 345 | ||
345 | bool KMainWindow::queryClose() | 346 | bool KMainWindow::queryClose() |
346 | { | 347 | { |
347 | return TRUE; | 348 | return TRUE; |
348 | } | 349 | } |
349 | 350 | ||
350 | void KMainWindow::saveGlobalProperties( KConfig* ) | 351 | void KMainWindow::saveGlobalProperties( KConfig* ) |
351 | { | 352 | { |
352 | } | 353 | } |
353 | 354 | ||
354 | void KMainWindow::readGlobalProperties( KConfig* ) | 355 | void KMainWindow::readGlobalProperties( KConfig* ) |
355 | { | 356 | { |
356 | } | 357 | } |
357 | 358 | ||
358 | void KMainWindow::savePropertiesInternal( KConfig *config, int number ) | 359 | void KMainWindow::savePropertiesInternal( KConfig *config, int number ) |
359 | { | 360 | { |
360 | bool oldASWS = d->autoSaveWindowSize; | 361 | bool oldASWS = d->autoSaveWindowSize; |
361 | d->autoSaveWindowSize = true; // make saveMainWindowSettings save the window size | 362 | d->autoSaveWindowSize = true; // make saveMainWindowSettings save the window size |
362 | 363 | ||
363 | QString s; | 364 | QString s; |
364 | s.setNum(number); | 365 | s.setNum(number); |
365 | s.prepend(QString::fromLatin1("WindowProperties")); | 366 | s.prepend(QString::fromLatin1("WindowProperties")); |
366 | config->setGroup(s); | 367 | config->setGroup(s); |
367 | 368 | ||
368 | // store objectName, className, Width and Height for later restoring | 369 | // store objectName, className, Width and Height for later restoring |
369 | // (Only useful for session management) | 370 | // (Only useful for session management) |
370 | config->writeEntry(QString::fromLatin1("ObjectName"), name()); | 371 | config->writeEntry(QString::fromLatin1("ObjectName"), name()); |
371 | config->writeEntry(QString::fromLatin1("ClassName"), className()); | 372 | config->writeEntry(QString::fromLatin1("ClassName"), className()); |
372 | 373 | ||
373 | saveMainWindowSettings(config); // Menubar, statusbar and Toolbar settings. | 374 | saveMainWindowSettings(config); // Menubar, statusbar and Toolbar settings. |
374 | 375 | ||
375 | s.setNum(number); | 376 | s.setNum(number); |
376 | config->setGroup(s); | 377 | config->setGroup(s); |
377 | saveProperties(config); | 378 | saveProperties(config); |
378 | 379 | ||
379 | d->autoSaveWindowSize = oldASWS; | 380 | d->autoSaveWindowSize = oldASWS; |
380 | } | 381 | } |
381 | 382 | ||
382 | void KMainWindow::setStandardToolBarMenuEnabled( bool enable ) | 383 | void KMainWindow::setStandardToolBarMenuEnabled( bool enable ) |
383 | { | 384 | { |
384 | if ( enable ) | 385 | if ( enable ) |
385 | { | 386 | { |
386 | if ( d->toolBarHandler ) | 387 | if ( d->toolBarHandler ) |
387 | return; | 388 | return; |
388 | 389 | ||
389 | d->toolBarHandler = new KDEPrivate::ToolBarHandler( this ); | 390 | d->toolBarHandler = new KDEPrivate::ToolBarHandler( this ); |
390 | 391 | ||
391 | /*US if ( factory() ) | 392 | /*US if ( factory() ) |
392 | factory()->addClient( d->toolBarHandler ); | 393 | factory()->addClient( d->toolBarHandler ); |
393 | */ | 394 | */ |
394 | } | 395 | } |
395 | else | 396 | else |
396 | { | 397 | { |
397 | if ( !d->toolBarHandler ) | 398 | if ( !d->toolBarHandler ) |
398 | return; | 399 | return; |
399 | /*US | 400 | /*US |
400 | if ( factory() ) | 401 | if ( factory() ) |
401 | factory()->removeClient( d->toolBarHandler ); | 402 | factory()->removeClient( d->toolBarHandler ); |
402 | */ | 403 | */ |
403 | delete d->toolBarHandler; | 404 | delete d->toolBarHandler; |
404 | d->toolBarHandler = 0; | 405 | d->toolBarHandler = 0; |
405 | } | 406 | } |
406 | 407 | ||
407 | } | 408 | } |
408 | 409 | ||
409 | bool KMainWindow::isStandardToolBarMenuEnabled() const | 410 | bool KMainWindow::isStandardToolBarMenuEnabled() const |
410 | { | 411 | { |
411 | return ( d->toolBarHandler != 0 ); | 412 | return ( d->toolBarHandler != 0 ); |
412 | } | 413 | } |
413 | 414 | ||
414 | void KMainWindow::createStandardStatusBarAction(){ | 415 | void KMainWindow::createStandardStatusBarAction(){ |
415 | if(!d->showStatusBarAction){ | 416 | if(!d->showStatusBarAction){ |
416 | d->showStatusBarAction = KStdAction::showStatusbar(this, SLOT(setSettingsDirty()), actionCollection()); | 417 | d->showStatusBarAction = KStdAction::showStatusbar(this, SLOT(setSettingsDirty()), actionCollection()); |
417 | connect(d->showStatusBarAction, SIGNAL(toggled(bool)), statusBar(), SLOT(setShown(bool))); | 418 | connect(d->showStatusBarAction, SIGNAL(toggled(bool)), statusBar(), SLOT(setShown(bool))); |
418 | if(internalStatusBar()) | 419 | if(internalStatusBar()) |
419 | d->showStatusBarAction->setChecked(!internalStatusBar()->isHidden()); | 420 | d->showStatusBarAction->setChecked(!internalStatusBar()->isHidden()); |
420 | } | 421 | } |
421 | } | 422 | } |
422 | 423 | ||
423 | QToolBar *KMainWindow::tBar( ) | 424 | QToolBar *KMainWindow::tBar( ) |
424 | { | 425 | { |
425 | if ( ! mQToolBar ) | 426 | if ( ! mQToolBar ) |
426 | mQToolBar = new QToolBar( this ); | 427 | mQToolBar = new QToolBar( this ); |
427 | return mQToolBar; | 428 | return mQToolBar; |
428 | } | 429 | } |
429 | 430 | ||
430 | KToolBar *KMainWindow::toolBar( const char * name ) | 431 | KToolBar *KMainWindow::toolBar( const char * name ) |
diff --git a/microkde/kdeui/kmainwindow.h b/microkde/kdeui/kmainwindow.h index e76e732..2aafb9d 100644 --- a/microkde/kdeui/kmainwindow.h +++ b/microkde/kdeui/kmainwindow.h | |||
@@ -1,224 +1,225 @@ | |||
1 | /* | 1 | /* |
2 | This file is part of the KDE libraries | 2 | This file is part of the KDE libraries |
3 | 3 | ||
4 | This library is free software; you can redistribute it and/or | 4 | This library is free software; you can redistribute it and/or |
5 | modify it under the terms of the GNU Library General Public | 5 | modify it under the terms of the GNU Library General Public |
6 | License version 2 as published by the Free Software Foundation. | 6 | License version 2 as published by the Free Software Foundation. |
7 | 7 | ||
8 | This library is distributed in the hope that it will be useful, | 8 | This library is distributed in the hope that it will be useful, |
9 | but WITHOUT ANY WARRANTY; without even the implied warranty of | 9 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
10 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | 10 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
11 | Library General Public License for more details. | 11 | Library General Public License for more details. |
12 | 12 | ||
13 | You should have received a copy of the GNU Library General Public License | 13 | You should have received a copy of the GNU Library General Public License |
14 | along with this library; see the file COPYING.LIB. If not, write to | 14 | along with this library; see the file COPYING.LIB. If not, write to |
15 | the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | 15 | the Free Software Foundation, Inc., 59 Temple Place - Suite 330, |
16 | Boston, MA 02111-1307, USA. | 16 | Boston, MA 02111-1307, USA. |
17 | 17 | ||
18 | $Id$ | 18 | $Id$ |
19 | 19 | ||
20 | */ | 20 | */ |
21 | 21 | ||
22 | 22 | ||
23 | 23 | ||
24 | #ifndef KMAINWINDOW_H | 24 | #ifndef KMAINWINDOW_H |
25 | #define KMAINWINDOW_H | 25 | #define KMAINWINDOW_H |
26 | 26 | ||
27 | /*US | 27 | /*US |
28 | #include "kxmlguifactory.h" | 28 | #include "kxmlguifactory.h" |
29 | #include "kxmlguiclient.h" | 29 | #include "kxmlguiclient.h" |
30 | #include "kxmlguibuilder.h" | 30 | #include "kxmlguibuilder.h" |
31 | #include <qmetaobject.h> | 31 | #include <qmetaobject.h> |
32 | 32 | ||
33 | class KPopupMenu; | 33 | class KPopupMenu; |
34 | class KXMLGUIFactory; | 34 | class KXMLGUIFactory; |
35 | class KConfig; | 35 | class KConfig; |
36 | class KHelpMenu; | 36 | class KHelpMenu; |
37 | class KStatusBar; | 37 | class KStatusBar; |
38 | class QStatusBar; | 38 | class QStatusBar; |
39 | class KMenuBar; | 39 | class KMenuBar; |
40 | class KMWSessionManaged; | 40 | class KMWSessionManaged; |
41 | class KAccel; | 41 | class KAccel; |
42 | class KToolBarMenuAction; | 42 | class KToolBarMenuAction; |
43 | */ | 43 | */ |
44 | 44 | ||
45 | class QMenuBar; | 45 | class QMenuBar; |
46 | class QStatusBar; | 46 | class QStatusBar; |
47 | class KMainWindowPrivate; | 47 | class KMainWindowPrivate; |
48 | class KAction; | 48 | class KAction; |
49 | 49 | ||
50 | #include <ktoolbar.h> | 50 | #include <ktoolbar.h> |
51 | #include <ktoolbarhandler.h> | 51 | #include <ktoolbarhandler.h> |
52 | #include <kxmlguiclient.h> | 52 | #include <kxmlguiclient.h> |
53 | #include <qmainwindow.h> | 53 | #include <qmainwindow.h> |
54 | #include <qptrlist.h> | 54 | #include <qptrlist.h> |
55 | 55 | ||
56 | class KActionCollection; | 56 | class KActionCollection; |
57 | 57 | ||
58 | class KMainWindow : public QMainWindow, virtual public KXMLGUIClient | 58 | class KMainWindow : public QMainWindow, virtual public KXMLGUIClient |
59 | { | 59 | { |
60 | Q_OBJECT | 60 | Q_OBJECT |
61 | 61 | ||
62 | private: | 62 | private: |
63 | //US create private defaultconstructor | 63 | //US create private defaultconstructor |
64 | KMainWindow() {;}; | 64 | KMainWindow() {;}; |
65 | 65 | ||
66 | public: | 66 | |
67 | public: | 67 | public: |
68 | /** | 68 | /** |
69 | * Construct a main window. | 69 | * Construct a main window. |
70 | * | 70 | * |
71 | * @param parent The widget parent. This is usually 0 but it may also be the window | 71 | * @param parent The widget parent. This is usually 0 but it may also be the window |
72 | * group leader. In that case, the KMainWindow becomes sort of a | 72 | * group leader. In that case, the KMainWindow becomes sort of a |
73 | * secondary window. | 73 | * secondary window. |
74 | * | 74 | * |
75 | * @param name The object name. For session management and window management to work | 75 | * @param name The object name. For session management and window management to work |
76 | * properly, all main windows in the application should have a | 76 | * properly, all main windows in the application should have a |
77 | * different name. When passing 0 (the default), KMainWindow will create | 77 | * different name. When passing 0 (the default), KMainWindow will create |
78 | * a unique name, but it's recommended to explicitly pass a window name that will | 78 | * a unique name, but it's recommended to explicitly pass a window name that will |
79 | * also describe the type of the window. If there can be several windows of the same | 79 | * also describe the type of the window. If there can be several windows of the same |
80 | * type, append '#' (hash) to the name, and KMainWindow will append numbers to make | 80 | * type, append '#' (hash) to the name, and KMainWindow will append numbers to make |
81 | * the names unique. For example, for a mail client which has one main window showing | 81 | * the names unique. For example, for a mail client which has one main window showing |
82 | * the mails and folders, and which can also have one or more windows for composing | 82 | * the mails and folders, and which can also have one or more windows for composing |
83 | * mails, the name for the folders window should be e.g. "mainwindow" and | 83 | * mails, the name for the folders window should be e.g. "mainwindow" and |
84 | * for the composer windows "composer#". | 84 | * for the composer windows "composer#". |
85 | * | 85 | * |
86 | * @param f Specify the widget flags. The default is | 86 | * @param f Specify the widget flags. The default is |
87 | * WType_TopLevel and WDestructiveClose. TopLevel indicates that a | 87 | * WType_TopLevel and WDestructiveClose. TopLevel indicates that a |
88 | * main window is a toplevel window, regardless of whether it has a | 88 | * main window is a toplevel window, regardless of whether it has a |
89 | * parent or not. DestructiveClose indicates that a main window is | 89 | * parent or not. DestructiveClose indicates that a main window is |
90 | * automatically destroyed when its window is closed. Pass 0 if | 90 | * automatically destroyed when its window is closed. Pass 0 if |
91 | * you do not want this behavior. | 91 | * you do not want this behavior. |
92 | * | 92 | * |
93 | * KMainWindows must be created on the heap with 'new', like: | 93 | * KMainWindows must be created on the heap with 'new', like: |
94 | * <pre> KMainWindow *kmw = new KMainWindow (...</pre> | 94 | * <pre> KMainWindow *kmw = new KMainWindow (...</pre> |
95 | **/ | 95 | **/ |
96 | KMainWindow( QWidget* parent = 0, const char *name = 0, WFlags f = WType_TopLevel | WDestructiveClose ); | 96 | //LR remove WDestructiveClose |
97 | KMainWindow( QWidget* parent = 0, const char *name = 0, WFlags f = WType_TopLevel /*| WDestructiveClose*/ ); | ||
97 | 98 | ||
98 | 99 | ||
99 | /** | 100 | /** |
100 | * Destructor. | 101 | * Destructor. |
101 | * | 102 | * |
102 | * Will also destroy the toolbars, and menubar if | 103 | * Will also destroy the toolbars, and menubar if |
103 | * needed. | 104 | * needed. |
104 | */ | 105 | */ |
105 | virtual ~KMainWindow(); | 106 | virtual ~KMainWindow(); |
106 | 107 | ||
107 | /** | 108 | /** |
108 | * Retrieve the standard help menu. | 109 | * Retrieve the standard help menu. |
109 | * | 110 | * |
110 | * It contains entires for the | 111 | * It contains entires for the |
111 | * help system (activated by F1), an optional "What's This?" entry | 112 | * help system (activated by F1), an optional "What's This?" entry |
112 | * (activated by Shift F1), an application specific dialog box, | 113 | * (activated by Shift F1), an application specific dialog box, |
113 | * and an "About KDE" dialog box. | 114 | * and an "About KDE" dialog box. |
114 | * | 115 | * |
115 | * Example (adding a standard help menu to your application): | 116 | * Example (adding a standard help menu to your application): |
116 | * <pre> | 117 | * <pre> |
117 | * KPopupMenu *help = helpMenu( <myTextString> ); | 118 | * KPopupMenu *help = helpMenu( <myTextString> ); |
118 | * menuBar()->insertItem( i18n("&Help"), help ); | 119 | * menuBar()->insertItem( i18n("&Help"), help ); |
119 | * </pre> | 120 | * </pre> |
120 | * | 121 | * |
121 | * @param aboutAppText The string that is used in the application | 122 | * @param aboutAppText The string that is used in the application |
122 | * specific dialog box. If you leave this string empty the | 123 | * specific dialog box. If you leave this string empty the |
123 | * information in the global @ref KAboutData of the | 124 | * information in the global @ref KAboutData of the |
124 | * application will be used to make a standard dialog box. | 125 | * application will be used to make a standard dialog box. |
125 | * | 126 | * |
126 | * @param showWhatsThis Set this to false if you do not want to include | 127 | * @param showWhatsThis Set this to false if you do not want to include |
127 | * the "What's This" menu entry. | 128 | * the "What's This" menu entry. |
128 | * | 129 | * |
129 | * @return A standard help menu. | 130 | * @return A standard help menu. |
130 | */ | 131 | */ |
131 | //US KPopupMenu* helpMenu( const QString &aboutAppText = QString::null, | 132 | //US KPopupMenu* helpMenu( const QString &aboutAppText = QString::null, |
132 | //US bool showWhatsThis = TRUE ); | 133 | //US bool showWhatsThis = TRUE ); |
133 | 134 | ||
134 | /** | 135 | /** |
135 | * Returns the help menu. Creates a standard help menu if none exists yet. | 136 | * Returns the help menu. Creates a standard help menu if none exists yet. |
136 | * | 137 | * |
137 | * It contains entries for the | 138 | * It contains entries for the |
138 | * help system (activated by F1), an optional "What's This?" entry | 139 | * help system (activated by F1), an optional "What's This?" entry |
139 | * (activated by Shift F1), an application specific dialog box, | 140 | * (activated by Shift F1), an application specific dialog box, |
140 | * and an "About KDE" dialog box. You must create the application | 141 | * and an "About KDE" dialog box. You must create the application |
141 | * specific dialog box yourself. When the "About application" | 142 | * specific dialog box yourself. When the "About application" |
142 | * menu entry is activated, a signal will trigger the | 143 | * menu entry is activated, a signal will trigger the |
143 | * @ref showAboutApplication slot. See @ref showAboutApplication for more | 144 | * @ref showAboutApplication slot. See @ref showAboutApplication for more |
144 | * information. | 145 | * information. |
145 | * | 146 | * |
146 | * Example (adding a help menu to your application): | 147 | * Example (adding a help menu to your application): |
147 | * <pre> | 148 | * <pre> |
148 | * menuBar()->insertItem( i18n("&Help"), customHelpMenu() ); | 149 | * menuBar()->insertItem( i18n("&Help"), customHelpMenu() ); |
149 | * </pre> | 150 | * </pre> |
150 | * | 151 | * |
151 | * @param showWhatsThis Set this to @p false if you do not want to include | 152 | * @param showWhatsThis Set this to @p false if you do not want to include |
152 | * the "What's This" menu entry. | 153 | * the "What's This" menu entry. |
153 | * | 154 | * |
154 | * @return A standard help menu. | 155 | * @return A standard help menu. |
155 | */ | 156 | */ |
156 | //US KPopupMenu* customHelpMenu( bool showWhatsThis = TRUE ); | 157 | //US KPopupMenu* customHelpMenu( bool showWhatsThis = TRUE ); |
157 | 158 | ||
158 | /** | 159 | /** |
159 | * @sect Session Management | 160 | * @sect Session Management |
160 | * | 161 | * |
161 | * Try to restore the toplevel widget as defined by the number (1..X). | 162 | * Try to restore the toplevel widget as defined by the number (1..X). |
162 | * | 163 | * |
163 | * If the session did not contain so high a number, the configuration | 164 | * If the session did not contain so high a number, the configuration |
164 | * is not changed and @p false returned. | 165 | * is not changed and @p false returned. |
165 | * | 166 | * |
166 | * That means clients could simply do the following: | 167 | * That means clients could simply do the following: |
167 | * <pre> | 168 | * <pre> |
168 | * if (kapp->isRestored()){ | 169 | * if (kapp->isRestored()){ |
169 | * int n = 1; | 170 | * int n = 1; |
170 | * while (KMainWindow::canBeRestored(n)){ | 171 | * while (KMainWindow::canBeRestored(n)){ |
171 | * (new childMW)->restore(n); | 172 | * (new childMW)->restore(n); |
172 | * n++; | 173 | * n++; |
173 | * } | 174 | * } |
174 | * } else { | 175 | * } else { |
175 | * // create default application as usual | 176 | * // create default application as usual |
176 | * } | 177 | * } |
177 | * </pre> | 178 | * </pre> |
178 | * Note that @ref QWidget::show() is called implicitly in restore. | 179 | * Note that @ref QWidget::show() is called implicitly in restore. |
179 | * | 180 | * |
180 | * With this you can easily restore all toplevel windows of your | 181 | * With this you can easily restore all toplevel windows of your |
181 | * application. | 182 | * application. |
182 | * | 183 | * |
183 | * If your application uses different kinds of toplevel | 184 | * If your application uses different kinds of toplevel |
184 | * windows, then you can use @ref KMainWindow::classNameOfToplevel(n) | 185 | * windows, then you can use @ref KMainWindow::classNameOfToplevel(n) |
185 | * to determine the exact type before calling the childMW | 186 | * to determine the exact type before calling the childMW |
186 | * constructor in the example from above. | 187 | * constructor in the example from above. |
187 | * | 188 | * |
188 | * If your client has only one kind of toplevel widgets (which | 189 | * If your client has only one kind of toplevel widgets (which |
189 | * should be pretty usual) then you should use the RESTORE-macro | 190 | * should be pretty usual) then you should use the RESTORE-macro |
190 | * for backwards compatibility with 3.1 and 3.0 branches: | 191 | * for backwards compatibility with 3.1 and 3.0 branches: |
191 | * | 192 | * |
192 | * <pre> | 193 | * <pre> |
193 | * if (kapp->isRestored()) | 194 | * if (kapp->isRestored()) |
194 | * RESTORE(childMW) | 195 | * RESTORE(childMW) |
195 | * else { | 196 | * else { |
196 | * // create default application as usual | 197 | * // create default application as usual |
197 | * } | 198 | * } |
198 | * </pre> | 199 | * </pre> |
199 | * | 200 | * |
200 | * The macro expands to the term above but is easier to use and | 201 | * The macro expands to the term above but is easier to use and |
201 | * less code to write. | 202 | * less code to write. |
202 | * | 203 | * |
203 | * For new code or if you have more than one kind of toplevel | 204 | * For new code or if you have more than one kind of toplevel |
204 | * widget (each derived from @ref KMainWindow, of course), you can | 205 | * widget (each derived from @ref KMainWindow, of course), you can |
205 | * use the templated @ref kRestoreMainWindows global functions: | 206 | * use the templated @ref kRestoreMainWindows global functions: |
206 | * | 207 | * |
207 | * <pre> | 208 | * <pre> |
208 | * if (kapp->isRestored()) | 209 | * if (kapp->isRestored()) |
209 | * kRestoreMainWindows< childMW1, childMW2, childMW3 >(); | 210 | * kRestoreMainWindows< childMW1, childMW2, childMW3 >(); |
210 | * else { | 211 | * else { |
211 | * // create default application as usual | 212 | * // create default application as usual |
212 | * } | 213 | * } |
213 | * </pre> | 214 | * </pre> |
214 | * | 215 | * |
215 | * Currently, these functions are provided for up to three | 216 | * Currently, these functions are provided for up to three |
216 | * template arguments. If you need more, tell us. To help you in | 217 | * template arguments. If you need more, tell us. To help you in |
217 | * deciding whether or not you can use @ref kRestoreMainWindows, a | 218 | * deciding whether or not you can use @ref kRestoreMainWindows, a |
218 | * define KDE_RESTORE_MAIN_WINDOWS_NUM_TEMPLATE_ARGS is provided. | 219 | * define KDE_RESTORE_MAIN_WINDOWS_NUM_TEMPLATE_ARGS is provided. |
219 | * | 220 | * |
220 | * @see restore() | 221 | * @see restore() |
221 | * @see classNameOfToplevel() | 222 | * @see classNameOfToplevel() |
222 | * | 223 | * |
223 | **/ | 224 | **/ |
224 | static bool canBeRestored( int number ); | 225 | static bool canBeRestored( int number ); |