Tjenesten ScriptForge.Platform

Tjenesten Platform giver en samling af egenskaber vedrørerende det aktuelle kørselsmiljø og kontekst, såsom:

Den fysiske platform (arkitektur, CPU antal, maskintype og så videre)
Information og operativsystem (type af operativsystem, udgivelse, version og så videre)
LibreOffice version
Det aktuelle brugernavn

Alle egenskaber i tjenesten Platform er skrivebeskyttet.

Kald af tjeneste

Før brug af tjenesten Platformskal biblioteket ScriptForge være indlæst eller importeret:

• Basic-makroer kræver, at biblioteket ScriptForge indlæses med følgende udtryk:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• Python-scripts kræver import af scriptforge-modulet:
from scriptforge import CreateScriptService

Eksemplerne herunder på Basic og Python instantierer tjenesten Platform og tilgår egenskaben Platform.

I Basic


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

I Python


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

Egenskaber

Navn	Skrivebeskyttet	Type	Beskrivelse
Architecture	Ja	String	Hardwarens bit-arkitektur. Eksempel: '32bit' eller '64bit'
ComputerName	Ja	String	Computerens netværksnavn.
CPUCount	Ja	Integer	Antallet af centrale processeringsenheder (CPUer).
CurrentUser	Ja	String	Navnet på den aktuelt loggede bruger.
Extensions	Ja	Streng-array	Returnerer et array af strenge, med nul som første indeks, der indeholder de interne ID'er på alle installerede udvidelser.
FilterNames	Ja	Streng-array	Returnerer et usorteret array med begyndelsesindeks 0, med strenge som indeholder navnene på de tilgængelige filtre til dokumentimport og -export.
Fonts	Ja	Streng-array	Returnerer et array af strenge med 0 som første indeks, der indeholder navnene på alle tilgængelige fonte.
FormatLocale	Ja	String	Returnerer den lokalisering , der bruges til tal og datoer, som en streng i formatet "la-CO" (language-COUNTRY = sprog-LAND).
Locale	Yes	String	Returnerer operativsystemets lokalisering som en streng i formatet "la-CO" (language-COUNTRY = sprog-LAND). Den svarer til egenskaben SystemLocale (system_lokalisering).
Machine	Ja	String	Maskintype. Eksempler er: 'i386' eller 'x86_64'.
OfficeLocale	Ja	String	Returnerer brugerfladens lokalisering som en streng i formatet "la-CO" (language-COUNTRY = sprog-LAND).
OfficeVersion	Ja	String	Den aktuelle LibreOffice version, udtrykt som ' LibreOffice w.x.y.z (The Document Foundation)'. Eksempel: 'LibreOffice 7.4.1.2 (The Document Foundation, Debian og Ubuntu)'
OSName	Ja	String	Typen af operativsystem. Eksempel: 'Darwin, Linux' eller 'Windows'.
OSPlatform	Ja	String	En enkelt streng, der identificerer den underliggende platform med så megen nyttig og menneskeligt læsbar information som muligt. Eksempel: 'Linux-5.8.0-44-generic-x86_64-with-glibc2.32'
OSRelease	Ja	String	Operativsystemets udgave. Eksempel: '5.8.0-44-generic'
OSVersion	Ja	String	Operativsystemets byggenummer eller version. Eksempel: '#50-Ubuntu SMP Tue Feb 9 06:29:41 UTC 2021'
Printers	Ja	String array	Listen over tilgængelige printere som et array med 0 som første indeks. Standardprinteren står øverst på listen (indeks = 0).
Processor	Ja	String	Det faktiske processornavn. Eksempel: 'amdk6'. Denne egenskab kan returnere den samme værdi som egenskaben Machine ,
PythonVersion	Yes	String	Returnerer versionen på den Python-oversætter, der bruges, som en streng i formatet "Python major.minor.patchlevel" (fx: "Python 3.9.7").
SystemLocale	Ja	String	Returnerer operativsystemets lokalisering som en streng i formatet "la-CO" (language-COUNTRY = sprog-LAND). Den svarer til egenskaben Locale (lokalisering).
UserData	Ja	Dictionary	Returnerer en Dictionary-instans, som indeholder nøgle-værdi-par relateret til Funktioner ▸ Indstillinger ▸ Brugerdata-dialogen.

Eksempel:

I Basic

De følgende eksempler i Basic og Python viser, hvordan egenskaben Fonts (Skrifttyper) bruges til at skrive navnene på alle tilgængelige skrifttyper til det aktuelle Calc-ark begyndende med celle "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)

Eksemplet herunder viser, hvor du kan oprette en Calc-tabel med alle værdierne gemt i UserData-egenskaben, som er en instans af Dictionary-tjenesten:


    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)

I Python

Eksemplerne ovenfor kan skrives i Python som følger:


    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)

Alle ScriptForge Basic-rutiner eller identifikatorer, der indledes med et understregstegn "_" er reserveret til internt brug. Det er ikke meningen, at de skal bruges i Basic-makroer eller Python-scripts.

Identificerer operativsystemet

Platform- information med Calc-formlen INFO("system")

GetGuiType-funktion

Biblioteket Tools