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 [2019/04/11 15:05] – [Background] blueberrybrowniexfce: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 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. 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.
  
 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...**. 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:xfce4-panel-preferences-display.png?nolink&|}}</figure>+<figure "Panel Preferences Window"> 
 +{{:xfce:xfce4-panel:xfce-panel-prefs.png|Panel Preferences Window}} 
 +</figure> 
 + 
 +----
  
 ===== Selecting a panel ===== ===== Selecting a panel =====
Line 11: Line 28:
  
 The panel currently selected will show a flashing, dashed red border around it, so it's clear which panel you are currently 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.  The **Display** tab contains options for how the panel is positioned on the screen. 
 +
 +----
  
 ===== General ===== ===== General =====
Line 32: Line 53:
   ? Always   ? Always
   ! Always hide the panel.   ! Always hide the panel.
-? Don't reserve space on borders+ 
 +! If you want to disable the autohide animation you can use the hidden setting **popdown-speed**. 
 + 
 +! <code> 
 +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. ! 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 ===== ===== Measurements =====
Line 40: Line 83:
 ? Number of rows ? Number of rows
 ! 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). ! 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 Vertical or Deskbar mode) of the panel. The size is specified as a percentage of the width (or height) of the display.+! 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 the length ? Automatically increase the length
 ! 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. ! 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 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. 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]]
 +----
  
 ===== Appearance ===== ===== Appearance =====
 The **Appearance** tab contains options for styling the currently selected panel. The **Appearance** tab contains options for styling the currently selected panel.
  
-<figure "Panel Appearance Preferences">{{:xfce:xfce4-panel:xfce4-panel-preferences-appearance.png?nolink&|}}</figure>+<figure "Panel Appearance Preferences"> 
 +{{:xfce:xfce4-panel:xfce-panel-appearance.png|Panel Appearance Preferences}} 
 +</figure> 
 + 
 +[[|Back to Top]] 
 +----
  
 ===== Background ===== ===== Background =====
Line 59: Line 110:
   ! The panel inherits colors from the currently selected GTK+ theme. You can view or change the theme by going to {gui>Settings Manager>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, by choosing a custom color you can also change the opacity. 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. 
Line 67: Line 118:
 ! 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}. ! 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. 
- +
-====== 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.+[[|Back to Top]] 
 +----
  
-This tab contains a row of buttons that allow you to manipulate the items on the panel.+===== Items ===== 
 +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.
  
-With the {gui>up} and {gui>down} buttons you can move the currently selected item in the panel.+<figure "Panel Items Preferences"> 
 +{{:xfce:xfce4-panel:xfce-panel-items.png|Panel Items Preferences}} 
 +</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]]