Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
xfce:xfdesktop:advanced [2012/01/15 19:45] – [Advanced] nickxfce:xfdesktop:advanced [2024/12/11 12:38] (current) – kevinbowen
Line 1: Line 1:
-====== Advanced ====== +~~NOTOC~~ 
- +{{ :xfce:xfdesktop.png?nolink|}} 
-<note warning>This page is work in progress!</note>+======  xfdesktop - Advanced Options ======
  
 ===== Hidden Options ===== ===== Hidden Options =====
  
-There are a number of hidden options that cannot be set by the Xfce Settings Manager. These require use of a text editor.+<note tip>Xfdesktop now uses [[:xfce:xfconf:start:|Xfconf]] to store its configuration.  Xfconf is a 
 +hierarchical configuration system.  The channel name that xfdesktop uses 
 +is 'xfce4-desktop'.</note>
  
-Icon View Text Appearance 
  
-The colors of the icon text and the icon text background, as well as the opacity of the icon text background, can be customized by putting directives simiar to the following in your ~/.gtkrc-2.0 file:+The entire list of ''xfconf'' options for ''xfdesktop'' can be found in the [[https://gitlab.xfce.org/xfce/xfdesktop/-/blob/master/doc/README.xfconf|README]]. 
 + 
 +---- 
 + 
 +<note warning>The following information applies only to GTK 2, and therefore not the GTK 3 version of ''xfdesktop''.</note> 
 + 
 +There are a number of hidden options that cannot be set by the Xfce Settings Manager; these require use of a text editor. 
 + 
 +==== List of icon view appearance settings ==== 
 + 
 +The colors of the icon text and the icon text background, as well as the opacity of the icon text background and icon layout can be customized by putting directives similar to the following in your ~/.gtkrc-2.0 file:
  
   style "xfdesktop-icon-view" {   style "xfdesktop-icon-view" {
       XfdesktopIconView::label-alpha = 75       XfdesktopIconView::label-alpha = 75
 +      XfdesktopIconView::selected-label-alpha = 100
 +      XfdesktopIconView::ellipsize-icon-labels = 1
 +      XfdesktopIconView::tooltip-size = 128
 +  
 +      XfdesktopIconView::shadow-x-offset = 1
 +      XfdesktopIconView::shadow-y-offset = 1
 +      XfdesktopIconView::shadow-color = "#ff0000"
 +      XfdesktopIconView::selected-shadow-x-offset = 2
 +      XfdesktopIconView::selected-shadow-y-offset = 2
 +      XfdesktopIconView::selected-shadow-color = "#00ff00"
 +  
 +      XfdesktopIconView::cell-spacing = 6
 +      XfdesktopIconView::cell-padding = 6
 +      XfdesktopIconView::cell-text-width-proportion = 2.5
      
       base[NORMAL] = "#00ff00"       base[NORMAL] = "#00ff00"
Line 23: Line 48:
   }   }
   widget_class "*XfdesktopIconView*" style "xfdesktop-icon-view"   widget_class "*XfdesktopIconView*" style "xfdesktop-icon-view"
-           
  
-The first entry sets the opacity of the rounded text background. The three "base" entries set the text background color, and the three "fg" entries set the text color.+==== Icon view text appearance ==== 
 + 
 +The first four entries set the opacity of the rounded text background 
 +(allowed values are from 0 (totally transparent) to 255 (totally opaque), 
 +and whether or not unselected icons get their labels ellipsized 
 +(truncated) to fit on one line.  (The 'selected-' version controls the 
 +opacity of icons that have been selected with the mouse.) The tooltip-size 
 +determines how large the image preview will be when the mouse is hovered 
 +over an icon (allowed values are from 0 (not shown) to 512, values larger 
 +than 256 may cause poor image quality however.) 
 + 
 +==== Shadow appearance ==== 
 + 
 +The second six entries can be used to enable a text shadow to be painted 
 +with the icon labels.  The offsets are in pixels.  Setting them to 0 (the 
 +defaults) will disable the shadows entirely.  Again, the 'selected-' 
 +versions apply to icons that have been selected with the mouse. 
 + 
 +==== Icon grid ==== 
 + 
 +The third four entries set spacing and sizing for individual icons on 
 +the grid.  The 'cell-spacing' property specifies the spacing between each 
 +'cell' in the grid of icons.  The 'cell-padding' property sets extra 
 +padding placed around each icon+text.  The units for these two are in 
 +pixels.  The 'cell-text-width-proportion' property specifies the maximum 
 +width of the text label underneat the icon, as a multiplier of the icon 
 +width (so for 30px icons, '2.5' would leave a 75px wide area underneath 
 +for the text). 
 + 
 +==== Text and text background colors ==== 
 + 
 +The fourth three entries set the color of the rounded text background. 
 +  * NORMAL sets the color for the regular, unselected state. 
 +  * SELECTED sets the color for when the icon is selected, and the desktop has keyboard/mouse focus. 
 +  * ACTIVE sets the color for when the icon is selected, but the desktop does not have keyboard/mouse focus. 
 + 
 +The final three entries set the color of the label text.  See above for the 
 +differences between NORMAL, SELECTED, and ACTIVE. 
 + 
 +[[|Back to Top]] 
 +---- 
 + 
 +===== Hidden xfconf Options ===== 
 +There are some hidden ''xfconf'' settings that cannot be set by the Desktop settings application. You can edit these settings under "xfce4-desktop" in ''xconf''. For more information, see the [[:xfce:xfconf:start:|xfconf documentation]]. 
 + 
 +? /desktop-icons/right-click-edits-menu 
 +! Boolean, default is TRUE. 
 +! This value controls whether right-clicking on a menu item pops up the **Edit Launcher** dialog. 
 + 
 +? /desktop-icons/center-text 
 +! Boolean, default is TRUE. 
 +! This value controls whether the text for all the desktop icon labels are centered.
  
-The "NORMAL" entries set the color for the regular, unselected state. The "SELECTED" entries set the color for when the icon is selected, and the desktop has keyboard focus. The "ACTIVE" entries set the color for when the icon is selected, but the desktop does not have keyboard focus. +? /desktop-menu/max-template-files 
 +! Integer, default value is 16. 
 +! This value controls how many items will appear in the **Create From Template** sub-menu.
  
-===== Command line =====+The entire list of ''xfconf'' options for ''xfdesktop'' can be found in the [[https://gitlab.xfce.org/xfce/xfdesktop/-/blob/master/doc/README.xfconf|README]].
  
-You can open the menu or window list from the commandline as well. This can be useful for keyboard shortcuts. To open the menu run the command xfdesktop --menu, and for the windowlist use xfdesktop --windowlist. To cause the current running instance to quit, run xfdesktop --quit. +[[|Back To Top]] 
 +---- 
 +[[:xfce:xfdesktop:start:|Return to xfdesktop Main Documentation Page]]