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:launcher [2012/01/11 23:50] – [Launcher] nickxfce:xfce4-panel:launcher [2024/12/11 11:31] (current) – kevinbowen
Line 1: Line 1:
-====== Launcher ======+~~NOTOC~~ 
 +{{ :xfce:xfce4-panel.png?nolink|}} 
 +====== xfce4-panel - Launcher ====== 
 +The Launcher panel plugin allows you to create application shortcuts and display them on your panel.
  
-The //Launcher// panel plugin allows you to create application shortcuts and display them in your panel.+  * **[[#General|General]]** 
 +  * **[[#Advanced|Advanced]]** 
 +  * **[[#Expanding Variables|Expanding Variables]]** 
 +  * **[[#Plugin Events|Plugin Events]]**
  
-===== Usage =====+----
  
-==== Add New Launchers ====+===== Add New Launchers ===== 
 +Besides adding launchers with the [[add-new-items|Add New Items]] window, it is also possible to drag-and-drop ''.desktop'' files straight onto the panel. A common way to do this is by finding the desired application in [[..:xfce4-appfinder:|Application Finder]], and then dragging it from the list and onto the panel.
  
-Beside adding launchers with the [[add-new-items|Add New Items]] dialog, it is also possible to drop desktop files on the panel. A common way to do this, is by using the [[..:xfce4-appfinder:|Application Finder]] to drag an application from the view and drop it in the panel.\\  +<note tip>If you try to drop it in between two existing launchers, Xfce will attempt to open the ''.desktop'' file with the nearest application. To prevent this, hold down **Ctrl** as you drag and drop the item.</note>
-If you try to drop between two launchers, you'll notice it will result in opening the .desktop file with the launcher-application. To avoid this, hold the {key>Ctrl} button and you will be able to place a new launcher between 2 existing launchers. +
-===== Properties =====+
  
-<figure "Launcher's properties dialog"> +---- 
-{{:xfce:xfce4-panel:launcher.png?nolink&|}}+ 
 +===== Arguments ===== 
 +All launchers accept ''text/uri-list'' as arguments when dropped on the launcher button, it will be used as an argument for the first application in the items list. See the [[:xfce:xfce4-panel:launcher#expanding_variables|Expanding Variables]] below for more information. 
 + 
 +---- 
 + 
 +===== Preferences ===== 
 + 
 +<figure "Launcher Preferences"> 
 +{{:xfce:xfce4-panel:launcher_props.png|Launcher Preferences Window}}
 </figure> </figure>
-===== Style Properties ===== 
-You can set a custom menu and tooltip icon size in gtk-icon-sizes with the name ''panel-launcher-menu'' and ''panel-launcher-tooltip''. The default 
-icon sizes are both 32px. Special widget names in this plugin are ''launcher-button'' and ''launcher-arrow''. 
  
-See the section [[theming|Theming]] for more information.+---- 
 + 
 +===== General ===== 
 +The **General** tab offers options down the right hand side for manipulating the selected item. 
 + 
 +? Move up / Move down 
 +! Moves the currently selected item up or down in the list. 
 +? Edit the currently selected item 
 +! Opens up an [[:xfce:exo:desktop-item-edit#editing_launchers|Edit Launcher]] window. 
 +? Delete the currently selected item 
 +! Deletes the item from the list. If there is only one item, the launcher on the panel becomes blank. 
 +? Add one or more existing items to the launcher 
 +! Opens an Add New Item window with a list of all installed applications. Additional items added are displayed under a list accessible by an arrow that appears next to the launcher. If more than one items are present in the launcher, the first one that appears in the list is used as the primary target. 
 +? Add a new empty item 
 +! Opens a [[:xfce:exo:desktop-item-edit|Create Launcher]] window to create a new item for the list. 
 +? Add a new hyperlink 
 +! Opens a Create Link window to create a new hyperlink, links have to follow a [[https://www.iana.org/assignments/uri-schemes/uri-schemes.xhtml|URI Scheme]]. 
 + 
 +[[|Back to Top]] 
 +---- 
 + 
 +===== Advanced ===== 
 + 
 +<figure "Launcher Advanced Preferences"> 
 +{{:xfce:xfce4-panel:xfce4-panel-launcher-preferences-advanced.png|Launcher Advanced Preferences Window}} 
 +</figure> 
 + 
 +? Disable tooltips 
 +! Doesn't display tooltips when hovering over the launcher. 
 +? Show label instead of icon 
 +! Displays name of launcher instead of specified icon. 
 +? Show last used item in panel 
 +! Only available when more than one items are present in the launcher. Shows the last used application / link as the primary item. 
 +? Arrow button position 
 +! Displays the arrow to access additional items to the left, right, top or bottom of the launcher. The **Inside Button** option displays the arrow inside the launcher and displays the list of launcher items when left-clicking on the launcher. 
 + 
 +[[|Back to Top]] 
 +---- 
 + 
 +===== Expanding Variables ===== 
 + 
 +Each launcher's command is expanded before it is executed, meaning the .desktop files' field codes are processed. [[http://standards.freedesktop.org/desktop-entry-spec/latest/|See the specification]] for more details. 
 + 
 +Below are some sample variables: 
 + 
 +<code> 
 +%F 
 +%f 
 +%U 
 +%u 
 +%i 
 +%c 
 +%k 
 +%% 
 +</code> 
 + 
 +---- 
 + 
 +===== Plugin Events ===== 
 + 
 +It is possible to send events to launcher plugins over the command line. One example is this: 
 + 
 +  xfce4-panel --plugin-event launcher:disable-tooltips:bool:true 
 + 
 +This will disable the tooltips property for all launcher plugins in the panel. 
 + 
 +[[|Back To Top]] 
 +---- 
 +[[:xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]