Click Expression Reference

The following is a list of the expressions that are used in the various Click programs.

Note: this list only includes expressions for the default system objects and the Expression Editor dialog; extensions' expressions are not listed here. Some of these expressions may only be available in newer builds of specified programs. Expression names are not case-sensitive.

Special Object

Expression	Description	Availability
Random( int )	Generates a random integer from 0 to (n - 1). Max n is 65535.	(put icons here someday)
[Name of Global Value]	Returns the value of a given Global Value.
[Name of Global String]	Returns the text of a given Global String.
Appdrive$	Returns the drive letter the application is found on.
Appdir$	Returns thee path where the application can be found, minus the drive letter.
Apppath$	Same as Appdrive$ + Appdir$.
AppTempPath$	Returns the path of the temporary folder where the application is extracted during runtime.
Appname$	Returns the name of the executable, minus ".exe".
BinFileTempName$( path )	Returns the name of the last extracted binary file.
Str$( number )	Converts a number into a string.
FloatToString$( float, total_digits, digits_after_point )	Converts a float into a string, with some formatting options.
Int( float )	Converts a float into an integer (anything after the decimal point is lost)
Round( float )	Rounds a float up if the decimal is >= .5, or down otherwise. The resulting number is still a float.
Hex$( integer )	Converts an integer to a hex string in the form 0xNNNNNNNN. The resulting hex string past the '0x' may be up to 8 characters, but can be less.
Bin$( integer )	Converts an integer to a binary string in the form 0bNNNNNNNN. The resulting binary string past the '0b' may be up to 32 characters, but can be less.
abs( number )	Returns the absolute value of a number (removes the negative sign in present).
ceil( float )	Forces a float to round to the nearest number larger than it. The result is still a float. (Ex: 3.2 -> 4.0; -3.2 -> -3.0)
ceil( float )	Forces a float to round to the nearest number smaller than it. The result is still a float. (Ex: 4.8 -> 4.0; -4.8 -> -5.0)
sqr( number )	Returns the square root of a number.
log( number )	Returns the base-10 log of a number.
ln( number )	Returns the natural log (base-e) of a number.
exp( number )	Returns e to the power of a number.
min( number1, number2 )	Returns the smaller of the two numbers.
max( number1, number2 )	Returns the larger of the two numbers.
sin( angle )	Returns the sine of the angle (in degrees).
cos( angle )	Returns the cosine of the angle (in degrees).
tan( angle )	Returns the tangent of the angle (in degrees).
asin( angle )	Returns the arcsine of the angle (in degrees).
acos( angle )	Returns the arccosine of the angle (in degrees).
atan( angle )	Returns the arctangent of the angle (in degrees).
atan2( y_delta, x_delta )	Returns the angle between two points (in degrees).
not( integer )	Performs and returns a bitwise Not on an integer.
left$( string, length )	Returns the left portion of string with a given length.
right$( string, length )	Returns the right portion of string with a given length.
mid$( string, start, length )	Returns the middle portion of string starting at a 0-based position and with a given length.
len( string )	Returns an integer representing the length of a string; the empty string "" is 0.
newline$	Causes following text to display on another line.
lower$( string )	Converts all characters in a string to lowercase.
upper$( string )	Converts all characters in a string to UPPERCASE.
find( string, pattern, startnum )	Returns an integer representing the 0-based location of the first character of the first occurence of pattern in string, starting at location startnum. If pattern is not found, -1 is returned.
reversefind( string, pattern, startnum )	Same as find(), but searches for pattern by starting at the end of string.
ndropped	Returns the number of files dropped into application window.
dropped$( integer )	Returns the path of a dropped file, referenced by an integer.
commandline$( string )	Returns the command line used to launch the application.
getcommanditem$( string )	Returns the string from a provided command item switch. If the switch has no associated string, "Empty" is returned; if the switch is not found at all, "" is returned.
getrgb( red, green, blue )	Converts an RGB value to MMF's color format integer. Same as: red + green * 256 + blue * 65536
getred( string )	Returns the red value from MMF's color format.
getgreen( string )	Returns the green value from MMF's color format.
getblue( string )	Returns the blue value from MMF's color format.
cliptext$	Returns the text currently in the clipboard.
loopindex( loopname )	Returns the current 0-based index of loopname.