System object

ATTN: methods of this object are not always available to the script - they depend on feature parameters of VM creation.

Constants

IS_READONLY - int, scanFiles callback/attributes, file/dir is readonly.
IS_DIR - int, scanFiles callback/attributes, file is directory(folder).
IS_HIDDEN - int, scanFiles callback/attributes, file/dir is marked as hidden.
IS_SYSTEM - int, scanFiles callback/attributes, file/dir is marked as internal for the system.
MOBILE_OS - true for the mosciter that is running on mobile platform, false otherwise.
DESKTOP_OS - true for the sciter running on desktop PC/platform, false otherwise.
OS - symbol, on Windows it is one of these:
  • #Windows-98
  • #Windows-98-SE
  • #Windows-ME
  • #Windows-CE - Windows CE or Windows Mobile
  • #Windows-NT4
  • #Windows-2000
  • #Windows-2003
  • #Windows-XP
  • #Windows-Vista
  • #Windows-7

Methods

scanFiles

( path:string [, callback:function] ) :integer

Function calls callback function for each entry found in directory defined by the path. Path can contain wildcards like ? or *. Function returns number of entries scanned.

If callback is ommited then function just returns number of items satisfying path condition. In this form the scan can be used for testing of some file existence as an example.

Callback function shall accept two parameters:

function callback( filename: string, attributes: integer ): bool

where filename is an name of the file and attributes is an integer - OR-ed combination of IS_*** flags. Callback function shall return true if further scanning needed and false to stop enumeration.

home
([relpath:string]) returns: string

Returns home folder of the application - folder where sciter started from. If relpath is some string then it will be appended to the return value. Use this if you need to find fully qualified file name residing in sciter folder or subfolder.

path
(system-folder: symbol [,relpath:string]) returns: string

Returns path of one of the system folders. system-folder here is one of:

  • #SYSTEM
  • #SYSTEM_BIN
  • #PROGRAM_FILES
  • #USER_APPDATA
  • #COMMON_APPDATA
  • #USER_DOCUMENTS
  • #COMMON_DOCUMENTS

Prperties

language The abbreviated name of the language, ISO Standard 639 names.
country Country/region name, based on ISO Standard 3166.