Professional Documents
Culture Documents
2
_________________________
‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
***Please enable word wrap when viewing this document***
Major Changes in Latest Versions
================================
Only the most significant feature changes are listed under this topic. Some vers
ion updates may include more comprehensive details under the next main topic sec
tion.
Clip-code additions:
--------------------
^$GetCodePage$
Returns the default Windows ANSI Code page.
^$GetDocCodePage$
Returns the Code page of the active document.
^$GetDocCodePage(Index)$
Returns the Code page of the specified document.
Clip Language:
.............
* Added ^!SetCode command for assigning values to a variable without interpretin
g ^?{} prompts and Clip tokens like ^P, ^T, ^&, ^#, etc. Variables and functions
are evaluated normally.
^!SetCode %VariableName%=Value
* Added ^!InsertCode command for inserting values into the current document with
out interpreting ^?{} prompts and Clip tokens like ^P, ^T, ^&, ^#, etc. Variable
s and functions are evaluated normally. This command is very useful when treatin
g UUEncoded text, which may contain character sequences that imitate such tokens
.
^!InsertCode Text
* Added ^$StrROT13("Text")$ function to perform a ROT13 operation on the specifi
ed text.
* Added ^$StrEncrypt("Text";[Key])$ and ^$StrDecrypt("Text";[Key])$ functions, w
hich provide stronger text encryption than ROT13. Use the optional "Key" paramet
er to define an encryption password (max. 255 characters). Make sure you don't f
orget the key you used with this function, otherwise you may never be able to re
trieve your encrypted text. Note that although the encryption algorithm is very
good, there is no guarantee that it can't be cracked. You should not rely on thi
s feature to protect very sensitive data. Example:
^$StrEncrypt("^$GetSelection$";"^?[key=My secret password]")$
* Added Clip functions ^$GetCrcText("Text")$ and ^$GetCrcFile("Filename")$. Use
these to calculate the CRC32 (cyclic redundancy check) of text and files respect
ively. Example:
^$GetCrcFile(^$GetAppFileName$)$
* Added Clip functions ^$GetMD5Text("Text")$ and ^$GetMD5File("Filename")$. Use
these to calculate the MD5 signature of text and files respectively. The result
is produced in hexadecimal format. MD5 is a hashing algorithm that generates a d
igital signature, or Message Digest, representing the supplied data. The MD5 alg
orithm was produced by RSA Data Security Inc. Example:
^$GetMD5File(^$GetAppFileName$)$
* Added ^$StrUUEncode("Text")$ and ^$StrUUDecode("Text")$ functions, to encode t
ext to 7-bit UUEncode format and decode it back respectively. This encoding form
at is frequently used to send 8-bit data through transmission media (email, for
example) supporting only 7-bit data. These new Clip functions are useful if you
want to send encrypted text by email. Example:
^$StrUUEncode("^$StrEncrypt("^$GetText$";)$")$
^$StrDecrypt("^$StrUUDecode("^$GetText$";)$")$
Important note: UUencoded text may contain characters that the Clip parser inter
prets as tokens, like ^p and ^&. As a result, you should use the ^!SetCode comma
nd to assign such data to a variable and ^!InsertCode to paste the result of ^$S
trUUEncode("Text")$ into a document. See the example in the Utilities library.
* Added UUEncode and UUDecode Clip commands:
^!UUEncode "InputName"[ "OutputName"]
InputName is the file to encode. Use the optional OutputName to define the name
of the UUEncoded data file. If you don't specify an output name, the name will b
e based on InputName with the extension ".uue".
^!UUDecode "InputName"[ "OutputName"]
InputName is the file to decode. Use the optional OutputName to define the name
of the UUEncoded data file. If you don't specify an output name, the name stored
in the encoded file will be used.
* Added encryption/decryption command for files:
^!FileScramble "InputName"[ "OutputName"[ "Key"]]
This command can automatically detect if the file needs encrypting or decrypting
. InputName is the file to encrypt or decrypt. Use the optional OutputName to de
fine the name of the file created by the operation. If the file is going to be e
ncrypted and you don't specify an output name, the name will be based on InputNa
me with the extension ".npw". If the file is going to be decrypted and you don't
specify an output name, the original file name will be used. Use the optional "
Key" parameter to define an encryption password (max. 255 characters). Make sure
you don't forget your password, or you will not be able to restore your encrypt
ed data.
The encryption algorithm is based on RC4 ("RC4" is a trademark of RSA security c
orporation). You should not rely on this feature to protect very sensitive data.
* Added ^$ChangeFileExt("FileName";"Ext")$
Use this function to create a new file name based on the provided extension. Exa
mple:
^$ChangeFileExt("c:\config.sys";"bak")$ = c:\config.bak
* Added ^$StrRandom(Size)$ to create strings of random characters of the specifi
ed length. Example:
^$StrRandom(6)$ = È$q3åî
* The ^$GetDocIndex(Name)$ now returns the index number of the specified documen
t, as indicated in the Help file.
* Improved ^$HexToInt(Value)$ and ^$IntToHex(Value)$ to handle larger values.
* Fixed ^!MoveFile command "losing" files when the destination folder does not e
xist.
* Fixed last character of parameter being truncated by ^!Shell command.
Clip Language:
.............
* Added Clip function ^$StrToHtml("Str"[;ConvertLineBreaks[;ConvertEntities]])$,
to convert plain text to HTML format. "Str" represents the text you want to con
vert. Use False for ConvertEntities if you don't want special characters (e.g. ©)
to be converted to HTML entities (e.g. ©); the default value when omitted i
s True. Use False for ConvertLineBreaks if you don't want <p> and <br> tags to b
e inserted at line breaks in the text; the default value when omitted is True.
* Changed the behavior of the ^$GetFiles([+]FilePath;FileSpecs[;Attr][;SortingOr
der])$ and ^$GetFileFirst([+]FilePath;FileSpecs[;Attr][;SortingOrder])$ Clip fun
ctions. When the Attr field is used, only files that use the specified attribute
s are selected. To select files that have no attribute settings, use "-" as a va
lue for Attr. You can also span through subdirectories by adding a + sign in fro
nt of the FilePath criteria. The following example will select all files under W
indows and its subdirectories, that have the System attribute set:
^$GetFiles("+C:\Windows";*.*;S;Name)$
* The registry-related Clip functions and commands (GetRegValue, SaveRegValue, C
learRegValue) look for a colon (:) as the delimiter between the key and name par
ts. Unfortunately, there are situations where a colon character needs to be used
in the name part, and this causes malformed key and name values. In this situat
ion, you can now use a double colon (::) to indicate where the name value starts
.
* Fixed a bug in the ^$GetValue(...)$ function, which removed quotes surrounding
values.
* Fixed problems in the ^!Find and ^!Replace Clip commands when used with the Re
gular Expression option.
* Fixed quote problem with ^!Open command: ^!Open "^?{(T=O;S=M)Browse to file(s)
to open}"
* Fixed a problem with the GetRelativeName Clip function when only the FileName
parameter is specified and quotes are used around it.
* NoteTab Light/Std: fixed ^!SelectTo, which can now be used to select text back
wards.
Clip Language:
.............
* New Clip functions:
^!Shell
Launches the specified file, program, or URL through the Windows shell. Proposed
as a replacement for the default ^! launch method. Example: instead of using "^
!WordPad c:\autoexec.bat", use "^!Shell WordPad c:\autoexec.bat"
^!ShellWait
Similar to the ^!Shell command, but waits until the launched program is terminat
ed before moving to the next Clip instruction. Unlike the ^!Wait command, you ca
n continue editing files in NoteTab while the application is running. Example:
^!ShellWait WordPad c:\autoexec.bat
^$StrDeleteLeft("Str";Amount)$
Similar to ^$StrDelete()$ but deletes the text from the start of the specified s
tring.
^$StrDeleteRight("Str";Amount)$
Similar to ^$StrDelete()$ but deletes the text from the end of the specified str
ing.
^$StrCopyLeft("Str";Amount)$
Similar to ^$StrCopy()$ but copies the substring from the start of the specified
string.
^$IsWildcard("FileName")$
Returns 1 if FileName contains one or more wildcard characters (* and ?), and 0
if it does not.
^$GetSysProgPath$
Returns the path containing system programs like MS-Notepad and FTP.exe.
^$StrStripHTML("Str";PreserveURLs)$
Returns a copy of Str with all HTML tags removed. PreserveURLs is either True or
False, and determines if URLs are preserved or not.
^!TextToUnicodeFile "FileName" AnyText
Saves the specified text to FileName in the Unicode format using the current Win
dows code page.
^!AppendTextToUnicodeFile "FileName" AnyText
Appends the specified text to the end of a disk file in Unicode format using the
current Windows code page. A new file is created if FileName does not exist.
^$GetUnicodeFileText("FileName")$
Reads Unicode text from FileName and returns it as normal text based on the curr
ent Windows code page.
* Clips with multiple "^&" are better handled.
* Fixed incorrect behavior when pasting Clip text beginning with a line break wh
en the "Indent on Paste" option is set. Now indents a whole selection when place
holder is also indented. Example:
^!InsertHtml <p>^P ^&^P</p>
Applied on the following three lines:
Line1
Line2
Line3
will now indent all the lines in the selection, instead of just the first one.
<p>
Line1
Line2
Line3
</p>
* Clip shell commands did not respect the ^!ChDir setting. Fixed.
* ^$GetWord$, ^$GetBlock$, and ^$GetQuoteBlock$ now return the whole item even w
hen it is wrapped.
* Fixed a bug that caused the ^%AR_KEY% to always return an empty value.
* Fixed problem with ^!SetScreenUpdate not working within sub-Clips (those run w
ith the ^!Clip command).
* Fixed ^$GetColScreen$ when text is selected.
* Fixed ^!MoveFile which caused target directory file to end up in recycle bin i
f original did not exist.
* Fixed ^!SetFocus Frame1
Clip Language:
--------------
^!SetHtmlFormat [UPPERCASE|LOWERCASE|XHTML]
Sets the default format of HTML tags created by the ^!InsertHtml and ^!InsertWiz
ardHtml, as well as other related HTML commands.
^$GetHtmlFormat$
Returns the default format used for creating HTML tags. Possible values are: Upp
ercase, Lowercase, XHTML.
^$GetClipVersion$
Since version 4.801, this function returns the actual NoteTab release version as
an integer. For example, in version 4.801, ^$GetClipVersion$ returns 4801.
* Fixed Clip command ^!AppendToFile so that it accepts text ending with blank li
nes.
* Custom Clip function names can now be shorter than 5 characters.
Clipbar:
--------
* Added support for user-made toolbars, called Clipbars. You can open available
Clipbars and create new ones through the "View|Clipbar" submenu commands. Quick
instructions to add buttons to a Clipbar:
+ Open a new Clipbar or an existing one.
+ Open the Clipbook window (F4) and select the library that contains the Clips y
ou want to use from the Clipbar.
+ The setting "Single Click to Paste" on the Clipbook tab in the Options box mus
t be unchecked.
+ Click on the desired Clip label in the Clipbook window and drag it to the Clip
bar. The button is added once you release the mouse button. You can reorder Clip
bar buttons by holding the Shift key down and dragging them to the new position.
+ To change the button icon, click on it with the right mouse button to open the
context menu and choose the "Button Properties" command. Choose a new icon from
the list in the dialog box. You can either use the internal NoteTab icons, or y
our own custom icons. Your icons should be placed in the NoteTab Libraries folde
r. Accepted image formats are bitmaps (.bmp) and icons (.ico). Recommended maxim
um image size is 18x18 pixels. Larger images are shrunk to fit in the allocated
space and may look distorted. The icon transparency color is determined by the p
ixel color at the bottom-left corner of the image.
+ A Clipbar can contain Clips from any library as long as they remain available
in the Libraries directory. Note that the Clipbar reads the Clips from disk only
. If you have edited a Clip in NoteTab and want to test it from the Clipbar, you
will first have to save your library to disk.
+ To save the changes made to the Clipbar, click on it with the right mouse butt
on to open the context menu and choose the "Save Clipbar" command. When the Clip
bar is saved, the settings are stored in the Libraries directory in a text file
with the .ctb extension. You can edit it manually by choosing the "Edit Clipbar"
command from the context menu.
IMPORTANT: Currently, the Clipbar cannot handle Clips that use the ^$GetClipText
(ClipName)$ function and user-made functions.
* The Clipbar supports the OnOpen and OnClose events. Just drag an OnOpen or OnC
lose Clip to it. The OnOpen event is triggered when a Clipbar is first opened, a
nd when switching to another library. The OnClose event is triggered when switch
ing to another library or starting a new one, and when closing NoteTab. The trig
gering of these events can be canceled by holding down the Shift key.
* Added command-line parameter to open a specific Clipbar when launching NoteTab
:
NoteTab /C=ClipbarName
Clip Language:
--------------
* Simple text Clips use the "^&" code to determine where selected text should be
placed when pasting the Clip contents. If no text is selected, then it marks th
e position where the cursor should be placed. In NoteTab 4.6 and older, this met
hod did not work in executable Clips. This issue has been addressed in version 4
.8. See the HTML library for an example of this new functionality.
* You can now apply Clips on text that contains Clip code, without causing it to
be interpreted by the Clip parser. Unfortunately, there is a small price to pay
for this improvement. The following old function formats for dates: ^[mm/dd/yyy
y^] and mathematical evaluation: ^$[Expression] will not work if their arguments
are built from the values of variables and functions. Instead of those old func
tion formats, you should use the more recent ^$GetDate(mm/dd/yyyy)$ and ^$Calc(E
xpression[;Decimals])$ functions.
* Conditional commands now accept a command statement instead of a label. The se
cond command statement may not be another conditional command, and it may not be
followed by an ELSE-type label. Examples:
^!If ^%Variable% < 0 ^!Set %Variable%=0
^!IfFileExist "^%Variable%" GoToLabelTrue ELSE ^!Prompt File does not exist
* You can now create your own Clip functions, using an approach that is similar
to the ^!Clip command. Custom Clip functions must not have the same name as a pr
e-defined function. The function name corresponds to the name of the Clip that c
ontains the code. You can create functions that take one parameter or none. You
can access the parameter data in your function script by using the ^& code. Your
function script must assign the result to the new ^!Result command, or by using
the new pre-defined variable %RESULT%. Example:
H="Double"
^!IfTrue ^$IsNumber("^&")$ Multiply
^!Result ^&^&
^!Goto End
:Multiply
^!Result ^$Calc(^& * 2)$
H="TestDouble"
^!Prompt ^$Double(^?[Enter a number or some text])$
HTML Editing
¨¨¨¨¨¨¨¨¨¨¨¨
^!InsertHtml Any text with tokens (^p/^t)
Similar to ^!InsertText command, but converts HTML tags to Uppercase, Lowercase,
or XHTML format (depending on settings in Options). This command is sensitive
to the "Indent on Paste" setting in the Options dialog box on the Clipbook tab.
You can precede it with the command "^!SetPasteIndent Off" to make it ignore the
indent setting.
^!InsertWizardHtml Any text with tokens (^p/^t)
Similar to ^!InsertHtml command, but removes attributes that have no value. This
command is useful when used together with the Clip wizard. It allows the user t
o leave certain fields blank in the Wizard, and the corresponding tags are then
automatically removed before being inserted in the document. Example:
^!InsertWizardHtml <TD ALIGN="" WIDTH="">
will insert the following tag in your document: <TD>
^!RunTidy [i|d]
^!RunTidy [Switches]
HTML Tidy is a free utility that cleans HTML code and fixes errors. This new Cli
p command will send your document text to the HTML Tidy program. The corrected o
utput returned by HTML Tidy is then inserted into the document. The StdError str
eam is saved in a file called "StdError.err" in NoteTab's application directory,
unless another file is specified with the SetStdError Name command. You can use
the optional parameter "Switches" to specify Tidy command-line arguments; examp
le:
^!RunTidy -f errs.txt -qiu
If no argument is specified and you have a Tidy.cfg file in the NoteTab folder,
then HTML Tidy will be configured according to the settings in that configuratio
n file. If NoteTab does not find the configuration file, it will determine the a
ppropriate switches based on the settings in NoteTab. If you have a Tidy.cfg fil
e, but you want NoteTab to ignore it and use default settings, then use the "d"
argument (without the quotes). If you want NoteTab to determine the best setting
s, but would like to have your tags indented, just use the "i" argument; example
:
^!RunTidy i
You can learn more about HTML Tidy and download the latest version by visiting t
he following Web page:
http://www.w3.org/People/Raggett/tidy/
The easiest setup is to install the Tidy.exe program file in the NoteTab folder,
but you may place it anywhere else if you prefer.
^$GetTidyExe$
Returns full path and name of HTML Tidy application.
^$GetHtmlTagName("TagStr"[;Format])$
Returns the name of the HTML Tag, either in uppercase or lowercase. If the Forma
t parameter is not specified, the character case is determined by the settings i
n NoteTab's Options. Use the Format parameter to control the format of HTML tags
. It can have one of the following values: UPPERCASE, LOWERCASE, or XHTML. Examp
le:
^$GetHtmlTagName("<TD ALIGN="left" WIDTH="250">";LOWERCASE)$ -> td
^$GetHtmlTagAttr("TagStr";Attr[;Format])$
Returns the value of the specified HTML attribute. If the Format parameter is no
t specified, the result is determined by the settings in NoteTab's Options. Use
the Format parameter to control the case of minimized attributes (it has no effe
ct on the value returned for normal attributes). It can have one of the followin
g values: UPPERCASE, LOWERCASE, or XHTML. Example:
^$GetHtmlTagAttr("<DL COMPACT>;Compact;XHTML)$ -> compact
^$GetHtmlTagAttr("<DL COMPACT>;Compact;UPPERCASE)$ -> COMPACT
^$GetHtmlTagAttr("<TD ALIGN="left" WIDTH="250">";Width)$ -> 250
^$GetHtmlTagTidy("TagStr"[;Format])$
Returns a properly formatted HTML tag converted to uppercase, lowercase, or XHTM
L format. If the Format parameter is not specified, the result is determined by
the settings in NoteTab's Options. Use the Format parameter to control the forma
t of HTML tags. It can have one of the following values: UPPERCASE, LOWERCASE, o
r XHTML. Example:
^$GetHtmlTagTidy("<HR SIZE=2 NOSHADE>";XHTML)$ -> <hr size="2" noshade="noshade"
/>
^$GetHtmlTextTidy("Str"[;Format])$
Returns the string with HTML tags converted to Uppercase, Lowercase, or XHTML fo
rmat. If the Format parameter is not specified, the result is determined by the
settings in NoteTab's Options. Use the Format parameter to control the format of
HTML tags. It can have one of the following values: UPPERCASE, LOWERCASE, or XH
TML.
TopStyle
¨¨¨¨¨¨¨¨
NoteTab now supports Bradsoft's TopStyle CSS editor, version 1.51 and above -- a
program for editing Cascading Style Sheets. You can learn more about this usefu
l program and download the latest version by visiting the following Web page:
http://www.bradsoft.com/redir.asp?id=130
Note that the TopStyle commands described below are used in the TopStyle library
packaged with NoteTab. There is also a convenient TopStyle Clipbar to access th
e Clip commands.
^$IsTopStyleEnabled$
Returns 1 if the TopStyle editor is available through NoteTab, and 0 if it is no
t.
^$EditStyleBlock("Str")$
Opens TopStyle in <style>..</style> block editing mode. Returns the updated styl
e block. Note that the "Str" argument should not include the surrounding <style>
..</style> tags.
^$EditStyleAttr("Str")$
Opens TopStyle in inline (STYLE attribute) editing mode. Returns the updated sty
le. Note that the contents of the style attribute should only include the value
assigned to the style attribute. For example, if you wish to edit the style attr
ibute in the tag <span style="color:blue">, then you should only pass color:blue
to this function.
^!EditStyleSheet [FileName]
Opens the specified style sheet file in TopStyle. If no file name is specified,
this command will launch TopStyle without opening a specific style sheet. Note t
hat unlike the EditStyleBlock and EditStyleAttr functions, which block the calli
ng application until the user closes TopStyle, EditStyleSheet simply executes To
pStyle and returns immediately.
Application
¨¨¨¨¨¨¨¨¨¨¨
^$GetAppFileName$
Returns the file and path name of the NoteTab program file. Example, with defaul
t folder for NoteTab Pro:
^$GetAppFileName$ -> C:\Program Files\NoteTab Pro\NotePro.exe
^!DirectPrint "Title" Data
Prints text directly to the printer, bypassing NoteTab's print procedure. Uses d
efault printer settings. Title is the text shown in the Print manager and Data i
s the text to send directly to the printer. Data can contain printer control cod
es.
^!SetFocus [Clipbook|ClipEdit|Document|Frame1|Frame2|List_Clip|List_Disk|List_Do
cs|List_Favs|Outline|PasteBoard]
Moves the focus to the specified screen object. This command will fail if the No
teTab window is minimized. Example to move the focus to the Outline-headings win
dow:
^!SetFocus Outline
Keyboard
¨¨¨¨¨¨¨¨
^$IsCtrlKeyDown$
Returns 1 if the Control key is pressed while the function is executed and 0 if
it is not.
^$IsShiftKeyDown$
Returns 1 if the Shift key is pressed while the function is executed and 0 if it
is not.
^$IsAltKeyDown$
Returns 1 if the Alt key is pressed while the function is executed and 0 if it i
s not.
Clip Code
¨¨¨¨¨¨¨¨¨
^!SetDebug [On|Off]
When enabled, a dialog box pops up just before each statement and paste operatio
n is executed. The dialog box shows the parsed instruction or the text about to
be pasted in the document. There are three buttons; "Yes" is for continuing exec
ution until the next instruction, "No" disables Debug mode, and "Cancel" ends Cl
ip execution.
^!SetPasteIndent [On|Off]
Enables or disables automatic indenting when a Clip inserts text into a document
. The scope of this command is limited to the Clip (and eventual sub-Clips) wher
e it was invoked. When a Clip ends, the original user setting is automatically r
e-enabled.
^$IsPasteIndent$
Returns 1 if Clips insert text with automatic indenting and 0 if not.
^!DestroyLibrary [LibraryName]
Deletes the specified Clipbook library (path name and extension are not needed).
If the optional LibraryName argument is not used, then the library currently ru
nning the Clip is closed and destroyed.
^!InsertText Any text with tokens (^p/^t)
Since version 4.8, this command is sensitive to the "Indent on Paste" setting in
the Options dialog box on the Clipbook tab. You can precede it with the command
"^!SetPasteIndent Off" to make it ignore the indent setting.
Clipbar
¨¨¨¨¨¨¨
^!OpenClipbar Name
Opens the specified Clipbar file.
^!CloseClipbar
Closes the current Clipbar.
^!ReloadClipbar
Reloads the current Clipbar.
^$GetClipbarName$
Returns the name of the current Clipbar file.
Files
¨¨¨¨¨
^$GetFileFirst(FilePath;FileSpecs[;Attr][;SortingOrder])$
Added optional Attr parameter. Attr can represent multiple values: A = Archive,
H = Hidden, R = Read-only, S = System, * = All attributes. If the Attr parameter
is not used, then file attributes are ignored.
^$GetFiles(FilePath;FileSpecs[;Attr][;SortingOrder])$
The parameters are identical to the ^$GetFileFirst$ function. Returns all matchi
ng files as a single string using the default separator (;), or the one defined
by ^!SetListDelimiter. Note that ^$GetFileNext$ and ^!CloseFileFind do not work
with this function. This new function is useful to assign the result to an array
variable. Example:
^!SetArray %Files%=^$GetFiles("c:\Program Files\NoteTab Pro\Documents";*.txt;AR;
DATE)$
^!SetFileAttr "FileSpecs" Attr
Changes the file attributes. FileSpecs is the file name, which may have wild car
ds. Attr can represent multiple values: A = Archive, H = Hidden, R = Read-only,
S = System, * = All attributes. Use a minus sign in front of the letter to remov
e an attribute. The following example sets the Archive attribute and removes the
Read-only attribute, if set:
^!SetFileAttr "c:\Scandisk.log" A-R
^!IfFileAttr "FileName" Attr GoToLabelTrue [ELSE GoToLabelFalse]
Compares FileName attributes with Attr. If Attr is equal or a subset of FileName
's attributes, then GoToLabelTrue is activated. Attr can represent multiple valu
es: A = Archive, D = Directory, H = Hidden, R = Read-only, S = System, V = Volum
eID, * = All attributes. Example:
^!IfFileAttr "c:\Scandisk.log" AH LabelTrue ELSE LabelFalse
If Scandisk.log has at least the Archive and Hidden attributes set, then the ins
truction jumps to LabelTrue.
^$GetFileAttr(FileName)$
Returns the file attributes as a string of characters. A file can have zero, one
, or several attributes. The string may contain the following characters: A = Ar
chive, D = Directory, H = Hidden, R = Read-only, S = System, V = VolumeID, * = A
ll attributes. Example:
^$GetFileAttr(c:\Scandisk.log)$ -> AH
^$GetRelativeName(FileName;BaseDir)$
Returns the relative name of FileName against BaseDir. If BaseDir is not defined
, the active document path is used as the reference directory. Example:
^$GetRelativeName(c:\temp\test\MyFile.txt;c:\temp\)$ -> test\MyFile.txt
^$GetExpandedName(FileName;BaseDir)$
Returns the fully qualified name of FileName against BaseDir. If BaseDir is not
defined, the active document path is used as the reference directory. Example:
^$GetExpandedName(..\MyFile.txt;c:\temp\test\)$ -> c:\temp\MyFile.txt
^$FileToUrl("FileName")$
Converts a Windows file name to a URL file name. Example:
^$FileToUrl("c:\program files\index.htm")$ -> file:///c|/program%20files/index.h
tm
^$UrlToFile("URL")$
Converts a URL file name to a Windows file name. Example:
^$UrlToFile("file:///c|/program%20files/index.htm")$ -> c:\program files\index.h
tm
* The following procedures will now also work with files in the form of URLs
^$GetName(FileName)$
^$GetFileName(FileName)$
^$GetPath(FileName)$
Text Processing
¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
^!IfMatch "RegEx" "Value2" GoToLabelTrue [ELSE GoToLabelFalse]
Similar to ^!IfSame, but accepts a regular expression for the first value.
^$StrAnsiToAscii("Str")$
Returns Str with all extended ANSI characters converted to ASCII.
^$StrAsciiToAnsi("Str")$
Returns Str with all extended ASCII characters converted to ANSI.
^$IsLowercase("Str")$
Returns 1 if Str does not contain any uppercase characters, and 0 if it does.
^$IsUppercase("Str")$
Returns 1 if Str does not contain any lowercase characters, and 0 if it does.
^$IsCapitalized("Str")$
Returns 1 if Str does not start with a lowercase character and is not followed b
y any uppercase characters, and 0 if this condition is not met.
^$IsMixedCase("Str")$
Returns 1 if Str contains both lowercase and uppercase characters, and 0 if it d
oes not.
^$IsAlpha("Str")$
Returns 1 if Str contains only characters from the alphabet, and 0 if it does no
t.
^$IsAlphaNumeric("Str")$
Returns 1 if Str contains only numbers and characters from the alphabet, and 0 i
f it does not.
^$IsBlank("Str")$
Returns 1 if Str contains only blank characters (tabs, spacebar, line breaks, et
c.), and 0 if it does not.
^$StrCapitalize("Str")$
Capitalizes all words in Str and returns the resulting string.
^$StrInvertCase("Str")$
Converts all uppercase characters to lowercase, and lowercase characters to uppe
rcase, and returns the resulting string.
^$StrSentenceCase("Str")$
Capitalizes all words following a period, exclamation, and question mark and con
verts all other words to lowercase.
^$CharToDec(Character)$
Returns the decimal value of Character. Example:
^$CharToDec(S)$ -> 83
^$DecToChar(Decimal)$
Returns the character corresponding to the decimal value. Example:
^$DecToChar(83)$ -> S
Note that you should avoid converting the following decimal values 1, 4, 5, and
6 to characters as they have a special meaning for the Clip interpreter.
^$IntToHex(Char)$
Now also returns the ANSI hex code of single character if Char does not represen
t a number.
Windows
¨¨¨¨¨¨¨
^$GetSpecialPath(TypeFolder)$
Returns the path name of the specified Windows folder. TypeFolder can have one o
f the following values:
AppFolder
Desktop
DesktopDir
StartMenu
Programs
Startup
SendTo
Favorites
Recent
CommonDesktopDir
CommonStartMenu
CommonPrograms
CommonStartup
CommonFavorites
^!MakeShortcut ShortcutLocation "Target" ["Arguments"] ["Description"] [CmdShow]
Creates Windows shortcuts. Syntax:
- ShortcutLocation is the place where the shortcut is created. It accepts the sa
me values as the TypeFolder argument used in the ^$GetSpecialPath(TypeFolder)$ f
unction.
- "Target" is the program to execute, or the document to launch.
- "Arguments" are eventual command-line switches you might want to use with the
target program.
- "Description" is an optional parameter you can use to identify the shortcut. I
f it is left blank, the shortcut name will be the same as the target program nam
e.
- CmdShow defines how the program is opened. It can have one of the following va
lues:
Normal (default if no value specified)
Maximized
Minimized
Example:
^!MakeShortcut SendTo "^$GetAppFileName$" "" "Open in NoteTab" MAXIMIZED
Registry:
¨¨¨¨¨¨¨¨¨
^!SaveRegValue [BaseRoot\]Key[:Name]=Value
Saves the specified value under the key entry in the Windows Registry. If BaseRo
ot is not defined, then HKEY_CURRENT_USER is used. If no value is specified for
Name, the "(Default)" name is used. The maximum amount of text that can be saved
this way is 1024 characters. Use with care! Example:
^!SaveRegValue HKEY_CURRENT_USER\Software\Beta:UserName=Raymond
^!SaveRegValue Control Panel\International:sDate=/
^!SaveRegValue HKEY_CLASSES_ROOT\.386=vxdfile
^$GetRegValue("[BaseRoot\]Key[:Name]")$
Returns the value stored under the specified key in the Windows Registry. If Bas
eRoot is not defined, then HKEY_CURRENT_USER is used. If no value is specified f
or Name, the "(Default)" name is used. Returns an empty string if the key does n
ot exist. Example based on ^!SaveRegValue example:
^$GetRegValue(HKEY_CURRENT_USER\Software\Beta:UserName)$ -> Raymond
^$GetRegValue(Control Panel\International:sDate)$ -> /
^$GetRegValue(HKEY_CLASSES_ROOT\.386)$ -> vxdfile
^!ClearRegValue [BaseRoot\]Key[:Name]
Deletes the specified name or key in the Windows Registry. If BaseRoot is not de
fined, then HKEY_CURRENT_USER is used. If a Name is specified, then only that na
me will be deleted from the Registry. If no Name is specified (no colon), then t
he key and all Names under it will be deleted. Use with care!
BaseRoot can be any of the following values:
HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
Bug fixes:
----------
* Made changes to the code underlying the Clip commands ^!RunPerl, ^!RunGawk, ^!
RunScript, as well as the functions ^$GetOutput("Command")$, ^$GetInputOutput("C
ommand")$, ^$GetDosOutput("Command")$. These should run better under all version
s of Win32, and especially Windows NT.
* Selecting text containing the characters "^&" (without quotes) in a document a
nd running a Clip using the "^&" code no longer causes NoteTab to freeze.
* Fixed several problems in the spell-checker.
* Fixed access violation error when second document window was closed.
* Fixed regex bug when used with Count Occurrences and Replace All.
* Fixed NoteTab Pro bug that caused file truncation when a paragraph exceeded a
length of 65,500 characters.
* Fixed a glitch in NoteTab Pro when printing text with tabs.
* Blank lines at end of text are now ignored when printing.
* Hyperlinks using the format [test.html#anchor] are now correctly converted fro
m OTL to HTML.
* The Clip command ^!Find no longer attempts to translate NoteTab tokens (^P, ^T
, etc.) when a regular expression is specified.
* Can now run NoteTab from copy-protected disks.
______________________________________________________________________________
NoteTab is a registered trademark licensed to Fookes Software Ltd, Switzerland
Copyright © 1995-2010, Fookes Holding Ltd, Switzerland
- All Rights Reserved -
Fookes is a registered trademark of Fookes Holding Ltd.
Windows is a trademark of Microsoft Corporation registered in the U.S. and other
countries.
All other trademarks and service marks, both marked and not marked, are the prop
erty of their respective owners.