Inhalte
Index 🔎︎

# Dienst ScriptForge.Platform

Der Dienst Platform stellt eine Sammlung von Eigenschaften über die aktuelle Ausführungsumgebung und den aktuellen Kontext bereit, beispielsweise:

- Die Hardwareplattform (Architektur, CPU-Anzahl, Maschinentyp, …)

- Informationen zum Betriebssystem (BS-Typ, Release, Version, …)

- Die LibreOffice-Version

- Den aktuellen Benutzernamen

Alle Eigenschaften des Dienstes Platform sind schreibgeschützt.

## Dienstaufruf

Vor der Verwendung des Dienstes Platform muss die Bibliothek ScriptForge geladen oder importiert werden:

• Grundlegende Makros erfordern das Laden der Bibliothek ScriptForge mit der folgenden Anweisung:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")
• Python-Skripte erfordern einen Import aus dem Modul scriptforge:
from scriptforge import CreateScriptService

Die folgenden Beispiele in Basic und Python instanziieren den Dienst Platform und greifen auf die Eigenschaft Architecture zu.

##### 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)

## Eigenschaften

Name | Schreibgeschützt | Typ | Beschreibung
--- | --- | --- | ---
Architecture | Ja | String | Die Hardware-Bit-Architektur. Beispiel: '32bit' oder '64bit'
ComputerName | Ja | String | Der Netzwerkname des Computers.
CPUCount | Ja | Integer | Die Anzahl der CPUs.
CurrentUser | Ja | String | Der Name des aktuell angemeldeten Benutzers.
Extensions | Ja | Zeichenfolgenmatrix | Gibt eine nullbasierte Zeichenfolgenmatrix zurück, welche die internen IDs aller installierten Erweiterungen enthält.
FilterNames | Ja | Zeichenfolgenmatrix | Gibt eine nullbasierte, unsortierte Zeichenfolgenmatrix zurück, welche die verfügbaren Import- und Exportfilternamen für Dokumente enthält.
Fonts | Ja | Zeichenfolgenmatrix | Gibt eine nullbasierte Matrix mit Zeichenfolgen zurück, welche die Namen aller verfügbaren Schriftarten enthält.
FormatLocale | Ja | String | Gibt das für Zahlen und Daten verwendete Gebietsschema als Zeichenfolge im Format "la-CO" (Sprache-LAND) zurück.
Locale | Ja | String | Gibt das Gebietsschema des Betriebssystems als Zeichenfolge im Format "la-CO" (Sprache-LAND) zurück. Dies entspricht der Eigenschaft SystemLocale.
Machine | Ja | String | Der Maschinentyp. Beispielsweise: 'i386' oder 'x86_64'.
OfficeLocale | Ja | String | Gibt das Gebietsschema der Benutzeroberfläche als Zeichenfolge im Format "la-CO" (Sprache-LAND) zurück.
OfficeVersion | Ja | String | Die tatsächliche LibreOffice-Version, ausgedrückt als ' LibreOffice w.x.y.z (The Document Foundation)'. Beispiel: 'LibreOffice 7.4.1.2 (The Document Foundation, Debian and Ubuntu)'
OSName | Ja | String | Der Betriebssystemtyp. Beispielsweise: 'Darwin, Linux' oder 'Windows'.
OSPlatform | Ja | String | Eine einzelne Zeichenfolge, welche die zugrunde liegende Plattform mit so vielen nützlichen und für Menschen lesbaren Informationen wie möglich identifiziert. Beispielsweise: 'Linux-5.8.0-44-generic-x86_64-with-glibc2.32'
OSRelease | Ja | String | Die BS-Version. Beispielsweise: '5.8.0-44-generic'
OSVersion | Ja | String | Der Build oder die Version des Betriebssystems. Beispeilsweise: '#50-Ubuntu SMP Tue Feb 9 06:29:41 UTC 2021'
Printers | Ja | String array | Die Liste der verfügbaren Drucker als nullbasierte Matrix. Der Standarddrucker wird an die erste Position der Liste gesetzt (Index = 0).
Processor | Ja | String | Der echte Prozessorname. Beispielsweise: 'amdk6'. Diese Eigenschaft kann denselben Wert wie die Eigenschaft Machine zurückgeben.
PythonVersion | Ja | String | Gibt die Version des verwendeten Python-Interpreters als Zeichenfolge im Format „Python major.minor.patchlevel“ zurück (beispielsweise „Python 3.9.7“).
SystemLocale | Ja | String | Gibt das Gebietsschema des Betriebssystems als Zeichenfolge im Format "la-CO" (Sprache-LAND) zurück. Dies entspricht der Eigenschaft Locale.

### Beispiel:

Die folgenden Beispiele in Basic und Python veranschaulichen, wie die Eigenschaft Fonts verwendet wird, um die Namen aller verfügbaren Schriftarten in die aktuelle Calc-Tabelle zu schreiben, beginnend bei Zelle "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)

Alle ScriptForge Basic-Routinen oder Bezeichner, denen ein Unterstrich "_" vorangestellt ist, sind für den internen Gebrauch reserviert. Sie sind nicht für die Verwendung in Basic-Makros oder Python-Skripten vorgesehen.

Verwandte Themen

Betriebssystem identifizieren

Plattforminformationen mit INFO("system") Calc-Formel

Funktion GetGuiType

Die Bibliothek Tools