Development/Tutorials/Plasma/ThemeDetails - Revision history

Šumski: /* Current Theme Elements */

2013-01-27T19:50:58Z

‎Current Theme Elements

Manutortosa: Add information regarding the IDs in kde 4.10

2012-11-24T18:41:33Z

Add information regarding the IDs in kde 4.10

Mart: /* Current Theme Elements */

2012-10-10T13:09:42Z

‎Current Theme Elements

Mart: /* Current Theme Elements */

2012-10-09T17:01:30Z

‎Current Theme Elements

Mart: /* Current Theme Elements */

2012-10-09T16:24:08Z

‎Current Theme Elements

Minio: /* Current Theme Elements */ added some info about places when theme files are most visible. I had hard time finding out what some files do, hope this will help someone

2012-07-06T19:33:18Z

‎Current Theme Elements: added some info about places when theme files are most visible. I had hard time finding out what some files do, hope this will help someone

Minio: fixed markup mistakes

2012-07-06T19:20:07Z

fixed markup mistakes

Mart: /* Current Theme Elements */

2011-11-30T20:59:26Z

‎Current Theme Elements

Mart: /* Current Theme Elements */

2011-10-11T15:35:55Z

‎Current Theme Elements

Mart: /* Current Theme Elements */

2011-10-11T12:22:48Z

‎Current Theme Elements

@@ Line 279: / Line 279: @@
 *** ''focus'': will be drawn outside base, when the line edit has input focus
 *** ''hover'': will be drawn outside base, when the line edit is under the mouse
 ** '''/monitor.svgz''' : represents a screen, it's used in places such as the wallpaper config dialog. It contains a frame without prefixes and the following extra elements:
 *** ''glass'' : glass reflection effect over the screen

@@ Line 444: / Line 444: @@
 * Quassel IRC
 ** filename: '''quassel.svgz'''
-*** quassel öffline ID: '''quassel_inactive'''
+*** quassel öffline ID: '''quassel_inactive'''  ("quassel-inactive" in kde 4.10)
 *** quassel online ID: '''quassel'''
-*** quassel new message ID: '''quassel_message'''
+*** quassel new message ID: '''quassel_message''' ("quassel-message" in kde 4.10)
 * KWallet
 ** filename: '''wallet.svgz'''

@@ Line 168: / Line 168: @@
 *'''/dialogs''': elements for dialogs
 **'''/background.svg''': generic dialog background used by the sceensaver password dialog, etc. See the section on backgrounds above for information on the required elements in this file.
 **'''/krunner.svg''': dialog background, used by the Run Command. Please note, that this is used only when <menuchoice>Positioning</menuchoice> is set to <menuchoice>Free floating window</menuchoice>, '''not''' <menuchoice>Top edge of screen</menuchoice> (which is default). See the section on backgrounds above for information on the required elements in this file.
 **'''/shutdowndlg.svg''': background and buttons for the log out dialog
@@ Line 190: / Line 194: @@
 **'''/arrows.svg''': arrows that match the theme. Four elements should exist in this svg: up-arrow, down-arrow, left-arrow, right-arrow.
 **'''/background.svg''': a background image for plasmoids. See the section on backgrounds above for information on the required elements in this file.
 ** '''/bar_meter_horizontal.svg''': an horizontal meter like a progressbar
 ***''background'': background of the progressbar

@@ Line 284: / Line 284: @@
 *** if a prefix called ''shadow'' is available, it will be used as a drop shadow for the panel when compositing is available.
 ** '''/plot-background.svg''': a background for plotter (graph) widgets, such as the plots in ksysguard
-** '''/scrollbar.svgz''' : the classical ''elevator'' scrollbar, must have the following elemens : ''arrow-up'', ''mouseover-arrow-up'', ''sunken-arrow-up'', same 3 elements for ''arrow-left'', ''arrow-right'' and ''arrow-bottom'. From KDE 4.10 it can have an element called ''hint-scrollbar-size' that says at what size the scrollbar should be rendered (width if vertical, height if horizontal). It must also have frames with the following prefixes:
+** '''/scrollbar.svgz''' : the classical ''elevator'' scrollbar, must have the following elemens : ''arrow-up'', ''mouseover-arrow-up'', ''sunken-arrow-up'', same 3 elements for ''arrow-left'', ''arrow-right'' and ''arrow-bottom''. From KDE 4.10 it can have an element called ''hint-scrollbar-size'' that says at what size the scrollbar should be rendered (width if vertical, height if horizontal). It must also have frames with the following prefixes:
 *** ''slider''
 *** ''mouseover-slider''

@@ Line 284: / Line 284: @@
 *** if a prefix called ''shadow'' is available, it will be used as a drop shadow for the panel when compositing is available.
 ** '''/plot-background.svg''': a background for plotter (graph) widgets, such as the plots in ksysguard
-** '''/scrollbar.svgz''' : the classical ''elevator'' scrollbar, must have the following elemens : ''arrow-up'', ''mouseover-arrow-up'', ''sunken-arrow-up'', same 3 elements for ''arrow-left'', ''arrow-right'' and ''arrow-bottom'. It must also have frames with the following prefixes:
+** '''/scrollbar.svgz''' : the classical ''elevator'' scrollbar, must have the following elemens : ''arrow-up'', ''mouseover-arrow-up'', ''sunken-arrow-up'', same 3 elements for ''arrow-left'', ''arrow-right'' and ''arrow-bottom'. From KDE 4.10 it can have an element called ''hint-scrollbar-size' that says at what size the scrollbar should be rendered (width if vertical, height if horizontal). It must also have frames with the following prefixes:
 *** ''slider''
 *** ''mouseover-slider''

@@ Line 168: / Line 168: @@
 *'''/dialogs''': elements for dialogs
 **'''/background.svg''': generic dialog background used by the sceensaver password dialog, etc. See the section on backgrounds above for information on the required elements in this file.
-**'''/krunner.svg''': dialog background, used by the Run Command. See the section on backgrounds above for information on the required elements in this file.
+**'''/krunner.svg''': dialog background, used by the Run Command. Please note, that this is used only when <menuchoice>Positioning</menuchoice> is set to <menuchoice>Free floating window</menuchoice>, '''not''' <menuchoice>Top edge of screen</menuchoice> (which is default). See the section on backgrounds above for information on the required elements in this file.
 **'''/shutdowndlg.svg''': background and buttons for the log out dialog
 ***''background'': background for the logout dialog
@@ Line 257: / Line 257: @@
 *** ''hint-preferred-icon-size'': the size icons within the drag handle should get. The vertical size of the dragger is also derived from this: this size hint + the dragger's margins.
 ** '''/extender-background.svgz''': background for extenders. It needs the same elements as other backgrounds.
-** '''/extender-dragger.svgz''': Same as dragger.svgz. Drag handle for extenders (like the popup date of clock applets, KDE 4.2 and later). It needs to contain the same elements as other backgrounds, see the section about backgrounds above. In addition it needs the following element:
+** '''/extender-dragger.svgz''': Same as dragger.svgz. Drag handle for extenders (like the notification applet, KDE 4.2 and later). It needs to contain the same elements as other backgrounds, see the section about backgrounds above. In addition it needs the following element:
 *** ''hint-preferred-icon-size'': the size icons within the drag handle should get. The vertical size of the dragger is also derived from this: this size hint + the dragger's margins.
 *** Since KDE 4.6 it contains two optional prefixes: ''grouped'' for extender items contained in extender groups and ''root'' for root extender items. The version without prefix must still exist and is still used for extenders that don't have a stacked appearance.
@@ Line 280: / Line 280: @@
 **'''/panel-background.svg''': the background image for panels.
 *** If you want to create different background for panels located at the top, bottom, left or right, then also create sets of background elements with the following prefixes: ''north'', ''south'', ''west'' and ''east'' respectively. For example the center element of the left positioned panel's background should be named ''west-center''. (KDE 4.1 and later)
-*** When the panel is not 100% wide/tall the north, south etch prefixes becomes ''north-mini'' etc. (KDE 4.2 and later)
+*** When the panel is not 100% wide/tall the north, south etc. prefixes becomes ''north-mini'', ''south-mini'' etc. (KDE 4.2 and later). Please note that if KRunner <menuchoice>Positioning</menuchoice> is set to <menuchoice>Top edge of screen</menuchoice> (which is default), then KDE treats it as not 100% wide north panel.
 *** All prefixes fallback to a no prefix version when not available
 *** if a prefix called ''shadow'' is available, it will be used as a drop shadow for the panel when compositing is available.
@@ Line 317: / Line 317: @@
 ** '''/translucentbackground.svg''': a standard background image for plasmoids that for their nature are bigger and with not much text. In this case a translucent background looks better. It needs the same elements of background.svg in it. If this file is not present, the plasmoids that uses this will use background.svg instead.
 ** '''/media-delegate.svgz''': intended to be used as delegate for media types: as KDE 4.7 contains a single prefix: picture.
-** '''/viewitem.svgz''': controls the background look of selections, it can have 4 elements of 9 parts each with prefix ''normal'', ''hover'', ''selected'', ''selected+hover''.
+** '''/viewitem.svgz''': controls the background look of selections (results in KRunner, networks in network applet), it can have 4 elements of 9 parts each with prefix ''normal'', ''hover'', ''selected'', ''selected+hover''.
 ** '''/toolbar.svgz''': used in the ToolBar QML component, can be used in custom applications in a similar way, contains a single frame without prefix. Since KDE 4.8.

@@ Line 29: / Line 29: @@
 * '''colors''': optional a configuration file defining a colorscheme that blends well with the images
-* '''dialogs/'''': images for dialogs
+* '''dialogs/''': images for dialogs
 * '''wallpapers/''': wallpaper packages
 * '''widgets/''': images for widgets
@@ Line 137: / Line 137: @@
 * '''hint-overlay-random-pos''' it will be put at a random position, this works just for applet backgrounds
 * '''hint-overlay-tile''' tile the overlay
-* '''hint-overlay-stretch'' the overlay will be stretched
+* '''hint-overlay-stretch''' the overlay will be stretched
 * '''hint-overlay-pos-right''' align the overlay at right of the background rather than to the left (from KDE 4.4)
 * '''hint-overlay-pos-bottom''' align the overlay at bottom of the background rather than to the top (from KDE 4.4)
@@ Line 200: / Line 200: @@
 ** '''/bar_meter_vertical.svg''': a vertical meter like a vertical progressbar. It has the same format of ''/bar_meter_horizontal.svg''
 ** '''/branding.svgz''': a little KDE logo that can be customized by distributors as a branding element. Contains a single element called ''brilliant''
-** ''''/busywidget.svgz''': Used to indicate a busy state, it's a circular image that will be animated with a rotation.
+** '''/busywidget.svgz''': Used to indicate a busy state, it's a circular image that will be animated with a rotation.
 *** ''busywidget'': the main spinner
 *** ''paused'': the paused state

@@ Line 262: / Line 262: @@
 ** '''/frame.svgz''' : a generic frame, used mostly for widget containers, to visually group widgets together. It must contain the following prefixes, for different 3d looks:
 *** ''sunken''
 *** ''plain''
 *** ''raised''
@@ Line 298: / Line 297: @@
 *** ''vertical-slider-focus'': background for the handle when it has input focus (since KDE 4.4)
 *** ''vertical-slider-hover'': background for the handle when it is under the mouse (since KDE 4.4)
 *** ''horizontal-slider-line'': the background for horizontal sliders
 *** ''horizontal-slider-handle'': the handle for horizontal sliders