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

S铆

String

La arquitectura de bits del equipo. Ejemplo: 芦32bit禄 y 芦64bit

ComputerName

S铆

String

El nombre en red del equipo.

CPUCount

S铆

Integer

El n煤mero de unidades centrales de procesamiento.

CurrentUser

S铆

String

El nombre de la cuenta de usuario activa.

Extensions

S铆

Matriz de cadenas

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

FilterNames

S铆

Matriz de cadenas

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

Fonts

S铆

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

S铆

String

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

Locale

S铆

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

S铆

String

El tipo de m谩quina. Algunos ejemplos son: 芦i386禄 o 芦x86_64禄.

OfficeLocale

S铆

String

Devuelve la configuraci贸n regional de la interfaz de usuario en el formato 芦xx-XX禄 (idioma-PA脥S).

OfficeVersion

S铆

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

S铆

String

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

OSPlatform

S铆

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

S铆

String

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

OSVersion

S铆

String

The operating system's build or version.

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

Printers

S铆

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

S铆

String

El nombre real del procesador. Ejemplo: 芦amdk6禄.

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

PythonVersion

S铆

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

S铆

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!