/usr/share/doublecmd/doc/en/toolbar.html is in doublecmd-help-en 0.8.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>DC - Toolbars</title>
<link rel="STYLESHEET" type="text/css" href="doublecmd.css">
<link rel="shortcut icon" href="../../pixmaps/common/favicon.ico">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
<a name="topofpage"></a>
<div class="header"><a href="index.html"><img src="../../pixmaps/common/dclogo2017.png" alt="Double Commander" height="48" width="374"></a>
<div id="global-nav" class="nav"><a title="Double Commander" href="http://doublecmd.sourceforge.net/" target="_blank">Homepage</a></div>
</div>
<div class="footer"><div class="nav"><a title="Index" href="index.html">Index</a> | <a title="Previous page" href="shortcuts.html">Previous</a> | <a title="Next page" href="variables.html">Next</a></div></div>
<div class="dchelpage">
<div>
<h1>2.6. Toolbar</h1>
</div>
<div>
<h2>Content</h2>
<dl>
<dt>1. <a href="#toolbardefinition">What is the toolbar and how it could be used</a></dt>
<dt>2. <a href="#toolbarshowit">How to display it</a></dt>
<dt>3. <a href="#toolbarelementlist">What could be inside the toolbar</a></dt>
<dt>4. <a href="#toolbarconfig">How to configure the toolbar</a></dt>
<dt>5. <a href="#toolbardescription">Description of elements</a></dt>
<dd>
<dl>
<dd>5.1. <a href="#catseparator">Separator</a></dd>
<dd>5.2. <a href="#catinternal">Internal Command</a></dd>
<dd>5.3. <a href="#catexternal">External Command</a></dd>
<dd>5.4. <a href="#catmenu">Menu</a></dd>
</dl>
</dd>
</dl>
</div>
<div>
<h2><a name="toolbardefinition">1. What is the toolbar and how it could be used</a></h2>
<p>When working heavily with two-panels file manager like Double Commander, it comes a time that it would be more useful to launch the application we're using directly from our manager instead of having to reach a shortcut on the desktop, in a task bar or in a start menu.</p>
<p>This is especially true for task we do often.</p>
<p>The idea of the toolbar it to allow each one to customize buttons inside a bar for functions we need to do often.</p>
<p>Double Commander proposes also to use numerous possible parameters based on current displayed/selected files to allow us to pass them as parameters to the application to launch.</p>
<p>Here follows the default toolbar of DC shown above the file panels after a default installation. But don't worry: you may configure it the way you want to adapt to your need and your taste.</p>
<p class="figure"><img class="largeimage" title="Toolbar sample" alt="Toolbar sample" src="images/imgDC/toolbarsample.png" width="713" height="39"></p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
<div>
<h2><a name="toolbarshowit">2. How to display it</a></h2>
<p>The toolbar will be displayed or not depending of what is set in the "Layout" configuration settings.</p>
<p>To activate it, we just make sure we've set the "Show toolbar" option</p>
<p class="figure"><img class="largeimage" title="Toolbar sample" alt="Toolbar sample" src="images/imgDC/toolbarshowit.png" width="692" height="182"></p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
<div>
<h2><a name="toolbarelementlist">3. What could be inside the toolbar</a></h2>
<p>Here is a table of what may be present into a toolbar</p>
<table class="category">
<tr class="rowcategorytable"><th colspan="2">Possible element inside a toolbar</th></tr>
<tr class="rowcategorysubtitle"><th class="categorynamecolumn">Elements</th><th class="categorydesccolumn">Description</th></tr>
<tr>
<td class="categorycell"><div class="categoryname"><a href="#catseparator">Separator</a></div></td>
<td class="categorydesc">Vertical bar to help us to group together similar functions and/or similar context.</td>
</tr>
<tr>
<td class="categorycell"><div class="categoryname"><a href="#catinternal">Internal command</a></div></td>
<td class="categorydesc">To invoke internal command present in Double Commander.</td>
</tr>
<tr>
<td class="categorycell"><div class="categoryname"><a href="#catexternal">External command</a></div></td>
<td class="categorydesc">To launch external application, executable, script, etc.</td>
</tr>
<tr>
<td class="categorycell"><div class="categoryname"><a href="#catmenu">Menu</a></div></td>
<td class="categorydesc">To configure other toolbar element that will be displayed as drop menu from the main toolbar</td>
</tr>
</table>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
<BR>
<div>
<h2><a name="toolbarconfig">4. How to configure the toolbar</a></h2>
<p>To configure what will be present in our toolbar, we will need to configure it.</p>
<p>We may certainly go to the main configuration of Double Commander, scroll in the left column and select "Toolbar" and we'll have access to it.</p>
<p class="figure"><img class="largeimage" title="Toolbar configuration" alt="Toolbar configuration" src="images\imgDC\toolbarconfig1.png" width="680" height="160"></p>
<p>The other quick way to reach the configuration is to directly right click in an empty area of the toolbar and select "edit"</p>
<p class="figure"><img class="largeimage" title="Toolbar configuration" alt="Toolbar configuration" src="images\imgDC\toolbarconfig2.png" width="250" height="80"></p>
<p>As we're getting familiar with the toolbar, we'll also probably right click directly on a button from the toolbar to not only open the toolbar editor but beeing ready to immediately edit the associated action of the toolbar button we've right clicked on.</p>
<p class="figure"><img class="largeimage" title="Toolbar configuration" alt="Toolbar configuration" src="images\imgDC\toolbarconfig3.png" width="730" height="230"></p>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
</div>
<BR>
<div>
<h2><a name="catseparator">5.1. Description of elements - Separator</a></h2>
<p>The separator is simply a vertical bar that may be used to separate group of buttons to have similar related actions grouped together.</p>
<p>There have no real active functions, it's just decorative for pleasant looking.</p>
<p>In the following example, the person used separator to isolate together functions related with comparisons, then the ones related with clipboard, etc.</p>
<p class="figure"><img class="largeimage" title="Example of separator" alt="Example of separator" src="images/imgDC/toolbarseparator.png" width="430" height="220"></p>
</div>
<BR>
<div>
<h2><a name="toolbarconfig">5.2. Description of elements - Internal Command</a></h2>
<p>The internal commands are related with actions made directly by Double Commander that doesn't need to call an external application.</p>
<p>The commands are extremely varied. Please see <a href="cmds.html">this page</a> which is dedicated to described all the internal commands.</p>
<p>For example if we want a toolbar button to allow to launch a search, we'll just select the "cm_Search" command from the drop box of command.</p>
<p>As we see in the following image, we may select a custom icon for it but generally just choosing the command from the drop box of command is enough and command already have an internal associated icon.</p>
<p>The tooltip is also there to allow us to write an easy to remember little words to remember us the task of the button as we move cursor over.</p>
<p>Here is an example with that "<a href="cmds.html#cm_Search">cmSearch</a>" command:</p>
<p class="figure"><img class="largeimage" title="Example of internal command with no parameter" alt="Example of internal command with no parameter" src="images/imgDC/toolbarinternal1.png" width="636" height="220"></p>
<p>Some other commands might accept parameters to configure their actions.</p>
<p>When this is required, we'll simply write the parameter for in the parameter box.</p>
<p>In the following example, we use the internal command "<a href="cmds.html#cm_ChangeDir">cm_ChangeDir</a>" and we're providing two parameters to indicate which directory to load and show in each panel.</p>
<p class="figure"><img class="largeimage" title="Example of internal command with parameters" alt="Example of internal command with parameters" src="images/imgDC/toolbarinternal2.png" width="636" height="220"></p>
</div>
<BR>
<div>
<h2><a name="toolbarconfig">5.3. Description of elements - External Command</a></h2>
<p>The external commands are related with actions that require to call external program.</p>
<p>For the external commands we have the possibility to set a few more settings that will allow us to configure precisely the command we want to launch, in which directory we want to launch it and what we want to provide as parameters, if necessary, to the commands.</p>
<p>Regarding the parameters, you may select user variables that will be substituted by their actual value based on the current selected file of the active panel and so on. See the dedicated page of the possible variable to use as parameter under <a href="variables.html">this link</a>.</p>
<p>In the following example, we've set a toolbar button to launch the application "Gimp" and the <code>%p</code> as parameter means that when we click the button to launch "Gimp", the complete filename of the current selected file in the active panel will be passed as parameter, since that's what <code>%p</code> stands for.</p>
<p class="figure"><img class="largeimage" title="Example of external command" alt="Example of external command" src="images/imgDC/toolbarexternal.png" width="636" height="236"></p>
</div>
<BR>
<div>
<h2><a name="catmenu">5.4. Description of elements - Menu</a></h2>
<p>If we're configuring a lot of toolbar button, we may run out of space to have all our buttons on the same horizontal line.</p>
<p>So to allow us to add more buttons, we may add a special button type that will make appear a drop menu below the button to give us access to something similar to a toolbar of buttons but presented as a drop menu.</p>
<p>See the following example where we added a button type of "Menu".</p>
<p>This will make appear a new sub toolbar below that we can populate as we needed with new toolbar buttons pointing to different tasks.</p>
<p>This example also shows us that it could help to group together buttons related to the same projects, the same areas.</p>
<p>In this example the sub toolbar has functions related with different type of OS's installed in virtual machines.</p>
<p class="figure"><img class="largeimage" title="Example of menu" alt="Example of menu" src="images/imgDC/toolbarmenu.png" width="636" height="336"></p>
<p>Below is displayed how the configured sub toolbar will appear in the application:</p>
<p class="figure"><img class="largeimage" title="Example of drop menu" alt="Example of drop menu" src="images/imgDC/toolbarmenudrop.png" width="250" height="350"></p>
<p>The sub toolbar configured this way may contains the same type of button type presented before.</p>
<p>We may even have a sub toolbar inside a subtoolbar and so on.</p>
<p>This will simply be displayed in the application as a sub menu from a menu element.</p>
<p>See below an example:</p>
<p class="figure"><img class="largeimage" title="Example of toolbar in a toolbar" alt="Example of toolbar in a toolbar" src="images/imgDC/toolbarinbar.png" width="782" height="648"></p>
</div>
<div>
<p class="navback"><a href="#topofpage">(back to top)</a></p>
<BR>
</div>
</div>
<div class="footer"><div class="nav"><a title="Index" href="index.html">Index</a> | <a title="Previous page" href="shortcuts.html">Previous</a> | <a title="Next page" href="variables.html">Next</a></div></div>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
</body>
</html>
|