ScriptForge.Platform service

The Platform service provides a collection of properties about the current execution environment and context, such as:

note

All properties of the Platform service are read-only.


Invocació del servei

Abans d'utilitzar el servei Platform, cal carregar o importar la biblioteca ScriptForge:

note

• Basic macros require to load ScriptForge library using the following statement:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Python scripts require an import from scriptforge module:
from scriptforge import CreateScriptService


The examples below in Basic and Python instantiate the Platform service and access the Architecture property.

In Basic

      GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
      Dim platform As Variant
      platform = CreateScriptService("Platform")
      MsgBox platform.Architecture
    
In Python

      from scriptforge import CreateScriptService
      svc = CreateScriptService("Platform")
      bas = CreateScriptService("Basic")
      bas.MsgBox(svc.Architecture)
    

Propietats

Nom

Només de lectura

Tipus

Descripció

Architecture

String

The hardware bit architecture. Example: '32bit' or '64bit'

ComputerName

String

El nom que l'ordinador utilitza a les xarxes.

CPUCount

Integer

The number of central processing units.

CurrentUser

String

The name of the currently logged user.

Extensions

Matriu de cadenes

Returns a zero-based array of strings containing the internal IDs of all installed extensions.

FilterNames

Matriu de cadenes

Returns a zero-based unsorted array of strings containing the available document import and export filter names.

Fonts

Matriu de cadenes

Returns a zero-based array of strings containing the names of all available fonts.

FormatLocale

String

Returns the locale used for numbers and dates as a string in the format "la-CO" (language-COUNTRY).

Locale

String

Returns the locale of the operating system as a string in the format "la-CO" (language-COUNTRY). This is equivalent to the SystemLocale property.

Machine

String

The machine type. Examples are: 'i386' or 'x86_64'.

OfficeLocale

String

Returns the locale of the user interface as a string in the format "la-CO" (language-COUNTRY).

OfficeVersion

String

The actual LibreOffice version expressed as
' LibreOffice w.x.y.z (The Document Foundation)'.

Exemple: «LibreOffice 7.4.1.2 (The Document Foundation, Debian and Ubuntu)»

OSName

String

The operating system type. Example: 'Darwin, Linux' or 'Windows'.

OSPlatform

String

A single string identifying the underlying platform with as much useful and human-readable information as possible.

Example: 'Linux-5.8.0-44-generic-x86_64-with-glibc2.32'

OSRelease

String

The operating system's release. Example: '5.8.0-44-generic'

OSVersion

String

The operating system's build or version.

Example: '#50-Ubuntu SMP Tue Feb 9 06:29:41 UTC 2021'

Printers

String
array

The list of available printers as a zero-based array.

The default printer is put in the first position of the list (index = 0).

Processor

String

El nom real del processador. Exemple: «amdk6».

This property may return the same value as the Machine property.

PythonVersion

String

Returns the version of the Python interpreter being used as a string in the format "Python major.minor.patchlevel" (ex: "Python 3.9.7").

SystemLocale

String

Returns the locale of the operating system as a string in the format "la-CO" (language-COUNTRY). This is equivalent to the Locale property.


Exemple:

The following examples in Basic and Python illustrate how to use the Fonts property to write the names of all available fonts to the current Calc sheet starting at cell "A1":

In Basic

      Dim oDoc as Object
      Dim allFonts as Object
      Dim svcPlatform as Object
      Set oDoc = CreateScriptService("Calc")
      Set svcPlatform = CreateScriptService("Platform")
      allFonts = svcPlatform.Fonts
      oDoc.setArray("~.A1", allFonts)
    
In Python

      from scriptforge import CreateScriptService
      svc_platform = CreateScriptService("Platform")
      doc = CreateScriptService("Calc")
      all_fonts = svc_platform.Fonts
      doc.setArray("~.A1", all_fonts)
    
warning

All ScriptForge Basic routines or identifiers that are prefixed with an underscore character "_" are reserved for internal use. They are not meant be used in Basic macros or Python scripts.


Ens cal la vostra ajuda!