Servicio ScriptForge.Platform

El servicio Platform ofrece una colección de propiedades sobre el entorno y el contexto de ejecución actuales, tales como:

note

Todas las propiedades del servicio Platform son de solo lectura.


Invocación del servicio

Antes de utilizar el servicio Platform, es necesario cargar o importar la biblioteca ScriptForge:

note

• Para cargar la biblioteca ScriptForge que necesitan las macros de Basic se debe usar la siguiente declaración:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Los scripts de Python necesitan importar el módulo scriptforge:
from scriptforge import CreateScriptService


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

En BASIC

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

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

Propiedades

Nombre

De solo lectura

Tipo

Descripción

Architecture

String

La arquitectura de bits del equipo. Ejemplo: «32bit» y «64bit»

ComputerName

String

El nombre en red del equipo.

CPUCount

Integer

El número de unidades centrales de procesamiento.

CurrentUser

String

El nombre de la cuenta de usuario activa.

Extensions

Matriz de cadenas

Devuelve una matriz de cadenas indizada a partir de cero que contiene los identificadores internos de todas las extensiones instaladas.

FilterNames

Matriz de cadenas

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

Fonts

Matriz de cadenas

Devuelve una matriz de cadenas indizada a partir de cero que contiene los nombres de todos los tipos de letra disponibles.

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

El tipo de máquina. Algunos ejemplos son: «i386» o «x86_64».

OfficeLocale

String

Devuelve la configuración regional de la interfaz de usuario en el formato «xx-XX» (idioma-PAÍS).

OfficeVersion

String

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

Ejemplo: «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

La lista de impresoras disponibles devueltas como una matriz indizada a partir de cero.

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

Processor

String

El nombre real del procesador. Ejemplo: «amdk6».

Es posible que esta propiedad devuelva el mismo valor que la propiedad Machine.

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.

UserData

Yes

Dictionary

Returns a Dictionary instance containing key-value pairs in relation with Tools - Options - User Data dialog.


Ejemplo:

En BASIC

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":


    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)
  

The example below demonstrates how to create a Calc table with all the values stored in the UserData property, which is a Dictionary service instance:


    Dim svcPlatform as Object, oUserData as Object, oDoc as Object
    Dim arrUserData As Object, currCell As String
    Set svcPlatform = CreateScriptService("Platform")
    oUserData = svcPlatform.UserData
    arrUserData = oUserData.ConvertToArray()
    Set oDoc = CreateScriptService("Calc", ThisComponent)
    oDoc.SetArray("~.A1", Array(Array("Key", "Value")))
    oDoc.SetArray("~.A2", arrUserData)
  
En Python

The examples above can be written in Python as follows:


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

    from scriptforge import CreateScriptService
    bas = CreateScriptService("Basic")
    doc = CreateScriptService("Calc", bas.ThisComponent)
    svc_platform = CreateScriptService("Platform")
    user_data = svc_platform.UserData
    arr_user_data = [[key, user_data[key]] for key in user_data]
    doc.SetArray("~.A1", (("Key", "Value"),))
    doc.SetArray("~.A2", arr_user_data)
  
warning

Todas las rutinas o identificadores BASIC de ScriptForge precedidas por guion bajo «_» están reservadas para uso interno. No deben utilizarse en macros BASIC o secuencias Python.


¡Necesitamos su ayuda!