Policies/API to Avoid - Revision history

Neverendingo: Text replace - "" to ""

2011-06-29T20:50:35Z

Text replace - "</code>" to "</syntaxhighlight>"

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:31:26Z
Text replace - "<code cppqt>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 20:31, 29 June 2011
			
Line 21:
Line 21:
    
  Either use QWidget::setWindowState() in the following way   Either use QWidget::setWindowState() in the following way
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  widget->setWindowState(widget->windowState() | Qt::WindowFullScreen); // set   widget->setWindowState(widget->windowState() | Qt::WindowFullScreen); // set
  widget->setWindowState(widget->windowState() & ~Qt::WindowFullScreen); // reset   widget->setWindowState(widget->windowState() & ~Qt::WindowFullScreen); // reset



Aseigo at 20:09, 26 June 2009
2009-06-26T20:09:09Z


				
				
				
				
			
			← Older revision
			Revision as of 20:09, 26 June 2009
			
Line 10:
Line 10:
  Use KNotification for better KDE integration.   Use KNotification for better KDE integration.
    
− ==== QHttp ==== + === QHttp ===
    
  QHttp does not respect desktop settings such as the user's proxy settings or resource restrictions. Always use KIO to access network resources.   QHttp does not respect desktop settings such as the user's proxy settings or resource restrictions. Always use KIO to access network resources.



Aseigo at 20:08, 26 June 2009
2009-06-26T20:08:32Z


				
				
				
				
			
			← Older revision
			Revision as of 20:08, 26 June 2009
			
Line 9:
Line 9:
    
  Use KNotification for better KDE integration.   Use KNotification for better KDE integration.
  + 
  + ==== QHttp ====
  + 
  + QHttp does not respect desktop settings such as the user's proxy settings or resource restrictions. Always use KIO to access network resources.
    
  == API that is considered broken ==   == API that is considered broken ==



Rakuco: Removed extra blank line.
2009-03-30T19:39:51Z
Removed extra blank line.

				
				
				
				
			
			← Older revision
			Revision as of 19:39, 30 March 2009
			
Line 9:
Line 9:
    
  Use KNotification for better KDE integration.   Use KNotification for better KDE integration.
−  
    
  == API that is considered broken ==   == API that is considered broken ==



Dhaumann: link to common programming mistakes
2008-03-31T15:34:50Z
link to common programming mistakes

				
				
				
				
			
			← Older revision
			Revision as of 15:34, 31 March 2008
			
Line 23:
Line 23:
  </code>   </code>
  or use KDE API - KToggleFullScreenAction has setFullScreen() helper function, and KWindowSystem has calls for changing window state.   or use KDE API - KToggleFullScreenAction has setFullScreen() helper function, and KWindowSystem has calls for changing window state.
  + 
  + == Further Links ==
  + For further programming tips, please read the article about [[Development/Tutorials/Common_Programming_Mistakes|common programming mistakes]].



Seli: Initial version
2008-03-31T08:49:33Z
Initial version
New page
There are classes and functions that should be avoided in KDE applications, but KDE has no direct control over them (for example, they are part of Qt).



== API that has KDE replacements ==



=== Qt classes that have their KDE versions ===

KDE applications should not use Qt classes that have their KDE replacements. Examples include QFileDialog, QDialog, QMainWindow. KDE versions of these classes provide better integration with KDE.



=== QSystemTrayIcon::showMessage() ===



Use KNotification for better KDE integration.





== API that is considered broken ==



=== QWidget::showFullScreen/Maximized/Minimized/Normal() ===



Try to avoid calls to QWidget::showFullScreen(), QWidget::showMaximized(), QWidget::showMinimized() and QWidget::showNormal(), use them only if you understand what they do and you really want that. These calls do not only change the relevant window state as most people expect, but they also have other effects. For example, showFullScreen() among other things also removes the maximized state (see [http://bugs.kde.org/show_bug.cgi?id=157941 bug #157941]), the same way showNormal() is not an inverse call to showFullScreen().



Either use QWidget::setWindowState() in the following way

<code cppqt>

widget->setWindowState(widget->windowState() | Qt::WindowFullScreen); // set

widget->setWindowState(widget->windowState() & ~Qt::WindowFullScreen); // reset

</code>

or use KDE API - KToggleFullScreenAction has setFullScreen() helper function, and KWindowSystem has calls for changing window state.

← Older revision		Revision as of 20:08, 26 June 2009
Line 9:		Line 9:

	Use KNotification for better KDE integration.		Use KNotification for better KDE integration.
		+
		+	==== QHttp ====
		+
		+	QHttp does not respect desktop settings such as the user's proxy settings or resource restrictions. Always use KIO to access network resources.

	== API that is considered broken ==		== API that is considered broken ==

← Older revision		Revision as of 19:39, 30 March 2009
Line 9:		Line 9:

	Use KNotification for better KDE integration.		Use KNotification for better KDE integration.
−

	== API that is considered broken ==		== API that is considered broken ==

← Older revision		Revision as of 15:34, 31 March 2008
Line 23:		Line 23:
	</code>		</code>
	or use KDE API - KToggleFullScreenAction has setFullScreen() helper function, and KWindowSystem has calls for changing window state.		or use KDE API - KToggleFullScreenAction has setFullScreen() helper function, and KWindowSystem has calls for changing window state.
		+
		+	== Further Links ==
		+	For further programming tips, please read the article about [[Development/Tutorials/Common_Programming_Mistakes\|common programming mistakes]].