Add files via upload

Update to html files
This commit is contained in:
Mahmoud Gomaa authored and GitHub committed 2021-12-28 07:34:55 +02:00
1 parent 22e05ab1ad
commit b22ebd2cf8
33 files changed
+2790

No files matched your search

+47
View File
@@ -0,0 +1,47 @@
<h5>Copy Path example</h5>
<pre class="syntax"><code>shell
{
dynamic
{
<span class="syntax-comment">// type can set with '~taskbar' equals all file types except taskbar.</span>
menu(type=<span class="syntax-string">'file|dir|back|root|namespace'</span> mode=<span class="syntax-keyword">multiple</span> title=<span class="syntax-string">'copy to clipboard'</span> image=<span class="syntax-number">#ff00ff</span>)
{
<span class="syntax-comment">// Appears only when multiple selections.</span>
item(vis=<span class="syntax-code">@(sel.count > 1)</span> title=<span class="syntax-string">'Copy path (</span><span class="syntax-code">@sel.count</span><span class="syntax-string">) items selected'</span>
cmd=<span class="syntax-code">@sys.copy(sel(false, "\n"))</span>)
item(mode=<span class="syntax-keyword">single</span> title=<span class="syntax-code">@sel.path</span>
cmd=<span class="syntax-code">@sys.copy(sel.path)</span>)
item(mode=<span class="syntax-keyword">single</span> type=<span class="syntax-string">'file|dir|back.dir'</span>
vis=<span class="syntax-code">@sel.short.len!=sel.path.len</span> title=<span class="syntax-code">@sel.short</span>
cmd=<span class="syntax-code">@sys.copy(sel.short)</span>)
separator
item(mode=<span class="syntax-keyword">single</span> vis=<span class="syntax-code">@(sel.parent.len>3)</span> title=<span class="syntax-code">@sel.parent</span>
cmd=<span class="syntax-code">@sys.copy(sel.parent)</span>)
separator
item(mode=<span class="syntax-keyword">single</span> type=<span class="syntax-string">'file|dir|back.dir'</span> title=<span class="syntax-code">@sel.file.name</span>
cmd=<span class="syntax-code">@sys.copy(sel.file.name)</span>)
item(mode=<span class="syntax-keyword">single</span> type=<span class="syntax-string">'file'</span> title=<span class="syntax-code">@sel.file.title</span>
cmd=<span class="syntax-code">@sys.copy(sel.file.title)</span>)
item(mode=<span class="syntax-keyword">single</span> type=<span class="syntax-string">'file'</span> title=<span class="syntax-code">@sel.file.ext</span>
cmd=<span class="syntax-code">@sys.copy(sel.file.ext)</span>)
}
}
}</code></pre>
<div class="has-text-centered my-5">
<a class="lightbox">
<img class="is-256" src="/images/support/examples/copypath1.png">
</a>
<a class="lightbox">
<img class="is-256" src="/images/support/examples/copypath2.png">
</a>
<a class="lightbox">
<img class="is-256" src="/images/support/examples/copypath3.png">
</a>
</div>
+37
View File
@@ -0,0 +1,37 @@
<h5>Favorite applications and directories example</h5>
<pre class="syntax"><code>shell
{
dynamic
{
menu(type=<span class="syntax-string">'desktop|taskbar'</span> title=<span class="syntax-string">'Favorites'</span> image=<span class="syntax-number">#00ff00</span>)
{
menu(title=<span class="syntax-string">'Applications'</span> image=<span class="syntax-number">#ff0000</span>)
{
item(title=<span class="syntax-string">'Command prompt'</span> <span class="syntax-keyword">image</span> cmd=<span class="syntax-string">'cmd.exe'</span>)
item(title=<span class="syntax-string">'PowerShell'</span> <span class="syntax-keyword">image</span> cmd=<span class="syntax-string">'powershell.exe'</span>)
item(title=<span class="syntax-string">'Registry editor'</span> <span class="syntax-keyword">image</span> cmd=<span class="syntax-string">'regedit.exe'</span>)
separator
item(title=<span class="syntax-string">'Paint'</span> <span class="syntax-keyword">image</span> cmd=<span class="syntax-string">'mspaint.exe'</span>)
item(title=<span class="syntax-string">'Notepad'</span> <span class="syntax-keyword">image</span> cmd=<span class="syntax-string">'notepad.exe'</span>)
}
separator
menu(title=<span class="syntax-string">'Directories'</span> image=<span class="syntax-number">#0000ff</span>)
{
item(title=<span class="syntax-string">'Downloads'</span> cmd=<span class="syntax-code">@user.downloads</span>)
item(title=<span class="syntax-string">'Pictures'</span> cmd=<span class="syntax-code">@user.pictures</span>)
item(title=<span class="syntax-string">'Home'</span> cmd=<span class="syntax-code">@user.directory</span>)
separator
item(title=<span class="syntax-string">'Windows'</span> cmd=<span class="syntax-code">@sys.directory</span>)
item(title=<span class="syntax-string">'Program files'</span> cmd=<span class="syntax-code">@sys.prog</span>)
}
}
}
}</code></pre>
<figure class="has-text-centered my-5">
<a class="lightbox">
<img class="is-256" src="/images/support/examples/fav1.png">
</a>
<a class="lightbox">
<img class="is-256" src="/images/support/examples/fav2.png">
</a>
</figure>
+58
View File
@@ -0,0 +1,58 @@
<h5>Goto example</h5>
<pre class="syntax"><code>shell
{
dynamic
{
menu(mode=<span class="syntax-keyword">multiple</span> title=<span class="syntax-string">'goto'</span> separator=<span class="syntax-keyword">after</span> image=<span class="syntax-number">0xed25</span>)
{
item(title=<span class="syntax-string">'Windows'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@sys.dir</span>)
item(title=<span class="syntax-string">'System'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@sys.bin</span>)
item(title=<span class="syntax-string">'Program Files'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@sys.prog</span>)
item(title=<span class="syntax-string">'Program Files x86'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@sys.prog32</span>)
item(title=<span class="syntax-string">'ProgramData'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@sys.programdata</span>)
item(title=<span class="syntax-string">'Applications'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-string">'shell:appsfolder'</span>)
item(title=<span class="syntax-string">'Users'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@sys.users</span>)
item(title=<span class="syntax-string">'Control Panel'</span> image=<span class="syntax-number">0xe115</span> cmd=<span class="syntax-string">'shell:::{5399E694-6CE5-4D6C-8FCE-1D8870FDCBA0}'</span>)
item(title=<span class="syntax-string">'Control Panel (All Tasks)'</span> image=<span class="syntax-number">0xe115</span> cmd=<span class="syntax-string">'shell:::{ED7BA470-8E54-465E-825C-99712043E01C}'</span>)
item(title=<span class="syntax-string">'run'</span> cmd=<span class="syntax-string">'shell:::{2559a1f3-21d7-11d4-bdaf-00c04f60b9f0}'</span>)
separator
item(title=<span class="syntax-string">'@user.name@@@sys.name'</span> vis=<span class="syntax-keyword">disable</span>)
item(title=<span class="syntax-string">'Desktop'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@user.desktop</span>)
item(title=<span class="syntax-string">'Downloads'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@user.downloads</span>)
item(title=<span class="syntax-string">'Pictures'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@user.pictures</span>)
item(title=<span class="syntax-string">'Documents'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@user.documents</span>)
item(title=<span class="syntax-string">'Startmenu'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@user.startmenu</span>)
item(title=<span class="syntax-string">'Profile'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@user.dir</span>)
item(title=<span class="syntax-string">'AppData'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@user.appdata</span>)
item(title=<span class="syntax-string">'Temp'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-code">@user.temp</span>)
menu(title=<span class="syntax-string">'settings'</span> separator=<span class="syntax-keyword">before</span> image=<span class="syntax-number">0xe115</span>)
{
<span class="syntax-comment">// https://docs.microsoft.com/en-us/windows/uwp/launch-resume/launch-settings-app</span>
item(title=<span class="syntax-string">'systeminfo'</span> image=<span class="syntax-number">0xe946</span> cmd-line=<span class="syntax-string">'/K systeminfo'</span>)
item(title=<span class="syntax-string">'search'</span> cmd=<span class="syntax-string">'search-ms:'</span> image=<span class="syntax-number">0xe721</span>)
item(title=<span class="syntax-string">'settings'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-string">'ms-settings:'</span>)
item(title=<span class="syntax-string">'about'</span> image=<span class="syntax-number">0xe946</span> cmd=<span class="syntax-string">'ms-settings:about'</span>)
item(title=<span class="syntax-string">'usb'</span> image=<span class="syntax-number">0xe88e</span> cmd=<span class="syntax-string">'ms-settings:usb'</span>)
item(title=<span class="syntax-string">'network-status'</span> image=<span class="syntax-number">0xec27</span> cmd=<span class="syntax-string">'ms-settings:network-status'</span>)
item(title=<span class="syntax-string">'network-ethernet'</span> image=<span class="syntax-number">0xe839</span> cmd=<span class="syntax-string">'ms-settings:network-ethernet'</span>)
item(title=<span class="syntax-string">'personalization-background'</span> image=<span class="syntax-number">0xeb9f</span> cmd=<span class="syntax-string">'ms-settings:personalization-background'</span>)
item(title=<span class="syntax-string">'personalization-colors'</span> image=<span class="syntax-number">0xe790</span> cmd=<span class="syntax-string">'ms-settings:colors'</span>)
item(title=<span class="syntax-string">'lockscreen'</span> image=<span class="syntax-number">0xee3f</span> cmd=<span class="syntax-string">'ms-settings:lockscreen'</span>)
item(title=<span class="syntax-string">'personalization-start'</span> image=<span class="syntax-number">0xeca5</span> cmd=<span class="syntax-string">'ms-settings:personalization-start'</span>)
item(title=<span class="syntax-string">'appsfeatures'</span> image=<span class="syntax-number">0xe179</span> cmd=<span class="syntax-string">'ms-settings:appsfeatures'</span>)
item(title=<span class="syntax-string">'optionalfeatures'</span> image=<span class="syntax-number">0xe179</span> cmd=<span class="syntax-string">'ms-settings:optionalfeatures'</span>)
item(title=<span class="syntax-string">'defaultapps'</span> image=<span class="syntax-number">0xe17d</span> cmd=<span class="syntax-string">'ms-settings:defaultapps'</span>)
item(title=<span class="syntax-string">'yourinfo'</span> image=<span class="syntax-number">0xe136</span> cmd=<span class="syntax-string">'ms-settings:yourinfo'</span>)
item(title=<span class="syntax-string">'windowsupdate'</span> image=<span class="syntax-number">0xe895</span> cmd=<span class="syntax-string">'ms-settings:windowsupdate'</span>)
item(title=<span class="syntax-string">'windowsdefender'</span> image=<span class="syntax-number">0xe83d</span> cmd=<span class="syntax-string">'ms-settings:windowsdefender'</span>)
item(title=<span class="syntax-string">'network connections'</span> image-<span class="syntax-keyword">inherit</span> cmd=<span class="syntax-string">'shell:::{7007ACC7-3202-11D1-AAD2-00805FC1270E}'</span>)
}
}
}
}</code></pre>
<div class="has-text-centered my-5">
<a class="lightbox">
<img class="is-256" src="/images/support/examples/goto.png">
</a>
</div>
+2
View File
@@ -0,0 +1,2 @@
<h4>Examples</h4><br>
<p>This page contains some examples of what <b>Shell</b> can do.</p>
+22
View File
@@ -0,0 +1,22 @@
<h5>Taskbar example</h5>
<pre class="syntax"><code>shell
{
var
{
hello_world = <span class="syntax-string">'Hello World!'</span>
}
dynamic
{
item(title=<span class="syntax-code">@hello_world</span> cmd=<span class="syntax-code">@msgbox(hello_world)</span>)
separator
item(title=<span class="syntax-string">'Command prompt'</span> cmd=<span class="syntax-string">'cmd.exe'</span> args=<span class="syntax-string">'/k echo </span><span class="syntax-code">@hello_world</span><span class="syntax-string">'</span>)
separator
menu(title=<span class="syntax-string">'Sub menu'</span>)
{
item(title=<span class="syntax-string">'Open Paint'</span> cmd=<span class="syntax-string">'paint.exe'</span> arg=<span class="syntax-code">@sel.path</span>)
separator
item(title=<span class="syntax-string">'Open Notepad'</span> cmd=<span class="syntax-string">'notepad.exe'</span> arg=<span class="syntax-string">'"</span><span class="syntax-code">@sel.path</span><span class="syntax-string">"'</span>)
}
}
}</code></pre>
+4
View File
@@ -0,0 +1,4 @@
<h4>Color literal</h4>
<br>
<h5>Hexadecimal Colors</h5>
<p>interprets color constants as hexadecimal if they are preceded by <code>#</code> and hexadecimal color is specified with: <code>#RRGGBB</code>, where the RR (red), GG (green) and BB (blue) hexadecimal integers specify the components of the color. All values must be between <code>00</code> and <code>FF</code>.<br/>For example, the <code>#0000FF</code> value is rendered as blue, because the blue component is set to its highest value (<code>FF</code>) and the others are set to <code>00</code>.<br/>There are 140 color names are predefined under the <a href="/docs/functions/color">color</a> scope.</p>
+54
View File
@@ -0,0 +1,54 @@
<h4>Comments</h4>
<p>Comments can be used to explain <b>Shell</b> code, and to make it more readable. It can also be used to prevent execution <b>Shell</b> code. Comments can be singled-lined or multi-lined.</p>
<div id="single-line">
<h5>Single-line Comments</h5>
<p>
Single-line comments start with two forward slashes (<code>//</code>).<br>
Any text between <code>//</code> and the end of the line is ignored (will not be executed).
</p>
<p>This example uses a single-line comment before a line of code:</p>
<pre class="syntax"><code>shell
{
dynamic
{
<span class="syntax-comment">// This is a comment</span>
item(title=<span class="syntax-string">'Hello World!'</span>)
<span class="syntax-comment">//item(title='Hello World!')
}
}</code></pre>
<p>This example uses a single-line comment at the end of a line of code:</p>
<pre class="syntax"><code>shell
{
dynamic
{
item(title=<span class="syntax-string">'Hello World!'</span>) <span class="syntax-comment">// This is a comment</span>
}
}</code></pre>
</div>
<br>
<div id="multi-line">
<h5>Multi-line Comments</h5>
<p>
Multi-line comments start with <code>/*</code> and ends with <code>*/</code>.<br>
Any text between <code>/*</code> and <code>*/</code> will be ignored.
</p>
<pre class="syntax"><code>shell
{
dynamic
{
item(title=<span class="syntax-string">'Hello,</span><span class="syntax-comment">/* multiple-lines comment inside */</span><span class="syntax-string"> world'</span>)
<span class="syntax-comment">/*
item(title='test item 1')
item(title='test item 2')
*/</span>
}
}</code></pre>
<p>
Single or multi-line comments?<br>
It is up to you which you want to use. Normally, we use <code>//</code> for short comments, and <code>/* */</code> for longer.
</p>
</div>
+5
View File
@@ -0,0 +1,5 @@
<h4>Identifier</h4>
<br>
<p>The identifier have unique titles described by fully qualified names that indicate a logical hierarchy.<br>The identifier that has no parameters. Parentheses are added when necessary to separate:</p>
<p>There is a hierarchy of keywords in that some keywords are always followed by others.</p>
<pre><code>sel.path<br>sel.path().ext</code></pre>
+12
View File
@@ -0,0 +1,12 @@
<h4>Expressions</h4>
<br>
<p><b>Shell</b> provides a variety of statements and expressions. Most of these will be familiar to developers who have programmed in C, C++, C#.</p>
<p>Expressions gives you all the power of <b>Shell</b>, but is using a simplified syntax that's easier to learn if you're a beginner, and makes you more productive if you're an expert.</p>
<p>To use expressions, you write them by using proper syntax. Syntax is the set of rules by which the words and symbols in an expression are correctly combined. Initially, expressions in <b>Shell</b> are a little bit hard to read. But with a good understanding of expression syntax and a little practice, it becomes much easier.</p>
<ul>
<li>Expressions is non-case sensitive</li>
<li>Expressions (variables and functions) start with @</li>
<li>blocks are enclosed in @( ... )</li>
<li>Strings are enclosed with quotation marks or single quotation marks</li>
</ul>
+21
View File
@@ -0,0 +1,21 @@
<h4>Numeric literals</h4>
<br>
<p>There are two types of numbers. Integer and floating point.</p>
<h5>Integer literals</h5>
<p>An integer is a numeric literal(associated with numbers) without any fractional or exponential part. There are two types of integer literals:</p>
<ol>
<li>Decimal literal (base 10)</li>
<li>Hexadecimal literal (base 16)</li>
</ol>
<p><strong>1. Decimal-literal(base 10):</strong><br>A non-zero decimal digit followed by zero or more decimal digits(0, 1, 2, 3, 4, 5, 6, 7, 8, 9).</p>
For example:<pre><code>Decimal: 0, -9, 22 etc</code></pre>
<p><strong>2. Hexadecimal-literal(base 16):</strong><br>0x followed by one or more hexadecimal digits(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, d, e, f).</p>
For example:
<pre><code>Hexadecimal: 0x7f, 0x2a, 0x521 etc</code></pre>
<h5>Floating-point iterals</h5>
<p>Floating-point literals specify values that must have a fractional part. These values contain decimal points (.)</p>
For example:
<pre><code>-2.0<br>0.0000234</code></pre>
+187
View File
@@ -0,0 +1,187 @@
<h4>Operators</h4>
<br>
<p>An operator is a symbol that tells to perform specific mathematical or logical manipulations. <b>Shell</b> is rich in built-in operators and provide the following types of operators</p>
<p>This chapter will examine the arithmetic, relational, logical, bitwise, assignment and other operators one by one.</p>
<h5 id="arithmetic">Arithmetic Operators</h5>
<p>The five arithmetical operations supported</p>
<table class="table">
<tbody>
<tr>
<th class="has-text-centered" width="10%">Operator</th>
<th>Description</th>
</tr>
<tr>
<td class="has-text-centered">+</td>
<td>Addition</td>
</tr>
<tr>
<td class="has-text-centered">-</td>
<td>Subtraction</td>
</tr>
<tr>
<td class="has-text-centered">*</td>
<td>Multiplication</td>
</tr>
<tr>
<td class="has-text-centered">/</td>
<td>Division</td>
</tr>
<tr>
<td class="has-text-centered">%</td>
<td>Modulo</td>
</tr>
</tbody>
</table>
<br>
<h5 id="relational">Relational and comparison operators</h5>
<p>Two expressions can be compared using relational and equality operators. For example, to know if two values are equal or if one is greater than the other.</p>
<p>The result of such an operation is either true or false (i.e., a Boolean value).</p>
<p>The relational operators are:</p>
<table class="table">
<tbody>
<tr>
<th class="has-text-centered"width="10%">operator</th><th>description</th>
</tr>
<tr>
<td class="has-text-centered">==</td><td>Equal to</td>
</tr>
<tr>
<td class="has-text-centered">!=</td><td>Not equal to</td>
</tr>
<tr>
<td class="has-text-centered">&lt;</td><td>Less than</td>
</tr>
<tr>
<td class="has-text-centered">&gt;</td><td>Greater than</td>
</tr>
<tr>
<td class="has-text-centered">&lt;=</td><td>Less than or equal to</td>
</tr>
<tr>
<td class="has-text-centered">&gt;=</td><td>Greater than or equal to</td>
</tr>
</tbody>
</table>
<br>
<h5 id="logical">Logical Operators (!, ||, &amp;&amp;)</h5>
<p> The operator <code>!</code> is operator for the Boolean operation NOT. It has only one operand, to its right, and inverts it, producing false if its operand is true, and true if its operand is false. Basically, it returns the opposite Boolean value of evaluating its operand. For example:</p>
<p> The logical operators <code>&amp;&amp;</code> and <code>||</code> are used when evaluating two expressions to obtain a single relational result. The operator <code>&amp;&amp;</code> corresponds to the Boolean logical operation AND, which yields true if both its operands are true, and false otherwise. The following panel shows the result of operator <code>&amp;&amp;</code> evaluating the expression <code>a &amp;&amp; b</code>:</p>
<table class="table">
<tbody>
<tr>
<th class="has-text-centered" width="10%">operator</th>
<th>description</th>
</tr>
<tr>
<td class="has-text-centered">&amp;&amp;</td>
<td>Called Logical AND operator. If both the operands are non-zero, then condition becomes true.</td>
</tr>
<tr>
<td class="has-text-centered">||</td>
<td>Called Logical OR Operator. If any of the two operands is non-zero, then condition becomes true.</td>
</tr>
<tr>
<td class="has-text-centered">!</td>
<td>
Called Logical NOT Operator. Use to reverses the logical state of its operand. If a condition is true, then Logical NOT operator will make false.
<pre><code>!(5 == 5) <cite>// evaluates to false because the expression at its right (5 == 5) is true</cite>
!(6 &lt;= 4) <cite>// evaluates to true because (6 &lt;= 4) would be false</cite>
!<var>true</var> <cite>// evaluates to false</cite>
!<var>false</var> <cite>// evaluates to true</cite></code></pre>
</td>
</tr>
</tbody>
</table>
<br>
<h5 id="ternary">Conditional ternary operator</h5>
<p>The conditional operator evaluates an expression, returning one value if that expression evaluates to true, and a different one if the expression evaluates as false. Its syntax is:</p>
<pre><code>condition ? result1 : result2</code></pre>
<p>If condition is true, the entire expression evaluates to result1, and otherwise to result2.</p>
<pre><code>7==5 ? 4 : 3 <cite>// evaluates to 3, since 7 is not equal to 5.</cite>
7==5+2 ? 4 : 3 <cite>// evaluates to 4, since 7 is equal to 5+2.</cite>
5>3 ? a : b <cite>// evaluates to the value of a, since 5 is greater than 3.</cite>
a>b ? a : b <cite>// evaluates to whichever is greater, a or b.</cite></code></pre>
<h5 id="bitwise">Bitwise Operators</h5>
<p>Bitwise operators modify variables considering the bit patterns that represent the values they store.</p>
<table class="table">
<tbody>
<tr>
<th class="has-text-centered" width="10%">Operator</th>
<th>Description</th>
</tr>
<tr>
<td class="has-text-centered">&amp;</td>
</td><td>Bitwise AND</td>
</tr>
<tr>
<td class="has-text-centered">|</td>
<td>Bitwise inclusive OR</td>
</tr>
<tr>
<td class="has-text-centered">^</td>
<td>Bitwise exclusive OR</td>
</tr>
<tr>
<td class="has-text-centered">~</td>
<td>Unary complement (bit inversion)</td>
</tr>
<tr>
<td class="has-text-centered">&lt;&lt;</td>
<td>Shift bits left</td>
</tr>
<tr>
<td class="has-text-centered">&gt;&gt;</td>
<td>Shift bits right</td>
</tr>
</tbody>
</table>
<h5 id="precedence">Precedence of operators</h5>
<p> A single expression may have multiple operators. For example:</p>
<pre><code>x = 5 + 7 % 2</code></pre>
<p>the above expression always assigns 6 to variable x, because the <code>%</code> operator has a higher precedence than the <code>+</code> operator, and is always evaluated before. Parts of the expressions can be enclosed in parenthesis to override this precedence order, or to make explicitly clear the intended effect. Notice the difference:</p>
<pre><code>x = 5 + (7 % 2) <cite>// x = 6 (same as without parenthesis)</cite>
x = (5 + 7) % 2 <cite>// x = 0</cite></code></pre>
<p>From greatest to smallest priority, Operators are evaluated in the following order:</p>
<table class="table">
<tbody>
<tr>
<th>Level</th>
<th>Precedence group</th>
<th>Operator</th>
<th>Description</th>
<th>Grouping</th>
</tr>
<tr>
<td rowspan="4">1</td>
<td rowspan="4">Postfix (unary)</td>
<td><code>++ --</code></td>
<td>postfix increment / decrement</td>
<td rowspan="4">Left-to-right</td>
</tr>
<tr><td><code>()</code></td><td>functional forms</td></tr>
<tr><td><code>[]</code></td><td>subscript</td></tr>
<tr><td><code>.</code></td><td>member access</td>
</tr>
<tr><td rowspan="3">2</td><td rowspan="3">Prefix (unary)</td><td><code>++ --</code></td><td>prefix increment / decrement</td><td rowspan="3">Right-to-left</td></tr>
<tr><td><code>~ !</code></td><td>bitwise NOT / logical NOT</td></tr>
<tr><td><code>+ -</code></td><td>unary prefix</td></tr>
<tr><td>4</td><td>Arithmetic: scaling</td><td><code>* / %</code></td><td>multiply, divide, modulo</td><td>Left-to-right</td></tr>
<tr><td>5</td><td>Arithmetic: addition</td><td><code>+ -</code></td><td>addition, subtraction</td><td>Left-to-right</td></tr>
<tr><td>6</td><td>Bitwise shift</td><td><code>&lt;&lt; &gt;&gt;</code></td><td>shift left, shift right</td><td>Left-to-right</td></tr>
<tr><td>7</td><td>Relational</td><td><code>&lt; &gt; &lt;= &gt;=</code></td><td>comparison operators</td><td>Left-to-right</td></tr>
<tr><td>8</td><td>Equality</td><td><code>== !=</code></td><td>equality / inequality</td><td>Left-to-right</td></tr>
<tr><td>9</td><td>And</td><td><code>&amp;</code></td><td>bitwise AND</td><td>Left-to-right</td></tr>
<tr><td>10</td><td>Exclusive or</td><td><code>^</code></td><td>bitwise XOR</td><td>Left-to-right</td></tr>
<tr><td>11</td><td>Inclusive or</td><td><code>|</code></td><td>bitwise OR</td><td>Left-to-right</td></tr>
<tr><td>12</td><td>Conjunction</td><td><code>&amp;&amp;</code></td><td>logical AND</td><td>Left-to-right</td></tr>
<tr><td>13</td><td>Disjunction</td><td><code>||</code></td><td>logical OR</td><td>Left-to-right</td></tr>
<tr><td rowspan="2">15</td><td rowspan="2">Assignment-level expressions</td><td><code>=</code></td><td>assignment</td><td rowspan="2">Right-to-left</td></tr>
<tr><td><code>?:</code></td><td>conditional operator</td></tr>
<tr><td>16</td><td>Sequencing</td><td><code>,</code></td><td>comma separator</td><td>Left-to-right</td></tr>
</tbody>
</table>
<p>
When an expression has two operators with the same precedence level, grouping determines which one is evaluated first: either left-to-right or right-to-left.<br>
Enclosing all sub-statements in parentheses (even those unnecessary because of their precedence) improves code readability.
</p>
+47
View File
@@ -0,0 +1,47 @@
<h4>String literal</h4>
<br>
<p>string is zero or more characters written inside single or double quotes.</p>
<p>You can use quotes inside a string, as long as they don't match the quotes surrounding the string:</p>
<pre class="syntax"><code>var
{
var1 = <span class="syntax-string">"It's alright"</span>
var2 = <span class="syntax-string">"He is called 'Johnny'"</span>
var3 = <span class="syntax-string">'He is called "Johnny"'</span>
}</code></pre>
<br>
<h5>Single quotes</h5>
<br>
<p>single quotes allow you to use the syntax of expressions within them.<br/>The <code>@</code> sign must be placed before the expressions.</p>
<pre><code>dynamic
{
item(title = 'windows dir path: @sys.dir')
}</code></pre>
<br>
<h5>Double quotes</h5>
<br>
<p>double quotes allow you to use the Escape Character inside them only.<br/>The backslash (<code>\</code>) escape character turns special characters into characters.<br/>The sequence <code>\" </code> inserts a double quote in a string:</p>
<pre><code>var
{
var1 = "hello\"world"
// result: hello"world
}</code></pre>
<p>The complete set of escape sequences is as follows:</p>
<table class="table">
<tbody>
<tr><td>\'</td><td>Single quote</td></tr>
<tr><td>\"</td><td>Double quote</td></tr>
<tr><td>\\</td><td>Backslash</td></tr>
<tr><td>\0</td><td>Null</td></tr>
<tr><td>\a</td><td>Alert</td></tr>
<tr><td>\b</td><td>Backspace</td></tr>
<tr><td>\f</td><td>Form Feed</td></tr>
<tr><td>\n</td><td>New Line</td></tr>
<tr><td>\r</td><td>Carriage Return</td></tr>
<tr><td>\t</td><td>Horizontal Tab</td></tr>
<tr><td>\v</td><td>Vertical Tab</td></tr>
<tr><td>\uxxxx</td><td>Unicode escape sequence (UTF-16) \uHHHH (range: 0000 - FFFF)</td></tr>
<tr><td>\xnnnn</td><td>Unicode escape sequence for character with hex value nnnn (variable length version of \uxxxx)</td></tr>
<tr><td>\Uxxxxxxxx</td><td>Unicode escape sequence (UTF-32) \U00HHHHHH (range: 000000 - 10FFFF)</td></tr>
</tbody>
</table>
+54
View File
@@ -0,0 +1,54 @@
<h5>APP</h5>
<br>
<p>The namespace of the application contains file paths, version and some details.</p>
<br>
<p>
<h5>app.directory (app.dir)</h5>
Returns the path of <b>Shell</b> directory.
</p>
<br>
<p>
<h5>app.cfg</h5>
Returns the path of the configuration file "shell.shl".
</p>
<br>
<p>
<h5>app.dll</h5>
Returns the path of "shell.dll".
</p>
<br>
<p>
<h5>app.exe</h5>
Returns the path of "shell.exe".
</p>
<br>
<p>
<h5>app.name</h5>
Returns application name.
</p>
<br>
<p>
<h5>app.version (app.ver)</h5>
Revert <b>Shell</b> version.
</p>
<br>
<p>
<h5>app.is64</h5>
Returns the architecture of the application.
</p>
<br>
<p>
<h5>app.about</h5>
Returns <b>Shell</b> information.
</p>
<br>
<p>
<h5>app.reload</h5>
Reload the configuration file.
</p>
<br>
<p>
<h5>app.unload</h5>
Unload the configuration file.
</p>
<br>
+149
View File
@@ -0,0 +1,149 @@
<h5>COLOR</h5>
<br>
<p>Color namespace contains predefined colors</p>
<br>
<pre>
color.default
color.accent
color.aliceblue
color.antiquewhite
color.aqua
color.aquamarine
color.azure
color.beige
color.bisque
color.black
color.blanchedalmond
color.blue
color.blueviolet
color.brown
color.burlywood
color.cadetblue
color.chartreuse
color.chocolate
color.coral
color.cornflowerblue
color.cornsilk
color.crimson
color.cyan
color.darkblue
color.darkcyan
color.darkgoldenrod
color.darkgray
color.darkgreen
color.darkkhaki
color.darkmagenta
color.darkolivegreen
color.darkorange
color.darkorchid
color.darkred
color.darksalmon
color.darkseagreen
color.darkslateblue
color.darkslategray
color.darkturquoise
color.darkviolet
color.deeppink
color.deepskyblue
color.dimgray
color.dodgerblue
color.firebrick
color.floralwhite
color.forestgreen
color.fuchsia
color.gainsboro
color.ghostwhite
color.gold
color.goldenrod
color.gray
color.green
color.greenyellow
color.honeydew
color.hotpink
color.indianred
color.indigo
color.ivory
color.khaki
color.lavender
color.lavenderblush
color.lawngreen
color.lemonchiffon
color.lightblue
color.lightcoral
color.lightcyan
color.lightgoldenrodyellow
color.lightgray
color.lightgreen
color.lightpink
color.lightsalmon
color.lightseagreen
color.lightskyblue
color.lightslategray
color.lightsteelblue
color.lightyellow
color.lime
color.limegreen
color.linen
color.magenta
color.maroon
color.mediumaquamarine
color.mediumblue
color.mediumorchid
color.mediumpurple
color.mediumseagreen
color.mediumslateblue
color.mediumspringgreen
color.mediumturquoise
color.mediumvioletred
color.midnightblue
color.mintcream
color.mistyrose
color.moccasin
color.navajowhite
color.navy
color.oldlace
color.olive
color.olivedrab
color.orange
color.orangered
color.orchid
color.palegoldenrod
color.palegreen
color.paleturquoise
color.palevioletred
color.papayawhip
color.peachpuff
color.peru
color.pink
color.plum
color.powderblue
color.purple
color.red
color.rosybrown
color.royalblue
color.saddlebrown
color.salmon
color.sandybrown
color.seagreen
color.seashell
color.sienna
color.silver
color.skyblue
color.slateblue
color.slategray
color.snow
color.springgreen
color.steelblue
color.tan
color.teal
color.thistle
color.tomato
color.transparent
color.turquoise
color.violet
color.wheat
color.white
color.whitesmoke
color.yellow
color.yellowgreen
</pre>
+33
View File
@@ -0,0 +1,33 @@
<h5>IMAGE (ICON)</h5>
<p>The image namespace contains functions that return an icon and are only assigned to the <code>image</code> property</p>
<section class="my-5">
<h5>image.glyph</h5>
<p>Return font icon with color and size option.</p>
<p>Syntax</p>
<code>image.glyph(0xE00B)</code><br>
<code>image.glyph("\uE00B")</code><br>
<code>image.glyph("\xE00B")</code><br>
<br>
<code>image.glyph(0xE00B, #0000ff)</code><br>
<code>image.glyph(0xE00B, #0000ff, 10)</code><br>
<code>image.glyph(0xE00B, #0000ff, 12, "Segoe MDL2 Assets")</code><br>
</section>
<section class="my-5">
<h5>image.icon</h5>
<p>Returns an icon through a path or through resources.</p>
<p>Syntax</p>
<code>image.icon(path)</code><br>
<code>image.icon(path, index)</code><br>
<code>image.icon(path, -id)</code><br>
<br>
<code>image(path)</code><br>
<code>image(path, index)</code><br>
<code>image(path, -id)</code><br>
</section>
<section class="my-5">
<h5>image.rect</h5>
<p>Returns a colored rectangle icon of an optional size.</p>
<p>Syntax</p>
<code>image.rect(#0000ff)</code><br>
<code>image.rect(#0000ff, 10)</code><br>
</section>
+127
View File
@@ -0,0 +1,127 @@
<h4>Functions</h4>
<p>The functions and variables have unique titles described by fully qualified names that indicate a logical hierarchy.</p>
<p><b>Shell</b> has a number of functions and variables built into it that are always available. They are listed here in alphabetical order.</p>
<section class="my-5">
<h5>if</h5>
<p>Conditionally executes another statement.</p>
<p>Syntax</p>
<code>if(condition-expression)</code><br><br>
<code>if(condition-expression, true-expression)</code><br><br>
<code>if(condition-expression, true-expression, false-expression)</code>
</section>
<section class="my-5">
<h5>null</h5>
<p>Returns a null value.</p>
<p>Syntax</p>
<code>null(expression)</code><br><br>
</section>
<section class="my-5">
<h5>quote</h5>
<p>Returns text with a double quotation mark.</p>
<p>Syntax</p>
<code>quote(expression)</code>
</section>
<section class="my-5">
<h5>char</h5>
<p>Returns the value of the numeric parameter to a character.</p>
<p>Syntax</p>
<code>char(numeric-expression)</code>
</section>
<section class="my-5">
<h5>var</h5>
<p>Returns the value of the passed variable</p>
<p>Syntax</p>
<code>var(expression)</code>
</section>
<section class="my-5">
<h5>tohex</h5>
<p>Converting the value of the passed numeric expression to hexadecimal string.</p>
<p>Syntax</p>
<code>tohex(numeric-expression)</code>
</section>
<section class="my-5">
<h5>equal</h5>
<p>Returns <code>true</code> if the parameters passed are equal.</p>
<p>Syntax</p>
<code>equal(expression-1, expression-2)</code>
</section>
<section class="my-5">
<h5>not</h5>
<p>Returns <code>true</code> if the parameters passed are not equal.</p>
<p>Syntax</p>
<code>not(expression-1, expression-2)</code>
</section>
<section class="my-5">
<h5>greater</h5>
<p>Returns <code>true</code> if the first parameter is greater than the second parameter.</p>
<p>Syntax</p>
<code>greater(expression-1, expression-2)</code>
</section>
<section class="my-5">
<h5>less</h5>
<p>Returns <code>true</code> if the first parameter is less than the second parameter.</p>
<p>Syntax</p>
<code>less(expression-1, expression-2)</code>
</section>
<section class="my-5">
<h5>shl</h5>
<p>bitwise left shift.</p>
<p>Syntax</p>
<code>shl(shift-expression, additive-expression)</code>
</section>
<section class="my-5">
<h5>shr</h5>
<p>bitwise right shift.</p>
<p>Syntax</p>
<code>shr(shift-expression, additive-expression)</code>
</section>
<section class="my-5">
<h5>cmd visibility enumerations</h5>
<p>The flags that specify how an application is to be displayed when it is opened.</p>
<pre><code>cmd.hidden
cmd.show
cmd.visible
cmd.normal
cmd.maximized
cmd.minimized</code></pre>
</section>
<section class="my-5">
<h5>Selection mode enumerations</h5>
<p>Syntax</p>
<pre><code>mode.none
mode.single
mode.multiple
mode.multiunique
mode.multisingle
mode.multi</code></pre>
</section>
<section class="my-5">
<h5>Selection type enumerations</h5>
<p>Syntax</p>
<pre><code>type.desktop
type.directory(dir)
type.drive
type.dvd
type.file
type.fixed
type.namespace
type.remote
type.unknown
type.usb
type.vhd</code></pre>
</section>
<h5>Keywords</h5>
<pre><code>null
bool
true
false
auto
none
default</code>
</pre>
<div class="is-unstyled mt-5"><a href="/docs/functions/app">app</a> | <a href="/docs/functions/color">color</a> | <a href="/docs/functions/image">image</a> | <a href="/docs/functions/io">io</a> | <a href="/docs/functions/key">key</a> | <a href="/docs/functions/msg">msg</a> | <a href="/docs/functions/path">path</a> | <a href="/docs/functions/reg">reg</a> | <a href="/docs/functions/sel">sel</a> | <a href="/docs/functions/str">str</a> | <a href="/docs/functions/sys">sys</a> | <a href="/docs/functions/user">user</a>
</div>
+130
View File
@@ -0,0 +1,130 @@
<h5>IO</h5>
<br>
<section class="my-5">
<h5>io.attribute enumerations.</h5>
<p>Syntax</p>
<pre><code>io.attribute.archive
io.attribute.compressed
io.attribute.device
io.attribute.directory
io.attribute.encrypted
io.attribute.hidden
io.attribute.invalid
io.attribute.normal
io.attribute.offline
io.attribute.readonly
io.attribute.sparsefile
io.attribute.system
io.attribute.temporary
io.attribute.virtual</code></pre>
</section>
<section class="my-5">
<h5>io.attributes</h5>
<p>Retrieves file system attributes for a specified path.</p>
<p>Syntax</p>
<code>io.attributes(path)</code><br><br>
<p>attribute verification</p>
<pre><code>// check if path is hidden
io.attribute.hidden(path)
// check if path is directory
io.attribute.directory(path)
var { atrr = io.attributes(path) }
// check if attr is hidden
io.attribute.hidden(atrr)
// check if attr is directory
io.attribute.directory(atrr)</code></pre>
</section>
<section class="my-5">
<h5>io.copy</h5>
<p>Copies an existing file to a new file.</p>
<p>Syntax</p>
<code>io.copy(pathFrom, pathTo)</code>
</section>
<section class="my-5">
<h5>io.move</h5>
<p>Moves an existing file or a directory, including its children..</p>
<p>Syntax</p>
<code>io.move(oldPath, newPath)</code>
</section>
<section class="my-5">
<h5>io.rename</h5>
<p>Rename a file or directory.</p>
<p>Syntax</p>
<code>io.rename(oldName, newName)</code>
</section>
<section class="my-5">
<h5>io.delete</h5>
<p>Deletes an existing path.</p>
<p>Syntax</p>
<code>io.delete(path)</code>
</section>
<section class="my-5">
<h5>io.directory.create (io.dir.create)</h5>
<p>Create new directory.</p>
<p>Syntax</p>
<code>io.directory.create(path)</code>
</section>
<section class="my-5">
<h5>io.directory.exists (io.dir.exists)</h5>
<p>Check if one or more directories exists.</p>
<p>Syntax</p>
<code>io.directory.exists(path)</code>
<br>
<code>io.directory.exists(path1, path2, path3, ...)</code>
</section>
<section class="my-5">
<h5>io.directory.empty (io.dir.empty)</h5>
<p>Check if one or more directory is empty.</p>
<p>Syntax</p>
<code>io.directory.empty(path)</code>
<br>
<code>io.directory.empty(path1, path2, path3, ...)</code>
</section>
<h5 class="my-5">File functions.</h5>
<section class="my-5">
<h5>io.file.size</h5>
<p>Retrieves the size of the specified file, in bytes.</p>
<p>Syntax</p>
<code>io.file.size(path)</code>
</section>
<section class="my-5">
<h5>io.file.exists</h5>
<p>Check if one or more files exists.</p>
<p>Syntax</p>
<code>io.file.exists(path)</code>
<br>
<code>io.file.exists(path1, path2, path3, ...)</code>
</section>
<section class="my-5">
<h5>io.file.read</h5>
<p>Read file contents as text with character count option.</p>
<p>Syntax</p>
<code>io.file.read(path)</code><br>
<code>io.file.read(path, 12)</code>
</section>
<section class="my-5">
<h5>io.file.create</h5>
<p>Create new file with content option.</p>
<p>Syntax</p>
<code>io.file.create(path)</code><br>
<code>io.file.create(path, "Hello World!")</code>
</section>
<section class="my-5">
<h5>io.file.write</h5>
<p>Writing to a file with new content.</p>
<p>Syntax</p>
<code>io.file.write(path, "Hello World!")</code>
</section>
<section class="my-5">
<h5>io.file.append</h5>
<p>Appends text to an existing file, or to a new file if the specified file does not exist.</p>
<p>Syntax</p>
<code>io.file.append(path, "Hello ")</code>
<br>
<code>io.file.append(path, "World!")</code>
</section>
+82
View File
@@ -0,0 +1,82 @@
<h5>KEY</h5>
<p>Keyboard functions</p>
<section class="my-5">
<h5>keys enumerations</h5>
<pre><code>key.alt
key.apps
key.back
key.cancel
key.capital
key.capslock
key.control
key.delete
key.down
key.end
key.enter
key.escape
key.execute
key.f1
key.f10
key.f11
key.f12
key.f2
key.f3
key.f4
key.f5
key.f6
key.f7
key.f8
key.f9
key.help
key.home
key.insert
key.lalt
key.lcontrol
key.left
key.lshift
key.lwin
key.next
key.none
key.pagedown
key.pageup
key.pause
key.play
key.print
key.printscreen
key.prior
key.ralt
key.rcontrol
key.return
key.right
key.rshift
key.rwin
key.shift
key.snapshot
key.space
key.tab
key.up
key.win</code></pre>
</section>
<section class="my-5">
<h5>key</h5>
<p>Syntax</p>
<pre>
<code>// check if SHIFT key is pressed
key(key.shift)
// or
key == key.shift
// or
key.shift()
// check if tow keys (SHIFT+CTRL+X) is pressed
key(key.shift, key.control)
// check if keys (SHIFT+CTRL+X) is pressed
key(key.shift, key.control, 87)</code>
</pre>
</section>
+121
View File
@@ -0,0 +1,121 @@
<h4>MSG</h4>
<p>Displays a modal dialog box that contains a system icon, a set of buttons, and a brief application-specific message, such as status or error information. The message box returns an integer value that indicates which button the user clicked.</p>
<h5>Syntax</h5>
<pre>
msg(text)
msg(text, title)
msg(text, title, flags)
</pre>
<br>
<h5>Parameters</h5>
<table class="table table-borderless">
<tr>
<td class="kw">text</td>
<td>The message to be displayed.</td>
</tr>
<tr>
<td class="kw">title</td>
<td>The dialog box title. If this parameter is NULL, the default title is <b>Nilesoft Shell</b>.</td>
</tr>
<tr>
<td class="kw">flags</td>
<td>The contents and behavior of the dialog box. This parameter can be a combination of flags from the following groups of flags.</td>
</tr>
</table>
<h5>Flags</h5>
<br>
<h5>To display an icon in the message box, specify one of the following values.</h5>
<dl>
<dt>msg.error</dt>
<dd>A stop-sign icon appears in the message box.</dd>
<dt>msg.question</dt>
<dd>A question-mark icon appears in the message box.</dd>
<dt>msg.warning</dt>
<dd>An exclamation-point icon appears in the message box.</dd>
<dt>msg.info</dt>
<dd>An icon consisting of a lowercase letter i in a circle appears in the message box.</dd>
</dl
<br>
<h5>To indicate the buttons displayed in the message box, specify one of the following values.</h5>
<dl class="keyword">
<dt>msg.ok</dt>
<dd>The message box contains one push button: OK. This is the default.</dd>
<dt>msg.okcancel</dt>
<dd>The message box contains two push buttons: OK and Cancel.</dd>
<dt>msg.yesnocancel</dt>
<dd>The message box contains three push buttons: Yes, No, and Cancel.</dd>
<dt>msg.yesno</dt>
<dd>The message box contains two push buttons: Yes and No.</dd>
</dl>
<br>
<h5>To indicate the default button, specify one of the following values.</h5>
<dl>
<dt>msg.defbutton1</dt>
<dd>The first button is the default button.</dd>
<dt>msg.defbutton2</dt>
<dd>The second button is the default button.</dd>
<dt>msg.defbutton3</dt>
<dd>The third button is the default button.</dd>
</dl>
<br>
<h5>To indicate the modality of the dialog box, specify one of the following values.</h5>
<dl>
<dt>msg.applmodal</dt>
<dd>The user must respond to the message box before continuing work in the current window. However, the user can move to the windows of other threads and work in those windows.</dd>
<dt>msg.taskmodal</dt>
<dd></dd>Same as msg.applmodal except that all the top-level windows belonging to the current thread are disabled. </dd>
</dl>
<br>
<h5>To specify other options, use one or more of the following values.</h5>
<dl>
<dt>msg.right</dt>
<dd>The text is right-justified.</dd>
<dt>msg.rtlreading</dt>
<dd>Displays message and caption text using right-to-left reading order on Hebrew and Arabic systems.</dd>
<dt>msg.setforeground</dt>
<dd>The message box becomes the foreground window.</dd>
<dt>msg.topmost</dt>
<dd></dd>
</dl>
<br>
<h5>Return value</h5>
<p>If a message box has a Cancel button, the function returns the <code>msg.idcancel</code> value if either the <kbd>ESC</kbd> key is pressed or the Cancel button is selected. If the message box has no Cancel button, pressing <kbd>ESC</kbd> will no effect - unless an <code>msg.ok</code> button is present. If an <code>msg.ok</code> button is displayed and the user presses <kbd>ESC</kbd>, the return value will be <code>msg.idok</code>.</p>
<p>If the function fails, the return value is zero.<br>
If the function succeeds, the return value is one of the following values:
<dl>
<dt>msg.idok or 1</dt>
<dd>The OK button was selected.</dd>
<dt>msg.idcancel or 2</dt>
<dd>The Cancel button was selected.</dd>
<dt>msg.idyes or 6</dt>
<dd>The Yes button was selected.</dd>
<dt>msg.idno or 7</dt>
<dd>The No button was selected.</dd>
</dl>
</p>
<h5>Examples</h5>
<pre class="syntax"><code>msg("Hello, Warld!","NileSoft Shell", msg.info | msg.ok)<br>
msg("Hello, Warld!","NileSoft Shell")<br>
msg("Hello, Warld!")</code></pre>
<br><br>
<section class="my-5">
<h5>msg.beep(type)</h5>
<p>Plays a waveform sound. The waveform sound for each sound type is identified by an entry in the registry.</p>
<p>Syntax</p>
<code>sys.beep</code><br>
<code>sys.beep(msg.error)</code><br>
<code>sys.beep(msg.warning)</code>
</section>
+184
View File
@@ -0,0 +1,184 @@
<h5>PATH</h5>
<br>
<section class="my-5">
<h5>path.combine (path.join)</h5>
<p>Combines an array of strings into a path.</p>
<p>Syntax</p>
<code>path.combine(path1, path2)</code><br>
<code>path.combine("C:", "Windows", "Explorer.exe")</code>
</section>
<section class="my-5">
<h5>path.currentdirectory (path.curdir)</h5>
<p>Retrieves the current directory for the current process.</p>
<p>Syntax</p>
<code>path.currentdirectory</code>
</section>
<section class="my-5">
<h5>path.directory.name (path.dir.name)</h5>
<p>Return the directory name from the path.</p>
<p>Syntax</p>
<code>path.directory.name('c:\windows\system32') // returns: system32</code>
</section>
<section class="my-5">
<h5>path.directory.box (path.dir.box)</h5>
<p>Shows the directory selection box and returns the path of the specified directory.</p>
<p>Syntax</p>
<code>path.directory.box</code>
</section>
<section class="my-5">
<h5>path.empty</h5>
<p>Check if one or more path is empty.</p>
<p>Syntax</p>
<code>path.empty(path)</code><br>
<code>path.empty(path1, path2, ...)</code>
</section>
<section class="my-5">
<h5>path.exists</h5>
<p>Check if one or more path exists..</p>
<p>Syntax</p>
<code>path.exists(path)</code><br>
<code>path.exists(path1, path2, ...)</code>
</section>
<section class="my-5">
<h5>path.full</h5>
<p>Returns the absolute path for the specified path string.</p>
<p>Syntax</p>
<code>path.full(path)</code>
</section>
<section class="my-5">
<h5>path.short</h5>
<p>Retrieves the short path form of the specified path.</p>
<p>Syntax</p>
<code>path.short(path)</code>
</section>
<section class="my-5">
<h5>path.name</h5>
<p>Return the name from the path.</p>
<p>Syntax</p>
<code>path.name(path)</code>
</section>
<section class="my-5">
<h5>path.location (path.parent)</h5>
<p>Return the path of the parent</p>
<p>Syntax</p>
<code>path.location(path)</code>
</section>
<section class="my-5">
<h5>path.location.name</h5>
<p>Return the name from the parent</p>
<p>Syntax</p>
<code>path.location.name(path)</code>
</section>
<section class="my-5">
<h5>path.root</h5>
<p>Return the drive path</p>
<p>Syntax</p>
<code>path.root(path)</code>
</section>
<section class="my-5">
<h5>path.title</h5>
<p>Return the title from the path</p>
<p>Syntax</p>
<code>path.title(path)</code>
</section>
<section class="my-5">
<h5>path.type</h5>
<p>Return the type of path</p>
<p>Syntax</p>
<code>path.type(path) == type.file</code>
</section>
<section class="my-5">
<h5>path.file.name</h5>
<p>Return the name of path</p>
<p>Syntax</p>
<code>path.file.name(path)</code>
</section>
<section class="my-5">
<h5>path.file.title</h5>
<p>Return the name of path without extension</p>
<p>Syntax</p>
<code>path.file.title(path)</code>
</section>
<section class="my-5">
<h5>path.file.ext</h5>
<p>Return the extension of path</p>
<p>Syntax</p>
<code>path.file.ext(path)</code>
</section>
<section class="my-5">
<h5>path.file.box</h5>
<p>Shows the file selection box and returns the path of the specified file.</p>
<p>Syntax</p>
<code>path.file.box</code><br>
<code>path.file.box('All|*.*|Text|*.txt')</code><br>
<code>path.file.box('exe|*.exe', 'c:\windows')</code><br>
<code>path.file.box('exe|*.exe', 'c:\windows', 'explorer.exe')</code>
</section>
<section class="my-5">
<h5>path.isabsolute</h5>
<p></p>
<p>Syntax</p>
<code>path.isabsolute(path)</code>
</section>
<section class="my-5">
<h5>path.isrelative</h5>
<p></p>
<p>Syntax</p>
<code>path.isrelative(path)</code>
</section>
<section class="my-5">
<h5>path.isfile</h5>
<p></p>
<p>Syntax</p>
<code>path.isfile(path)</code>
</section>
<section class="my-5">
<h5>path.isdirectory</h5>
<p></p>
<p>Syntax</p>
<code>path.isdirectory(path)</code>
</section>
<section class="my-5">
<h5>path.isroot (path.isdrive)</h5>
<p></p>
<p>Syntax</p>
<code>path.isdrive(path)</code>
</section>
<section class="my-5">
<h5>path.isclsid (path.isnamespace)</h5>
<p></p>
<p>Syntax</p>
<code>path.isclsid(path)</code>
</section>
<section class="my-5">
<h5>path.isexe</h5>
<p></p>
<p>Syntax</p>
<code>path.isexe(path)</code>
</section>
<section class="my-5">
<h5>path.removeextension</h5>
<p>Remove the extension from the passed parameter.</p>
<p>Syntax</p>
<code>path.removeextension</code>
</section>
<section class="my-5">
<h5>path.lnktarget (path.lnk)</h5>
<p>Return a path from the shortcut</p>
<p>Syntax</p>
<code>path.lnktarget</code>
</section>
<section class="my-5">
<h5>path.getknownfolder</h5>
<p>Retrieves the full path of a known folder identified.</p>
<p>Syntax</p>
<code>path.getknownfolder('{905e63b6-c1bf-494e-b29c-65b732d3d21a}')</code>
</section>
<section class="my-5">
<h5>path.separator(path.sep)</h5>
<p>Replacing the back slash with a forward slash or defining a spacer.</p>
<p>Syntax</p>
<code>path.separator('c:\windows\system32')</code> <em>return "c:/windows/system32"</em><br>
<code>path.separator('c:\windows\system32', '#')</code> <em>return "c:#windows#system32"</em>
</section>
+30
View File
@@ -0,0 +1,30 @@
<h5>REG</h5>
<p>Registary functions</p>
<br>
<section class="my-5">
<h5>Registry hive enum</h5>
<p>Syntax</p>
<pre><code>reg.cr // HKEY_CLASSES_ROOT
reg.cu // HKEY_CURRENT_USER
reg.lm // HKEY_LOCAL_MACHINE
reg.u // HKEY_USERS
reg.cc // HKEY_CURRENT_CONFIG</code></pre>
</section>
<section class="my-5">
<h5>Registry value kind Enum</h5>
<p>Syntax</p>
<pre><code>reg.none // No data type
reg.sz // REG_SZ
reg.expand // REG_EXPAND_SZ
reg.binary // REG_BINARY
reg.multi // REG_MULTI_SZ
reg.dword // REG_DWORD
reg.qword // REG_QWORD</code></pre>
</section>
<section class="my-5">
<h5>The function of reading from the Registry.</h5>
<p>Syntax</p>
<code>reg(reg.lm, 'SOFTWARE\Microsoft\Windows NT\CurrentVersion','ProductName')</code><br><br>
<code>reg(reg.cr, 'txtfile\DefaultIcon')</code>
</section>
+194
View File
@@ -0,0 +1,194 @@
<h5>SEL</h5>
<p>Has many functions to handle selected file system objects.</p>
<br>
<p>
<h5>sel(quote=<code>false</code>, separator=<code>' '</code>)</h5>
<p>Returns all selected items with double quotation mark and custom separator.</p>
<pre><code>sel<br>sel(true)<br>sel(true, "\n")</code></pre>
</p>
<br>
<p>
<h5>sel.path</h5>
Returns the path of the selected item..
</p>
<br>
<p>
<h5>sel.path.title</h5>
Returns the name without the extension of the selected item.
</p>
<br>
<p>
<h5>sel.path.length</h5>
Returns the number of characters in the path of the selected item.
</p>
<br>
<p>
<h5>sel.path.title</h5>
Returns the path title of the selected item..
</p>
<br>
<p>
<h5>sel.path.quote</h5>
Returns the path of the selected item. with double quotation mark.
</p>
<br>
<p>
<h5>sel.short</h5>
Returns the short path of the selected item.
</p>
<br>
<p>
<h5>sel.short.length</h5>
Returns the number of characters in the short path of the selected item.
</p>
<br>
<p>
<h5>sel.raw</h5>
Returns the path of the selected item in raw format.
</p>
<br>
<p>
<h5>sel.raw.length</h5>
Returns the number of characters in the raw path of the selected item.
</p>
<br>
<p>
<h5>sel.root</h5>
Returns the root directory from the path of the selected items.
</p>
<br>
<p>
<h5>sel.name</h5>
Returns the name and extension of the selected item.
</p>
<br>
<p>
<h5>sel.name.length</h5>
Returns the number of characters in the name of the selected item.
</p>
<br>
<p>
<h5>sel.title</h5>
Returns the name without extension of the selected item.
</p>
<br>
<p>
<h5>sel.title.length</h5>
Returns the number of characters in the name without extension of the selected item.
</p>
<br>
<p>
<h5>sel.parent</h5>
Returns the directory path for the selected item.
</p>
<br>
<p>
<h5>sel.parent.quote</h5>
Returns the directory path for the selected item with quotation mark.
</p>
<br>
<p>
<h5>sel.parent.raw</h5>
Returns the directory path for the selected item in raw format.
</p>
<br>
<p>
<h5>sel.parent.name</h5>
Returns the name of the parent of the selected item.
</p>
<br>
<p>
<h5>sel.parent.length</h5>
Returns the number of characters in the parent path of the selected item.
</p>
<br>
<p>
<h5>sel.count</h5>
Returns count selected items.
</p>
<br>
<p>
<h5>sel.back</h5>
Returns whether the selection is in the background.
</p>
<br>
<p>
<h5>sel.curdir or sel.workdir</h5>
Returns the path of current working directory.
</p>
<br>
<p>
<h5>sel.file</h5>
Returns the path for the selected item. If it is a file
</p>
<br>
<p>
<h5>sel.file.name</h5>
Returns the number of characters in the name of the selected item. If it is a file.
</p>
<br>
<p>
<h5>sel.file.name.length</h5>
Returns the name for the selected item. If it is a file.
</p>
<br>
<p>
<h5>sel.file.ext</h5>
Returns the extension for the selected item. If it is a file.
</p>
<br>
<p>
<h5>sel.file.title</h5>
Returns the name without an extension for the selected item. If it is a file.
</p>
<br>
<p>
<h5>sel.file.quote</h5>
Returns the path for the selected item with quotation mark. If it is a file.
</p>
<br>
<p>
<h5>sel.directory</h5>
Returns the path for the selected item. If it is a directory.
</p>
<br>
<p>
<h5>sel.directory.name</h5>
Returns the name for the selected item. If it is a directory.
</p>
<br>
<p>
<h5>sel.directory.length</h5>
Returns the number of characters in the path of the selected item. If it is a directory.
</p>
<br>
<p>
<h5>sel.directory.quote</h5>
Returns the path for the selected item with quotation mark. If it is a directory.
</p>
<br>
<p>
<h5>sel.get(index=<code>0</code>)</h5>
Returns the path of the selected item by referring to the index number.
</p>
<br>
<p>
<h5>sel.raw(index=<code>0</code>)</h5>
Returns the raw path of the selected item by referring to the index number.
</p>
<br>
<p>
<h5>sel.length(index=<code>0</code>)</h5>
Returns the number of characters in the path of the selected item by referring to the index number.
</p>
<br>
<p>
<h5>sel.readonly(index=<code>0</code>)</h5>
Returns whether the selected item by referring to the index number is read-only.
</p>
<br>
<p>
<h5>sel.hidden(index=<code>0</code>)</h5>
Returns whether the selected item by referring to the index number is hidden.
</p>
+190
View File
@@ -0,0 +1,190 @@
<h5>STR</h5>
<br>
<section class="my-5">
<h5>str.get (str.at)</h5>
<p>Returns a character from a specific location in the string.</p>
<p>Syntax</p>
<code>str.get("Hello World!", 7)</code>
</section>
<section class="my-5">
<h5>str.set</h5>
<p>Sets a character with a specific location in the string.</p>
<p>Syntax</p>
<code>str.set("Hello World!", 6, '-')</code>
</section>
<section class="my-5">
<h5>str.contains</h5>
<p>Returns a value indicating whether a specified substring occurs within this string.</p>
<p>Syntax</p>
<code>str.contains("Hello World!", 'World')</code>
</section>
<section class="my-5">
<h5>str.empty (str.null)</h5>
<p>Tests whether the string contains characters.</p>
<p>Syntax</p>
<code>str.empty("")</code>
</section>
<section class="my-5">
<h5>str.start</h5>
<p>Checks whether the string starts with the specified prefix.</p>
<p>Syntax</p>
<code>str.start("Hello World!", "World!")</code>
</section>
<section class="my-5">
<h5>str.end</h5>
<p>Checks whether the string ends with the specified suffix.</p>
<p>Syntax</p>
<code>str.end("Hello World!", "World!")</code>
</section>
<section class="my-5">
<h5>str.equals</h5>
<p>Determines whether two String have the same value.</p>
<p>Syntax</p>
<code>str.equals("Hello World!", "Hello World!")</code>
</section>
<section class="my-5">
<h5>str.not</h5>
<p>Determine if two strings do not have the same value.</p>
<p>Syntax</p>
<code>str.not("Hello World!", "Hello-World!")</code>
</section>
<section class="my-5">
<h5>str.length (str.len)</h5>
<p>Gets the number of characters in the current string.</p>
<p>Syntax</p>
<code>str.length("Hello World!")</code>
</section>
<section class="my-5">
<h5>str.trim</h5>
<p>Returns a new string in which all leading and trailing occurrences of a set of specified characters from the current string are removed.</p>
<p>Syntax</p>
<p>Removes all leading and trailing white-space characters from the current string.</p>
<code>str.trim(" Hello World! ")</code><br><br>
<p>Removes all leading and trailing 'H!' characters from the current string.</p>
<code>str.trim("Hello World!", "H!")</code>
</section>
<section class="my-5">
<h5>str.trimstart</h5>
<p>Returns a new string in which all leading occurrences of a set of specified characters from the current string are removed.</p>
<p>Syntax</p>
<p>Removes all leading white-space characters from the current string.</p>
<code>str.trimstart(" Hello World!")</code><br>
<p>Removes all leading 'H' characters from the current string.</p>
<code>str.trimstart("Hello World!", "H")</code>
</section>
<section class="my-5">
<h5>str.trimend</h5>
<p>Returns a new string in which all trailing occurrences of a set of specified characters from the current string are removed.</p>
<p>Syntax</p>
<p>Removes all trailing white-space characters from the current string.</p>
<code>str.trimend("Hello World! ")</code><br>
<p>Removes all trailing '!' characters from the current string.</p>
<code>str.trimend("Hello World!", "!")</code>
</section>
<section class="my-5">
<h5>str.find</h5>
<p>Searches a string in a forward direction for the first occurrence of a substring that matches a specified sequence of characters.</p>
<p>Syntax</p>
<code>str.find("Hello World!", "lo")</code>
</section>
<section class="my-5">
<h5>str.findlast</h5>
<p>Searches a string in a backward direction for the first occurrence of a substring that matches a specified sequence of characters.</p>
<p>Syntax</p>
<code>str.findlast("Hello World!", "Wor")</code>
</section>
<section class="my-5">
<h5>str.lower</h5>
<p>Returns a copy of this string converted to lowercase.</p>
<p>Syntax</p>
<code>str.lower("Hello World!")</code>
</section>
<section class="my-5">
<h5>str.upper</h5>
<p>Returns a copy of this string converted to uppercase.</p>
<p>Syntax</p>
<code>str.upper("Hello World!")</code>
</section>
<section class="my-5">
<h5>str.left</h5>
<p>Extracts the left part of a string.</p>
<p>Syntax</p>
<code>str.left("Hello World!", 5)</code>
</section>
<section class="my-5">
<h5>str.right</h5>
<p>Extracts the right part of a string.</p>
<p>Syntax</p>
<code>str.right("Hello World!", 5)</code>
</section>
<section class="my-5">
<h5>str.sub</h5>
<p>Copies a substring of at most some number of characters from a string beginning from a specified position.</p>
<p>Syntax</p>
<code>str.sub("Hello World!", 5)</code><br>
<code>str.sub("Hello World!", 0, 5)</code>
</section>
<section class="my-5">
<h5>str.remove</h5>
<p>Removes an element or a range of elements in a string from a specified position.</p>
<p>Syntax</p>
<code>str.replace("Hello World!", " ")</code><br>
<code>str.remove("Hello World!", 5)</code><br>
<code>str.remove("Hello World!", 5, 1)</code>
</section>
<section class="my-5">
<h5>str.replace</h5>
<p>Replace elements in a string at a specified position with specific characters or characters copied from other ranges or strings.</p>
<p>Syntax</p>
<code>str.replace("Hello World!", "World", "User")</code><br>
<code>str.replace("Hello World!", "world", "user", true)</code>
</section>
<section class="my-5">
<h5>str.padleft</h5>
<p>Returns a new string of a specified length in which the beginning of the current string is padded with spaces or with a specified character.</p>
<p>Syntax</p>
<code>str.padleft("Hello World!", "*")</code><br>
<code>str.padleft("Hello World!", "*", 3)</code>
</section>
<section class="my-5">
<h5>str.padright</h5>
<p>Returns a new string of a specified length in which the end of the current string is padded with spaces or with a specified character.</p>
<p>Syntax</p>
<code>str.padright("Hello World!", "*")</code><br>
<code>str.padright("Hello World!", "*", 3)</code>
</section>
<section class="my-5">
<h5>str.padding</h5>
<p>Returns a new string of a specified length in which the start and end of the current string is padded with spaces or with a specified character.</p>
<p>Syntax</p>
<code>str.padding("Hello World!", "*")</code><br>
<code>str.padding("Hello World!", "*", 3)</code>
</section>
<section class="my-5">
<h5>str.guid</h5>
<p>Returns a new guid string</p>
<p>Syntax</p>
<code>str.guid</code> return 00000000000000000000000000000000 <br>
<code>str.guid(1)</code> return 00000000-0000-0000-0000-000000000000 <br>
<code>str.guid(2)</code> return {00000000-0000-0000-0000-000000000000} <br>
<code>str.guid(3)</code> return (00000000-0000-0000-0000-000000000000) <br>
</section>
<section class="my-5">
<h5>str.capitalize</h5>
<p>Returns a new capitalize string</p>
<p>Syntax</p>
<code>str.capitalize('hello world')</code> return "Hello World" <br>
</section>
<section class="my-5">
<h5>str.res</h5>
<p>Returns a string resource from the executable file. <em>"shell32.dll" is the default file.</em></p>
<p>Syntax</p>
<code>str.res(-4640)</code> return "Runs the selected command with elevation" from "shell32.dll"<br>
<code>str.res('explorer.dll', -22000)</code> return "Desktop" <br>
</section>
+108
View File
@@ -0,0 +1,108 @@
<h5>SYS (SYSTEM)</h5>
<section class="my-5">
<h5>sys.name</h5>
<p>Returns Windows name.</p>
<p>Syntax</p>
<code>sys.name</code>
</section>
<section class="my-5">
<h5>sys.name</h5>
<p>Returns Windows name.</p>
<p>Syntax</p>
<code>sys.name</code>
</section>
<section class="my-5">
<h5>sys.type</h5>
<p>Returns system architecture.</p>
<p>Syntax</p>
<code>sys.type</code>
</section>
<section class="my-5">
<h5>sys.type</h5>
<p>Returns system architecture.</p>
<p>Syntax</p>
<code>sys.type == 64</code><br>
<code>sys.type == 32</code>
</section>
<section class="my-5">
<h5>sys.is64</h5>
<p>Returns if system architecture is x64.</p>
<p>Syntax</p>
<code>sys.is64</code>
</section>
<section class="my-5">
<h5>sys.dark</h5>
<p>Check if dark mode is enabled.</p>
<p>Syntax</p>
<code>sys.dark</code>
</section>
<section class="my-5">
<h5>sys.var</h5>
<p>Retrieves the value of an environment variable.</p>
<p>Syntax</p>
<code>sys.var('WINDIR')</code>
</section>
<section class="my-5">
<h5>sys.version (sys.ver)</h5>
<p>Windows version.</p>
<p>Syntax</p>
<pre><code>sys.version
sys.version.build
sys.version.major
sys.version.minor
sys.version.name
sys.version.type</code></pre>
</section>
<section class="my-5">
<h5>sys.datetime</h5>
<p>Date and time format</p>
<p>Syntax</p>
<pre><code>sys.datetime
sys.datetime.date
sys.datetime.date_day
sys.datetime.date_dayofweek
sys.datetime.date_month
sys.datetime.date_y
sys.datetime.date_year
sys.datetime.date_yy
sys.datetime.short
sys.datetime.time
sys.datetime.time_hour
sys.datetime.time_milliseconds
sys.datetime.time_min
sys.datetime.time_minute
sys.datetime.time_ms
sys.datetime.time_pm
sys.datetime.time_second</code></pre>
</section>
<section class="my-5">
<h5>Windows paths</h5>
<pre><code>sys.appdata
sys.bin
sys.bin32
sys.bin64
sys.directory (sys.dir)
sys.path
sys.prog
sys.prog32
sys.programdata
sys.random
sys.refresh
sys.root
sys.temp
sys.templates
sys.users
sys.wow</code></pre>
</section>
<section class="my-5">
<h5>sys.beep(milliseconds)</h5>
<p>Suspends the execution of the current thread until the time-out interval elapses.</p>
<p>Syntax</p>
<code>sys.sleep(1000)</code>
</section>
<pre><code>
sys.toggleext
sys.togglehidden
</code></pre>
+36
View File
@@ -0,0 +1,36 @@
<h5>USER</h5>
<br>
<section class="my-5">
<h5>user.name</h5>
<p>Returns the current username.</p>
<p>Syntax</p>
<code>user.name</code>
</section>
<section class="my-5">
<h5>Functions to return the path of user directories</h5>
<p>Syntax</p>
<pre><code>user.home
user.appdata
user.contacts
user.desktop
user.directory (user.dir)
user.documents
user.documentslibrary
user.downloads
user.favorites
user.libraries
user.localappdata
user.music
user.personal
user.pictures
user.profile
user.quicklaunch
user.sendto
user.startmenu
user.temp
user.templates
user.videos</code>
</pre>
</section>
+29
View File
@@ -0,0 +1,29 @@
<h4>Get Started</h4>
<br>
<p>
This tutorial will teach you the basics of <b>Shell</b>.<br>
It is not necessary to have any prior experience.
</p>
<p>
To start using <b>Shell</b>, you need:<br>
A text editor, like Notepad, to write <b>Shell</b> code.
</p>
<h5>Quickstart</h5>
<p>Let's create our first menu item.</p>
<p>Open configuration file (shell.shl) and Write the following code and save.</p>
<pre class="syntax"><code>shell
{
dynamic
{
item(title=<span class="syntax-string">'Hello, World!'</span>)
}
}</code></pre>
<p>Don't worry if you don't understand the code above - we will discuss it in detail in later chapters.</p>
<p>The result will look something for this when you press the right-click in an empty place on the desktop:</p>
<div class="has-text-centered my-5">
<a class="lightbox">
<img src="/images/support/helloworld.png">
</a>
</div>
<p><strong>Congratulations</strong> You have now added the first time a menu item to the context menu</p>
+32
View File
@@ -0,0 +1,32 @@
<h4>Introduction</h4>
<br>
<h5>What is Shell?</h5>
<p>
<b>Shell</b> is a extensions of Windows File Explorer that can be used to create high-performance context menu items.
and gives user a high level of control over context menu of Windows File Explorer.
</p>
<p>The Right Click Menu or the Context Menu is the menu, which appears when you right-click on the desktop, file, folder or taskbar in Windows. This menu gives you added functionality by offering you actions you can take with the item</p>
<p><b>Shell</b> is all you need to customize or add new items with several functions to Windows File Explorer Context menu and Much More.(cascade menus, advanced menus, multi-level menus, command menus, separator).</p>
<div class="has-text-centered my-6">
<a class="lightbox">
<img src="/images/screenshots/goto.png">
</a>
</div>
<h5>Why Use Shell</h5>
<ul>
<li>Is portable, fun and easy to learn!.</li>
<li>Small installation file.</li>
<li>Clean and simple user interface.</li>
<li>Configuration in plain text.</li>
<li>Quick loading.</li>
<li>Minimal resource usage.</li>
<li>No limitations.</li>
<li>Embedded expressions syntax.</li>
<li>Built-in functions and predefined variables.</li>
<li>Multiple sources of images (embedded icons, image files, glyphs and colors).</li>
<li>Dynamic search and filter.</li>
<li>Support Taskbar context menu.</li>
<li>Full management of the context menu.</li>
</ul>
+47
View File
@@ -0,0 +1,47 @@
<h4>Installation</h4>
<br>
<p>Download the release package and unzip its content in any location you want.</p>
<p>Open an elevated command prompt.</p>
<div class="alert alert-primary" role="alert">Administrative permissions required for installation</div>
<h5>Command-Line Help</h5><br>
<code>shell -[options]</code>
<br><br>
<h5>Options</h5>
<table class="table table-sm">
<tr>
<td class="syntax-keyword w-25">-register (-r)</td>
<td>Registering.</td>
</tr>
<tr>
<td class="syntax-keyword">-unregister (-u)</td>
<td>Unregistering.</td>
</tr>
<tr>
<td class="syntax-keyword">-init (-i)</td>
<td>Initialize images cache.</td>
</tr>
<tr>
<td class="syntax-keyword">-restart (-re)</td>
<td>Restart Windows Explorer.</td>
</tr>
<tr>
<td class="syntax-keyword">-silent (-s)</td>
<td>Prevents displaying messages.</td>
</tr>
<tr>
<td class="syntax-keyword">-?</td>
<td>Dispay this help message.</td>
</tr>
</table>
<div id="intsall">
<h5>Intsall</h5>
<code>shell -register -init</code>
</div>
<hr>
<div id="unintsall">
<h5>Unintsall</h5>
<code>shell -unregister -restart</code>
<br>
<p class="mt-5"><i>Tip:</i> Close all instances of Windows File Explorer before uninstalling to avoid needing a reboot after it has been uninstalled.</p>
</div>
+37
View File
@@ -0,0 +1,37 @@
<h4>Default</h4>
<br><br>
<p>Default are containers for storing default values.</p>
<pre class="syntax"><code>shell
{
default
{
<span class="syntax-comment">// view = auto, compact, small, medium, large, wide</span>
view = <span class="syntax-code">view.compact</span>
<span class="syntax-comment">// theme = auto, dark, light, white, black</span>
theme = <span class="syntax-code">theme.black</span>
<span class="syntax-comment">// text = [normal, hover, disabled]</span>
text = [<span class="syntax-number">#ffffff</span>, <span class="syntax-keywor">default</span>, <span class="syntax-number">#808080</span>]
<span class="syntax-comment">// block = [normal, hover, radius]</span>
block = [<span class="syntax-number">#000</span>, <span class="syntax-number">#444</span>, <span class="syntax-number">5</span>]
<span class="syntax-comment">// separator = [color, size]</span>
separator = [<span class="syntax-number">#ff00ff</span>, <span class="syntax-number">1</span>]
<span class="syntax-comment">// frame = [border color, border size]</span>
frame = [<span class="syntax-number">#000</span>, <span class="syntax-number">3</span>]
<span class="syntax-comment">// font = [size, font name]</span>
font = [<span class="syntax-number">12</span>, <span class="syntax-string">'Brush Script'</span>]
<span class="syntax-comment">// Chevron, Check Mark, Radio Bullet</span>
symbol = <span class="syntax-number">#ff0000</span>
<span class="syntax-comment">// Enable/Disable drop shadow</span>
shadow = <span class="syntax-number">false</span>
}
}</code></pre>
File diff suppressed because it is too large. Load diff
+77
View File
@@ -0,0 +1,77 @@
<h4>Syntax Rules for Configuration Files</h4>
<br>
<p>This chapter describes the syntax rules for configuration file.</p>
<ul>
<li>Syntax are not case sensitive.</li>
<li>Spaces around the equal (<code>=</code>) sign are optional and are ignored.</li>
<li>The properties of static and dynamic items are separated by blank spaces or on a separate line and must be placed in parentheses <code>( )</code>.</li>
<li>variable are optional.</li>
<li>default are optional.</li>
<li>Static items are optional.</li>
<li>Static items have one type: item.</li>
<li>Dynamic items are optional.</li>
<li>Dynamic items have three types: menu, item, and separator(sep).</li>
</ul>
<p><i>Tip:</i> When there is an error, it is recorded in the log file (shell.log).</p>
<p>The following rules apply to the syntax of configuration file (shell.shl):</p>
<h5>shell.shl structure</h5>
<pre class="syntax"><code>shell
{
<span class="syntax-comment">// global variables</span>
var
{
<span class="syntax-comment">// variables content</span>
variable-name = variable-value
...
}
default
{
<span class="syntax-comment">// defaults content</span>
default-name = default-value
default-name = [default-value, default-value, ...]
...
}
<span class="syntax-comment">// static items</span>
static
{
<span class="syntax-comment">// static items content</span>
item ( property-name = property-value ... )
...
}
<span class="syntax-comment">// dynamic items</span>
dynamic
{
<span class="syntax-comment">// dynamic items content</span>
item ( property-name = property-value ... )
separator [( property-name = property-value ... )]
menu ( property-name = property-value ... )
{
var <span class="syntax-comment">// local variables</span>
{
variable-name = variable-value
...
}
item ( property-name = property-value ... )
...
}
...
}
}</code></pre>
<br>
<p><b>Breaking Long Lines</b><br>For best readability, users often like to avoid lines longer than 80 characters. single quotes also allow break up a line.</p>
<pre class="syntax"><code>shell
{
dynamic
{
item(title=<span class="syntax-string">'Command prompt'</span>
cmd=<span class="syntax-string">'cmd.exe'</span>)
}
}</code></pre>
+199
View File
@@ -0,0 +1,199 @@
<h4>Static Items</h4>
<br>
<p>This section modifies context menu items added by the system or by a third party. more than one item can be added with some properties to customize the context menu. explained below in more details.<br>The items must have the property <code>find</code>. to search in the titles of the menu items to catches them and customize by other properties such as changing the title, icon, visibility, or moving it to another location.</p>
<p>In the following example, it shows how to write add an items to static:</p>
<pre class="syntax"><code>shell
{
static
{
item(find = <span class="syntax-string">'copy'</span> image = <span class="syntax-number">#00ff00</span>)
item(find = <span class="syntax-string">'paste'</span> image = <span class="syntax-number">#0000ff</span>)
}
}</code></pre>
<br>
<br>
<h4>Properties</h4>
<div class="table-container">
<table class="table">
<thead>
<tr>
<th scope="col">Property</th>
<th scope="col">Summary</th>
</tr>
</thead>
<tbody>
<tr>
<td>Where</td>
<td>Allow menu item to be passed if a true value is returned<br>
Default = <span class="syntax-keyword">true</span>
</td>
</tr>
<tr>
<td>Find</td>
<td>Accept menuitem when the specific menuitem title is contains or equal to the current find property.<br>Use this delimiter <code>|</code> to separate patterns.
<p class="has-text-danger">This property must be included with another property at least if where property is not defined.</p>
Default = <span class="syntax-keyword">null</span>
</td>
</tr>
<tr>
<td>Title</td>
<td>
<p>Change value indicating the caption of the menuitem.</p>
Default = <span class="syntax-keyword">null</span>
</td>
</tr>
<tr>
<td>Mode</td>
<td>Accept item by selections behavior. Value have one of the following parameters:
<table class="table">
<tr>
<td class="syntax-keyword">None</td>
<td>Accept item when there are no selections.</td>
</tr>
<tr>
<td class="syntax-keyword">Single</td>
<td>Accept menuitem when there are single selection.</td>
</tr>
<tr>
<td class="syntax-keyword">MultiUnique</td>
<td>Accept when multiple selections are single type.</td>
</tr>
<tr>
<td class="syntax-keyword">MultiSingle</td>
<td>Accept when multiple selections are single file extension.</td>
</tr>
<tr>
<td class="syntax-keyword">Multiple</td>
<td>Accept all types.</td>
</tr>
</table>
Default = <span class="syntax-keyword">single</span>
</td>
</tr>
<tr>
<td>Visibility (vis)</td>
<td>Visibility of menuitem and can have one of the following parameters:.
<table class="table">
<tr>
<td class="syntax-keyword">Hidden</td>
<td>Hide the menuitem.</td>
</tr>
<tr>
<td class="syntax-keyword">Normal</td>
<td>Enabled the menuitem.</td>
</tr>
<tr>
<td class="syntax-keyword">Disable</td>
<td>Disabled the menuitem.</td>
</tr>
<tr>
<td class="syntax-keyword">Extended</td>
<td>The menuitem appears when the <kbd>Shift</kbd> key is pressed.</td>
</tr>
<tr>
<td class="syntax-keyword">ExtendedHidden</td>
<td>Hide the menuitem when the <kbd>Shift</kbd> key is pressed.</td>
</tr>
<tr>
<td class="syntax-keyword">ExtendedDisable</td>
<td>The item appears disabled when the <kbd>Shift</kbd> key is pressed.</td>
</tr>
</table>
Default = <span class="syntax-keyword">normal</span>
</td>
</tr>
<tr>
<td>Position (pos)</td>
<td>The position at which a menuitem should be inserted into the menu.<br/>Position can have one of the following parameters:
<table class="table">
<tr>
<td class="syntax-keyword">Auto</td>
<td>Insert the menuitem to the current position.</td>
</tr>
<tr>
<td class="syntax-keyword">Middle</td>
<td>Insert the menuitem to the middle of the menu.</td>
</tr>
<tr>
<td class="syntax-keyword">Top</td>
<td>Insert the menuitem to the top of the menu.</td>
</tr>
<tr>
<td class="syntax-keyword">Bottom</td>
<td>Insert the menuitem to the bottom of the menu.</td>
</tr>
<tr>
<td class="syntax-keyword">Number sets</td>
<td>Insert the menuitem to a specified position with integer numbers.</td>
</tr>
</table>
Default = <span class="syntax-keyword">auto</span>
</td>
</tr>
<tr>
<td>Separator (sep)</td>
<td>Add separator with menuitem position by parameters:
<table class="table">
<tr>
<td class="syntax-keyword">None</td>
<td>Not adding a separator with the menuitem.</td>
</tr>
<tr>
<td class="syntax-keyword">Before</td>
<td>Add a separator before the menuitem.</td>
</tr>
<tr>
<td class="syntax-keyword">After</td>
<td>Add a separator after the menuitem.</td>
</tr>
<tr>
<td class="syntax-keyword">Both</td>
<td>Add a separator before and after the menuitem.</td>
</tr>
</table>
Default = <span class="syntax-keyword">none</span>
</td>
</tr>
<tr>
<td>Image</td>
<td>The icon that appears in a menuitem, This property can be assigned as image files, resource icons, glyph or color. With one of the following parameters
<table class="table">
<tr>
<td class="syntax-keyword">Null</td>
<td>Show menuitem without icon.</td>
</tr>
<tr>
<td class="syntax-keyword">Inherit</td>
<td>Inheriting the image from the parent.</td>
</tr>
<tr>
<td class="syntax-keyword">Glyph</td>
<td>Assign image as Glyph.</td>
</tr>
<tr>
<td class="syntax-keyword">Color</td>
<td>Assign image as color.</td>
</tr>
<tr>
<td class="syntax-keyword">Path</td>
<td>Assign image from location path or resource icon.</td>
</tr>
</table>
Default = <span class="syntax-keyword">null</span>
</td>
</tr>
<tr>
<td>Parent</td>
<td><p>Move current menu item(s) to another menu.</p>
Default = <span class="syntax-keyword">null</span></td>
</tr>
<tr>
<td>Default</td>
<td>
<p>Specifies that the menuitem is the default. A menu can contain only one default menuitem, which is displayed in bold.</p>
Default = <span class="syntax-keyword">false</span>
</td>
</tr>
</tbody>
</table>
</div>
+46
View File
@@ -0,0 +1,46 @@
<h4>Variables</h4>
<br>
<p>Variables are containers for storing data values.</p>
<ul>
<li>Global and local variables are optional.</li>
<li>To declare more than one variable, use a space.</li>
</ul>
<p>The general rules for constructing names for variables (unique identifiers) are:</p>
<ul>
<li>Names can contain letters, digits and underscores (<code>_</code>).</li>
<li>Names must begin with a letter.</li>
<li>Names cannot contain whitespaces or special characters like !, #, %, etc.</li>
<li>Reserved words (like keywords, such as null, true, false, etc.) cannot be used as names.</li>
<li>Variables can be placed in globle variables, or in the dynamic body section of an menu, or in both.</li>
</ul>
<p>
All variables must be identified with unique names.<br>
These unique names are called identifiers.
Identifiers can be short names (like x and y) or more descriptive names (age, sum, totalVolume).
</p>
<p><i>Note:</i> It is recommended to use descriptive names in order to create understandable and maintainable code</p>
<h5 class="mt-5">Example</h5>
<pre class="syntax"><code>shell
{
var
{
hello_world = <span class="syntax-string">'Hello World!'</span>
test_add1 = <span class="syntax-number">5</span> + <span class="syntax-number">6</span>
}
dynamic
{
item(title = <span class="syntax-code">@hello_world</span> cmd = <span class="syntax-code">@msg(hello_world)</span>)
menu(title = <span class="syntax-code">@test_add1</span>)
{
var
{
test_sub1 = <span class="syntax-number">11</span> - <span class="syntax-number">5</span>
}
item(title = <span class="syntax-code">@test_sub1</span>)
}
}
}</code></pre>