Code: Select all
XYplorer Beta Club
v7.50.0019 - 2008-09-07 12:57
! Scripting: Variable assigment using the equal-operator did not
work without a blank between the variable and the equal-operator.
Now it does. All are identical:
::$a="b";
::$a = "b";
::$a = "b";
Code: Select all
v7.50.0020 - 2008-09-08 10:04
+ Scripting: Re-added command "br" (it had been removed in
v7.50.0016). Reason: It's still useful. For example, the simple
line ::br; will prevent all automatic line breaking in msg, text,
and copytext. So, to show HTML without replacing <br> with CRLF
you now can go two ways:
::readurl $a, "http://www.xyplorer.com"; text $a,,,,,""
::readurl $a, "http://www.xyplorer.com"; br; text $a;
Code: Select all
v7.50.0021 - 2008-09-08 14:15
! The Shell's Browse For Folders dialog did not always expand a
network computer's branch to show the shared folders. This might
be fixed now.
* Updated the help file.
+ Upgrade information: When upgrading to 7.60 you get an information
about the changes in scripting. It will be shown only once at
startup in version 7.60 or higher. Because this BETA is still 7.50
you'll see it on every startup.
Code: Select all
v7.50.0022 - 2008-09-09 09:32
! The Shell's Browse For Folders dialog did not always expand a
network computer's branch to show the shared folders. Fix #2.
! Address Bar: Using Auto-Complete would lead to a permanent folder
lock on first level folders (e.g. D:\Test\ but not D:\Test\Test\)
due to a mysterious shell bug. This bug does not happen though
when Auto-Complete is restricted to folders (and does not include
files). Which now is the case.
* Backup operation, feedback in the statusbar: You now get status
when a file starts to get copied and when it's finished, so you
always know what's happening.
Code: Select all
v7.60.0000 - 2008-09-09 15:00
= NEW OFFICIAL RELEASE. Main changes since last release:
+++ Scripting meets File Search: The brand-new LoadSearch command is the
nexus of two of XYplorer's strongest features: Scripting and File
Search. In combination with the Catalog, UDCs, and XYS files, you can
now easily build handy libraries of complex live searches.
+++ Scripting meets the Web: The brand-new Download command enables you
to download any internet content straight into your file manager with a
single click or keyboard shortcut!
+++ Scripting Syntax: String and variable handling has been massively
improved.
+++ The release package now includes a sample Catalog which will be used
on application startup if no catalog.dat file already exists.
+++ Copy Image: A new command allows you to copy the image of an image
file directly to the clipboard without first having to open the file
in an image viewer application.
Code: Select all
v7.60.0000 - 2008-09-09 20:45
! Recompiled due to a little bug fix.
Code: Select all
v7.60.0001 - 2008-09-10 11:55
+ Scripting | Step Dialog: Added information about the potential
risk associated with the command to be executed. There are the
following risk classes:
(3) Potentially harmful because the function ID might refer to
some risky process which is unknown at this point (either an
internal command or a UDC):
#[function ID]
(2) Potentially harmful because files or folders are affected:
backupto, copyto, delete, download, moveto, new, open,
openwith, rename, run, setkey, swapnames, timestamp
(1) Potentially harmful because step mode is terminated:
unstep
(0) Harmless:
(all others)
Class 3, 2, and 1 are marked with a yellow "warning" icon, class 0
with a green "ok" icon.
* Menu Window | Show Navigation Panel / Show Tree / Show Catalog:
Change the interrelated logic between the three. Since v7.30.0027
(2008-07-26 21:46) you could get an empty grey area when both Tree
and Catalog were hidden but Navigation Panel was shown. This was
irritating users and understandably so.
Now, when you hide both Tree and Catalog then the Navigation Panel
is hidden automatically as well, and it is auto-shown (if
necessary) when you show Tree or Catalog.
Special case: When all three are hidden and you then select Show
Navigation Panel, then by default the Tree is shown being the more
traditional control and, more imortant, the one the guaranteed
contents.
* Menu View | Date Column Format | Show Weekday: If "Show Weekday"
is enabled and the file date is within the last hour, you now get
"Now" instead of "Today".
You can tweak the actual word for "Now", for example you can set
it to "Ahora" by editing the INI-file like this:
[General]
; Tweak: 'Now' in file dates
TermThisHour=Ahora
Or set it to "Today" if you don't care about this new feature.
! Menu File | To Clipboard | Image: Did not work correctly with ARGB
images. Fixed.
Code: Select all
v7.60.0002 - 2008-09-11 12:27
+ Scripting: Improved error messaging. Now the Step dialog is
exploited for the task of telling you what went wrong where.
The dialog also has been slightly widened.
+ Scripting got a new command:
- InternetFlags
Action: tune internet commands (Download, ReadURL)
Syntax: internetflags name, value
name: INTERNET_FLAG_NO_COOKIES
(yes, only this is currently supported)
value: 1 = On, 0 = Off
Examples:
- The default is to use cookies:
::input $a, "Enter URL", <clipboard>;
download $a;
- Do it like this to not use cookies:
::internetflags "INTERNET_FLAG_NO_COOKIES", 1;
input $a, "Enter URL", <clipboard>;
download $a;
+ INI-Tweak to insert prompt on XClosing the app.
[Settings]
PromptOnXClose=1
Set to 1 to get nagged by an "Exit XYplorer now?" prompt.
Code: Select all
v7.60.0003 - 2008-09-11 13:24
! Scripting: Crash (error 9) on empty scripts (no commands). Fixed.
Code: Select all
v7.60.0005 - 2008-09-12 15:14
+++ Color Filters 2.0: Now you can define the *backcolor* of items!
The usage is just as simple as it has been before:
Before: patternlist>textcolor
Now: patternlist>textcolor,backcolor
And just like before, you can configure your color filters either
in Configuration | Color Filters, where you can define the colors
using the standard Windows color selector. Or you can use List
Management | Color Filters, where you can enter the colors
directly in RRGGBB format.
Remarks
~~~~~~~
- The usage of backcolor is optional, of course. So if you are not
interested in this new feature you don't have to do anything and
everything stays as it has been before.
- Leave any of the fields empty to use default colors:
/s>FF0000,FFFF80 -> red on light yellow
/s>FF0000 -> red on default back color
/s>,FFFF80 -> default text color on light yellow
- The backcolor will not cover the whole row but just the name of
the item. Therefore you should choose text colors that work on the
filter's backcolor as well as on the list's backcolor.
- If an item is selected the backcolor will be stretched 7 pixels
to the right in order to have it still visible behind the focus
rect.
+ Scripting got a new command:
- GetInfo
Action: Get various info into variable.
Syntax: getinfo output, info, [param1]
output: [required] variable
info: [required] sort of info (case-sensitive)
param1: [optional] depends on info
Possible values for info and param1:
- "CountSelected", [(unused)]
Count of selected items in List.
- "SelectedItemsPathNames", [delimiter=CRLF]
All selected items (full path/name) in List, delimited by
param1.
Examples:
::getinfo $a, "CountSelected"; msg $a
::getinfo $a, "SelectedItemsPathNames", "|"; msg $a
* Scripting command "InternetFlags": Now turning the flag ON is the
default if you don't pass a value. The interflags setting lives on
the stack. Also the error handling has been improved.
Revised command profile:
- InternetFlags
Action: tune internet commands (Download, ReadURL)
Syntax: internetflags name, [value]
name: INTERNET_FLAG_NO_COOKIES
(yes, only this is currently supported)
value: [optional] 1 = On [default]
0 = Off
Examples:
Turn it on:
::internetflags "INTERNET_FLAG_NO_COOKIES"
::internetflags "INTERNET_FLAG_NO_COOKIES", 1
Turn it off:
::internetflags "INTERNET_FLAG_NO_COOKIES", 0
+ Scripting | Step dialog: Now the first two lines display
(1) the current script resource
(2) the current script caption
! A FVS related bug from 7.50 could still survive in corrupted INIs
and fvs.dat files. Added code to handle and repair this.
Code: Select all
v7.60.0007 - 2008-09-13 14:41
+ Scripting: Added a bit of conditional logic in a form of "ternary
conditionals" as used in various programming languages (e.g. PHP).
The logic (this structure is not yet part of XY!) is this:
if (condition) {
variable = value-if-true;
} else {
variable = value-if-false;
}
As ternary conditional the same can be written like follows and is
now available in XY scripting:
variable = (condition) ? value-if-true : value-if-false;
The parentheses and the blanks are optional, so these are
identical:
variable = (condition) ? value-if-true : value-if-false;
variable = (condition)? value-if-true: value-if-false;
variable = condition?value-if-true:value-if-false;
The part "condition" has the form
"a" operator "b"
where "a" and "b" are whole strings (without any concatenators),
and "operator" can be one of the following:
== Equal
!= Not Equal
< Less than
> Greater than
<= Less than or Equal to
>= Greater than or Equal to
(none) True if expression is not 0 and not ""
The parts "value-if-true" and "value-if-false" must be whole
strings (without any concatenators).
Examples:
::$a = <date hh> >= "12"? "afternoon": "morning";
msg "Good $a!";
::$a = (<date mm-dd> == "12-24")? "": "not ";
msg "It's $a"."X-mas!";
::$a=1;$b=2;$c=3;$d=4;$e=$a==$b?$c:$d; msg $e;
Now the best part: You can employ ternary conditionals in any
argument or part of argument!
Examples:
::msg "Good ".<date hh> >= "12"? "afternoon": "morning"."!";
::msg "Good ".(<date hh> >= "12")? "afternoon": "morning"."!";
::msg "It's ".<date mm-dd> == "12-24"? "": "not"." X-mas!";
::getinfo $a, "CountSelected"; $r=$a?"$a":"no";
msg "There " . $a!=1?"are":"is" . " $r selection" .
$a!=1?"s":"" . ".";
! FVS: As a side-effect of a recent fix in v7.60.0005 the list
styles would get lost when switching between special folders
(MyComputer, Nethood) and normal folders on a fresh installation.
Fixed.
! SC download: Extension .htm was appended to all downloaded files
that were not *.htm. Stupid bug. Fixed: Now .htm is appended only
to files that are HTML but lack the extension.
::download "http://www.xyplorer.com/xyfc/viewforum.php?f=2"
= creates local copy "viewforum.php_f=2.htm" (where _ is your
replacement char for illegal characters).
+ Configuration | Color Filters: To reset textcolor or backcolor to
the default value, simply hold CTRL when you click the Text Color
resp. Back Color button.
! Monospace Fonts: Possible issues (wrong size) due to
misinterpreted number formating when user switches locale. Fixed.
Your monospace font size settings will be reset to factory
defaults due to the fix.
Code: Select all
v7.60.0008 - 2008-09-14 21:28
+ Scripting got a new command:
- Assert
Action: Interrupt processing on certain conditions.
Syntax: assert condition, [message], [continue=0]
condition: [required] any expression that evaluates
to True or False
message: [optional] message that's displayed if
condition evaluates to False
continue: [optional] set to 1 to allow continuing the
script after displaying the message; else the "Continue"
button is disabled; default is 0
Usage: This is mainly a debugging feature to interrupt
processing on certain conditions. If the condition evaluates
to True the program flow is not interrupted, otherwise you are
notified and can investigate what went wrong and decide
whether to continue and cancel (if continue=1). So, "assert"
can be very useful to keep your scripts under some control.
Apart from debugging you may use it to check (continue=1) or
enforce (continue=0) critical preconditions for your scripts
to run successfully.
Examples:
::$a="A"; assert $a=="A", '$a has wrong value!'
= no message (condition is True)
::$a="A"; assert $a=="B", '$a has wrong value!', 1
= message (condition is False)
::$a="A"; assert $a=="B", '$a has wrong value!', 0
= message (condition is False) and no option to continue
::getinfo $count, "CountSelected";
assert $count!=0,
"You must select a file before running this script!"
= if no files are selected: message
* Scripting | Step dialog: Improved coloring in the bottom list to
better distinguish spaces from nothing. Also made it wider.
! SC "download" needed extra refresh to actually display the
downloaded file if the target folder was the current one. Done.
! Scripting, ternary conditional: The following examples were not
parsed correctly for various reasons:
::msg "Good "."12" <=<date hh>? "afternoon": "morning"."!";
::?regexreplace $name, "some name [ETA: 12-2008]",
"^(.+?) \[ETA: .+$", "$1";
Fixed.
Code: Select all
v7.60.0009 - 2008-09-15 12:51
! Scripting: The ternary conditional was repeatedly processed with
unpredictable results. Fixed.
! SC "download" failed when target path/file name was passed (since
yesterday). Fixed.
+ Scripting: Now comparisons of two values are evaluated in-place.
The "comparison" has the form
"a" operator "b"
where "a" and "b" are whole strings (yet without any
concatenators, but this will change soon...), and "operator" can
be one of the following:
== Equal
!= Not Equal
< Less than
> Greater than
<= Less than or Equal to
>= Greater than or Equal to
NOTE: To prevent ambiguities with XY internal variables
(<curpath>, <xyver>...) the comparison operators must be
surrounded by blanks!
If the comparison evaluates as True it is set to "1", else it is
set to "0".
Examples:
::msg "a" == "a";
= shows '1'
::msg ("a" == "a") . ("a" == "b");
= shows '10'
::$r = ("a" == "a"); $r = ($r == 1?"True":"False"); msg $r;
= shows 'True' (note that the parentheses are optional)
::$comparison = "a == a"; assert $comparison == "a == a";
= no assertion error
::$minver="7.60.0009"; assert <xyver> >= $minver,
"This script needs at least XY $minver!"
* Scripting, ternary conditionals:
NOTE: To prevent ambiguities with XY internal variables
(<curpath>, <xyver>...) the comparison operators must be
surrounded by blanks!
* Scripting Tip: It's strongly recommended that you (double- or
single-) quote your strings because more and more characters acquire
a special meaning in scripting. The following are (or soon will be)
such special characters:
;,.?:(){}[]<>!=+-*/\"'&|$%
* Scripting | Step dialog: Now the options menu also appears on
right-clicking any of the two lists.
! Icon Overlays were not always correctly auto-refreshed in Tree and
List. Fixed.
Code: Select all
v7.60.0010 - 2008-09-15 22:08
+ Toolbar: Added button "Show Tree".
! A FVS related bug from 7.50 could still survive in corrupted INIs
and fvs.dat files. Fix #2.
* Scripting: It is not necessary anymore (but allowed) to surround
comparison operators with blanks.
However, to avoid ambiguities in parsing, you have to put XY
internal variables (<curpath>, <xyver>...) within doubled quotes
strings _IF_ they are to be interpolated!
::msg <xypath>; = okay, variable is isolated
::msg "<xypath>"; = okay, variable is isolated & quoted
::msg "XY = ".<xypath>; = okay, variable is isolated
::msg XY = <xypath>; = NOT okay, variable is interpolated
but not quoted
::msg "XY = <xypath>"; = okay, variable is interpolated &
quoted
These work all the same:
::assert <xyver>>="7.60.0009"
::assert "<xyver>">="7.60.0009"
::assert <xyver> >= "7.60.0009"
::assert "<xyver>" >= "7.60.0009"
::assert ("<xyver>" >= "7.60.0009")
! SC "text" would get confused with UNIX files (linefeed = LF) when
a line breaker was active. Fixed.
Also added support for Max files (linefeed = CR).
! Scripting: A Ternary Conditional and a Comparison could under
certain conditions be processed when inside quotes. Fixed.
Code: Select all
v7.60.0012 - 2008-09-16 15:14
+ Scripting: Now commenting at line ends is supported. Comments
begin with a double-forward slash (outside of any quotes) and end at
the end of the line.
Examples:
- $a = <xypath>; assert $a=="<xypath>"; //should not fail
- $a = <xypath>; //assign XY path
assert $a=="<xypath>"; //should not fail
- "getinfo CountSelected" // comment
getinfo $count, // comment
"CountSelected"; // comment
assert $count!=0, // comment
"You must select a file before running this script!"
+ Scripting: Now block comments (aka C-style comments) are
supported. They start with /* (outside of any quotes) and end with
the next */ (outside of any quotes) and can span any number of
lines.
Examples:
- /* This is
a multi-line
block comment
*/ msg "hi!";
- msg /*they can be inserted anywhere!*/ "hi!" /* anytime */;
Remarks on Comments
~~~~~~~~~~~~~~~~~~~
(1) Line-end and block comments overwrite each other:
::msg "Hi!"; // /*this is not a block comment starting...
::msg /* //this is not a line end comment starting... */ "Hi!";
(2) Make sure you don't nest block comments. It is easy to make
this mistake if you are trying to comment out a large block of
code:
/*
msg 'This is a test'; /* Will cause a problem */
*/
This, however, will work since // overwrites the /* */ comment:
//msg 'This is a test'; /* This comment is NO problem */
(3) Comments are not supported in Quick Scripting! This is
everywhere where no multiline scripts are possible: So they
won't work in the Address Bar, PFA, Favorites...
+ Scripting: Now you can nest expressions using parentheses, aka round
brackets: ( ). There's no practical limit to nesting depth and
superfluous parentheses are silently removed.
Examples where parentheses are merely decor:
::msg "a" . "b";
::msg ("a" . "b");
::msg ("a") . ("b");
::msg (("a") . ("b"));
::msg ((("a") . ("b")));
::msg "a" . "b" . ();
= ab
::msg "a" . ("b" . "c");
::msg ("a" . "b") . "c";
= abc
::msg "a" == "a" . "a" == "b";
::msg ("a" == "a") . ("a" == "b");
= 10
Examples where parentheses actually make a difference:
::msg "a" == "a" . "a";
::msg ("a" == "a") . "a";
= 1a
::msg "a" == ("a" . "a");
= 0
Examples for nesting errors:
::msg ("a" . "b"; // ')' missing!
= ("a" . "b"
::msg "a" . "b"); // '(' missing!
= a"b")
! Icon Overlays were not always correctly auto-refreshed in Tree and
List. Fix #2.