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:xfce4-panel:preferences [2012/07/03 11:26] – Added a comment on panel plugin alignment andrzejrxfce:xfce4-panel:preferences [2024/12/11 11:30] (current) – kevinbowen
Line 1: Line 1:
-====== Preferences ======+~~NOTOC~~ 
 +{{ :xfce:xfce4-panel.png?nolink|}} 
 +====== xfce4-panel - Preferences ====== 
 +  * **[[#Selecting a Panel|Selecting a Panel]]** 
 +  * **[[#Display|Display]]** 
 +  * **[[#General|General]]** 
 +  * **[[#Measurements|Measurements]]** 
 +  * **[[#Appearance|Appearance]]** 
 +  * **[[#Background|Background]]** 
 +  * **[[#Opacity|Opacity]]** 
 +  * **[[#Items|Items]]**
  
-The Xfce //Panel Preferences// dialog gives you the ability to customize your panel. You can change the size, appearance, and orientation of your panels. You can also add or remove extra panels on your desktop. +----
  
-<figure "Panel Preferences Dialog"> +The Panel Preferences window gives you the ability to customize your panel. You can change the size, appearance and orientation of your panels, as well as add add or remove panels on your desktop. These can be backed up on your system to be restored at a later date. 
-{{:xfce:xfce4-panel:preferences.png?nolink&|}}+ 
 +The preferences can be accessed by going to **Settings Manager** then clicking on **Panel**, or by right-clicking on a panel and selecting **Panel Preferences...**. 
 + 
 +<figure "Panel Preferences Window"> 
 +{{:xfce:xfce4-panel:xfce-panel-prefs.png|Panel Preferences Window}}
 </figure> </figure>
-===== Accessing Panel Preferences ===== 
  
-The panel preferences can be opened by going to {gui>Settings>Panel} in your applications menu. You can also access panel preferences by right clicking on your panel and going to Panel Settings. If you right click on space occupied by a panel plugin, you can access panel preferences by going to {gui>Panel>Panel Preferences...}. +----
  
 ===== Selecting a panel ===== ===== Selecting a panel =====
  
-You can select a panel from the drop down list at the top of the dialog. Next to this are two buttons that can be used to remove (-) the currently selected panel or add (+) a new empty panel.+You can choose which panel to customize by selecting it from the drop-down menu at the top of the window. Next to this are two buttons that can be used to add (+) a new empty panel and remove (-) the currently selected panel.
  
-The panel selected in the dialog should also show a selection around the panel, so it is clear which panel you are editing.+The panel currently selected will show a flashing, dashed red border around it, so it's clear which panel you are currently editing. 
 + 
 +----
  
 ===== Display ===== ===== Display =====
 +The **Display** tab contains options for how the panel is positioned on the screen. 
  
-This tab hold the settings how the panel is positioned on the screen.  +----
- +
-==== General ====+
  
 +===== General =====
 ? Mode ? Mode
-! Set the panel mode to horizontal, vertical or deskbar. In the deskbar mode, the panel is oriented vertically, just like in the vertical mode, while panel plugins are laid out horizontally. This mode works best with "number of rows" set to 2 or more.+! Set the panel mode to Horizontal, Vertical or Deskbar. In the Deskbar mode, the panel is oriented vertically, while panel plugins are oriented horizontally. This mode works best with **Number of rows** set to 2 or more.
 ? Output ? Output
-! Select the output (such as an secondary monitor) on which this panel should appear. If the output is not connected, the panel will not be shown. +! Select the output (such as a secondary monitor) on which the panel should appear.
 ? Span monitors ? Span monitors
-! If you have multiple monitors connected to the computer, this option will appear in the properties dialog. This will tell the panel to stretch across multiple monitors instead of only being restricted to one monitor. It look at the total screen size instead of the size of an individual monitor. +! This option causes the panel to span across multiple monitors instead of only being restricted to one display. 
 +<note tip>The **Output** and **Span Monitors** options are only displayed if an output is detected.</note>
 ? Lock panel ? Lock panel
-! Don't show the handles on the panel which allow you to move the panel. When this option is disabled, you can drag the panel anywhere you want on your screen. The panel will also snap to the edges of your screen.  +! Doesn't display the handles on either side of the panel which allow you to drag it around the screen. When this option is disabled, you can drag the panel anywhere you want on your screen to position it. The panel will automatically snap to the edges of your screen.  
-? Automatically show and hide the panel +? Automatically hide the panel 
-! Automatically hide the panel if the mouse is not hovering over it.  +  ? Never 
-? Don't reserve space on borders +  ! Always shows the panel. 
-! Normally, maximized application windows do not overlap the panel. Setting this option disables this behavior and allows the windows to stretch to the screen edge.+  ? Intelligently 
 +  ! Hide the panel when the currently focused window overlaps the panel. 
 +  ? Always 
 +  ! Always hide the panel.
  
-==== Measurements ====+! If you want to disable the autohide animation you can use the hidden setting **popdown-speed**.
  
-? Row Size +! <code> 
-! Change the height (or width, if the panel is in the vertical or deskbar mode) of the single row of the panel. The total panel height (or width) is equal to the "Row Size" × "Number of rows". The size is specified in pixels.+xfconf-query -n -c xfce4-panel -p /panels/panel-2/popdown-speed -t int -s 0 
 +</code> 
 + 
 +! You can also act on the delay to show/hide the panel by adjusting the following in ''~/.config/gtk-3.0/gtk.css'' (create the file if necessary): 
 + 
 +! <code> 
 +* { 
 +  -XfcePanelWindow-popup-delay: 1000; 
 +  -XfcePanelWindow-popdown-delay: 1000; 
 +  -XfcePanelWindow-autohide-size: 10; 
 +} 
 +</code> 
 + 
 +! Note that the minimum autohide-size is 1. 
 + 
 +? Keep panel above windows 
 +! Normally, maximized application windows do not overlap the panel. Setting this option disables this behavior and allows the windows to stretch to the screen edge behind the panel. This option is only available when the panel is set to never hide. 
 + 
 +[[|Back to Top]] 
 +---- 
 + 
 +===== Measurements ===== 
 +? Row Size (pixels) 
 +! Change the height (or width, if the panel is in Vertical or Deskbar mode) of a single row of the panel. The total panel height (or width) is equal to the "Row Size" × "Number of rows".
 ? Number of rows ? Number of rows
-! Change the number of rows (or columns, if the panel is in the vertical or deskbar mode) of the panel. Small panel plugins, such as [[launcher|launchers]], will be laid out in multiple rows (or columns), while larger ones, like [[tasklist|window buttons]] will continue to occupy the whole panel height (or width). +! Change the number of rows (or columns, if the panel is in Vertical or Deskbar mode) of the panel. Smaller panel plugins, such as [[launcher|launchers]], will be laid out in multiple rows (or columns), while larger ones, like [[tasklist|window buttons]] will continue to occupy the whole panel height (or width). 
-? Length +? Length (pixels) 
-! Change the width (or height, if the panel is in the vertical or deskbar mode) of the panel. The size is specified as a percentage of the width (or height) of the monitor screen. +! Change the width (or height, if the panel is in Vertical or Deskbar mode) of the panel. The size is specified in pixels to allow precise adjustment, for example when a horizontal and a vertical panel might overlap. However it is stored internally in percentages of the monitor size, so that when changing monitors the proportions should be respected. 
-? Automatically increase length +? Automatically increase the length 
-! Increase the length of the panel length to accommodate all the plugins. This option is useful for setting up short panels, which expand as the panel contents changes.+! Automatically increase the length of the panel to accommodate all the plugins. This option is useful when setting up short panels, which can be enabled to expand as content gets added.
  
-By default the panel distributes the plugins from left to right (or from top to bottom, if the panel is in the vertical or deskbar mode). However, it is possible to align plugins to the center to the right (or bottom) of the panel by inserting an expandable [[separator|separator]] to the left (or above) these plugins. By inserting two or more expandable separators it is also possible to position plugins at the center of the panel.+By default, the panel distributes the plugins from left to right (or from top to bottom, if the panel is in Vertical or Deskbar mode). However, it is possible to align plugins to the center or to the right (or bottom) of the panel by inserting [[separator|separators]] to the left (or above) these plugins. By inserting at least two expandable separators it is also possible to position plugins at the center of the panel. 
 + 
 +[[|Back to Top]] 
 +----
  
-<note tip> 
-NOTE: 
-If you have upgraded to Xfce 4.10 and all your panel plugins have shifted to the left (or top) of the panel, please use an expandable [[separator|separator]] as described above. In Xfce 4.8 the [[tasklist|window buttons]] plugin was expandable as well, but it is no longer the case in Xfce 4.10. 
-</note> 
 ===== Appearance ===== ===== Appearance =====
 +The **Appearance** tab contains options for styling the currently selected panel.
 +
 +<figure "Panel Appearance Preferences">
 +{{:xfce:xfce4-panel:xfce-panel-appearance.png|Panel Appearance Preferences}}
 +</figure>
  
-This tab contains the style settings of the currently selected panel. +[[|Back to Top]] 
 +----
  
-==== Background ====+===== Background =====
  
 ? Style ? Style
-! This allows you to change the transparency, color, and background image of the panel. You have three options to choose from. +! This allows you to use a solid color, background image, or adopt the system style for the background of the panel. 
-  ? None (user system style) +  ? None (use system style) 
-  ! The panel inherits colors from the currently selected GTK+ theme. You can view and change the current GTK+ theme by going to {gui>Settings>Appearance}. +  ! The panel inherits colors from the currently selected GTK+ theme. You can view or change the theme by going to {gui>Settings Manager>Appearance}. 
   ? Solid Color   ? Solid Color
-  ! You can select a color using the provided color picker. The color you select will be applied to the panel. +  ! You can select a color using the provided color picker, by choosing a custom color you can also change the opacity. The color you select will be applied to the panel. Continue reading here about [[xfce:xfce4-panel:preferences:transparent-panel|how to create a partially transparent panel]].
   ? Background Image   ? Background Image
   ! Select a background for your panel.    ! Select a background for your panel. 
-? Alpha 
-! Change the alpha transparency of the panel. Some panel plugins may still retain a non-transparent background. This option is only available if your panel style is set to {gui>None} or {gui>Solid Color}.  
-! <note tip>The opacity and alpha settings are only available if the X server supports compositing and this is enabled in the window manager. To enabled this in Xfwm4 activate {gui>Settings>Window Manager Tweaks>Compositor>Enable display compositing} from the applications menu. </note> 
 ? Color ? Color
-! Clicking this activates a color picker. You can select a color by using the color wheel, entering a hex value, or entering a color name. This option is only available if your panel style is set to {gui>Solid Color}. +! Clicking this activates a color picker. You can select a color by using the options available, entering a hex value, or a color name. This option is only available if your panel style is set to {gui>Solid color}. 
 ? File ? File
-! This allows you to select a background for the panel using a file browser. This option is only available if your panel style is set to {gui>Background Image}.+! This displays a file manager window to select an image to be used as the background for the panel. This option is only available if your panel style is set to {gui>Background image}.
  
-==== Opacity ====+[[|Back to Top]] 
 +----
  
 +===== Opacity =====
 These options set the transparency of the entire panel.  These options set the transparency of the entire panel. 
 +
 +<note important>Panel transparency is only available if display compositing is enabled in **Settings Manager -> Window Manager Tweaks -> Compositor**.</note>
  
 ? Enter ? Enter
-! This controls the transparency of the panel when a mouse pointer is not hovering over it. Ranges from 0 (fully transparent) and 100 (fully opaque). All panel plugins will be affected by this setting. +! This controls the transparency of the panel when hovering over it. Ranges from 0 (fully transparent) to 100 (fully opaque). All panel plugins are affected by this setting. 
 ? Leave ? Leave
-! This controls the transparency of the panel when a mouse pointer is not hovering over it. Ranges from 0 (fully transparent) and 100 (fully opaque). All panel plugins will be affected by this setting. +! This controls the transparency of the panel when not hovering over it. Ranges from 0 (fully transparent) to 100 (fully opaque). All panel plugins are affected by this setting.  
 + 
 +[[|Back to Top]] 
 +----
  
 ===== Items ===== ===== Items =====
-This shows the items that are placed on the currently selected panel. In case items are hard to move or edit on the panel using the right-click menu, this tab allows you to move, add, remove and access the preferences of the items on the panel.+The **Items** tab displays the panel plugins that are on the selected panel, with options to move them, add or remove new items, edit the item and view information about the plugin.
  
-This tab contains a row of buttons that allow you to manipulate the items on the panel. +<figure "Panel Items Preferences"> 
- +{{:xfce:xfce4-panel:xfce-panel-items.png|Panel Items Preferences}} 
-With the {gui>up} and {gui>down} buttons you can move the currently selected item in the panel.+</figure>
  
-The {gui>add} button opens the [[add-new-items|add new items]] dialog. With the {gui>remove }button you can remove the currently selected item from the panel.+To the right of the list of panel plugins are various buttons. Hovering over them will display a tooltip explaining what they do.
  
-The {gui>preferences} and {gui>about} buttons are only active if the plugin support these features. It will open the selected items' settings.+Using the {gui>up} and {gui>down} buttons you can move the currently selected item in the panel.
  
-Only limitation in this dialog, compared to mouse handling, is that you cannot move items between panels and access custom menu items a plugin can add in the item menu.+The {gui>add} button opens the [[add-new-items|Add New Items]] window where you can add more plugins to the panel, and the {gui>remove} button allows you to remove the currently selected item from the panel.
  
 +The {gui>preferences} and {gui>about} buttons are only active if the highlighted plugin supports these features. They will open the selected item's preferences and "About" window.
  
 +[[|Back to Top]]
 +----
 +[[:xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]