Development/Tutorials/Plasma/Python/Using widgets - Revision history

Neverendingo: Text replace - "" to ""

2011-06-29T20:54:13Z

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

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


2011-06-29T20:34:30Z
Text replace - "<code python>" to "<syntaxhighlight lang="python">"

				
				
				
				
			
			← Older revision
			Revision as of 20:34, 29 June 2011
			
Line 11:
Line 11:
  Here is how our main.py file will look like:   Here is how our main.py file will look like:
    
− <code python> + <syntaxhighlight lang="python">
  # -*- coding: utf-8 -*-   # -*- coding: utf-8 -*-
  # Copyright stuff   # Copyright stuff



Phobie: /* The 'main.py' file */ never "use from x import *"!
2010-06-23T23:58:04Z
‎The 'main.py' file:  never "use from x import *"!

				
				
				
				
			
			← Older revision
			Revision as of 23:58, 23 June 2010
			
Line 12:
Line 12:
    
  <code python>   <code python>
  + # -*- coding: utf-8 -*-
  # Copyright stuff   # Copyright stuff
− from PyQt4.QtCore import * + from PyQt4.QtCore import Qt
− from PyQt4.QtGui import * + from PyQt4.QtGui import QGraphicsLinearLayout
  from PyKDE4.plasma import Plasma   from PyKDE4.plasma import Plasma
  from PyKDE4 import plasmascript   from PyKDE4 import plasmascript



Thomas Olsen: Changed self.setLayout(self.layout) to self.applet.setLayout(self.layout)
2009-10-24T22:58:06Z
Changed self.setLayout(self.layout) to self.applet.setLayout(self.layout)

				
				
				
				
			
			← Older revision
			Revision as of 22:58, 24 October 2009
			
Line 34:
Line 34:
           label.setText("Hello world!")            label.setText("Hello world!")
           self.layout.addItem(label)            self.layout.addItem(label)
−          self.setLayout(self.layout) +          self.applet.setLayout(self.layout)
           self.resize(125,125)            self.resize(125,125)
    
Line 48:
Line 48:
  The third and most important step deals with creating a layout. It is a bit different than the standard <tt>QBoxLayout</tt> seen in Qt and PyQt, because it is done inside a <tt>QGraphicsView</tt> used by Plasma. We want a simple, linear layout, and so we use a <tt>QGraphicsLinearLayout</tt>, setting it to be horizontal (<tt>Qt.Horizontal</tt>).   The third and most important step deals with creating a layout. It is a bit different than the standard <tt>QBoxLayout</tt> seen in Qt and PyQt, because it is done inside a <tt>QGraphicsView</tt> used by Plasma. We want a simple, linear layout, and so we use a <tt>QGraphicsLinearLayout</tt>, setting it to be horizontal (<tt>Qt.Horizontal</tt>).
    
− Next we create a <tt>Plasma.Label</tt>. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout. Also, we set the applet's layout to be the one we have just defined using <tt>self.setLayout</tt>. Finally we resize the applet to 125 x 125 pixels.   + Next we create a <tt>Plasma.Label</tt>. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout. Also, we set the applet's layout to be the one we have just defined using <tt>self.applet.setLayout</tt>. Finally we resize the applet to 125 x 125 pixels. When using <tt>self.applet.setLayout(self.layout)</tt> it is really not necessary to resize the applet because the layout will make sure that the applet has a reasonable size.
    
  Once packaged and installed (see [[../GettingStarted | the Getting Started tutorial]]), the Plasmoid will look like this:   Once packaged and installed (see [[../GettingStarted | the Getting Started tutorial]]), the Plasmoid will look like this:



Agateau: /* The 'main.py' file */
2009-08-29T20:54:13Z
‎The 'main.py' file

				
				
				
				
			
			← Older revision
			Revision as of 20:54, 29 August 2009
			
Line 46:
Line 46:
  First of all we tell Plasma that this applet does not have a configuration dialog (<tt>self.setHasConfigurationInterface(False)</tt>). We then set the aspect ratio mode to a square (<tt>Plasma.Square</tt>). This is taken into account when someone resizes the applet. Next, we add a background to the applet using a SVG image provided by the standard Plasma theme. We do so by creating an instance of <tt>Plasma.Svg</tt>, assigning it to <tt>self.theme</tt>, and then specifying the SVG graphic we want to use via <tt>self.setImagePath()</tt>. This way the applet will use the standard "background" SVG provided by the "widgets" directory of our current Plasma theme. We can also use relative paths or absolute paths to SVGs of our choice, should we need to. The <tt>setBackgroundHints()</tt> method sets the Plasmoid's background to the default Plasma background (<tt>Plasma.Applet.DefaultBackground</tt>) saving us from having to manually draw the background ourselves.   First of all we tell Plasma that this applet does not have a configuration dialog (<tt>self.setHasConfigurationInterface(False)</tt>). We then set the aspect ratio mode to a square (<tt>Plasma.Square</tt>). This is taken into account when someone resizes the applet. Next, we add a background to the applet using a SVG image provided by the standard Plasma theme. We do so by creating an instance of <tt>Plasma.Svg</tt>, assigning it to <tt>self.theme</tt>, and then specifying the SVG graphic we want to use via <tt>self.setImagePath()</tt>. This way the applet will use the standard "background" SVG provided by the "widgets" directory of our current Plasma theme. We can also use relative paths or absolute paths to SVGs of our choice, should we need to. The <tt>setBackgroundHints()</tt> method sets the Plasmoid's background to the default Plasma background (<tt>Plasma.Applet.DefaultBackground</tt>) saving us from having to manually draw the background ourselves.
    
− The third and most important step deals with creating a layout. It is a bit different than the standard <tt>QLinearLayout</tt> seen in Qt and PyQt, because it is done inside a <tt>QGraphicsView</tt> used by Plasma. We want a simple, linear layout, and so we use a <tt>QGraphicsLinearLayout</tt>, setting it to be horizontal (<tt>Qt.Horizontal</tt>). + The third and most important step deals with creating a layout. It is a bit different than the standard <tt>QBoxLayout</tt> seen in Qt and PyQt, because it is done inside a <tt>QGraphicsView</tt> used by Plasma. We want a simple, linear layout, and so we use a <tt>QGraphicsLinearLayout</tt>, setting it to be horizontal (<tt>Qt.Horizontal</tt>).
    
  Next we create a <tt>Plasma.Label</tt>. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout. Also, we set the applet's layout to be the one we have just defined using <tt>self.setLayout</tt>. Finally we resize the applet to 125 x 125 pixels.     Next we create a <tt>Plasma.Label</tt>. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout. Also, we set the applet's layout to be the one we have just defined using <tt>self.setLayout</tt>. Finally we resize the applet to 125 x 125 pixels.  



Tampakrap: Added link to widget API definitions
2009-02-02T02:56:44Z
Added link to widget API definitions

				
				
				
				
			
			← Older revision
			Revision as of 02:56, 2 February 2009
			
Line 56:
Line 56:
  == Conclusion ==   == Conclusion ==
    
− This brief tutorial shows how to use Plasma widgets with your applet. Beside <tt>Plasma.Label</tt> there are many more widgets that you can use. + This brief tutorial shows how to use Plasma widgets with your applet. Beside <tt>Plasma.Label</tt> there are many more widgets that you can use. The [http://api.kde.org/4.x-api/kdelibs-apidocs/plasma/html/annotated.html C++ widget definitions] should be used till a python API is put up.
    
  Notice that at the moment you can only add widgets and create layouts directly in code. This means you can't use an application like Qt Designer to design the appearance of your applet.   Notice that at the moment you can only add widgets and create layouts directly in code. This means you can't use an application like Qt Designer to design the appearance of your applet.



Nielsslot at 20:35, 25 January 2009
2009-01-25T20:35:24Z


				
				
				
				
			
			← Older revision
			Revision as of 20:35, 25 January 2009
			
Line 48:
Line 48:
  The third and most important step deals with creating a layout. It is a bit different than the standard <tt>QLinearLayout</tt> seen in Qt and PyQt, because it is done inside a <tt>QGraphicsView</tt> used by Plasma. We want a simple, linear layout, and so we use a <tt>QGraphicsLinearLayout</tt>, setting it to be horizontal (<tt>Qt.Horizontal</tt>).   The third and most important step deals with creating a layout. It is a bit different than the standard <tt>QLinearLayout</tt> seen in Qt and PyQt, because it is done inside a <tt>QGraphicsView</tt> used by Plasma. We want a simple, linear layout, and so we use a <tt>QGraphicsLinearLayout</tt>, setting it to be horizontal (<tt>Qt.Horizontal</tt>).
    
− Next we create a <tt>Plasma.Label</tt>. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout.Also, we set the applet's layout to be the one we have just defined using <tt>self.setLayout</tt>. Finally we resize the applet to 125 x 125 pixels.   + Next we create a <tt>Plasma.Label</tt>. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout. Also, we set the applet's layout to be the one we have just defined using <tt>self.setLayout</tt>. Finally we resize the applet to 125 x 125 pixels.  
    
  Once packaged and installed (see [[../GettingStarted | the Getting Started tutorial]]), the Plasmoid will look like this:   Once packaged and installed (see [[../GettingStarted | the Getting Started tutorial]]), the Plasmoid will look like this:



Nielsslot: Add missing  tags.

2009-01-25T20:33:40Z
Add missing <tt> tags.

				
				
				
				
			
			← Older revision
			Revision as of 20:33, 25 January 2009
			
Line 46:
Line 46:
  First of all we tell Plasma that this applet does not have a configuration dialog (<tt>self.setHasConfigurationInterface(False)</tt>). We then set the aspect ratio mode to a square (<tt>Plasma.Square</tt>). This is taken into account when someone resizes the applet. Next, we add a background to the applet using a SVG image provided by the standard Plasma theme. We do so by creating an instance of <tt>Plasma.Svg</tt>, assigning it to <tt>self.theme</tt>, and then specifying the SVG graphic we want to use via <tt>self.setImagePath()</tt>. This way the applet will use the standard "background" SVG provided by the "widgets" directory of our current Plasma theme. We can also use relative paths or absolute paths to SVGs of our choice, should we need to. The <tt>setBackgroundHints()</tt> method sets the Plasmoid's background to the default Plasma background (<tt>Plasma.Applet.DefaultBackground</tt>) saving us from having to manually draw the background ourselves.   First of all we tell Plasma that this applet does not have a configuration dialog (<tt>self.setHasConfigurationInterface(False)</tt>). We then set the aspect ratio mode to a square (<tt>Plasma.Square</tt>). This is taken into account when someone resizes the applet. Next, we add a background to the applet using a SVG image provided by the standard Plasma theme. We do so by creating an instance of <tt>Plasma.Svg</tt>, assigning it to <tt>self.theme</tt>, and then specifying the SVG graphic we want to use via <tt>self.setImagePath()</tt>. This way the applet will use the standard "background" SVG provided by the "widgets" directory of our current Plasma theme. We can also use relative paths or absolute paths to SVGs of our choice, should we need to. The <tt>setBackgroundHints()</tt> method sets the Plasmoid's background to the default Plasma background (<tt>Plasma.Applet.DefaultBackground</tt>) saving us from having to manually draw the background ourselves.
    
− The third and most important step deals with creating a layout. It is a bit different than the standard <tt>QLinearLayout</tt> seen in Qt and PyQt, because it is done inside a <tt>QGraphicsView</tt> used by Plasma. We want a simple, linear layout, and so we use a QGraphicsLinearLayout, setting it to be horizontal (Qt.Horizontal). + The third and most important step deals with creating a layout. It is a bit different than the standard <tt>QLinearLayout</tt> seen in Qt and PyQt, because it is done inside a <tt>QGraphicsView</tt> used by Plasma. We want a simple, linear layout, and so we use a <tt>QGraphicsLinearLayout</tt>, setting it to be horizontal (<tt>Qt.Horizontal</tt>).
    
− Next we create a Plasma.Label. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout.Also, we set the applet's layout to be the one we have just defined using <tt>self.setLayout</tt>. Finally we resize the applet to 125 x 125 pixels.   + Next we create a <tt>Plasma.Label</tt>. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout.Also, we set the applet's layout to be the one we have just defined using <tt>self.setLayout</tt>. Finally we resize the applet to 125 x 125 pixels.  
    
  Once packaged and installed (see [[../GettingStarted | the Getting Started tutorial]]), the Plasmoid will look like this:   Once packaged and installed (see [[../GettingStarted | the Getting Started tutorial]]), the Plasmoid will look like this:



Einar: Add setLayout in the code and in the explanation
2009-01-19T20:38:17Z
Add setLayout in the code and in the explanation

				
				
				
				
			
			← Older revision
			Revision as of 20:38, 19 January 2009
			
Line 34:
Line 34:
           label.setText("Hello world!")            label.setText("Hello world!")
           self.layout.addItem(label)            self.layout.addItem(label)
  +         self.setLayout(self.layout)
           self.resize(125,125)            self.resize(125,125)
    
Line 47:
Line 48:
  The third and most important step deals with creating a layout. It is a bit different than the standard <tt>QLinearLayout</tt> seen in Qt and PyQt, because it is done inside a <tt>QGraphicsView</tt> used by Plasma. We want a simple, linear layout, and so we use a QGraphicsLinearLayout, setting it to be horizontal (Qt.Horizontal).   The third and most important step deals with creating a layout. It is a bit different than the standard <tt>QLinearLayout</tt> seen in Qt and PyQt, because it is done inside a <tt>QGraphicsView</tt> used by Plasma. We want a simple, linear layout, and so we use a QGraphicsLinearLayout, setting it to be horizontal (Qt.Horizontal).
    
− Next we create a Plasma.Label. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout. Finally we resize the applet to 125 x 125 pixels.   + Next we create a Plasma.Label. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout.Also, we set the applet's layout to be the one we have just defined using <tt>self.setLayout</tt>. Finally we resize the applet to 125 x 125 pixels.  
    
  Once packaged and installed (see [[../GettingStarted | the Getting Started tutorial]]), the Plasmoid will look like this:   Once packaged and installed (see [[../GettingStarted | the Getting Started tutorial]]), the Plasmoid will look like this:



Sedwards: fixed links
2009-01-18T11:50:02Z
fixed links

				
				
				
				
			
			← Older revision
			Revision as of 11:50, 18 January 2009
			
Line 5:
Line 5:
  == Prerequisites ==   == Prerequisites ==
    
− Set up your applet directory and create a <tt>metadata.desktop</tt> file as described in the [[../ | main tutorial]]. + Set up your applet directory and create a <tt>metadata.desktop</tt> file as described in the [[../GettingStarted | Getting Started tutorial]].
    
  == The 'main.py' file ==   == The 'main.py' file ==
Line 49:
Line 49:
  Next we create a Plasma.Label. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout. Finally we resize the applet to 125 x 125 pixels.     Next we create a Plasma.Label. This is a widget that is Plasma aware and therefore uses all of the goodies provided by Plasma. For example, automatically changing its text color if the Plasma theme changes. We then use the <tt>setText()</tt> method (analogous to the normal <tt>QLabel.setText()</tt> method) to set our label text ("Hello, world!") and then add the label to the layout. Finally we resize the applet to 125 x 125 pixels.  
    
− Once packaged and installed (see [[../ | the main tutorial]]), the Plasmoid will look like this: + Once packaged and installed (see [[../GettingStarted | the Getting Started tutorial]]), the Plasmoid will look like this:
    
  [[Image:Helloworld.png|center]]   [[Image:Helloworld.png|center]]

@@ Line 41: / Line 41: @@
      return HelloWorldApplet(parent)
-</code>
+</syntaxhighlight>
 Let's take a deeper look at it. As in the main tutorial, we create our class by deriving from the <tt>plasmascript.Applet</tt> class. In <tt>__init__()</tt>, we quickly initialize the class. We use the <tt>init()</tt> method instead to do all the dirty work of creating the applet and adding the widget needed to display the text.

Development/Tutorials/Plasma/Python/Using widgets - Revision history

Neverendingo: Text replace - "" to ""

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

Phobie: /* The 'main.py' file / never "use from x import "!

Thomas Olsen: Changed self.setLayout(self.layout) to self.applet.setLayout(self.layout)

Agateau: /* The 'main.py' file */

Tampakrap: Added link to widget API definitions

Nielsslot at 20:35, 25 January 2009

Nielsslot: Add missing `tags.`

Einar: Add setLayout in the code and in the explanation

Sedwards: fixed links