<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>emergeLauncher</title>
<link rel = StyleSheet type = "text/css" HREF = "../../emerge.css">
</head>
<body>
<table bgcolor="#7f907f" cellpadding="5" cellspacing="0" width="100%">
<tr>
<td>
<font color="white"><b>About</b></font> </td>
</tr>
</table>
<p>
emergeLauncher provides a "Quick Launch" applet for Emerge Desktop. It displays icons of applications in a movable, resizeable window.</p>
<table bgcolor="#7f907f" cellpadding="5" cellspacing="0" width="100%">
<tr>
<td>
<font color="white"><b>Configuration</b></font> </td>
</tr>
</table>
<p>emergeLauncher is configured by pressing the Ctrl key and right-clicking on the emergeLauncher window. This opens the configuration menu:</p>
<p><img src="CtrlRightClickApp2.png" width="146" height="162"></p>
<p style="margin-bottom: 0;"><strong>About</strong> displays the module's author and version and the current style's path and filename.<br>
<strong>Load Style</strong> allows the user to browse and select a <a href="Styles.html">Style File</a>.</p>
<p style="margin-top: 0; margin-bottom: 0;"><strong>Reload Current Style</strong> allows to reload the current style after editing.</p>
<p style="margin-top: 0; margin-bottom: 0;"><strong>Configure</strong> displays the emergeLauncher configuration dialog box.</p>
<p style="margin-top: 0; margin-bottom: 0;"><strong>New Instance</strong> allows the creation of a new emergeLauncher window.</p>
<p style="margin-top: 0;"><strong>Delete Instance</strong> deletes this emergeLauncher window.<br>
<strong>Exit</strong> closes the module. It can be restarted by highlighting it and clicking on the Start <img src="Start.png" width="24" height="23"> button in the Launch Applet dialog box (see <a href="emergeCore.html">emergeCore</a>).</p>
<p style="margin-bottom: 0;"> </p>
<p style="margin-top: 0;">After selecting <strong>Configure</strong>, the configuration dialog box opens. The first tab is <strong>General</strong>:</p>
<p><img src="LauncherConfig1.png" width="473" height="481"></p>
<p><strong>SnapMove</strong> makes the window snap to the edges of other applets' windows or the edges of the screen when moving it.</p>
<p><strong>SnapSize</strong> makes the window snap to the edges of other applets' windows or the edges of the screen when changing its size.</p>
<p><strong>AutoSize</strong> keeps the window to a minimum size around the icons. A number may be entered after <strong>wrap at</strong> to specify the amount of icons per row or column (depending on <strong>Orientation</strong> in <strong>Position</strong> tab). The size of the window can no longer be changed by dragging an edge while pressing the Alt key.</p>
<p style="margin-bottom: 0;"><strong>Start Hidden </strong>will keep the emergeLauncher window hidden starting after the next reboot. The visibility of one applet can be toggled with ShowApplet internal command, see that <a href="internal.html">page</a> for details.</p>
<p style="margin-top: 0; margin-bottom: 0;"><strong></strong></p>
<p style="margin-top: 0;"><strong>Click Through</strong> allows clicking "through" the window (i.e. allows clicking on whatever is behind it). It has two modes: <strong>Full</strong> (the whole window is "transparent" to mouse input), or <strong>Background</strong> (only the background area is "transparent" but the user can click on the icons in emergeTray, emergeTasks, emergeLauncher, the text in emergeCommand, emergePower, the active mini-window in emergeVWM, the graphs in emergeSysMon). </p>
<p><u>Important notes</u>: 1) <strong>Full Click Through </strong>works for any level of opacity, from opaque to fully transparent; 2) <strong>Background Click Through </strong>automatically sets the background to transparent but does not change the style, this is a known limitation; 3) To manipulate an applet set on <strong>Full Click Through, </strong>the user must press the Shift key: Shift+Ctrl+LeftClick to move the applet, Shift+Ctrl+RightClick to get the configuration menu and Shift+Alt to resize the applet.</p>
<p><strong>Icon Spacing</strong> defines the spacing in pixels between adjacent icons.</p>
<p><strong>Icon Size</strong> gives the choice of 16x16, 32x32 or 48x48 pixel icons. Due to system limitations, 48x48 pixel icons can not be used under Windows 2000.</p>
<p><strong>Title Text</strong> allows differentiation between Emerge Launcher instances. </p>
<p><strong>Title Font</strong> brings up the font dialog box, which allows to select <strong>Font</strong>,<strong> Font style</strong> and <strong>Size</strong> of the title:</p>
<p><img src="eCommandFontH.png" width="437" height="351"></p>
<p>The configuration dialog box's second tab is <strong>Launch Items</strong>:</p>
<p><img src="LaunchConfig2.png" width="446" height="459"></p>
<p style="margin-bottom: 0;">To Add <img src="Add.png" width="24" height="23"> a new item, the user can select from the <strong>Type</strong> drop list:</p>
<ul style="margin-top: 0;">
<li><strong>Executable</strong>, which allows to Browse <img src="BrowseFile.png" width="26" height="25" style="width: 24px; height: 23px;"> for an executable, for a <strong>Working Directory <img src="Browse.png" width="24" height="23"></strong> if needed, for a different <strong>Icon</strong> (see details below), and a<strong> Tip.</strong></li>
<li><strong style="margin-top: 0; margin-bottom: 0;">Internal Commands</strong>, with a <a href="internal.html">list</a> in <strong> Command</strong>, and a window for an <strong>Argument</strong>, which is needed only for two internal commands: Activate, with only emergeHotkeys and emergeLauncher as arguments, and ShowApplet, with the name of an applet as argument.
<span style="font-family:times new roman;font-size:16px;">See <em>ShowApplet</em> in <a href="internal.html">Internal Commands</a> for details about additional instances.</span> The user can also select an <strong>Icon</strong> (see details below), and type a<strong> Tip.</strong></li>
<li><strong>Separator</strong>, with a choice of four <strong>Styles</strong>.</li>
<li><strong>Special Folder, </strong>with a choice of My Computer, My Documents, My Network Places, Control Panel, and Recycle Bin. The user can also select an <strong>Icon</strong> (see details below), and type a<strong> Tip.</strong></li>
<li><strong>Entire Folder</strong>, which opens a browsing window <img src="Browse.png" width="24" height="23"> for a static display of the contents of a folder.</li>
<li><strong>Live Folder</strong>, which opens a browsing window <img src="Browse.png" width="24" height="23"> for a dynamic display of the contents of a folder.</li>
</ul>
<p>Prepending an <strong>Executable</strong> with "@" (e.g. "@%ProgramFiles%\Mozilla Firefox\firefox.exe") allows the execution of the command from an administrator account after selecting the administrator’s user name (or typing an other existing user name) and entering the password in the Run As dialog box.</p>
<p>The user then clicks on Save <img src="Save.png" width="24" height="23" style="width: 24px; height: 23px;"> (or Discard <img src="Discard.png" width="24" height="23" style="width: 24px; height: 23px;"> to start over). Pressing the <strong>OK</strong> button saves the current settings and closes the configuration dialog box.</p>
<p style="margin-bottom: 0;">The items in the <strong>Applications</strong> window can be modified <img src="Edit.png" width="24" height="23" style="width: 24px; height: 23px;"> or deleted <img src="Delete.png" width="24" height="23" style="width: 24px; height: 23px;"> after highlighting them. </p>
<p style="margin-top: 0;">After the user adds, deletes or modifies incorrectly an item, she can undo changes by clicking the <strong>Cancel</strong> button. A dialog box will open asking for confirmation to close the configuration dialog box without saving the changes made. </p>
<p style="margin-bottom: 0;"> </p>
<p style="margin-top: 0;">Notes on the <strong>Icon</strong> window: By default, the icon used is the first icon of the executable. To select a different icon, the user clicks the Browse <img src="BrowseFile.png" width="26" height="25" style="width: 24px; height: 23px;"> button, and can select a different icon (if the executable has more than one), or add an external icon:</p>
<p><img src="ChangeIcon.png" width="296" height="357"></p>
<p>By default when adding an icon to a command which does not contain an icon (e.g. most internal commands) emergeLauncher will display the windows icon library SHELL32.DLL located in %SystemRoot%\system32\. Alternatively the user can use any library or executable that contains icons or icon files (.ico))</p>
<p>Note that the icons are updated in the emergeLauncher configuration dialog box only after pressing <strong>OK</strong> or <strong>Cancel</strong>.</p>
<p>The configuration dialog box's third tab is <strong>Position</strong>:</p>
<p><img src="LaunchConfig3.png" width="446" height="459"></p>
<p><strong>Anchor Point</strong> gives the choice of anchoring the window to the monitor's <strong>Top Left, Top Center, Top Right, Middle Left, Middle Center, Middle Right, Bottom Left, Bottom Center, or Bottom Right</strong>.</p>
<p><strong>ZPosition</strong> defines the relative position of the window in the Z axis (i.e. from the screen to the user) and can be set to always on the <strong>Top</strong>, <strong>Normal</strong> (behaves as a regular program window), or always at the <strong>Bottom</strong>.</p>
<p><strong>Orientation</strong> defines if the icons are set as a column (<strong>Vertical</strong>) or as a row (<strong>Horizontal</strong>). </p>
<p>Independently of the the Orientation, the icons can have three options for <strong>Horizontal </strong>or <strong>Vertical Alignment</strong>:</p>
<p><strong>Horizontal Aligment</strong> can be set to: align on the <strong>Left</strong> of the applet (i.e. new items are added to the right), <strong>Center</strong> (i.e. expand in both directions in relation to the horizontal center), or on the <strong>Right</strong>.</p>
<p><strong>Vertical Aligment </strong>can be set to: <strong>Top</strong> of the applet, vertical <strong>Center</strong>, or <strong>Bottom</strong>.</p>
<p>If <strong>Autosize</strong> is not selected, when icons reach an edge, they will add a new row or column to the window, depending on <strong>Vertical</strong> or <strong>Horizontal</strong> <strong>Orientation</strong>.</p>
<p>For the configuration dialog box's fourth tab, see the <a href="Styles.html">Style Editor</a>.</p>
<table bgcolor="#7f907f" cellpadding="5" cellspacing="0" width="100%">
<tr>
<td>
<font color="white"><b>Usage</b></font> </td>
</tr>
</table>
<p>Left-clicking on the application icon launches the application.</p>
<p>To move the window, the user must press the Ctrl key, left-click on the window, and drag it to another location. </p>
<p>To resize the window (provided that <strong>Autosize</strong> is not selected), the user must press the Alt key, left-click on one edge of the window, and drag it to a new size.</p>
<p><span class="style4" style="margin-top: 0; margin-bottom: 0;">The window position and size are stored in the applet's xml file, which is located in the User Profile folder under "\Application Data\Emerge Desktop\themes", in a subfolder with the same name as the current Theme. See <a href="ThemeManager.html">Theme Manager</a> for more details.</span></p>
</body>
</html>
